@leadbay/mcp 0.31.1 → 0.32.0

package/dist/bin.js

@@ -5693,7 +5693,7 @@ var init_notifications = __esm({
 });
 
 // ../core/dist/tool-descriptions.generated.js
-var leadbay_account_history, leadbay_account_status, leadbay_acknowledge_notification, leadbay_add_contact, leadbay_add_leads_to_campaign, leadbay_add_note, leadbay_adjust_audience, leadbay_agent_memory_capture, leadbay_agent_memory_recall, leadbay_agent_memory_review, leadbay_answer_clarification, leadbay_artifact_kit, leadbay_bulk_enrich_status, leadbay_bulk_qualify_leads, leadbay_campaign_call_sheet, leadbay_campaign_progression, leadbay_clear_selection, leadbay_clear_user_prompt, leadbay_create_campaign, leadbay_create_custom_field, leadbay_create_lens, leadbay_create_lens_draft, leadbay_create_topup_link, leadbay_delete_custom_field, leadbay_deselect_leads, leadbay_discover_leads, leadbay_dislike_lead, leadbay_dismiss_clarification, leadbay_enrich_contacts, leadbay_enrich_titles, leadbay_extend_lens, leadbay_followups_map, leadbay_get_clarification, leadbay_get_contacts, leadbay_get_enrichment_job_titles, leadbay_get_epilogue_responses, leadbay_get_lead_activities, leadbay_get_lead_custom_fields, leadbay_get_lead_notes, leadbay_get_lead_profile, leadbay_get_lens_filter, leadbay_get_lens_scoring, leadbay_get_prospecting_actions, leadbay_get_qualification_questions, leadbay_get_quota, leadbay_get_selection_ids, leadbay_get_taste_profile, leadbay_get_user_prompt, leadbay_get_web_fetch, leadbay_getting_started, leadbay_import_and_qualify, leadbay_import_leads, leadbay_import_status, leadbay_launch_bulk_enrichment, leadbay_like_lead, leadbay_list_campaigns, leadbay_list_lenses, leadbay_list_locations, leadbay_list_mappable_fields, leadbay_list_sectors, leadbay_login, leadbay_my_lenses, leadbay_new_lens, leadbay_open_billing_portal, leadbay_pick_clarification, leadbay_pin_contact, leadbay_prepare_outreach, leadbay_preview_bulk_enrichment, leadbay_promote_lens, leadbay_pull_followups, leadbay_pull_leads, leadbay_qualify_lead, leadbay_qualify_status, leadbay_recall_ordered_titles, leadbay_refine_prompt, leadbay_remove_contact, leadbay_remove_epilogue, leadbay_remove_leads_from_campaign, leadbay_remove_pushback, leadbay_report_friction, leadbay_report_outreach, leadbay_research_lead_by_id, leadbay_research_lead_by_name_fuzzy, leadbay_resolve_import_rows, leadbay_scan_portfolio_signals, leadbay_seed_candidates, leadbay_select_leads, leadbay_send_feedback, leadbay_set_active_lens, leadbay_set_epilogue_status, leadbay_set_pushback, leadbay_set_qualification_questions, leadbay_set_telemetry, leadbay_set_user_prompt, leadbay_team_activity, leadbay_tour_plan, leadbay_unpin_contact, leadbay_update_contact, leadbay_update_custom_field, leadbay_update_lens, leadbay_update_lens_filter;
+var leadbay_account_history, leadbay_account_status, leadbay_acknowledge_notification, leadbay_add_contact, leadbay_add_leads_to_campaign, leadbay_add_note, leadbay_adjust_audience, leadbay_agent_memory_capture, leadbay_agent_memory_recall, leadbay_agent_memory_review, leadbay_answer_clarification, leadbay_artifact_kit, leadbay_bulk_enrich_status, leadbay_bulk_qualify_leads, leadbay_campaign_call_sheet, leadbay_campaign_progression, leadbay_clear_selection, leadbay_clear_user_prompt, leadbay_create_campaign, leadbay_create_custom_field, leadbay_create_lens, leadbay_create_lens_draft, leadbay_create_topup_link, leadbay_delete_custom_field, leadbay_deselect_leads, leadbay_discover_leads, leadbay_dislike_lead, leadbay_dismiss_clarification, leadbay_enrich_contacts, leadbay_enrich_titles, leadbay_extend_lens, leadbay_followups_map, leadbay_get_clarification, leadbay_get_contacts, leadbay_get_enrichment_job_titles, leadbay_get_epilogue_responses, leadbay_get_lead_activities, leadbay_get_lead_custom_fields, leadbay_get_lead_notes, leadbay_get_lead_profile, leadbay_get_lens_filter, leadbay_get_lens_scoring, leadbay_get_prospecting_actions, leadbay_get_qualification_questions, leadbay_get_quota, leadbay_get_selection_ids, leadbay_get_taste_profile, leadbay_get_user_prompt, leadbay_get_web_fetch, leadbay_getting_started, leadbay_import_and_qualify, leadbay_import_leads, leadbay_import_status, leadbay_launch_bulk_enrichment, leadbay_like_lead, leadbay_list_campaigns, leadbay_list_lenses, leadbay_list_locations, leadbay_list_mappable_fields, leadbay_list_sectors, leadbay_login, leadbay_my_lenses, leadbay_new_lens, leadbay_open_billing_portal, leadbay_pick_clarification, leadbay_pin_contact, leadbay_prepare_outreach, leadbay_preview_bulk_enrichment, leadbay_promote_lens, leadbay_pull_followups, leadbay_pull_leads, leadbay_qualify_lead, leadbay_qualify_status, leadbay_recall_ordered_titles, leadbay_refine_prompt, leadbay_remove_contact, leadbay_remove_epilogue, leadbay_remove_leads_from_campaign, leadbay_remove_pushback, leadbay_report_friction, leadbay_report_outreach, leadbay_research_lead_by_id, leadbay_research_lead_by_name_fuzzy, leadbay_resolve_import_rows, leadbay_scan_portfolio_signals, leadbay_seed_candidates, leadbay_select_leads, leadbay_send_feedback, leadbay_set_active_lens, leadbay_set_epilogue_status, leadbay_set_lead_status, leadbay_set_pushback, leadbay_set_qualification_questions, leadbay_set_telemetry, leadbay_set_user_prompt, leadbay_team_activity, leadbay_tour_plan, leadbay_unpin_contact, leadbay_update_contact, leadbay_update_custom_field, leadbay_update_lens, leadbay_update_lens_filter;
 var init_tool_descriptions_generated = __esm({
   "../core/dist/tool-descriptions.generated.js"() {
     "use strict";
@@ -6247,7 +6247,7 @@ The model \u2014 two layers. Primitives: \`lb.field\` (value + API-populated opt
 
 Canonical uses: a cold-call sheet (\`lb.callList\` + per-row \`lb.outreach\`/\`lb.leadHistory\`); a manager dashboard (\`lb.teamActivity\` \u2192 leaderboard table + Chart.js trend); a live enrichment view (\`lb.enrichment\` \u2192 progress + refresh). Live auto-poll is host-dependent \u2014 always wire a Refresh.
 
-Write-call footguns (in the guide, repeated because they bite): for \`leadbay_report_outreach\` (status/disposition) the \`args\` MUST include \`verification:{source:"user_confirmed",ref:"\u2026"}\` AND \`_triggered_by:"<the user's request>"\`, or the call is rejected. \`leadbay_add_leads_to_campaign\` needs \`_triggered_by\` too. \`leadbay_add_note\`/\`leadbay_like_lead\`/\`leadbay_dislike_lead\` need only their own args. Snoozing (pushback) and standalone status are advanced-gated \u2014 not callable from a default artifact; use \`report_outreach\`'s \`epilogue_status\` for outcomes.
+Write-call footguns (in the guide, repeated because they bite): for \`leadbay_report_outreach\` (status/disposition) the \`args\` MUST include \`verification:{source:"user_confirmed",ref:"\u2026"}\` AND \`_triggered_by:"<the user's request>"\`, or the call is rejected. \`leadbay_add_leads_to_campaign\` needs \`_triggered_by\` too. \`leadbay_add_note\`/\`leadbay_like_lead\`/\`leadbay_dislike_lead\` need only their own args. Snoozing (pushback) is advanced-gated \u2014 not callable from a default artifact. Org CRM status IS available: \`lb.leadStatus()\` gives the Wanted/Won/Lost/Unwanted picker field and \`lb.setStatus()\` the write (\`leadbay_set_lead_status\`), with the partial-write check baked in. Keep it distinct from \`report_outreach\`'s \`epilogue_status\`, which records how one outreach ATTEMPT went.
 
 WHEN TO USE: the user asks for a clickable / interactive artifact, dashboard, or call sheet that DOES things (not just displays data).
 
@@ -7105,9 +7105,31 @@ WHEN NOT TO USE: to answer the question \u2014 use leadbay_answer_clarification.
 `;
     leadbay_get_contacts = `Get contacts for a lead, including enriched email and phone data. Returns both organization contacts and enrichable contacts with IDs, tagged with \`source:'org'|'paid'\`.
 
-WHEN TO USE: to check enrichment status (\`contact.enrichment.done\`) on individual leads after a bulk enrichment was launched, or to find the \`contact_id\` needed by leadbay_enrich_contacts.
+WHEN TO USE: to check enrichment status (\`contact.enrichment\`) on individual leads after a bulk enrichment was launched, or to find the \`contact_id\` needed by leadbay_enrich_contacts.
 
 WHEN NOT TO USE: as a substitute for leadbay_research_lead_by_id, which already includes enriched contacts in its return.
+
+## Reading \`contact.enrichment\`
+
+\`enrichment\` is the per-contact reveal record. Four states. Read \`done\` and \`credits_used\` **together** \u2014 neither is a verdict on its own.
+
+| \`enrichment\` | \`done\` | \`credits_used\` | Meaning | What to do |
+|---|---|---|---|---|
+| missing / \`null\` | \u2014 | \u2014 | Never requested. | Enrichable \u2014 launch it. |
+| present | \`false\` | any | Reservation in flight. | Poll. Do NOT re-launch. |
+| present | \`true\` | \`0\` | Settled, found nothing. | **Terminal. Stop.** |
+| present | \`true\` | \`> 0\` | Resolved. | The channel is on the org-source twin, not here \u2014 see below. |
+
+**\`done: true\` with \`credits_used: 0\` is terminal for that contact.** The enrichment completed and the provider returned nothing. Do not re-attempt it on a later run \u2014 the answer will not change. Roughly 29% of all enrichments land here, so it is an ordinary outcome, not an anomaly. Tell the user plainly that there is no reachable contact rather than reporting it as still pending. The one exception: a launch that errored in this same session settles its reservation as a zero-credit failure, so retry that one once, then treat it as terminal.
+
+Two ways to misread the pair:
+
+- **\`credits_used: 0\` alone means nothing.** An in-flight reservation also reports \`0\` (with \`done: false\`). Gate every read of \`credits_used\` on \`done: true\`.
+- **An absent \`credits_used\` is unknown, not zero.** The field is optional. When it is missing you cannot conclude terminal-empty \u2014 only an explicit \`0\` alongside \`done: true\` means "we looked and found nothing".
+
+A missing or \`null\` \`enrichment\` is not the same as \`done: false\`. It means the contact was never requested, so \`enrichment?.done\` reading falsy does NOT mean a reveal is running. Treat missing/\`null\` as enrichable and \`done: false\` as in-flight.
+
+**Where a resolved channel lands.** A \`source:'paid'\` contact keeps its \`enrichment\` record but never carries the revealed \`email\` / \`phone_number\` itself \u2014 the reveal materializes a \`source:'org'\` twin of the same person, and the channel is on that entry. So a paid contact reading \`done: true, credits_used: 1\` with a null \`email\` is RESOLVED, not failed: find the org-source entry with the same name and read the channel there. Judge success by the channel you can actually see across both entries, never by \`enrichment\` on the paid record alone.
 `;
     leadbay_get_enrichment_job_titles = `List the actual job titles present across the leads currently in the user's selection \u2014 the candidate set the user can ask to enrich.
 
@@ -7422,7 +7444,7 @@ WHEN NOT TO USE: discovery (use leadbay_pull_leads); single-lead deep dive (use
 
 Budgets: \`total_budget_ms\` caps wall-clock; \`per_lead_budget_ms\` caps each lead's poll. For short transport timeouts, pass \`wait_for_completion:false\` and poll \`leadbay_import_status\`. Outputs \`qualified[]\`, \`still_running[]\`, \`not_imported[]\`, \`qualify_id\` (resumable handle). Idempotent within a 5-min window. \`dry_run:'preview'\` returns mapping hints + custom-field candidates without importing.
 
-\`not_imported\` rows with \`reason:"uncrawled"\` are **pending a background crawl**, NOT failures: Leadbay just hasn't matched/crawled that domain yet and will add the lead asynchronously (the label doesn't verify the URL resolves \u2014 don't call the site bad, but don't certify it valid either). Surface them as pending; the leads populate in the user's Leadbay account as the crawl completes (no tool here fetches them on demand \u2014 \`leadbay_import_status\` returns status/progress only, and \`leadbay_pull_leads\` reads the active lens's wishlist so an imported lead outside that lens may not appear). To pull those specific companies back through the MCP, re-run the import later. A large \`uncrawled\` share on a fresh list is normal.
+\`not_imported\` rows with \`reason:"uncrawled"\` are **pending a background crawl**, NOT failures: Leadbay just hasn't matched/crawled that domain yet and will add the lead asynchronously (the label doesn't verify the URL resolves \u2014 don't call the site bad, but don't certify it valid either). Surface them as pending; the leads populate in the user's Leadbay account as the crawl completes (no tool here fetches them on demand \u2014 \`leadbay_import_status\` reports the rows the wizard has already placed, not leads a later crawl adds, and \`leadbay_pull_leads\` reads the active lens's wishlist so an imported lead outside that lens may not appear). To pull those specific companies back through the MCP, re-run the import later. A large \`uncrawled\` share on a fresh list is normal.
 
 This tool MUTATES state. The caller (agent or human-in-the-loop) is responsible for confirming intent before invocation; the MCP server does not soft-prompt for confirmation. See \`annotations.destructiveHint\`.
 
@@ -7447,7 +7469,8 @@ Otherwise, partition \`not_imported\` by \`reason\` into these buckets before yo
 **Header \u2014 single line, choose by status:**
 
 - Completed: \`"\u2713 Import complete \u2014 N imported \xB7 P pending crawl \xB7 Q need attention"\` (drop any segment whose count is 0)
-- Running: \`"\u23F3 Import running \u2014 handle_id <id>; poll leadbay_import_status"\`
+- Running, \`handle_id\` present: \`"\u23F3 Import running \u2014 handle_id <id>; poll leadbay_import_status"\`
+- Running with \`timed_out:true\` (blocking call ran out of poll budget): the import is FINE and still running server-side \u2014 never render this as an error or a failure. \`"\u23F3 Import still running (the backend is slow today) \u2014 I'll check back."\` Then call \`leadbay_import_status({importIds})\`, do NOT re-run leadbay_import_leads. If \`rows_pending_upload\` is present, add \`"\u26A0 K rows weren't submitted \u2014 re-import just those."\`
 - Pending qualification (\`leadbay_import_and_qualify\`): \`"\u2713 Imported N leads \xB7 qualifying M of them \u2014 qualify_id <id>"\`
 
 Count \`uncrawled\` rows as **pending**, never as failures \u2014 never say "M failed" when the M is mostly/entirely uncrawled rows.
@@ -7496,7 +7519,9 @@ User picks \u2192 call the matching \`Calls\` tool. Constraints: 2\u20134 mutual
 
 | Observation                                    | Suggest                                                       | Calls                                                  |
 |------------------------------------------------|---------------------------------------------------------------|--------------------------------------------------------|
-| Status: running                                | "Check progress"                                              | leadbay_import_status(handle_id)                       |
+| Status: running, \`handle_id\` present           | "Check progress"                                              | leadbay_import_status(handle_id)                       |
+| Status: running with \`timed_out:true\`          | "Check progress" \u2014 NOT "retry the import"                     | leadbay_import_status(importIds, dry_run if the result carried it) after ~30s; \`result.leads\` carries the leadIds once complete |
+| \`rows_pending_upload\` present                  | "Import the rows that never got submitted"                    | leadbay_import_leads (that subset only)                |
 | Status: complete, imports succeeded            | "Run AI qualification on the imported leads"                  | leadbay_bulk_qualify_leads([leadIds]) \u2014 or use leadbay_import_and_qualify next time |
 | Pending-crawl (\`uncrawled\`) rows present       | "Re-run the import for those domains later, once Leadbay has crawled them" | leadbay_import_leads (re-run with just the uncrawled domains, later \u2014 they re-reconcile once crawled). NOTE: not a live-fetch of the added leads; those populate in the user's Leadbay account as the crawl completes |
 | Ambiguous / unresolved rows present            | "Resolve the ambiguous rows"                                  | leadbay_resolve_import_rows(records, identity_mappings)|
@@ -7506,9 +7531,11 @@ User picks \u2192 call the matching \`Calls\` tool. Constraints: 2\u20134 mutual
 `;
     leadbay_import_leads = `Import leads into Leadbay's CRM via the file-import wizard. Returns stable Leadbay leadIds for downstream chaining into leadbay_bulk_qualify_leads / leadbay_research_lead_by_id. For MCP clients with short transport timeouts, pass \`wait_for_completion:false\` to return quickly with \`{status:'running', handle_id}\`; poll leadbay_import_status with that handle. For end-to-end import+qualify in one call, prefer leadbay_import_and_qualify. For messy files, prefer the \`leadbay_import_file\` prompt which walks an agent through scan \u2192 resolve \u2192 preserve \u2192 commit phases.
 
+SLOW BACKEND \u21D2 \`{status:'running', timed_out:true, importIds}\`. The wizard is sometimes slow; when the poll budget runs out this tool returns that SUCCESS result, not an error. The import is still running server-side. **Do NOT call leadbay_import_leads again** \u2014 that re-uploads the file and leaves a duplicate CRM-imports row. Call \`leadbay_import_status({importIds})\` after ~30s \u2014 and pass \`dry_run:true\` too if the result carried it; on \`complete\` it returns \`result.leads\` with the leadIds, while \`phase:"committing"\` just means keep polling. Tell the user it's running and you'll check back \u2014 it is not a problem to report. Exception: \`rows_pending_upload\` rows never reached the backend and DO need a fresh call for that subset only. In records mode the result also carries \`row_ids\` \u2014 the synthetic id of each input row, in your \`records[]\` order \u2014 because \`leadbay_import_status\` reports recovered leads by that id; keep it to map them back to your source rows.
+
 TWO MODES: (A) Domain-list shortcut \u2014 pass \`domains: [{domain, name?}]\`. The tool builds a 2-column CSV (LEAD_NAME, LEAD_WEBSITE) and imports with the default mapping. (B) Custom records + mapping \u2014 pass \`records: [{Col1, Col2, ...}]\` plus \`mappings.fields: {Col1: 'LEAD_NAME', ...}\`. \`mappings.fields\` must include LEADBAY_ID, CRM_ID, SIREN, LEAD_NAME, or LEAD_WEBSITE (resolver needs at least one identity key). Pass exactly one of \`domains\` / \`records\`. Reserved column \`MCP_ROW_ID\` cannot appear in records/mappings \u2014 the tool injects it for stable reconciliation.
 
-\`not_imported\` rows with \`reason:"uncrawled"\` are **pending a background crawl**, NOT failures: Leadbay just hasn't matched/crawled that domain yet and will add the lead asynchronously (the label doesn't verify the URL resolves \u2014 don't call the site bad, but don't certify it valid either). Surface them as pending; the leads populate in the user's Leadbay account as the crawl completes (no tool here fetches them on demand \u2014 \`leadbay_import_status\` returns status/progress only, and \`leadbay_pull_leads\` reads the active lens's wishlist so an imported lead outside that lens may not appear). To pull those specific companies back through the MCP, re-run the import later. A large \`uncrawled\` share on a fresh list is normal.
+\`not_imported\` rows with \`reason:"uncrawled"\` are **pending a background crawl**, NOT failures: Leadbay just hasn't matched/crawled that domain yet and will add the lead asynchronously (the label doesn't verify the URL resolves \u2014 don't call the site bad, but don't certify it valid either). Surface them as pending; the leads populate in the user's Leadbay account as the crawl completes (no tool here fetches them on demand \u2014 \`leadbay_import_status\` reports the rows the wizard has already placed, not leads a later crawl adds, and \`leadbay_pull_leads\` reads the active lens's wishlist so an imported lead outside that lens may not appear). To pull those specific companies back through the MCP, re-run the import later. A large \`uncrawled\` share on a fresh list is normal.
 
 MUTATES USER STATE: each call creates a row in the user's CRM-imports list (visible in the web UI) and touches onboarding state. Suitable for occasional automation, NOT for high-cadence (>5 calls/day). Imported leads are NOT auto-promoted to the user's Monitor view; lens-scoring threshold decides. For messy files call leadbay_resolve_import_rows first, then pass \`records_for_import\`/\`mappings_for_import\` here. Agents should inspect every column, build a preservation plan, and pass an explicit final mapping. For each meaningful column decide standard field, CONTACT_* field, Leadbay note, custom field, derived helper, or skip with a reason. For contact-only exports, derive a company-domain column from CONTACT_EMAIL only when it's a real business domain. Multiple rows can share the same LEADBAY_ID and import as separate contacts on that lead. Custom fields use \`CUSTOM.<id>\` in \`mappings.fields\` or the \`mappings.custom_fields\` shorthand. For source-system deep links create a custom field via leadbay_create_custom_field first (prefer EXTERNAL_ID + url_template). Preserve meaningful per-lead notes by calling leadbay_add_note after import returns lead IDs.
 
@@ -7539,7 +7566,8 @@ Otherwise, partition \`not_imported\` by \`reason\` into these buckets before yo
 **Header \u2014 single line, choose by status:**
 
 - Completed: \`"\u2713 Import complete \u2014 N imported \xB7 P pending crawl \xB7 Q need attention"\` (drop any segment whose count is 0)
-- Running: \`"\u23F3 Import running \u2014 handle_id <id>; poll leadbay_import_status"\`
+- Running, \`handle_id\` present: \`"\u23F3 Import running \u2014 handle_id <id>; poll leadbay_import_status"\`
+- Running with \`timed_out:true\` (blocking call ran out of poll budget): the import is FINE and still running server-side \u2014 never render this as an error or a failure. \`"\u23F3 Import still running (the backend is slow today) \u2014 I'll check back."\` Then call \`leadbay_import_status({importIds})\`, do NOT re-run leadbay_import_leads. If \`rows_pending_upload\` is present, add \`"\u26A0 K rows weren't submitted \u2014 re-import just those."\`
 - Pending qualification (\`leadbay_import_and_qualify\`): \`"\u2713 Imported N leads \xB7 qualifying M of them \u2014 qualify_id <id>"\`
 
 Count \`uncrawled\` rows as **pending**, never as failures \u2014 never say "M failed" when the M is mostly/entirely uncrawled rows.
@@ -7588,7 +7616,9 @@ User picks \u2192 call the matching \`Calls\` tool. Constraints: 2\u20134 mutual
 
 | Observation                                    | Suggest                                                       | Calls                                                  |
 |------------------------------------------------|---------------------------------------------------------------|--------------------------------------------------------|
-| Status: running                                | "Check progress"                                              | leadbay_import_status(handle_id)                       |
+| Status: running, \`handle_id\` present           | "Check progress"                                              | leadbay_import_status(handle_id)                       |
+| Status: running with \`timed_out:true\`          | "Check progress" \u2014 NOT "retry the import"                     | leadbay_import_status(importIds, dry_run if the result carried it) after ~30s; \`result.leads\` carries the leadIds once complete |
+| \`rows_pending_upload\` present                  | "Import the rows that never got submitted"                    | leadbay_import_leads (that subset only)                |
 | Status: complete, imports succeeded            | "Run AI qualification on the imported leads"                  | leadbay_bulk_qualify_leads([leadIds]) \u2014 or use leadbay_import_and_qualify next time |
 | Pending-crawl (\`uncrawled\`) rows present       | "Re-run the import for those domains later, once Leadbay has crawled them" | leadbay_import_leads (re-run with just the uncrawled domains, later \u2014 they re-reconcile once crawled). NOTE: not a live-fetch of the added leads; those populate in the user's Leadbay account as the crawl completes |
 | Ambiguous / unresolved rows present            | "Resolve the ambiguous rows"                                  | leadbay_resolve_import_rows(records, identity_mappings)|
@@ -7596,7 +7626,7 @@ User picks \u2192 call the matching \`Calls\` tool. Constraints: 2\u20134 mutual
 | User wants to see the imported leads           | "See the imported leads in your view"                         | leadbay_pull_leads                                     |
 | User had follow-up intent for the imports      | "Prep outreach for [a specific imported lead]"                | leadbay_prepare_outreach(leadId)                       |
 `;
-    leadbay_import_status = `Retrieve the current **status/progress** of a lead import. Pass \`handle_id\` \u2014 returned by either \`leadbay_import_leads\` OR \`leadbay_import_and_qualify\` when called with \`wait_for_completion:false\` \u2014 to resolve the stored result (leads + not_imported) once that async run has completed in this MCP instance. **If you were given a \`handle_id\`, poll with it, not with \`importIds[]\`** \u2014 only the \`handle_id\` path returns the stored result/not_imported breakdown. Pass \`importIds[]\` (a completed import returns \`importIds\`; \`leadbay_import_and_qualify\` returns \`import_ids\`) only when you don't have a handle, to refresh the backend wizard rows' phase + record counts. Note: the \`importIds[]\` path returns status/progress only \u2014 it does NOT re-reconcile records or return refreshed leads/not_imported. This status call performs a single refresh pass and never polls in a loop.
+    leadbay_import_status = `Retrieve the current **status/progress** of a lead import, and its leadIds once it finishes. Pass \`handle_id\` \u2014 returned by either \`leadbay_import_leads\` OR \`leadbay_import_and_qualify\` when called with \`wait_for_completion:false\` \u2014 to resolve the stored result (leads + not_imported) for that async run. Pass \`importIds[]\` when you don't have a handle: after a blocking \`leadbay_import_leads\` returned \`{status:'running', timed_out:true, importIds}\`, or from any completed import's \`importIds\` (\`leadbay_import_and_qualify\` calls the same field \`import_ids\`). **Both paths return leads.** The \`importIds[]\` path reads the wizard's records directly, so once every named import is \`complete\` (and it wasn't a dry run) the response carries \`result.leads\` + \`result.not_imported\` \u2014 that is how you recover the leadIds from an import that timed out mid-poll, without re-importing. \`result.still_settling\` counts rows the wizard hasn't finished placing; they are neither imported nor failed, so poll again rather than reporting them. If \`result\` is absent on a \`complete\` import the records weren't readable \u2014 report completion without inventing counts. \`phase:"committing"\` means the import is still being committed, NOT that it finished with nothing: keep polling. Pass \`dry_run:true\` when the importIds came from a dry run (a \`{timed_out:true}\` result carries \`dry_run\` \u2014 hand it straight back); a finished dry run and an import mid-commit are identical on the wire, so without that flag this tool reports \`committing\` rather than risk rendering a validation pass as a real import. This status call performs a single refresh pass and never polls in a loop.
 
 WHEN TO USE: after an async import (\`leadbay_import_leads\` OR \`leadbay_import_and_qualify\` with \`wait_for_completion:false\`) returns \`{status:'running', handle_id}\`, poll with that \`handle_id\`; OR to check whether a finished import is still processing. This tool does NOT surface the leads Leadbay adds later for pending-crawl (\`uncrawled\`) rows \u2014 those populate in the user's Leadbay account as the crawl completes; no tool here fetches them on demand (re-run the import to pull them back through the MCP).
 
@@ -7620,12 +7650,14 @@ After the status line, propose the obvious refresh / progress-check / recovery a
 
 Specifically for import status:
 
-This tool returns \`status\`, \`importIds\`, and \`progress\` ({phase, records_processed, records_total}). It carries a \`result\` object (with \`leads\` + \`not_imported\`) ONLY when resolving an async \`handle_id\` whose run completed in this MCP instance \u2014 the \`importIds[]\` status-check path does NOT return \`result\`. **Render only from the fields actually present; never invent counts.**
+This tool returns \`status\`, \`importIds\`, and \`progress\` ({phase, records_processed, records_total}). It carries a \`result\` object (with \`leads\` + \`not_imported\`) when resolving an async \`handle_id\` whose run completed in this MCP instance, AND on the \`importIds[]\` path once every named import is \`complete\` and it wasn't a dry run. A \`complete\` import with no \`result\` means the records weren't readable \u2014 render completion only. **Render only from the fields actually present; never invent counts.**
 
 Caveat on \`progress\`: \`records_processed\` counts only the rows that MATCHED an existing lead (backend \`imported_records\`), not every row that finished processing \u2014 so for a complete import whose rows are mostly/all \`uncrawled\` (pending crawl), \`records_processed\` is legitimately low or 0. Never read a low \`records_processed\` on a \`complete\` import as "stuck" or "failed": once \`status:"complete"\`, processing is done; the pending-crawl rows just matched no existing lead yet.
 
-- Running \u2192 \`"\u23F3 Import still running \u2014 phase <phase>; check back in ~M minutes."\` (use the phase; don't turn the matched-count into an "X/Y processed" progress bar).
-- Complete, **no \`result\`** (the usual \`importIds\` status check) \u2192 \`"\u2713 Import complete."\` Do NOT append a \`records_processed/records_total\` fraction (it undercounts pending-crawl rows and looks stuck) and do NOT report pending-crawl / need-attention bucket counts \u2014 the row-level \`not_imported\` breakdown isn't in this response.
+- Running \u2192 \`"\u23F3 Import still running \u2014 phase <phase>; check back in ~M minutes."\` (use the phase; don't turn the matched-count into an "X/Y processed" progress bar). \`phase:"committing"\` is normal for an import that timed out \u2014 say it's still being committed, never that it failed or finished empty.
+- Complete with **\`dry_run:true\`** on the response \u2192 a VALIDATION pass; nothing was committed. \`"\u{1F50E} Dry run complete \u2014 input validated, nothing imported. Re-run without dry_run to commit."\` Never render this as a completed import, and never quote a lead count.
+- Complete, **no \`result\`** \u2192 \`"\u2713 Import complete."\` Do NOT append a \`records_processed/records_total\` fraction (it undercounts pending-crawl rows and looks stuck) and do NOT report pending-crawl / need-attention bucket counts \u2014 the row-level \`not_imported\` breakdown isn't in this response.
+- Complete with \`result.still_settling > 0\` \u2192 say \`"\u2713 Import complete \u2014 N imported, S rows still being placed."\` Never count \`still_settling\` rows as failures.
 - Complete, **\`result\` present AND it was a dry run** (\`result.dry_run:true\`, or every \`result.not_imported\` row has \`reason:"dry_run"\`) \u2192 this resolved handle was a VALIDATION pass, nothing committed. Render \`"\u{1F50E} Dry run complete \u2014 V rows validated, nothing imported. Re-run without dry_run to commit."\` \u2014 do NOT render it as a real import completion or use the pending/attention buckets.
 - Complete, **\`result\` present** (async handle resolved, real import) \u2192 then, and only then, partition \`result.not_imported\` as in the shared import-result render block below \u2014 \`"\u2713 Import complete \u2014 N imported \xB7 P pending crawl \xB7 Q need attention"\` where **pending crawl** is \`uncrawled\` rows that HAVE a \`domain\` (not failures) and no-\`domain\` \`uncrawled\` rows fall under need-attention. Drop any zero segment.
 - Error / failed \u2192 \`"\u26A0 Import failed: <error>. See leadbay_resolve_import_rows for diagnosis."\` \u2014 reserve this ONLY for a true transport/backend error on the import itself, never for \`uncrawled\` rows.
@@ -7649,9 +7681,10 @@ How the OTHER reasons map to the "Need attention" bucket (see the render block a
 
 | Observation                          | Suggest                                              | Calls                          |
 |--------------------------------------|------------------------------------------------------|--------------------------------|
+| Status: complete, \`result.leads\` present | "Qualify the imported leads"                     | leadbay_bulk_qualify_leads(result.leads[].leadId) |
 | Status: complete                     | "See the imported (matched) leads"                   | leadbay_pull_leads             |
 | Pending-crawl (\`uncrawled\`) rows     | "Re-run the import for those domains later, once Leadbay has crawled them" | leadbay_import_leads (re-run with just the uncrawled domains, later \u2014 they re-reconcile once crawled). The added leads otherwise populate in the user's Leadbay account as the crawl completes; no live-fetch here |
-| Status: running                      | "Check again in N minutes"                           | leadbay_import_status \u2014 re-call|
+| Status: running (incl. \`committing\`) | "Check again in N minutes"                           | leadbay_import_status \u2014 re-call (pass \`dry_run:true\` if the ids came from a dry run) |
 | Status: error / failed (true error)  | "Diagnose the failure"                               | leadbay_resolve_import_rows    |
 `;
     leadbay_launch_bulk_enrichment = `Launch a bulk-enrichment job against the current selection. The backend requires \`email=true\` OR \`phone=true\` (both can be true). Returns 204 with no body \u2014 there is no bulk_id and no per-job status endpoint. Track results by polling individual leads via leadbay_get_contacts after ~60s; a contact is done for this run only when the REQUESTED channel landed (requested \`email\` and/or \`phone_number\` present), not \`contact.enrichment.done\` alone (that flag is already true for a contact enriched on the other channel earlier). \`dry_run:true\` returns the call shape without contacting the backend.
@@ -9183,35 +9216,38 @@ Trigger phrases: "look up <Company>", "research <Company>", "what do we know abo
 
 Do NOT use for: "picked row with leadId" \u2192 \`leadbay_research_lead_by_id\`; "draft outreach for <Contact>" \u2192 \`leadbay_prepare_outreach\`.
 
-Prefer when: company name in prose and no Leadbay id yet
+Prefer when: a 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."
 - "Find Initech in my pipeline."
+- "Who is Wink Lab? Their email is at @wink-lab.com."
 
 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."
 
 ---
 
-Resolves \`companyName\` across visible Discover, Monitor, and Activate leads,
-then delegates to **leadbay_research_lead_by_id**. Supplying \`lensId\`
-deliberately restricts the backend search to that lens. The result matches
-\`_by_id\`, plus:
+Resolves across the user's visible Discover/Monitor/Activate leads AND the
+**Leadbay company registry** \u2014 so a company they do not own yet is still
+findable \u2014 then delegates to **leadbay_research_lead_by_id**.
 
-- \`_meta.resolved_from\`: \`"companyName"\`
-- \`_meta.resolved_query\`: the original query
-- \`_meta.match_candidates[]\`: up to 4 \`{leadId, name, score}\` alternatives
+**Pass \`website\` whenever the user mentioned a domain** \u2014 the strongest match
+key. It survives a misspelled company name and is what turns "not in your
+list" into an answer. With only a contact email, pass \`email\`: the company
+domain is derived from it, consumer mailboxes ignored.
 
-\`LEAD_NOT_FOUND\` identifies whether the complete visible corpus, an explicit
-lens, or only a degraded active-lens fallback was searched.
+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\`.
 
-WHEN TO USE: for a company/domain/contact reference
-without a \`lead_id\`. Offer \`_meta.match_candidates\` when present.
+\`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.
 
-WHEN NOT TO USE: with a UUID; call
-leadbay_research_lead_by_id directly.
+Offer \`_meta.match_candidates\` when present.
 
 ---
 
@@ -9350,6 +9386,10 @@ out?"\`
 | User is done with this lead                            | "Back to the inbox"                                      | leadbay_pull_leads                                             |
 
 
+When \`resolution\` is \`"ambiguous"\`, render no card: use \`ask_user_input_v0\`,
+ONE \`single_select\` question ("Which one?"), one short label per candidate
+combining \`name\` and \`location\`.
+
 When \`_meta.match_candidates\` is non-empty, prepend one extra NEXT STEPS row:
 
 | Observation | Suggest | Calls |
@@ -9744,6 +9784,84 @@ WHEN TO USE: low-level.
 
 WHEN NOT TO USE: from agent flow \u2014 leadbay_report_outreach pairs this with a note + verification, which is what humans actually need to see in Leadbay.
 
+This tool MUTATES state. The caller (agent or human-in-the-loop) is responsible for confirming intent before invocation; the MCP server does not soft-prompt for confirmation. See \`annotations.destructiveHint\`.
+`;
+    leadbay_set_lead_status = `## WHEN TO USE
+
+Trigger phrases: "we won this deal", "mark this lead as won", "we lost them", "mark as lost", "this one is a target", "add them to my wanted list", "set the status on these leads", "closed the deal with", "they signed", "not a target anymore".
+
+**Memory:** recall + capture via \`leadbay_agent_memory_*\` tools.
+
+Do NOT use for: "I sent the email / left a voicemail \u2014 log the outcome" \u2192 \`leadbay_report_outreach\`; "thumbs up, I like this lead" \u2192 \`leadbay_like_lead\`; "remind me about this lead next week / snooze it" \u2192 \`leadbay_set_pushback\`.
+
+Prefer when: user states a COMMERCIAL outcome or pipeline stage, not an outreach event; pass \`lead_ids\` + the uppercase \`status\`, and \`status_date\` when they name a close date
+
+Examples that SHOULD invoke this tool:
+- "We just signed Acme Corp \u2014 mark them as won."
+- "Mark these three as lost, they went with a competitor."
+- "Add Northwind to my wanted list, they're a priority target."
+
+Examples that should NOT invoke this tool (sound similar, route elsewhere):
+- "I emailed the CTO this morning, log it."
+- "Thumbs up on this one, show me more like it."
+- "Snooze this lead until next quarter."
+
+## RENDER (quick)
+
+One short confirmation line per status applied ("\u2705 **Acme Corp** \u2192 WON
+(closed 2026-03-14)"). If \`failed\` is non-empty, list those leads with
+their error underneath. Don't re-render the full lead card.
+
+---
+
+Set the **org-wide CRM lead status** \u2014 the same field the Leadbay website's status
+selector writes, and the one a CSV import maps via \`mappings.statuses\`. It is shared
+across the whole organization: every rep sees the value this call sets.
+
+Two distinct status systems exist in Leadbay. Do not confuse them:
+
+| System | Values | Written by | Means |
+|---|---|---|---|
+| **Lead status** (this tool) | \`WANTED\` \`WON\` \`LOST\` \`UNWANTED\` (plus system-set \`DEFAULT\`, \`INBOUND\`) | this tool, CSV import | Commercial/pipeline outcome, org-wide |
+| **Epilogue status** | \`STILL_CHASING\` \`COULD_NOT_REACH_STILL_TRYING\` \`INTEREST_VALIDATED_OR_MEETING_PLANED\` \`NOT_INTERESTED_LOST\` | \`leadbay_report_outreach\`, \`leadbay_set_epilogue_status\` | Disposition of a specific outreach attempt; drives \`leadbay_pull_followups\` ranking |
+
+A deal outcome is a **lead status**. "She didn't pick up" is an **epilogue status**.
+Setting one never sets the other \u2014 when the user reports both in one breath ("called
+them, they signed"), make both calls.
+
+## Parameters
+
+- \`lead_ids\` (required) \u2014 1\u2013200 lead UUIDs. Every lead gets the same status.
+- \`status\` (required) \u2014 one of \`WANTED\`, \`WON\`, \`LOST\`, \`UNWANTED\`. Accepted
+  case-insensitively (\`won\` \u2192 \`WON\`); no synonyms are guessed, so "closed-won"
+  or "dead" are rejected rather than silently mapped. \`DEFAULT\` and \`INBOUND\`
+  are accepted but are normally set by Leadbay itself \u2014 don't offer them as
+  user choices.
+- \`status_date\` (optional) \u2014 \`YYYY-MM-DD\`, the date the status was actually
+  reached (a close date, the day the deal was lost). Omit it and the backend
+  stamps now. Pass it whenever the user names a date; a deal closed last month
+  stamped as today distorts every pipeline report.
+
+## Behaviour
+
+Each lead is written individually (\`POST /leads/{leadId}/set_status\`, then
+\`POST /leads/{leadId}/set_status_date\` when \`status_date\` is given), so a partial
+failure is possible. The return is
+\`{ applied, count, status, status_date?, failed: [{lead_id, message}] }\` \u2014
+**always check \`failed\`** and report those leads to the user rather than claiming
+a clean sweep. \`applied\` is \`false\` when every lead failed.
+
+Re-sending the same status is idempotent \u2014 no error, no duplicate entry.
+
+WHEN TO USE: the user states a commercial outcome or pipeline
+position for specific leads: "we won them", "that one's dead", "these are my targets
+this quarter". Also use it from an artifact's status dropdown.
+
+WHEN NOT TO USE: the user is reporting that an outreach
+*happened* (use \`leadbay_report_outreach\` \u2014 its \`epilogue_status\` covers the
+follow-up disposition), expressing taste rather than an outcome (\`leadbay_like_lead\`
+/ \`leadbay_dislike_lead\`), or temporarily deferring a lead (\`leadbay_set_pushback\`).
+
 This tool MUTATES state. The caller (agent or human-in-the-loop) is responsible for confirming intent before invocation; the MCP server does not soft-prompt for confirmation. See \`annotations.destructiveHint\`.
 `;
     leadbay_set_pushback = `Snooze (pushback) one or more leads for 3, 6, or 12 months. The leads remain in the user's pipeline but are excluded from \`leadbay_pull_followups\` until the pushback window expires. Use this when the user says "not now", "next quarter", "follow up in 3 months", "6 months out", "next year", or any equivalent deferral.
@@ -10535,6 +10653,52 @@ var init_get_contacts = __esm({
         required: ["leadId"],
         additionalProperties: false
       },
+      outputSchema: {
+        type: "object",
+        properties: {
+          contacts: {
+            type: "array",
+            description: "Merged org+paid contacts. Each: {id, first_name, last_name, email, phone_number, linkedin_page, job_title, recommended, enrichment, source:'org'|'paid'}.",
+            items: {
+              type: "object",
+              properties: {
+                id: { type: "string" },
+                first_name: { type: ["string", "null"] },
+                last_name: { type: ["string", "null"] },
+                email: { type: ["string", "null"] },
+                phone_number: { type: ["string", "null"] },
+                linkedin_page: { type: ["string", "null"] },
+                job_title: { type: ["string", "null"] },
+                recommended: { type: "boolean" },
+                source: { type: "string", enum: ["org", "paid"] },
+                enrichment: {
+                  type: ["object", "null"],
+                  description: "Per-contact reveal record. Missing or null = the contact was NEVER requested (enrichable \u2014 not the same as done:false). Read `done` and `credits_used` TOGETHER: done:false = reservation in flight, poll and do not re-launch; done:true with credits_used:0 = the reveal SETTLED and found nothing, which is TERMINAL \u2014 do not re-attempt it on a later run; done:true with credits_used>0 = resolved, but the revealed channel lands on the source:'org' twin of this person, not on the source:'paid' record itself, so a null email here is not a failure. credits_used:0 on its own is NOT a verdict (an in-flight reservation reports 0 too), and an ABSENT credits_used means the cost is unknown, not zero.",
+                  properties: {
+                    done: {
+                      type: "boolean",
+                      description: "False = reservation in flight. True = settled, either with a result (credits_used>0) or empty (credits_used:0). Per-contact, not per-channel."
+                    },
+                    credits_used: {
+                      type: "number",
+                      description: "Credits charged for this reveal. Only meaningful when done:true. An explicit 0 alongside done:true means the provider returned nothing. Optional \u2014 when absent the cost is unknown and terminal-empty must NOT be inferred."
+                    },
+                    email_requested: { type: "boolean" },
+                    phone_requested: { type: "boolean" }
+                  }
+                }
+              },
+              required: ["id", "source"]
+            }
+          },
+          _fetch_errors: {
+            type: "array",
+            description: "Present only when one of the two contact endpoints failed. Each: {endpoint:'org'|'paid', code?, retry_after?}. A rejected endpoint contributes no contacts, so an empty `contacts` alongside this field is a fetch failure, NOT 'no contacts'.",
+            items: { type: "object" }
+          }
+        },
+        required: ["contacts"]
+      },
       execute: async (client, params) => {
         const [orgResult, paidResult] = await Promise.allSettled([
           client.request("GET", `/leads/${params.leadId}/contacts?IncludeEnriched=true`),
@@ -12902,18 +13066,7 @@ var init_qualify_helpers = __esm({
   }
 });
 
-// ../core/dist/composite/import-leads.js
-import { createHash as createHash3, randomUUID as randomUUID2 } from "crypto";
-function isImportLeadsRunningResult(result) {
-  return "status" in result && result.status === "running";
-}
-function isCustomFieldMappingValue(v) {
-  return CUSTOM_FIELD_RE.test(v);
-}
-function customFieldIdOf(v) {
-  const m = CUSTOM_FIELD_RE.exec(v);
-  return m ? m[1] : null;
-}
+// ../core/dist/composite/_import-records.js
 function normalizeDomain(input) {
   if (!input || typeof input !== "string")
     return null;
@@ -12944,6 +13097,214 @@ function normalizeDomain(input) {
     return null;
   return v;
 }
+function ourRowId(raw) {
+  if (raw == null)
+    return void 0;
+  const v = raw.trim();
+  return MCP_ROW_ID_RE.test(v) ? v : void 0;
+}
+function cellNames(c) {
+  return [c?.column_name, c?.key, c?.field].filter((n) => n != null && n !== "").map((n) => String(n).toLowerCase());
+}
+function readCell(record, key) {
+  const want = key.toLowerCase();
+  const arr = record.records;
+  if (Array.isArray(arr)) {
+    for (const c of arr) {
+      if (cellNames(c).includes(want)) {
+        const v = c?.value ?? null;
+        return v != null ? String(v) : null;
+      }
+    }
+  }
+  const cells = record.cells;
+  if (cells && typeof cells === "object" && !Array.isArray(cells)) {
+    for (const [k, v] of Object.entries(cells)) {
+      if (k.toLowerCase() === want) {
+        return v != null ? String(v) : null;
+      }
+    }
+  }
+  if (Array.isArray(cells)) {
+    for (const c of cells) {
+      if (cellNames(c).includes(want)) {
+        const v = c?.value ?? null;
+        return v != null ? String(v) : null;
+      }
+    }
+  }
+  return null;
+}
+function recordMatchType(record) {
+  return (record.match_type ?? record.matchType ?? "").toString().toUpperCase();
+}
+function isRecordTerminal(record) {
+  const status = (record.status ?? "").toString().toUpperCase();
+  return recordMatchType(record) === "NO_MATCH" || status === "IMPORTED";
+}
+function settlingDeficit(declaredTotal, fetched) {
+  return Math.max(0, declaredTotal - fetched);
+}
+function reconcileRecords(records) {
+  const leads = [];
+  const not_imported = [];
+  const pendingLeadIds = /* @__PURE__ */ new Set();
+  let pending = 0;
+  let distinct = 0;
+  const seenRowIds = /* @__PURE__ */ new Set();
+  for (const rec of records) {
+    const rowId = ourRowId(readCell(rec, MCP_ROW_ID_COLUMN));
+    const dedupeKey = rowId !== void 0 ? `row:${rowId}` : rec.id != null ? `rec:${String(rec.id)}` : null;
+    if (dedupeKey !== null) {
+      if (seenRowIds.has(dedupeKey))
+        continue;
+      seenRowIds.add(dedupeKey);
+    }
+    distinct++;
+    const websiteCell = readCell(rec, "LEAD_WEBSITE");
+    const domain = normalizeDomain(websiteCell ?? "") ?? normalizeDomain(rec.lead?.website ?? "") ?? void 0;
+    if (!isRecordTerminal(rec)) {
+      pending++;
+      if (rec.lead?.id)
+        pendingLeadIds.add(rec.lead.id);
+      continue;
+    }
+    if (rec.lead?.id) {
+      leads.push({
+        ...rowId ? { rowId } : {},
+        ...domain ? { domain } : {},
+        leadId: rec.lead.id,
+        name: rec.lead.name ?? null
+      });
+      continue;
+    }
+    if (recordMatchType(rec) === "NO_MATCH") {
+      not_imported.push({
+        ...rowId ? { rowId } : {},
+        ...domain ? { domain } : {},
+        reason: domain && PUBLIC_MAILBOX_DOMAINS.has(domain) ? "no_match" : "uncrawled"
+      });
+      continue;
+    }
+    pending++;
+  }
+  return { leads, not_imported, pending, distinct, pendingLeadIds };
+}
+var PUBLIC_MAILBOX_DOMAINS, MCP_ROW_ID_COLUMN, MCP_ROW_ID_RE;
+var init_import_records = __esm({
+  "../core/dist/composite/_import-records.js"() {
+    "use strict";
+    PUBLIC_MAILBOX_DOMAINS = /* @__PURE__ */ new Set([
+      "gmail.com",
+      "googlemail.com",
+      "yahoo.com",
+      "ymail.com",
+      "outlook.com",
+      "hotmail.com",
+      "live.com",
+      "icloud.com",
+      "me.com",
+      "mac.com",
+      "aol.com",
+      "proton.me",
+      "protonmail.com",
+      "tutanota.com",
+      "gmx.com",
+      "gmx.net",
+      "gmx.de",
+      "mail.com",
+      "yandex.com",
+      "yandex.ru",
+      "qq.com",
+      "163.com",
+      "126.com",
+      // Regional aliases of the same providers, plus the consumer ISP mailboxes
+      // that dominate a French user base. Without these, `orange.fr` or
+      // `yahoo.fr` reads as a company domain (codex review, mcp#188).
+      "yahoo.fr",
+      "yahoo.co.uk",
+      "yahoo.es",
+      "yahoo.it",
+      "yahoo.de",
+      "yahoo.ca",
+      "yahoo.com.br",
+      "yahoo.co.jp",
+      "hotmail.fr",
+      "hotmail.co.uk",
+      "hotmail.es",
+      "hotmail.it",
+      "hotmail.de",
+      "hotmail.be",
+      "outlook.fr",
+      "outlook.es",
+      "outlook.de",
+      "outlook.it",
+      "live.fr",
+      "live.be",
+      "live.co.uk",
+      "msn.com",
+      "orange.fr",
+      "wanadoo.fr",
+      "free.fr",
+      "sfr.fr",
+      "laposte.net",
+      "bbox.fr",
+      "neuf.fr",
+      "aliceadsl.fr",
+      "numericable.fr",
+      "club-internet.fr",
+      "gmx.fr",
+      "gmx.at",
+      "gmx.ch",
+      "web.de",
+      "t-online.de",
+      "libero.it",
+      "wp.pl",
+      "seznam.cz"
+    ]);
+    MCP_ROW_ID_COLUMN = "MCP_ROW_ID";
+    MCP_ROW_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+  }
+});
+
+// ../core/dist/composite/_import-commit-log.js
+function recordCommitFailure(importId, reason) {
+  if (failures.size >= MAX_ENTRIES) {
+    const oldest = failures.keys().next().value;
+    if (oldest !== void 0)
+      failures.delete(oldest);
+  }
+  failures.set(importId, reason);
+}
+function commitFailureFor(importIds) {
+  for (const id of importIds) {
+    const reason = failures.get(id);
+    if (reason !== void 0)
+      return reason;
+  }
+  return void 0;
+}
+var MAX_ENTRIES, failures;
+var init_import_commit_log = __esm({
+  "../core/dist/composite/_import-commit-log.js"() {
+    "use strict";
+    MAX_ENTRIES = 500;
+    failures = /* @__PURE__ */ new Map();
+  }
+});
+
+// ../core/dist/composite/import-leads.js
+import { createHash as createHash3, randomUUID as randomUUID2 } from "crypto";
+function isImportLeadsRunningResult(result) {
+  return "status" in result && result.status === "running";
+}
+function isCustomFieldMappingValue(v) {
+  return CUSTOM_FIELD_RE.test(v);
+}
+function customFieldIdOf(v) {
+  const m = CUSTOM_FIELD_RE.exec(v);
+  return m ? m[1] : null;
+}
 function escapeCsvCell(raw) {
   if (raw == null)
     return "";
@@ -13023,37 +13384,6 @@ async function sleepWithAbort2(ms, signal) {
     signal.addEventListener("abort", onAbort, { once: true });
   });
 }
-function readCell(record, key) {
-  const want = key.toLowerCase();
-  const arr = record.records;
-  if (Array.isArray(arr)) {
-    for (const c of arr) {
-      const k = (c?.column_name ?? c?.key ?? c?.field ?? "").toString().toLowerCase();
-      if (k === want) {
-        const v = c?.value ?? null;
-        return v != null ? String(v) : null;
-      }
-    }
-  }
-  const cells = record.cells;
-  if (cells && typeof cells === "object" && !Array.isArray(cells)) {
-    for (const [k, v] of Object.entries(cells)) {
-      if (k.toLowerCase() === want) {
-        return v != null ? String(v) : null;
-      }
-    }
-  }
-  if (Array.isArray(cells)) {
-    for (const c of cells) {
-      const k = (c?.key ?? c?.field ?? c?.column_name ?? "").toString().toLowerCase();
-      if (k === want) {
-        const v = c?.value ?? null;
-        return v != null ? String(v) : null;
-      }
-    }
-  }
-  return null;
-}
 function validateColumnName(client, name, path) {
   if (typeof name !== "string" || name.length === 0) {
     throw client.makeError("IMPORT_INVALID_COLUMN_NAME", `Column name at ${path} must be a non-empty string`, `Use a plain string column name (1-${MAX_COLUMN_NAME_LEN} chars).`, "POST /imports");
@@ -13303,7 +13633,7 @@ async function pollUntil(fn, done, budgetMs, signal, ctx, label) {
 async function pollPreprocess(client, importId, budgetMs, ctx, signal) {
   const result = await pollUntil(() => client.request("GET", `/imports/${importId}`), (r) => Boolean(r.pre_processing?.finished), budgetMs, signal, ctx, "preprocess");
   if (!result.pre_processing?.finished) {
-    throw client.makeError("IMPORT_BUDGET_EXHAUSTED", `Preprocess phase did not finish within ${budgetMs}ms`, `Increase per_phase_budget_ms (current: ${budgetMs}) or split the batch. importId=${importId}.`, `GET /imports/${importId}`);
+    throw new ImportPhaseTimeout("preprocess", importId, budgetMs);
   }
   if (result.pre_processing.error) {
     throw client.makeError("IMPORT_PREPROCESS_FAILED", `Preprocess failed: ${result.pre_processing.error}`, `Check the input domains. importId=${importId} for backend debugging.`, `GET /imports/${importId}`);
@@ -13313,7 +13643,7 @@ async function pollPreprocess(client, importId, budgetMs, ctx, signal) {
 async function pollProcess(client, importId, budgetMs, ctx, signal) {
   const result = await pollUntil(() => client.request("GET", `/imports/${importId}`), (r) => Boolean(r.processing?.finished), budgetMs, signal, ctx, "process");
   if (!result.processing?.finished) {
-    throw client.makeError("IMPORT_BUDGET_EXHAUSTED", `Process phase did not finish within ${budgetMs}ms`, `Increase per_phase_budget_ms (current: ${budgetMs}) or split the batch. importId=${importId}.`, `GET /imports/${importId}`);
+    throw new ImportPhaseTimeout("process", importId, budgetMs);
   }
   if (result.processing.error != null) {
     throw client.makeError("IMPORT_PROCESSING_FAILED", `Backend processing failed: ${result.processing.error}`, `importId=${importId}.`, `GET /imports/${importId}`);
@@ -13340,10 +13670,7 @@ async function pollRecordsToTerminal(client, importId, budgetMs, expectedRowCoun
       records.push(...res.items);
       total = res.pagination.total ?? records.length;
       for (const r of res.items) {
-        const status = (r.status ?? "").toString().toUpperCase();
-        const matchType = (r.match_type ?? r.matchType ?? "").toString().toUpperCase();
-        const isTerminal = matchType === "NO_MATCH" || status === "IMPORTED";
-        if (!isTerminal)
+        if (!isRecordTerminal(r))
           transient++;
       }
       const totalPages = res.pagination.pages ?? 0;
@@ -13371,14 +13698,15 @@ async function pollRecordsToTerminal(client, importId, budgetMs, expectedRowCoun
     }
     if (Date.now() >= deadline) {
       ctx?.logger?.warn?.(`import-leads: records did not stabilize (transient=${transient}, total=${total}); returning best-effort`);
-      throw client.makeError("IMPORT_NOT_TERMINAL", `Backend hasn't fully settled records within ${budgetMs}ms`, `Retry leadbay_import_leads with the same input in 30s, or split the batch. importId=${importId}.`, `GET /imports/${importId}/records`);
+      throw new ImportPhaseTimeout("reconcile", importId, budgetMs);
     }
     await sleepWithAbort2(POLL_INTERVAL_MS2, signal);
   }
 }
-async function runOneChunk(client, chunk, chunkIdx, totalChunks, header, mappings, dryRun, perPhaseBudgetMs, totalDeadline, ctx, signal, onImportId) {
+async function runOneChunk(client, chunk, chunkIdx, totalChunks, header, mappings, dryRun, perPhaseBudgetMs, totalDeadline, ctx, signal, onImportId, onNotificationId, onUploaded) {
   const upload = await uploadOneChunk(client, chunk, chunkIdx, totalChunks, header, ctx, onImportId);
-  return completeUploadedChunk(client, upload, mappings, dryRun, perPhaseBudgetMs, totalDeadline, ctx, signal);
+  onUploaded?.(upload);
+  return completeUploadedChunk(client, upload, mappings, dryRun, perPhaseBudgetMs, totalDeadline, ctx, signal, onNotificationId);
 }
 async function uploadOneChunk(client, chunk, chunkIdx, totalChunks, header, ctx, onImportId) {
   const csv = synthesizeCsv(header, chunk.map((c) => c.row));
@@ -13390,27 +13718,30 @@ async function uploadOneChunk(client, chunk, chunkIdx, totalChunks, header, ctx,
   onImportId(importId);
   return { importId, chunk, chunkIdx, totalChunks };
 }
-async function completeUploadedChunk(client, upload, mappings, dryRun, perPhaseBudgetMs, totalDeadline, ctx, signal) {
-  const { importId, chunk } = upload;
-  const phaseBudget = Math.min(perPhaseBudgetMs, Math.max(1, totalDeadline - Date.now()));
-  await pollPreprocess(client, importId, phaseBudget, ctx, signal);
-  ctx?.logger?.info?.(`import-leads: preprocess done for importId=${importId}`);
-  if (dryRun) {
-    return { importId, records: [], notification_id: null };
-  }
-  let updateMappingsResp = null;
+async function commitMappings(client, importId, mappings, ctx) {
   try {
-    updateMappingsResp = await client.request("POST", `/imports/${importId}/update_mappings`, mappings);
+    const resp = await client.request("POST", `/imports/${importId}/update_mappings`, mappings);
+    return resp?.notification_id ?? null;
   } catch (err) {
     if (err?.code === "API_ERROR" || err?.code === "NOT_FOUND") {
       ctx?.logger?.warn?.(`import-leads: update_mappings raw error (${err?.code}); retrying void`);
       await client.requestVoid("POST", `/imports/${importId}/update_mappings`, mappings);
-    } else {
-      throw err;
+      return null;
     }
+    throw err;
   }
-  const importNotificationId = updateMappingsResp?.notification_id ?? null;
+}
+async function completeUploadedChunk(client, upload, mappings, dryRun, perPhaseBudgetMs, totalDeadline, ctx, signal, onNotificationId) {
+  const { importId, chunk } = upload;
+  const phaseBudget = Math.min(perPhaseBudgetMs, Math.max(1, totalDeadline - Date.now()));
+  await pollPreprocess(client, importId, phaseBudget, ctx, signal);
+  ctx?.logger?.info?.(`import-leads: preprocess done for importId=${importId}`);
+  if (dryRun) {
+    return { importId, records: [], notification_id: null };
+  }
+  const importNotificationId = await commitMappings(client, importId, mappings, ctx);
   if (importNotificationId) {
+    onNotificationId?.(importNotificationId);
     ctx?.logger?.info?.(`import-leads: notification_id=${importNotificationId} importId=${importId}`);
   }
   ctx?.logger?.info?.(`import-leads: mappings committed for importId=${importId}`);
@@ -13461,7 +13792,7 @@ function reconcileOneChunk(prep, chunk, matched, notImported) {
     }
     seenInputIndex.add(inputIdx);
     const inp = prep.validInputs[inputIdx];
-    const matchType = (rec.match_type ?? rec.matchType ?? "").toString();
+    const matchType = recordMatchType(rec);
     if (rec.lead?.id) {
       matched.set(inputIdx, {
         domain: inp.outputDomain,
@@ -13553,6 +13884,19 @@ function buildImportLeadsResult(client, prep, importIds, matched, notImported, d
     }
   };
 }
+function resumeParkedUpload(client, upload, mappings, ctx) {
+  const bgCtx = { logger: ctx?.logger };
+  const { importId } = upload;
+  setTimeout(() => {
+    void (async () => {
+      await pollPreprocess(client, importId, RESUME_COMMIT_BUDGET_MS, bgCtx, void 0);
+      await commitMappings(client, importId, mappings, bgCtx);
+    })().then(() => ctx?.logger?.info?.(`import-leads: parked upload ${importId} committed; backend is processing`), (err) => {
+      recordCommitFailure(importId, err?.message ?? err?.code ?? "mapping commit failed");
+      ctx?.logger?.warn?.(`import-leads: parked upload ${importId} could not be committed (${err?.code ?? err?.message ?? "unknown"})`);
+    });
+  }, 0);
+}
 async function runImportInBackground(client, prep, uploadedChunks, opts, ctx, handleId) {
   const tracker = ctx.bulkTracker;
   if (!tracker)
@@ -13593,11 +13937,13 @@ async function runImportInBackground(client, prep, uploadedChunks, opts, ctx, ha
     })();
   }, 0);
 }
-var CHUNK_SIZE, POLL_INTERVAL_MS2, DEFAULT_PER_PHASE_BUDGET_MS, DEFAULT_TOTAL_BUDGET_MS, STABILIZATION_POLLS, MAX_COLUMN_NAME_LEN, RESERVED_COLUMN_RE, CUSTOM_FIELD_RE, IMPORT_RESOLVER_FIELDS, PUBLIC_MAILBOX_DOMAINS, LEAD_STATUSES, LEAD_STATUS_SET, importLeads;
+var CHUNK_SIZE, POLL_INTERVAL_MS2, DEFAULT_PER_PHASE_BUDGET_MS, DEFAULT_TOTAL_BUDGET_MS, STABILIZATION_POLLS, MAX_COLUMN_NAME_LEN, RESERVED_COLUMN_RE, CUSTOM_FIELD_RE, IMPORT_RESOLVER_FIELDS, ImportPhaseTimeout, LEAD_STATUSES, LEAD_STATUS_SET, importLeads, RESUME_COMMIT_BUDGET_MS;
 var init_import_leads = __esm({
   "../core/dist/composite/import-leads.js"() {
     "use strict";
     init_tool_descriptions_generated();
+    init_import_records();
+    init_import_commit_log();
     CHUNK_SIZE = 100;
     POLL_INTERVAL_MS2 = 2e3;
     DEFAULT_PER_PHASE_BUDGET_MS = 6e4;
@@ -13613,31 +13959,19 @@ var init_import_leads = __esm({
       "LEAD_WEBSITE",
       "SIREN"
     ]);
-    PUBLIC_MAILBOX_DOMAINS = /* @__PURE__ */ new Set([
-      "gmail.com",
-      "googlemail.com",
-      "yahoo.com",
-      "ymail.com",
-      "outlook.com",
-      "hotmail.com",
-      "live.com",
-      "icloud.com",
-      "me.com",
-      "mac.com",
-      "aol.com",
-      "proton.me",
-      "protonmail.com",
-      "tutanota.com",
-      "gmx.com",
-      "gmx.net",
-      "gmx.de",
-      "mail.com",
-      "yandex.com",
-      "yandex.ru",
-      "qq.com",
-      "163.com",
-      "126.com"
-    ]);
+    ImportPhaseTimeout = class extends Error {
+      phase;
+      importId;
+      budgetMs;
+      code = "IMPORT_TIMEOUT";
+      constructor(phase, importId, budgetMs) {
+        super(`Import ${phase} phase did not finish within ${budgetMs}ms; the wizard is still running server-side. Poll leadbay_import_status with importIds=["${importId}"].`);
+        this.phase = phase;
+        this.importId = importId;
+        this.budgetMs = budgetMs;
+        this.name = "ImportPhaseTimeout";
+      }
+    };
     LEAD_STATUSES = [
       "DEFAULT",
       "INBOUND",
@@ -13750,7 +14084,20 @@ var init_import_leads = __esm({
           },
           handle_id: {
             type: "string",
-            description: "Persisted UUID handle to pass to leadbay_import_status."
+            description: "Persisted UUID handle to pass to leadbay_import_status. Only on the wait_for_completion=false path; absent when a blocking call timed out (use importIds then)."
+          },
+          timed_out: {
+            type: "boolean",
+            description: "True when a blocking call ran out of poll budget. The import is still running server-side \u2014 poll leadbay_import_status(importIds). Do NOT re-issue the import."
+          },
+          rows_pending_upload: {
+            type: "number",
+            description: "Rows from later chunks that were never uploaded before the budget ran out. These are NOT running anywhere; re-import just those rows."
+          },
+          row_ids: {
+            type: "array",
+            description: "Records mode only: the synthetic MCP_ROW_ID of each input row, in the order you passed `records[]`. leadbay_import_status reports recovered leads by that id \u2014 use this to map them back to your source rows.",
+            items: { type: "string" }
           },
           progress: {
             type: "object",
@@ -13780,7 +14127,7 @@ var init_import_leads = __esm({
         required: ["importIds", "region", "_meta"],
         anyOf: [
           { required: ["leads", "not_imported", "importIds", "region", "_meta"] },
-          { required: ["status", "handle_id", "importIds", "progress", "region", "_meta"] }
+          { required: ["status", "importIds", "progress", "region", "_meta"] }
         ]
       },
       execute: async (client, params, ctx) => {
@@ -13907,23 +14254,33 @@ var init_import_leads = __esm({
         const matched = /* @__PURE__ */ new Map();
         const notImported = /* @__PURE__ */ new Map();
         let cancelled = false;
+        let timedOut = null;
+        let rowsStarted = 0;
+        const lastUpload = { current: null };
         const recordImportId = (id) => {
           if (!importIds.includes(id))
             importIds.push(id);
         };
+        const recordNotificationId = (id) => {
+          if (!notificationIds.includes(id))
+            notificationIds.push(id);
+        };
         try {
           for (let i = 0; i < chunks.length; i++) {
             const chunk = chunks[i];
-            const out = await runOneChunk(client, chunk, i, chunks.length, prep.header, prep.mappings, dryRun, perPhaseBudget, totalDeadline, ctx, signal, recordImportId);
-            if (out.notification_id && !notificationIds.includes(out.notification_id)) {
-              notificationIds.push(out.notification_id);
-            }
+            rowsStarted += chunk.length;
+            const out = await runOneChunk(client, chunk, i, chunks.length, prep.header, prep.mappings, dryRun, perPhaseBudget, totalDeadline, ctx, signal, recordImportId, recordNotificationId, (u) => {
+              lastUpload.current = u;
+            });
             if (!dryRun) {
               reconcileOneChunk(prep, out, matched, notImported);
             }
           }
         } catch (err) {
-          if (err?.name === "AbortError") {
+          if (err instanceof ImportPhaseTimeout) {
+            timedOut = err;
+            ctx?.logger?.warn?.(`import-leads: ${err.phase} budget exhausted after ${err.budgetMs}ms; returning status=running importIds=${importIds.join(",")}`);
+          } else if (err?.name === "AbortError") {
             cancelled = true;
             ctx?.logger?.info?.(`import-leads: aborted via signal; importIds=${importIds.join(",")}`);
           } else if (err?.error === true) {
@@ -13938,9 +14295,41 @@ var init_import_leads = __esm({
             throw err;
           }
         }
+        if (timedOut) {
+          if (timedOut.phase === "preprocess" && // A dry run is SUPPOSED to stop after preprocess — committing its
+          // mappings would turn a validation pass into a real import.
+          !dryRun && lastUpload.current && lastUpload.current.importId === timedOut.importId) {
+            resumeParkedUpload(client, lastUpload.current, prep.mappings, ctx);
+          }
+          const rowsPendingUpload = prep.validInputs.length - rowsStarted;
+          const malformed = prep.malformedDomains.map((d) => ({ domain: d, reason: "malformed" }));
+          return {
+            status: "running",
+            timed_out: true,
+            importIds,
+            notification_ids: notificationIds,
+            ...malformed.length > 0 ? { not_imported: malformed } : {},
+            ...dryRun ? { dry_run: true } : {},
+            ...prep.mode === "records" ? { row_ids: prep.validInputs.map((i) => i.rowId) } : {},
+            progress: {
+              phase: timedOut.phase,
+              records_processed: matched.size,
+              records_total: prep.validInputs.length
+            },
+            ...rowsPendingUpload > 0 ? { rows_pending_upload: rowsPendingUpload } : {},
+            region: client.region,
+            _meta: client.lastMeta ?? {
+              region: client.region,
+              endpoint: `GET /imports/${timedOut.importId}`,
+              latency_ms: null,
+              retry_after: null
+            }
+          };
+        }
         return buildImportLeadsResult(client, prep, importIds, matched, notImported, dryRun, cancelled, notificationIds);
       }
     };
+    RESUME_COMMIT_BUDGET_MS = 10 * 6e4;
   }
 });
 
@@ -15958,6 +16347,133 @@ var init_dislike_lead = __esm({
   }
 });
 
+// ../core/dist/tools/set-lead-status.js
+function messageOf(e) {
+  if (e && typeof e === "object" && "message" in e)
+    return String(e.message);
+  return String(e);
+}
+async function writeAll(client, leadIds, status, statusDate) {
+  const failed = [];
+  let cursor = 0;
+  async function worker() {
+    for (; ; ) {
+      const i = cursor++;
+      if (i >= leadIds.length)
+        return;
+      const id = leadIds[i];
+      try {
+        await client.requestVoid("POST", statusPath(id), statusBody(status));
+        if (statusDate) {
+          await client.requestVoid("POST", statusDatePath(id), statusDateBody(statusDate));
+        }
+      } catch (e) {
+        failed.push({ lead_id: id, message: messageOf(e) });
+      }
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(CONCURRENCY, leadIds.length) }, () => worker()));
+  return failed;
+}
+var statusPath, statusDatePath, statusBody, statusDateBody, MAX_LEADS, CONCURRENCY, LEAD_STATUS_SET2, SETTABLE_LEAD_STATUSES, ISO_DATE, setLeadStatus;
+var init_set_lead_status = __esm({
+  "../core/dist/tools/set-lead-status.js"() {
+    "use strict";
+    init_tool_descriptions_generated();
+    init_import_leads();
+    statusPath = (leadId) => `/leads/${encodeURIComponent(leadId)}/set_status`;
+    statusDatePath = (leadId) => `/leads/${encodeURIComponent(leadId)}/set_status_date`;
+    statusBody = (status) => ({ status });
+    statusDateBody = (date) => ({ date: `${date}T00:00:00Z` });
+    MAX_LEADS = 200;
+    CONCURRENCY = 6;
+    LEAD_STATUS_SET2 = new Set(LEAD_STATUSES);
+    SETTABLE_LEAD_STATUSES = ["WANTED", "WON", "LOST", "UNWANTED"];
+    ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+    setLeadStatus = {
+      name: "leadbay_set_lead_status",
+      annotations: {
+        title: "Set lead CRM status",
+        readOnlyHint: false,
+        // Org-wide and overwrites whatever the last rep set — destructive in the
+        // MCP sense (not reversible from the value we replaced).
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: true
+      },
+      description: leadbay_set_lead_status,
+      optional: true,
+      write: true,
+      inputSchema: {
+        type: "object",
+        properties: {
+          lead_ids: {
+            type: "array",
+            items: { type: "string" },
+            description: `Lead UUIDs (1-${MAX_LEADS}). Every lead gets the same status.`
+          },
+          status: {
+            type: "string",
+            description: "One of: WANTED, WON, LOST, UNWANTED (case-insensitive). DEFAULT and INBOUND are accepted but are normally set by Leadbay itself."
+          },
+          status_date: {
+            type: "string",
+            description: "Optional YYYY-MM-DD \u2014 the date the status was actually reached (close date). Omit to let the backend stamp now."
+          }
+        },
+        required: ["lead_ids", "status"],
+        additionalProperties: false
+      },
+      execute: async (client, params) => {
+        const leadIds = (params.lead_ids ?? []).filter((id) => typeof id === "string" && id.trim() !== "");
+        if (leadIds.length === 0) {
+          return {
+            error: true,
+            code: "BAD_INPUT",
+            message: "lead_ids is empty",
+            hint: "Pass at least one lead UUID."
+          };
+        }
+        if (leadIds.length > MAX_LEADS) {
+          return {
+            error: true,
+            code: "BAD_INPUT",
+            message: `lead_ids has ${leadIds.length} entries, max is ${MAX_LEADS}`,
+            hint: `Call leadbay_set_lead_status again per chunk of ${MAX_LEADS} lead_ids or fewer.`
+          };
+        }
+        const status = String(params.status ?? "").trim().toUpperCase();
+        if (!LEAD_STATUS_SET2.has(status)) {
+          return {
+            error: true,
+            code: "BAD_INPUT",
+            message: `Unknown lead status: ${JSON.stringify(params.status)}`,
+            hint: `Use one of ${SETTABLE_LEAD_STATUSES.join(", ")} (case-insensitive).`
+          };
+        }
+        const statusDate = params.status_date?.trim() || void 0;
+        if (statusDate && !ISO_DATE.test(statusDate)) {
+          return {
+            error: true,
+            code: "BAD_INPUT",
+            message: `status_date ${JSON.stringify(params.status_date)} is not YYYY-MM-DD`,
+            hint: "Pass a calendar date like 2026-03-14, or omit it to stamp now."
+          };
+        }
+        const failed = await writeAll(client, leadIds, status, statusDate);
+        const count = leadIds.length - failed.length;
+        return {
+          applied: count > 0,
+          count,
+          status,
+          ...statusDate ? { status_date: statusDate } : {},
+          failed
+        };
+      }
+    };
+  }
+});
+
 // ../core/dist/tools/set-telemetry.js
 function isEnabled(telemetry_enabled) {
   return telemetry_enabled !== false;
@@ -16493,6 +17009,51 @@ var init_prepare_outreach = __esm({
   }
 });
 
+// ../core/dist/lead-order.js
+function resolveLeadOrder(raw, tool) {
+  const order = raw?.trim().toUpperCase();
+  if (!order)
+    return {};
+  if (!LEAD_ORDER_SET.has(order)) {
+    return {
+      error: {
+        error: true,
+        code: "BAD_INPUT",
+        message: `Unknown order: ${JSON.stringify(raw)}`,
+        hint: `Call ${tool} again with one of: ${LEAD_ORDERS.join(", ")}.`
+      }
+    };
+  }
+  return { order };
+}
+var LEAD_ORDERS, LEAD_ORDER_SET;
+var init_lead_order = __esm({
+  "../core/dist/lead-order.js"() {
+    "use strict";
+    LEAD_ORDERS = [
+      "SCORE:DESC",
+      "SCORE:ASC",
+      "NAME:ASC",
+      "NAME:DESC",
+      "SIZE:DESC",
+      "SIZE:ASC",
+      "SECTOR:ASC",
+      "SECTOR:DESC",
+      "STATUS:ASC",
+      "STATUS:DESC",
+      "CONTACT_COUNT:DESC",
+      "CONTACT_COUNT:ASC",
+      "LAST_PROSPECTING_ACTION_AT:DESC",
+      "LAST_PROSPECTING_ACTION_AT:ASC",
+      "EPILOGUE_STATUS_SET_AT:DESC",
+      "EPILOGUE_STATUS_SET_AT:ASC",
+      "LIKED:DESC",
+      "DISLIKED:DESC"
+    ];
+    LEAD_ORDER_SET = new Set(LEAD_ORDERS);
+  }
+});
+
 // ../core/dist/composite/_empty-lens-reason.js
 function criteriaOf(filter) {
   return filter?.lens_filter?.items?.flatMap((i) => i.criteria ?? []) ?? [];
@@ -16678,6 +17239,7 @@ var init_pull_leads = __esm({
   "../core/dist/composite/pull-leads.js"() {
     "use strict";
     init_agent_memory();
+    init_lead_order();
     init_empty_lens_reason();
     init_tool_descriptions_generated();
     pullLeads = {
@@ -16699,6 +17261,10 @@ var init_pull_leads = __esm({
           },
           count: { type: "number", description: "Leads per page, max 50 (default 20)" },
           page: { type: "number", description: "Page number, 0-indexed (default 0)" },
+          order: {
+            type: "string",
+            description: "Optional sort, FIELD:ASC|DESC (SCORE, NAME, SIZE, SECTOR, STATUS, CONTACT_COUNT, LAST_PROSPECTING_ACTION_AT, LIKED). Omit for the lens's own Discover ranking. An unknown value is rejected and the error lists every accepted order."
+          },
           verbose: {
             type: "boolean",
             description: "If true, include the full set of lead-summary fields. Default false: returns the trimmed agent-friendly form."
@@ -16807,7 +17373,11 @@ var init_pull_leads = __esm({
         const page = params.page ?? 0;
         const count = Math.min(params.count ?? 20, 50);
         const verbose = params.verbose ?? false;
-        const res = await client.request("GET", `/lenses/${lensId}/leads/wishlist?count=${count}&page=${page}&contacts=true`);
+        const resolvedOrder = resolveLeadOrder(params.order, "leadbay_pull_leads");
+        if (resolvedOrder.error)
+          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}`);
         const summaries = await Promise.all(res.items.map(async (lead) => {
           try {
             const r = await client.request("GET", `/leads/${lead.id}/ai_agent_responses`);
@@ -17060,6 +17630,7 @@ var init_pull_followups = __esm({
   "../core/dist/composite/pull-followups.js"() {
     "use strict";
     init_agent_memory();
+    init_lead_order();
     init_tool_descriptions_generated();
     init_geo_helpers();
     init_country_guard();
@@ -17092,6 +17663,10 @@ var init_pull_followups = __esm({
             type: "number",
             description: "Leads per page, max 200 (default 20)."
           },
+          order: {
+            type: "string",
+            description: "Optional sort, FIELD:ASC|DESC (SCORE, NAME, SIZE, SECTOR, STATUS, CONTACT_COUNT, LAST_PROSPECTING_ACTION_AT, LIKED). Omit for the Monitor's own ranking. An unknown value is rejected and the error lists every accepted order."
+          },
           page: {
             type: "number",
             description: "Page number, 0-indexed (default 0)."
@@ -17201,7 +17776,7 @@ var init_pull_followups = __esm({
         if (params.city_id)
           geoTexts.push(params.city_id);
         if (geoTexts.length > 0) {
-          const { resolved, ambiguities } = await resolveLocations(client, geoTexts);
+          const { resolved: resolved2, ambiguities } = await resolveLocations(client, geoTexts);
           if (ambiguities.length > 0) {
             return withAgentMemoryMeta(client, {
               status: "ambiguous_locations",
@@ -17216,8 +17791,8 @@ var init_pull_followups = __esm({
               }
             }, ctx);
           }
-          if (resolved.length > 0) {
-            effectiveSetFilter = mergeLocationIds(effectiveSetFilter, resolved);
+          if (resolved2.length > 0) {
+            effectiveSetFilter = mergeLocationIds(effectiveSetFilter, resolved2);
           }
         }
         if (effectiveSetFilter) {
@@ -17227,12 +17802,17 @@ var init_pull_followups = __esm({
             ctx?.logger?.warn?.(`pull_followups: POST /monitor/filter failed: ${err?.message ?? err?.code ?? err}`);
           }
         }
+        const resolved = resolveLeadOrder(params.order, "leadbay_pull_followups");
+        if (resolved.error)
+          return resolved.error;
+        const order = resolved.order;
         const qs = new URLSearchParams({
           personal: String(personal),
           liked: String(liked),
           filtered: String(filtered),
           count: String(count),
-          page: String(page)
+          page: String(page),
+          ...order ? { order } : {}
         }).toString();
         const [filterR, monitorR] = await Promise.allSettled([
           filtered ? client.request("GET", "/monitor/filter") : Promise.resolve(null),
@@ -18511,7 +19091,7 @@ var init_research_lead_by_id = __esm({
           },
           _meta: {
             type: "object",
-            description: "Operator context: region (us/fr/custom), lens_id (the lens used for the lead-by-id fetch), web_fetch_in_progress (true if the backend is still hydrating signals), has_reachable_contact (true if at least one contact or recommended_contact has email or phone \u2014 drives NEXT STEPS routing between enrichment vs outreach). When the call was routed via leadbay_research_lead_by_name_fuzzy, also: resolved_from='companyName', resolved_query='<needle>', match_candidates=[{leadId,name,score}].",
+            description: "Operator context: region (us/fr/custom), lens_id (the lens used for the lead-by-id fetch), web_fetch_in_progress (true if the backend is still hydrating signals), has_reachable_contact (true if at least one contact or recommended_contact has email or phone \u2014 drives NEXT STEPS routing between enrichment vs outreach). When the call was routed via leadbay_research_lead_by_name_fuzzy, also: resolved_from='companyName' (matched in the user's own leads) or 'resolver' (matched in the Leadbay company registry), resolved_query='<needle>', resolved_matched_on=['website_exact',\u2026] on the resolver path, match_candidates=[{leadId,name,score}].",
             properties: {
               region: { type: "string" },
               lens_id: { type: "number" },
@@ -18523,6 +19103,10 @@ var init_research_lead_by_id = __esm({
                 type: ["array", "null"],
                 items: { type: "object" }
               },
+              resolved_matched_on: {
+                type: ["array", "null"],
+                items: { type: "string" }
+              },
               agent_memory: { type: "object" }
             },
             // _meta is an open envelope: the MCP server layer injects
@@ -18695,7 +19279,8 @@ var init_research_lead_by_id = __esm({
             has_reachable_contact: hasReachableContact,
             resolved_from: params._resolved?.from ?? null,
             resolved_query: params._resolved?.query ?? null,
-            match_candidates: params._resolved?.candidates ?? null
+            match_candidates: params._resolved?.candidates ?? null,
+            resolved_matched_on: params._resolved?.matched_on ?? null
           }
         }, _ctx);
       }
@@ -18719,16 +19304,6 @@ var init_research_lead_by_id = __esm({
 });
 
 // ../core/dist/composite/research-lead-by-name-fuzzy.js
-function rankSubstringMatches(needle, candidates) {
-  const n = needle.toLowerCase();
-  const hits = candidates.filter((c) => typeof c.name === "string" && c.name.toLowerCase().includes(n));
-  hits.sort((a, b) => {
-    const aScore = a.score ?? -Infinity;
-    const bScore = b.score ?? -Infinity;
-    return bScore - aScore;
-  });
-  return hits;
-}
 function parseLensId(value) {
   const parsed = typeof value === "number" ? value : typeof value === "string" && value.trim() !== "" ? Number(value) : Number.NaN;
   return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : void 0;
@@ -18743,6 +19318,34 @@ function suggestionLeadId(suggestion) {
 function isLeadbayError(error) {
   return typeof error === "object" && error !== null && error.error === true && typeof error.code === "string" && typeof error.message === "string" && typeof error.hint === "string";
 }
+function businessDomainFromEmail(email) {
+  if (!email || typeof email !== "string")
+    return null;
+  const at = email.lastIndexOf("@");
+  if (at === -1)
+    return null;
+  const domain = normalizeDomain(email.slice(at + 1));
+  if (!domain)
+    return null;
+  return PUBLIC_MAILBOX_DOMAINS.has(domain) ? null : domain;
+}
+function buildResolvePayload(params) {
+  const queryDomain = normalizeDomain(params.query);
+  const website = (params.website ? normalizeDomain(params.website) : null) ?? queryDomain ?? businessDomainFromEmail(params.email);
+  const payload = {};
+  if (!queryDomain)
+    payload.name = params.query;
+  if (website)
+    payload.website = website;
+  if (params.email)
+    payload.email = params.email;
+  if (params.registry_number)
+    payload.registry_number = params.registry_number;
+  return payload;
+}
+function hasStrongIdentityKey(payload) {
+  return Boolean(payload.website || payload.registry_number);
+}
 async function resolveWithinLens(client, query, lensId) {
   const results = await client.request("GET", `/lenses/${lensId}/leads/wishlist?q=${encodeURIComponent(query)}&count=50&page=0&contacts=false`);
   return results.items.map((lead) => ({
@@ -18764,12 +19367,33 @@ async function resolveAcrossVisibleCorpus(client, query) {
     };
   }).filter((suggestion) => suggestion.id !== "" && suggestion.name !== "");
 }
-var researchLeadByNameFuzzy;
+async function hydrateAmbiguous(client, candidates, lensId) {
+  const selected = candidates.slice(0, MAX_AMBIGUOUS_CANDIDATES);
+  const settled = await Promise.allSettled(selected.map((c) => client.request("GET", `/lenses/${lensId}/leads/${c.lead_id}`)));
+  return selected.map((c, i) => {
+    const r = settled[i];
+    const lead = r.status === "fulfilled" ? r.value : null;
+    return {
+      leadId: c.lead_id,
+      name: lead?.name ?? null,
+      website: lead?.website ?? null,
+      location: lead?.location?.full ?? lead?.location?.city ?? lead?.location?.country ?? null,
+      registry_ids: lead?.registry_ids ?? null,
+      score: c.score,
+      matched_on: c.matched_on,
+      lead_fields_populated: c.lead_fields_populated
+    };
+  });
+}
+var RESOLVE_TIMEOUT_MS, MAX_AMBIGUOUS_CANDIDATES, researchLeadByNameFuzzy;
 var init_research_lead_by_name_fuzzy = __esm({
   "../core/dist/composite/research-lead-by-name-fuzzy.js"() {
     "use strict";
     init_research_lead_by_id();
+    init_import_leads();
     init_tool_descriptions_generated();
+    RESOLVE_TIMEOUT_MS = 1e4;
+    MAX_AMBIGUOUS_CANDIDATES = 4;
     researchLeadByNameFuzzy = {
       name: "leadbay_research_lead_by_name_fuzzy",
       annotations: {
@@ -18785,11 +19409,23 @@ var init_research_lead_by_name_fuzzy = __esm({
         properties: {
           companyName: {
             type: "string",
-            description: "Company name, domain, or contact name to resolve across visible Leadbay leads in Discover, Monitor, and Activate."
+            description: "Company name, domain, or contact name. Resolved against the user's own Discover/Monitor/Activate leads and the Leadbay company registry."
+          },
+          website: {
+            type: "string",
+            description: "Company domain or website when you have one (`acme.com`, `https://www.acme.com/` \u2014 both fine). This is the single strongest match key; pass it whenever the user mentioned a domain, and a company outside their leads becomes findable."
+          },
+          email: {
+            type: "string",
+            description: "A contact email at the company. Used to derive the company domain when `website` is absent; consumer mailboxes (gmail, orange.fr, \u2026) are ignored."
+          },
+          registry_number: {
+            type: "string",
+            description: "Company registry number (SIREN/SIRET in France, company number elsewhere). The other exact match key \u2014 pass it when the user supplies one, or when a previous LEAD_NOT_FOUND hint asked for it."
           },
           lensId: {
             type: "number",
-            description: "Optional strict scope. When supplied, search only this lens's wishlist; normally omit to search all visible Leadbay leads."
+            description: "Optional strict scope. When supplied, search only this lens's wishlist and do NOT fall through to the registry; normally omit."
           },
           concise: {
             type: "boolean",
@@ -18805,59 +19441,123 @@ var init_research_lead_by_name_fuzzy = __esm({
         additionalProperties: false
       },
       // Output shape matches leadbay_research_lead_by_id; the only additions are
-      // _meta.resolved_from / resolved_query / match_candidates which are
-      // documented on _by_id's output schema. Defer to _by_id for the schema —
-      // duplicating it would just rot.
+      // _meta.resolved_from / resolved_query / resolved_matched_on /
+      // match_candidates which are documented on _by_id's output schema. Defer to
+      // _by_id for the schema — duplicating it would just rot. The one exception
+      // is the ambiguous branch, which returns a disambiguation payload instead
+      // of a research card.
       outputSchema: {
         type: "object",
-        description: "Same shape as leadbay_research_lead_by_id, with _meta.resolved_from='companyName', _meta.resolved_query='<needle>', and _meta.match_candidates=[{leadId,name,score}] populated.",
+        description: "Same shape as leadbay_research_lead_by_id, with _meta.resolved_from='companyName'|'resolver', _meta.resolved_query='<needle>', _meta.resolved_matched_on=[...], and _meta.match_candidates=[{leadId,name,score}] populated. When the registry resolver cannot pick one company, returns {resolution:'ambiguous', query, candidates:[{leadId,name,website,location,registry_ids,score,matched_on}]} instead \u2014 ask the user which one, then call leadbay_research_lead_by_id.",
         additionalProperties: true
       },
       execute: async (client, params, ctx) => {
         if (!params.companyName || typeof params.companyName !== "string" || params.companyName.trim() === "") {
-          throw client.makeError("INVALID_PARAMS", "companyName is required", "Pass the company name as a string. If you already have the lead UUID, call leadbay_research_lead_by_id directly.");
+          throw client.makeError("INVALID_PARAMS", "companyName is required and must be a non-empty string", "Pass the company name, domain, or contact name as `companyName` \u2014 e.g. companyName:'Wink Lab'. Add `website` (the strongest match key) or `email` when you have one. If you already have the lead UUID, call leadbay_research_lead_by_id with leadId instead.");
         }
         const query = params.companyName.trim();
-        let ranked;
         let lensId = params.lensId;
-        let usedActiveLensFallback = false;
-        if (lensId !== void 0) {
-          ranked = await resolveWithinLens(client, query, lensId);
-        } else {
+        if (params.lensId !== void 0) {
+          const scoped = await resolveWithinLens(client, query, params.lensId);
+          if (scoped.length > 0) {
+            return await delegate(scoped, params.lensId);
+          }
+          throw client.makeError("LEAD_NOT_FOUND", `No lead matching "${query}" in lens ${params.lensId}`, "This lookup was intentionally restricted to the supplied lens. Omit lensId to search your visible leads across Discover, Monitor, and Activate and then the Leadbay company registry.");
+        }
+        async function delegate(matches, fallbackLens) {
+          const [primary, ...rest] = matches;
+          const resolvedLens = primary.lensId ?? fallbackLens ?? await client.resolveDefaultLens();
+          return await researchLeadById.execute(client, {
+            leadId: primary.id,
+            lensId: resolvedLens,
+            concise: params.concise,
+            response_format: params.response_format,
+            _resolved: {
+              from: "companyName",
+              query,
+              candidates: rest.slice(0, MAX_AMBIGUOUS_CANDIDATES).map((m) => ({
+                leadId: m.id,
+                name: m.name,
+                score: m.score
+              }))
+            }
+          }, ctx);
+        }
+        const payload = buildResolvePayload({
+          query,
+          website: params.website,
+          email: params.email,
+          registry_number: params.registry_number
+        });
+        let corpusSearched = false;
+        let ranked = [];
+        const searchCorpus = async (strict) => {
           try {
             ranked = await resolveAcrossVisibleCorpus(client, query);
+            corpusSearched = true;
           } catch (error) {
-            if (isLeadbayError(error))
+            if (strict && isLeadbayError(error))
               throw error;
-            lensId = await client.resolveDefaultLens();
-            usedActiveLensFallback = true;
-            ctx?.logger?.warn?.("Cross-tab company search was unavailable; falling back to the active lens for this lookup.");
-            ranked = rankSubstringMatches(query, await resolveWithinLens(client, query, lensId));
-          }
-        }
-        if (ranked.length === 0) {
-          const scope = usedActiveLensFallback ? `in active lens ${lensId}; cross-tab search was unavailable` : params.lensId === void 0 ? "across your visible Leadbay leads" : `in lens ${params.lensId}`;
-          const hint = usedActiveLensFallback ? `Only active lens ${lensId} was checked because cross-tab search was unavailable. Retry later before concluding the company is missing or offering to import it.` : params.lensId === void 0 ? "Search checks company names, domains, and contact names across Discover, Monitor, and Activate. Confirm the spelling or domain, or add/import the company first." : "This lookup was intentionally restricted to the supplied lens. Omit lensId to search visible leads across Discover, Monitor, and Activate.";
-          throw client.makeError("LEAD_NOT_FOUND", `No lead matching "${query}" ${scope}`, hint);
-        }
-        const [primary, ...rest] = ranked;
-        lensId = primary.lensId ?? lensId ?? await client.resolveDefaultLens();
-        const candidates = rest.slice(0, 4).map((m) => ({
-          leadId: m.id,
-          name: m.name,
-          score: m.score
-        }));
-        return await researchLeadById.execute(client, {
-          leadId: primary.id,
-          lensId,
-          concise: params.concise,
-          response_format: params.response_format,
-          _resolved: {
-            from: "companyName",
-            query,
-            candidates
+            ctx?.logger?.warn?.("Cross-tab company search was unavailable; resolving against the Leadbay registry instead.");
           }
-        }, ctx);
+        };
+        const registryFirst = hasStrongIdentityKey(payload);
+        if (!registryFirst) {
+          await searchCorpus(true);
+          if (ranked.length > 0)
+            return await delegate(ranked);
+        }
+        let resolved;
+        try {
+          resolved = await client.request("POST", "/leads/resolve", payload, { timeoutMs: RESOLVE_TIMEOUT_MS });
+        } catch (error) {
+          if (isLeadbayError(error))
+            throw error;
+          throw client.makeError("LEAD_NOT_FOUND", `Could not reach the Leadbay company registry while looking up "${query}"`, "The registry lookup did not complete. Retry once; if it fails again, say so rather than concluding the company is missing.", "POST /leads/resolve");
+        }
+        if (resolved.type === "matched") {
+          lensId = lensId ?? await client.resolveDefaultLens();
+          return await researchLeadById.execute(client, {
+            leadId: resolved.lead_id,
+            lensId,
+            concise: params.concise,
+            response_format: params.response_format,
+            _resolved: {
+              from: "resolver",
+              query,
+              candidates: [],
+              matched_on: resolved.matched_on
+            }
+          }, ctx);
+        }
+        if (resolved.type === "ambiguous" && resolved.candidates.length > 0) {
+          const hydrationLens = lensId ?? await client.resolveDefaultLens();
+          const candidates = await hydrateAmbiguous(client, resolved.candidates, hydrationLens);
+          return {
+            resolution: "ambiguous",
+            query,
+            resolver_payload: payload,
+            candidates,
+            next_step: "Ask the user which company they mean, then call leadbay_research_lead_by_id with the chosen leadId. Do not guess from score \u2014 it is a tied evidence band, not a confidence.",
+            _meta: {
+              region: client.region,
+              lens_id: hydrationLens,
+              resolved_from: "resolver",
+              resolved_query: query
+            }
+          };
+        }
+        if (!corpusSearched) {
+          await searchCorpus(false);
+          if (ranked.length > 0)
+            return await delegate(ranked);
+        }
+        const registryScope = payload.website ? `the Leadbay company registry (domain ${payload.website})` : "the Leadbay company registry";
+        const searched = corpusSearched ? `in your visible Leadbay leads and in ${registryScope}` : `in ${registryScope} \u2014 your own leads could NOT be searched, the search route was unreachable`;
+        const wanted = resolved.type === "none" && resolved.would_help.length > 0 ? resolved.would_help : ["website", "registry_number"];
+        const asks = wanted.map((f) => f === "registry_number" ? "a registry number (SIREN/SIRET) for `registry_number`" : f === "website" ? "the company website for `website`" : `\`${f}\``).join(" or ");
+        const hint = resolved.type === "unidentifiable" ? `The registry could not identify a company from this input (${resolved.reason}). Ask the user for ${asks}, then call this tool again with it.` : `The registry found no company for what was supplied. It would match on ${asks}. Ask the user for that \u2014 "what's their website?" usually settles it \u2014 then call this tool again. Do not offer an import before asking.`;
+        throw client.makeError("LEAD_NOT_FOUND", `No company matching "${query}" ${searched}`, hint, "POST /leads/resolve");
       }
     };
   }
@@ -20937,7 +21637,7 @@ async function runPreview(client, params, ctx, perPhaseBudget, _totalBudget) {
     throw Object.assign(new Error("aborted"), { name: "AbortError" });
   }
   if (!fileImport) {
-    throw client.makeError("IMPORT_BUDGET_EXHAUSTED", `Preview preprocess did not finish within ${perPhaseBudget}ms`, "Increase per_phase_budget_ms or shrink the input. The wizard row will eventually be cleaned up.", `GET /imports/${importId}`);
+    throw client.makeError("IMPORT_TIMEOUT", `Preview preprocess did not finish within ${perPhaseBudget}ms`, `Raise per_phase_budget_ms above ${perPhaseBudget} or send fewer rows \u2014 re-running the identical call will not help. The wizard row will eventually be cleaned up.`, `GET /imports/${importId}`);
   }
   if (fileImport.pre_processing?.error) {
     throw client.makeError("IMPORT_PREPROCESS_FAILED", `Preview preprocess failed: ${fileImport.pre_processing.error}`, "Inspect the input rows for encoding / shape issues.", `GET /imports/${importId}`);
@@ -21104,6 +21804,19 @@ var init_import_and_qualify = __esm({
             type: "string",
             description: "Import handle to pass to leadbay_import_status when wait_for_completion=false."
           },
+          timed_out: {
+            type: "boolean",
+            description: "True when the underlying import ran out of poll budget. Still running server-side \u2014 poll leadbay_import_status(import_ids). Do NOT re-issue the import."
+          },
+          rows_pending_upload: {
+            type: "number",
+            description: "Rows from later chunks that never reached the backend. These are NOT running anywhere; re-import just those rows."
+          },
+          row_ids: {
+            type: "array",
+            description: "Records mode only: the synthetic row id of each input row, in the order you passed `records[]`. leadbay_import_status reports recovered leads by that id \u2014 use this to map them back to your source rows.",
+            items: { type: "string" }
+          },
           // preview-shape keys
           mapping_hints: {
             type: "array",
@@ -21247,7 +21960,7 @@ var init_import_and_qualify = __esm({
           return {
             kind: "result",
             status: "running",
-            handle_id: queued.handle_id,
+            ...queued.handle_id ? { handle_id: queued.handle_id } : {},
             ...chosenBudgets ? { chosen_budgets: chosenBudgets } : {},
             qualify_id: null,
             import_ids: queued.importIds,
@@ -21279,7 +21992,35 @@ var init_import_and_qualify = __esm({
           wait_for_completion: true
         }, ctx);
         if (isImportLeadsRunningResult(importResultRaw)) {
-          throw client.makeError("IMPORT_ASYNC_UNEXPECTED", "Import returned an async handle while import_and_qualify was waiting for completion", "Retry with wait_for_completion=false and poll leadbay_import_status, or retry the blocking call.", "POST /imports");
+          return {
+            kind: "result",
+            status: "running",
+            ...importResultRaw.handle_id ? { handle_id: importResultRaw.handle_id } : {},
+            // Everything the rendering contract keys off has to survive the
+            // wrapper. Without `timed_out` the agent can't tell this from a
+            // deliberate async launch; without `rows_pending_upload` a >100-row
+            // batch silently loses every unuploaded chunk; without `dry_run`
+            // leadbay_import_status can't tell a validation pass from a real
+            // import still committing.
+            ...importResultRaw.timed_out ? { timed_out: true } : {},
+            ...importResultRaw.rows_pending_upload !== void 0 ? { rows_pending_upload: importResultRaw.rows_pending_upload } : {},
+            ...importResultRaw.dry_run ? { dry_run: true } : {},
+            ...importResultRaw.row_ids ? { row_ids: importResultRaw.row_ids } : {},
+            ...chosenBudgets ? { chosen_budgets: chosenBudgets } : {},
+            qualify_id: null,
+            import_ids: importResultRaw.importIds,
+            notification_ids: importResultRaw.notification_ids ?? [],
+            imported: [],
+            not_imported: (importResultRaw.not_imported ?? []).map(toNotImportedEntry),
+            qualified: [],
+            still_running: [],
+            failed: [],
+            quota_exceeded: false,
+            skipped_already_qualified: [],
+            not_in_lens: [],
+            region: client.region,
+            _meta: importResultRaw._meta
+          };
         }
         const importResult = importResultRaw;
         if (importResult.cancelled) {
@@ -22140,12 +22881,80 @@ function summarizeImports(imports, dryRun) {
     records_total: recordsTotal
   };
 }
-var importStatus;
+function isInProgress(err) {
+  return /in_progress/i.test(String(err?.message ?? ""));
+}
+async function fetchReconciledRecords(client, importIds, declaredTotal, ctx) {
+  const canonicalLeadIds = /* @__PURE__ */ new Set();
+  for (const importId of importIds) {
+    try {
+      const res = await client.request("GET", `/imports/${importId}/leads`);
+      for (const id of res?.lead_ids ?? [])
+        canonicalLeadIds.add(id);
+    } catch (err) {
+      if (isInProgress(err))
+        throw new ImportNotReady();
+      if (err?.code !== "NOT_FOUND" && err?._meta?.http_status !== 404)
+        throw err;
+      ctx?.logger?.warn?.(`import-status: /imports/${importId}/leads not available on this backend (404) \u2014 using records only`);
+    }
+  }
+  const all = [];
+  for (const importId of importIds) {
+    for (let page = 0; page < RECORDS_MAX_PAGES; page++) {
+      const qs = `count=${RECORDS_PAGE_SIZE}&page=${page}&automatic_match=true&manual_match=true&no_match=true&matching=true&importing=true&imported=true`;
+      let res;
+      try {
+        res = await client.request("GET", `/imports/${importId}/records?${qs}`);
+      } catch (err) {
+        if (isInProgress(err))
+          throw new ImportNotReady();
+        throw err;
+      }
+      all.push(...res.items);
+      const totalPages = res.pagination.pages ?? 0;
+      if (page + 1 >= totalPages)
+        break;
+      if (page + 1 === RECORDS_MAX_PAGES) {
+        ctx?.logger?.warn?.(`import-status: importId=${importId} has >${RECORDS_MAX_PAGES} record pages; skipping reconciliation`);
+        return null;
+      }
+    }
+  }
+  const { leads, not_imported, pending, distinct, pendingLeadIds } = reconcileRecords(all);
+  const deficit = settlingDeficit(declaredTotal, distinct);
+  const seenLeadIds = new Set(leads.map((l) => l.leadId));
+  const merged = [...leads];
+  if (deficit === 0) {
+    for (const id of canonicalLeadIds) {
+      if (seenLeadIds.has(id))
+        continue;
+      if (pendingLeadIds.has(id))
+        continue;
+      merged.push({ leadId: id, name: null });
+    }
+  }
+  return {
+    leads: merged,
+    not_imported,
+    // A snapshot short of the declared row count is not final — see
+    // `settlingDeficit`. Measured on DISTINCT rows: `all.length` counts a
+    // re-paged row twice and would mask a genuine shortfall.
+    still_settling: pending + deficit
+  };
+}
+var RECORDS_PAGE_SIZE, RECORDS_MAX_PAGES, ImportNotReady, importStatus;
 var init_import_status = __esm({
   "../core/dist/composite/import-status.js"() {
     "use strict";
     init_bulk_store();
+    init_import_records();
+    init_import_commit_log();
     init_tool_descriptions_generated();
+    RECORDS_PAGE_SIZE = 100;
+    RECORDS_MAX_PAGES = 20;
+    ImportNotReady = class extends Error {
+    };
     importStatus = {
       name: "leadbay_import_status",
       annotations: {
@@ -22165,8 +22974,12 @@ var init_import_status = __esm({
           },
           importIds: {
             type: "array",
-            description: "Legacy backend file-import ids to inspect directly.",
+            description: "Backend file-import ids to inspect directly \u2014 from a completed import's `importIds`, or from a `{status:'running', timed_out:true}` result.",
             items: { type: "string" }
+          },
+          dry_run: {
+            type: "boolean",
+            description: "Pass true when the importIds came from a dry run. A dry run and an import still committing its mappings look identical on the wire, so without this the tool reports the dry run as still running rather than risk rendering it as a real import."
           }
         },
         additionalProperties: false
@@ -22180,9 +22993,13 @@ var init_import_status = __esm({
           progress: { type: "object" },
           result: {
             type: "object",
-            description: "Final import result when the handle has completed in this MCP instance."
+            description: "Final import result: {leads, not_imported, importIds, still_settling?}. Present when a handle_id resolves a completed run in this MCP instance, OR when the importIds[] path finds every import complete and reconciles the wizard's records."
           },
           error: { type: "string" },
+          dry_run: {
+            type: "boolean",
+            description: "True when these importIds came from a dry run. NOTHING was committed to the CRM \u2014 render it as a validation pass, never as a completed import."
+          },
           region: { type: "string" },
           _meta: { type: "object" }
         },
@@ -22191,7 +23008,7 @@ var init_import_status = __esm({
       execute: async (client, params, ctx) => {
         let handleId = params.handle_id;
         let importIds = params.importIds ?? [];
-        let handleDryRun;
+        let handleDryRun = params.dry_run;
         if (handleId) {
           if (!isValidBulkId(handleId)) {
             throw client.makeError("BULK_INVALID_ID", "handle_id is not a valid UUIDv4", "Pass the handle_id returned by leadbay_import_leads verbatim.", "");
@@ -22208,7 +23025,7 @@ var init_import_status = __esm({
             throw client.makeError("BULK_NOT_FOUND", "No import record for that handle_id", "It may have expired (30-day TTL) or the MCP process was restarted without persistence.", "");
           }
           importIds = record.import_ids;
-          handleDryRun = record.dry_run;
+          handleDryRun = record.dry_run ?? handleDryRun;
           if (record.status === "complete" && record.result) {
             return {
               status: "complete",
@@ -22269,6 +23086,7 @@ var init_import_status = __esm({
             };
           }
         }
+        importIds = [...new Set(importIds)];
         if (importIds.length === 0) {
           throw client.makeError("IMPORT_STATUS_INPUT_REQUIRED", "Pass either handle_id or importIds[]", "Call leadbay_import_leads with wait_for_completion=false first, then pass its handle_id.", "");
         }
@@ -22284,14 +23102,40 @@ var init_import_status = __esm({
             return Boolean(i.processing?.finished);
           return Boolean(i.processing?.finished || i.pre_processing?.finished && !i.processing);
         });
+        let reconciled = null;
+        const commitError = commitFailureFor(importIds);
+        let notReady = false;
+        const declaredTotal = imports.reduce((n, i) => n + Number(i.total_records ?? 0), 0);
+        if (!failed && complete && handleDryRun !== true && importIds.length > 0) {
+          try {
+            reconciled = await fetchReconciledRecords(client, importIds, declaredTotal, ctx);
+          } catch (err) {
+            if (err instanceof ImportNotReady) {
+              notReady = true;
+              ctx?.logger?.info?.(`import-status: wizard reports in_progress; mappings not committed yet \u2014 reporting running`);
+            } else {
+              ctx?.logger?.warn?.(`import-status: records reconciliation failed (${err?.code ?? err?.message ?? "unknown"}); returning status only`);
+            }
+          }
+        }
+        const settled = complete && !notReady;
         return {
-          status: failed ? "failed" : complete ? "complete" : "running",
+          status: failed || commitError ? "failed" : settled ? "complete" : "running",
           ...handleId ? { handle_id: handleId } : {},
           importIds,
-          progress,
+          ...handleDryRun === true ? { dry_run: true } : {},
+          progress: notReady ? { ...progress, phase: "committing" } : progress,
+          ...reconciled ? {
+            result: {
+              leads: reconciled.leads,
+              not_imported: reconciled.not_imported,
+              importIds,
+              ...reconciled.still_settling > 0 ? { still_settling: reconciled.still_settling } : {}
+            }
+          } : {},
           ...failed ? {
             error: failed.pre_processing?.error ?? failed.processing?.error ?? "import failed"
-          } : {},
+          } : commitError ? { error: `Import mappings were rejected: ${commitError}` } : {},
           region: client.region,
           _meta: client.lastMeta ?? {
             region: client.region,
@@ -25564,9 +26408,9 @@ var ARTIFACT_KIT_VERSION, ARTIFACT_RUNTIME, ARTIFACT_USAGE_GUIDE;
 var init_artifact_runtime_generated = __esm({
   "../core/dist/artifact-runtime.generated.js"() {
     "use strict";
-    ARTIFACT_KIT_VERSION = "0.3.1";
-    ARTIFACT_RUNTIME = '"use strict";(()=>{var _=Object.defineProperty;var k=(e,t,n)=>t in e?_(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n;var o=(e,t,n)=>k(e,typeof t!="symbol"?t+"":t,n);var T="0.3.1",d=class extends Error{constructor(n,i={}){super(n);o(this,"code");o(this,"raw");this.name="LbError",this.code=i.code,this.raw=i.raw}},v=null,f=3e4;function L(){let e=globalThis.cowork;return e&&typeof e.callMcpTool=="function"?(t,n)=>e.callMcpTool(t,n):null}function p(e){if(e&&typeof e=="object"&&"content"in e){let t=e.content;if(Array.isArray(t)&&t[0]&&typeof t[0].text=="string")return t[0].text}return null}function y(e){if(!e||typeof e!="object")return e;let t=e;if(t.isError)throw new d(p(e)??"tool call failed",{raw:e});if("structuredContent"in t&&t.structuredContent!=null)return t.structuredContent;let n=p(e);if(n!=null)try{return JSON.parse(n)}catch{return n}return e}function E(e){return e instanceof Error?e.message:String(e)}function m(e){let t=e instanceof d?e.code:void 0;return{message:E(e),unavailable:t==="unavailable",code:t}}function S(e={}){v=e.call??null,f=e.timeoutMs??3e4}async function w(e,t){if(!f||f<=0)return e;let n,i=new Promise((r,a)=>{n=setTimeout(()=>a(new d(`"${t}" timed out after ${f}ms`,{code:"timeout"})),f)});try{return await Promise.race([e,i])}finally{n&&clearTimeout(n)}}async function s(e,t={}){if(v)return y(await w(Promise.resolve(v(e,t)),e));let n=L();if(!n)throw new d("Leadbay bridge unavailable (window.cowork absent)",{code:"unavailable"});return y(await w(Promise.resolve(n(e,t)),e))}var c=class{constructor(){o(this,"subs",new Set)}subscribe(t){return this.subs.add(t),t(this),()=>this.subs.delete(t)}emit(){for(let t of this.subs)t(this)}};function A(e){return Array.isArray(e)?e.map(t=>t&&typeof t=="object"?t:{value:t,label:String(t)}):[]}var h=class extends c{constructor(n={}){super();o(this,"kind");o(this,"value");o(this,"options",[]);o(this,"loading",!1);o(this,"error",null);o(this,"ready",!1);o(this,"cfg");o(this,"depUnsubs",[]);o(this,"seq",0);this.cfg=n,this.kind=n.kind,this.value=n.value??"";for(let i of n.dependsOn??[]){let r=i.value;this.depUnsubs.push(i.subscribe(()=>{i.value!==r&&(r=i.value,this.cfg.load&&this.load())}))}n.load&&(n.autoLoad??!0)&&this.load()}async load(){if(!this.cfg.load)return;let n=++this.seq;this.loading=!0,this.error=null,this.emit();try{let i=await this.cfg.load();if(n!==this.seq)return;this.options=this.cfg.options?this.cfg.options(i):A(i),this.ready=!0;let r=this.value==null?"":String(this.value);this.options.length&&(r===""||!this.options.some(a=>String(a.value)===r))&&(this.value=this.options[0].value)}catch(i){if(n!==this.seq)return;this.options=[],this.error=m(i)}finally{n===this.seq&&(this.loading=!1,this.emit())}}setValue(n){this.value=n;let i=this.validate();this.error=i?{message:i,unavailable:!1}:null,this.emit()}validate(){return this.cfg.validate?this.cfg.validate(this.value):null}get valid(){return this.validate()==null}reset(){this.value=this.cfg.value??"",this.error=null,this.emit()}dispose(){for(let n of this.depUnsubs)n();this.depUnsubs=[]}},l=class extends c{constructor(n){super();o(this,"loading",!1);o(this,"error",null);o(this,"lastResult",null);o(this,"cfg");this.cfg=n}async run(){if(this.loading)return;for(let i of this.cfg.fields??[]){let r=i.validate();if(r!=null){this.error={message:r,unavailable:!1},this.emit();return}}if(this.cfg.confirm&&typeof globalThis.confirm=="function"&&!globalThis.confirm(this.cfg.confirm))return;this.loading=!0,this.error=null,this.emit();let n;try{let i=typeof this.cfg.args=="function"?this.cfg.args():this.cfg.args??{};n=await s(this.cfg.tool,i)}catch(i){this.error=m(i),this.loading=!1,this.emit(),this.cfg.onError?.(this.error);return}return this.lastResult=n,this.loading=!1,this.emit(),this.cfg.onSuccess?.(n),n}reset(){this.error=null,this.lastResult=null,this.emit()}},u=class extends c{constructor(n){super();o(this,"data",null);o(this,"loading",!1);o(this,"refreshing",!1);o(this,"error",null);o(this,"done",!1);o(this,"cfg");o(this,"timer",null);o(this,"seq",0);this.cfg=n,(n.autoLoad??!0)&&this.load()}async load(){this.clearTimer();let n=++this.seq;this.data==null?this.loading=!0:this.refreshing=!0,this.error=null,this.emit();try{let r=await this.cfg.load();if(n!==this.seq)return;this.data=r,this.done=this.cfg.until?this.cfg.until(r):!0,this.cfg.pollEvery&&!this.done&&(this.timer=setTimeout(()=>void this.load(),this.cfg.pollEvery))}catch(r){if(n!==this.seq)return;this.error=m(r)}finally{n===this.seq&&(this.loading=!1,this.refreshing=!1,this.emit())}}refresh(){return this.load()}stop(){this.clearTimer()}clearTimer(){this.timer&&(clearTimeout(this.timer),this.timer=null)}},b=class extends c{constructor(n){super();o(this,"items",[]);o(this,"page",0);o(this,"pageSize");o(this,"total",0);o(this,"loading",!1);o(this,"error",null);o(this,"cfg");o(this,"seq",0);this.cfg=n,this.pageSize=n.pageSize??20,(n.autoLoad??!0)&&this.loadPage(0)}async loadPage(n){let i=++this.seq;this.loading=!0,this.error=null,this.emit();try{let r=await this.cfg.load({page:n,pageSize:this.pageSize});if(i!==this.seq)return;this.items=r.items??[],this.total=r.total??this.items.length,this.page=n}catch(r){if(i!==this.seq)return;this.error=m(r)}finally{i===this.seq&&(this.loading=!1,this.emit())}}next(){return this.loadPage(this.page+1)}prev(){return this.loadPage(Math.max(0,this.page-1))}get hasMore(){return(this.page+1)*this.pageSize<this.total}};function x(e,t){let n=t.error?.unavailable?"unavailable":t.loading?"loading":t.error?"error":"ready";e.setAttribute("data-lb-state",n),t.error?e.setAttribute("data-lb-error",t.error.message):e.removeAttribute("data-lb-error")}function C(e,t){let n=()=>t.setValue(e.value);e.addEventListener("change",n);let i=t.subscribe(()=>{x(e,t),e.disabled=t.loading,e.innerHTML="";for(let r of t.options){let a=document.createElement("option");a.value=String(r.value),a.textContent=r.label,e.appendChild(a)}e.value=t.value==null?"":String(t.value)});return()=>{e.removeEventListener("change",n),i()}}function R(e,t){let n=e.type==="checkbox",i=e.tagName==="SELECT"?"change":"input",r=()=>t.setValue(n?e.checked:e.value);e.addEventListener(i,r);let a=t.subscribe(()=>{if(n)e.checked=!!t.value;else{let g=t.value==null?"":String(t.value);e.value!==g&&(e.value=g)}e.setAttribute("data-lb-state",t.error?"error":"ready"),t.error?e.setAttribute("data-lb-error",t.error.message):e.removeAttribute("data-lb-error")});return()=>{e.removeEventListener(i,r),a()}}function I(e,t){let n=r=>{r.preventDefault(),t.run()};e.addEventListener("click",n);let i=t.subscribe(()=>{let r=t.error?.unavailable?"unavailable":t.loading?"loading":t.error?"error":t.lastResult!=null?"success":"idle";e.setAttribute("data-lb-state",r),"disabled"in e&&(e.disabled=t.loading),t.error?e.setAttribute("data-lb-error",t.error.message):e.removeAttribute("data-lb-error")});return()=>{e.removeEventListener("click",n),i()}}var O=["STILL_CHASING","COULD_NOT_REACH_STILL_TRYING","INTEREST_VALIDATED_OR_MEETING_PLANED","NOT_INTERESTED_LOST"];function P(e){return new h({kind:"select",load:()=>s("leadbay_list_campaigns",{_triggered_by:e}),options:t=>(t?.campaigns??[]).map(i=>{let r=i?.campaign??i;return r?.id?{value:r.id,label:r.name??r.ai_generated_name??String(r.id)}:null}).filter(i=>i!=null)})}function M(e){return new l({tool:"leadbay_report_outreach",fields:e.note?[e.note]:[],args:()=>({lead_id:e.leadId,...e.status?{epilogue_status:e.status.value}:{},note:e.note?e.note.value:"",verification:{source:"user_confirmed",ref:e.ref??"logged from artifact"},_triggered_by:e.ask})})}function F(e){return new l({tool:"leadbay_add_note",fields:[e.note],args:()=>({leadId:e.leadId,note:e.note.value})})}function q(e){return new l({tool:"leadbay_like_lead",args:{lead_id:e}})}function H(e){return new l({tool:"leadbay_dislike_lead",args:{lead_id:e}})}function z(e,t){return new u({autoLoad:!1,load:()=>s("leadbay_account_history",{leadId:e,_triggered_by:t})})}function N(e,t){return new u({autoLoad:!1,load:()=>s("leadbay_research_lead_by_id",{leadId:e,_triggered_by:t})})}function U(e){let t=null;return new u({...e.autoLoad!==void 0?{autoLoad:e.autoLoad}:{},pollEvery:e.pollEvery??4e3,until:n=>!!n?.all_done,load:async()=>{if(!t){let n=await s("leadbay_enrich_titles",{...e.leadIds?{leadIds:e.leadIds}:{},titles:e.titles,...e.email!==void 0?{email:e.email}:{},...e.phone!==void 0?{phone:e.phone}:{},...e.confirm!==void 0?{confirm:e.confirm}:{},_triggered_by:e.ask});if(t=n?.bulk_id??null,!t)return{...n,all_done:!0,no_job:!0}}return s("leadbay_bulk_enrich_status",{bulk_id:t,_triggered_by:e.ask})}})}function D(e){let t=e.source??"followups";return new b({pageSize:e.pageSize??20,load:async({page:n,pageSize:i})=>{let a=t==="campaign"?await s("leadbay_campaign_call_sheet",{campaign_id:e.campaignId,page:n,count:i,_triggered_by:e.ask}):await s("leadbay_pull_followups",{page:n,count:i,...e.city?{city:e.city}:{},_triggered_by:e.ask}),g=a.leads??a.items??[];return{items:g,total:a.total_leads??a.pagination?.total??g.length}}})}function V(e){return new u({load:()=>s("leadbay_team_activity",{weeks:e.weeks??4,_triggered_by:e.ask})})}var j={VERSION:T,configure:S,call:s,field:e=>new h(e),action:e=>new l(e),resource:e=>new u(e),list:e=>new b(e),bindSelect:C,bindValue:R,bindAction:I,campaigns:P,outreach:M,note:F,like:q,dislike:H,leadHistory:z,leadProfile:N,enrichment:U,callList:D,teamActivity:V,EPILOGUE_STATUSES:O};typeof globalThis<"u"&&(globalThis.LeadbayArtifacts=j);})();';
-    ARTIFACT_USAGE_GUIDE = '# Leadbay Artifact Kit \u2014 headless domain components\n\nYou are building a single-file HTML **artifact** the user runs inside cowork. This\nkit gives you **headless view-models** that own a control\'s whole data lifecycle \u2014\nload/populate from a Leadbay call, hold value/state, poll, validate, and\nencapsulate the API call + business rules. **You own 100% of markup/layout/style.**\nThe library renders nothing. Inline the runtime once as a `<script>`; it exposes\none global `window.LeadbayArtifacts` (call it `lb`). Vanilla, no React, no build.\n\nPass every tool you use as the artifact\'s `mcp_tools` so the host permits it.\n\n## Two layers\n\n**Primitives** (generic):\n- `lb.field({ load, options, value, validate, dependsOn })` \u2014 a value + optionally\n  API-populated options. `.value/.setValue/.options/.loading/.error/.valid/.subscribe`.\n- `lb.action({ tool, args, fields, confirm, onSuccess, onError })` \u2014 a write/submit.\n  `.run()/.loading/.error/.lastResult/.subscribe`.\n- `lb.resource({ load, pollEvery?, until?, autoLoad? })` \u2014 one read that may change:\n  load-on-click or poll-until-`until`. `.data/.loading/.refreshing/.error/.done/.load()/.refresh()/.stop()/.subscribe`.\n- `lb.list({ load, pageSize })` \u2014 paginated rows. `.items/.page/.total/.loading/.loadPage(n)/.next()/.prev()/.hasMore/.subscribe`.\n\n`.error` is `{ message, unavailable } | null`. `subscribe(cb)` fires immediately\nthen on every change \u2014 render your own DOM from it.\n\n**Domain components** (pre-wired \u2014 bake in the tool name, arg shape, and footguns):\n\n| Call | Returns | For |\n|---|---|---|\n| `lb.campaigns(ask)` | field | a campaign `<select>`, options from `leadbay_list_campaigns` |\n| `lb.outreach({leadId, ask, status?, note?})` | action | log a call \u2192 `report_outreach` (verification + `_triggered_by` baked in) |\n| `lb.note({leadId, note})` | action | add a note \u2192 `add_note` |\n| `lb.like(leadId)` / `lb.dislike(leadId)` | action | taste signal |\n| `lb.leadHistory(leadId, ask)` | resource (lazy) | notes + activities + engagement \u2192 `account_history` |\n| `lb.leadProfile(leadId, ask)` | resource (lazy) | full lead profile \u2192 `research_lead_by_id` |\n| `lb.callList({source:\'followups\'\\|\'campaign\', campaignId?, city?, ask})` | list | a cold-call list (Monitor or a campaign) |\n| `lb.enrichment({leadIds, titles, ask, pollEvery?})` | resource (polling) | launch + watch contact enrichment |\n| `lb.teamActivity({weeks, ask})` | resource | manager leaderboard + activity trend \u2192 `leadbay_team_activity` |\n\n`lb.EPILOGUE_STATUSES` = the 4 disposition values\n(`STILL_CHASING`, `COULD_NOT_REACH_STILL_TRYING`, `INTEREST_VALIDATED_OR_MEETING_PLANED`, `NOT_INTERESTED_LOST`).\n\n**Binding sugar** (optional; binds a view-model to YOUR native element, no style):\n`lb.bindSelect(selectEl, field)` (populates options + value), `lb.bindValue(inputEl, field)`,\n`lb.bindAction(buttonEl, action)`. They set `data-lb-state`\n(`ready|loading|error|success|unavailable`) + `data-lb-error` on your element as\nstyling hooks. For lists/resources, use `.subscribe()` and render yourself.\n\n`ask` is the user\'s request this artifact serves \u2014 it becomes `_triggered_by`.\n\n## Recipe: cold-call sheet (one row per lead)\n\n```js\nconst lb = window.LeadbayArtifacts; lb.configure();\nconst ASK = "<the user\'s request>";\n\nconst list = lb.callList({ source: "campaign", campaignId: CID, ask: ASK });\nlist.subscribe((l) => renderRows(l.items, l.loading));   // your render\n\n// per lead row (call when you build a row):\nfunction wireRow(lead, els) {\n  const status = lb.field({ value: "STILL_CHASING" });   // static-enum <select>\n  const note   = lb.field({ validate: (v) => (v && v.trim() ? null : "Add a note") });\n  lb.bindValue(els.status, status);\n  lb.bindValue(els.note, note);\n  lb.bindAction(els.log,  lb.outreach({ leadId: lead.id, ask: ASK, status, note }));\n  lb.bindAction(els.like, lb.like(lead.id));\n\n  const history = lb.leadHistory(lead.id, ASK);          // lazy\n  history.subscribe((h) => renderHistory(els.history, h));\n  els.expand.onclick = () => history.load();             // load on click\n}\n```\n\n## Recipe: manager dashboard\n\n```js\nconst team = lb.teamActivity({ weeks: 4, ask: ASK });\nteam.subscribe((t) => {\n  if (t.loading) showSpinner();\n  if (t.data) {\n    renderLeaderboard(t.data.reps);   // sorted by total_activities; cols: name, notes, meetings_or_interest, lost\u2026\n    renderTrendChart(t.data.trend);   // [{date,count}] \u2192 Chart.js (allowed from CDN)\n  }\n});\nrefreshBtn.onclick = () => team.refresh();\n```\n\n## Recipe: live enrichment\n\n```js\nconst job = lb.enrichment({ leadIds: [LEAD], titles: ["CEO", "VP Sales"], ask: ASK });\njob.subscribe((j) => {\n  const p = j.data && j.data.overall_progress;            // {done,total,done_ratio}\n  renderBar(p);\n  if (j.done) renderContacts(j.data.leads);               // enriched contacts\n});\nrefreshBtn.onclick = () => job.refresh();\n```\n\n## Write-call rules\n\nThe domain factories handle these for you. If you hand-roll an action:\n`leadbay_report_outreach` args MUST include `verification:{source:"user_confirmed", ref}`\nAND `_triggered_by`; `leadbay_add_leads_to_campaign` needs `_triggered_by`;\n`add_note`/`like_lead`/`dislike_lead` take only their own args. `epilogue_status` is\none of `lb.EPILOGUE_STATUSES`. Snoozing (pushback) and org WON/LOST status are\nadvanced-gated \u2014 not callable from a default artifact; use the epilogue values.\n\n## Degradation + live updates\n\nIf the host bridge is absent, a view-model\'s `.error` is set with `.error.unavailable\n=== true` (bind helpers set `data-lb-state="unavailable"`) \u2014 nothing throws. Every\ncall also has a **30s timeout** (configurable via `lb.configure({ timeoutMs })`): a\nhost call that never settles becomes `.error` with `code:"timeout"`, so a control is\nnever stuck loading forever \u2014 always render the `.error` branch so the user can retry.\nAuto-poll (`pollEvery`) depends on the cowork host serving FRESH reads; `.refresh()`\nis the guaranteed manual path \u2014 always wire a Refresh control for polling resources.';
+    ARTIFACT_KIT_VERSION = "0.5.0";
+    ARTIFACT_RUNTIME = '"use strict";(()=>{var L=Object.defineProperty;var A=(e,r,t)=>r in e?L(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t;var a=(e,r,t)=>A(e,typeof r!="symbol"?r+"":r,t);var S=`\n:root{\n--color-black:#191919;--color-white:#fff;\n--color-gray-1:#f9f9f9;--color-gray-2:#f0f0f0;--color-gray-3:#e0e0e0;--color-gray-4:#cecece;\n--color-gray-5:#c4c4c4;--color-gray-6:#8d8d8d;--color-gray-7:#787878;--color-gray-8:#646464;\n--color-gray-9:#202020;\n--color-linkedin:#0a66c2;\n--color-blue-background:oklch(0.947 0.029 251);--color-blue-foreground:oklch(0.564 0.181 251);\n--color-green-background:oklch(0.947 0.029 141);--color-green-foreground:oklch(0.564 0.181 141);\n--color-red-background:oklch(0.947 0.029 26);--color-red-foreground:oklch(0.564 0.191 26);\n--color-gold-background:oklch(0.972 0.049 91);--color-gold-foreground:oklch(0.667 0.177 91);\n--color-cherry-background:oklch(0.947 0.029 15);--color-cherry-foreground:oklch(0.44 0.146 15);\n--color-red-like:var(--color-cherry-foreground);\n--lb-font:"Nikkei Maru",system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;\n--lb-radius:1rem;--lb-radius-sm:0.625rem;--lb-gap:0.75rem;\n--lb-surface:var(--color-gray-1);--lb-border:var(--color-gray-3);\n--lb-fg:var(--color-black);--lb-muted:var(--color-gray-8);--lb-field:var(--color-white);\n}\n:root[data-theme=dark],:root[data-lb-theme=dark]{\n--lb-surface:var(--color-gray-9);--lb-border:var(--color-gray-8);\n--lb-fg:var(--color-white);--lb-muted:var(--color-gray-3);--lb-field:var(--color-gray-9);\n}\n@media(prefers-color-scheme:dark){:root:not([data-theme=light]):not([data-lb-theme=light]){\n--lb-surface:var(--color-gray-9);--lb-border:var(--color-gray-8);\n--lb-fg:var(--color-white);--lb-muted:var(--color-gray-3);--lb-field:var(--color-gray-9);\n}}\n.lb-card{display:grid;gap:var(--lb-gap);padding:0.875rem;\nbackground-color:var(--lb-surface);border:1px solid var(--lb-border);\nborder-radius:var(--lb-radius);corner-shape:squircle;color:var(--lb-fg);\nfont-family:var(--lb-font);\nbox-shadow:0 1rem 2.5rem color-mix(in srgb,var(--color-gray-9) 6%,transparent),\n0 0.125rem 0.5rem color-mix(in srgb,var(--color-gray-9) 4%,transparent)}\n.lb-card-head{display:flex;justify-content:space-between;align-items:baseline;gap:var(--lb-gap)}\n.lb-title{font-size:0.875rem;font-weight:600;line-height:1.25rem;color:var(--lb-fg)}\n.lb-sub{font-size:0.8125rem;line-height:1.125rem;color:var(--lb-muted)}\n.lb-row{display:flex;align-items:center;gap:var(--lb-gap);flex-wrap:wrap}\n.lb-stack{display:grid;gap:var(--lb-gap)}\n.lb-select,.lb-input{font:inherit;font-family:var(--lb-font);font-size:0.8125rem;color:var(--lb-fg);\nbackground-color:var(--lb-field);border:1px solid var(--lb-border);\nborder-radius:var(--lb-radius-sm);corner-shape:squircle;padding:0.4rem 0.55rem;min-height:2.125rem}\n.lb-btn{font:inherit;font-family:var(--lb-font);font-size:0.8125rem;font-weight:600;\ncolor:var(--lb-fg);background-color:var(--lb-field);border:1px solid var(--lb-border);\nborder-radius:var(--lb-radius-sm);corner-shape:squircle;padding:0.4rem 0.85rem;min-height:2.125rem;\ncursor:pointer;transition:background-color .15s,border-color .15s,color .15s}\n.lb-btn:hover:not([disabled]){border-color:var(--color-gray-6)}\n.lb-btn:focus-visible,.lb-select:focus-visible,.lb-input:focus-visible{\noutline:2px solid var(--color-blue-foreground);outline-offset:1px}\n.lb-btn[data-lb-state=loading]{opacity:.55;cursor:progress}\n.lb-btn[data-lb-state=success]{background-color:var(--color-green-background);\nborder-color:var(--color-green-foreground);color:var(--color-green-foreground)}\n.lb-btn[data-lb-state=error],.lb-select[data-lb-state=error]{\nbackground-color:var(--color-red-background);border-color:var(--color-red-foreground);\ncolor:var(--color-red-foreground)}\n.lb-btn[data-lb-state=unavailable],.lb-btn[disabled]{opacity:.5;cursor:not-allowed}\n.lb-msg{font-size:0.8125rem;line-height:1.125rem;color:var(--lb-muted)}\n.lb-msg[data-tone=error]{color:var(--color-red-foreground)}\n.lb-msg[data-tone=ok]{color:var(--color-green-foreground)}\n.lb-chip{display:inline-flex;align-items:center;gap:.25rem;white-space:nowrap;\nfont-size:0.75rem;font-weight:600;line-height:1rem;padding:0.125rem 0.5rem;\nborder-radius:var(--lb-radius-sm);corner-shape:squircle;\nbackground-color:var(--color-gray-2);color:var(--lb-muted)}\n.lb-chip[data-status=WANTED]{background-color:var(--color-blue-background);color:var(--color-blue-foreground)}\n.lb-chip[data-status=WON]{background-color:var(--color-green-background);color:var(--color-green-foreground)}\n.lb-chip[data-status=LOST]{background-color:var(--color-red-background);color:var(--color-red-foreground)}\n.lb-chip[data-status=UNWANTED]{background-color:var(--color-gray-2);color:var(--color-gray-7)}\n.lb-chip[data-taste=liked]{background-color:var(--color-cherry-background);color:var(--color-red-like)}\n.lb-chip[data-taste=disliked]{background-color:var(--color-gray-2);color:var(--color-gray-7)}\n.lb-chips{display:flex;align-items:center;gap:.35rem;flex-wrap:wrap}\n.lb-chip[hidden]{display:none}\n.lb-table{width:100%;border-collapse:collapse;font-family:var(--lb-font);color:var(--lb-fg)}\n.lb-table th,.lb-table td{text-align:left;padding:0.5rem 0.4rem;\nborder-bottom:1px solid var(--lb-border);vertical-align:middle;font-size:0.8125rem}\n.lb-table th{font-size:0.75rem;font-weight:600;color:var(--lb-muted);\ntext-transform:uppercase;letter-spacing:.04em}\n.lb-link{color:var(--color-blue-foreground);text-decoration:none}\n.lb-link:hover{text-decoration:underline}\n/* Quiet text link out of the artifact. Button-height so it shares the row\'s\n   baseline; understated so it never competes with the actions beside it. The\n   arrow is a bare diagonal stroke \\u2014 an escape-hatch marker, not an icon that\n   asks to be read. */\n.lb-link-out{display:inline-flex;align-items:center;gap:.3rem;\nfont-size:0.75rem;line-height:1rem;min-height:2.125rem;\ncolor:var(--lb-fg);text-decoration:none;opacity:.65;transition:opacity .15s}\n.lb-link-out:hover{opacity:1;text-decoration:underline}\n.lb-link-out:focus-visible{outline:2px solid var(--color-blue-foreground);outline-offset:1px;\nborder-radius:var(--lb-radius-sm)}\n.lb-link-out svg{width:.85em;height:.85em;flex-shrink:0}\n/* Pushes whatever follows it to the right edge of an .lb-row, so a trailing\n   link sits on the SAME baseline as the row\'s buttons instead of on its own\n   line below them. */\n.lb-spacer{flex:1 1 auto}\n.lb-spinner{display:inline-block;width:.7em;height:.7em;border:2px solid var(--lb-border);\nborder-top-color:var(--color-blue-foreground);border-radius:50%;animation:lb-spin .8s linear infinite}\n@keyframes lb-spin{to{transform:rotate(1turn)}}\n@media(prefers-reduced-motion:reduce){.lb-spinner{animation:none}\n.lb-btn{transition-property:none}}\n`,p="lb-styles";var x="0.5.0",c=class extends Error{constructor(t,o={}){super(t);a(this,"code");a(this,"raw");this.name="LbError",this.code=o.code,this.raw=o.raw}},y=null,f=3e4;function C(){let e=globalThis.cowork;return e&&typeof e.callMcpTool=="function"?(r,t)=>e.callMcpTool(r,t):null}function _(e){if(e&&typeof e=="object"&&"content"in e){let r=e.content;if(Array.isArray(r)&&r[0]&&typeof r[0].text=="string")return r[0].text}return null}function E(e){if(!e||typeof e!="object")return e;let r=e;if(r.isError)throw new c(_(e)??"tool call failed",{raw:e});if("structuredContent"in r&&r.structuredContent!=null)return r.structuredContent;let t=_(e);if(t!=null)try{return JSON.parse(t)}catch{return t}return e}function I(e){return e instanceof Error?e.message:String(e)}function v(e){let r=e instanceof c?e.code:void 0;return{message:I(e),unavailable:r==="unavailable",code:r}}function O(e={}){y=e.call??null,f=e.timeoutMs??3e4}function R(){if(typeof document>"u"||!document.head)return null;let e=document.getElementById(p);if(e)return e;let r=document.createElement("style");return r.id=p,r.textContent=S,document.head.appendChild(r),r}async function T(e,r){if(!f||f<=0)return e;let t,o=new Promise((n,i)=>{t=setTimeout(()=>i(new c(`"${r}" timed out after ${f}ms`,{code:"timeout"})),f)});try{return await Promise.race([e,o])}finally{t&&clearTimeout(t)}}async function l(e,r={}){if(y)return E(await T(Promise.resolve(y(e,r)),e));let t=C();if(!t)throw new c("Leadbay bridge unavailable (window.cowork absent)",{code:"unavailable"});return E(await T(Promise.resolve(t(e,r)),e))}var g=class{constructor(){a(this,"subs",new Set)}subscribe(r){return this.subs.add(r),r(this),()=>this.subs.delete(r)}emit(){for(let r of this.subs)r(this)}};function N(e){return Array.isArray(e)?e.map(r=>r&&typeof r=="object"?r:{value:r,label:String(r)}):[]}var b=class extends g{constructor(t={}){super();a(this,"kind");a(this,"value");a(this,"options",[]);a(this,"loading",!1);a(this,"error",null);a(this,"ready",!1);a(this,"cfg");a(this,"depUnsubs",[]);a(this,"seq",0);this.cfg=t,this.kind=t.kind,this.value=t.value??"";for(let o of t.dependsOn??[]){let n=o.value;this.depUnsubs.push(o.subscribe(()=>{o.value!==n&&(n=o.value,this.cfg.load&&this.load())}))}t.load&&(t.autoLoad??!0)&&this.load()}async load(){if(!this.cfg.load)return;let t=++this.seq;this.loading=!0,this.error=null,this.emit();try{let o=await this.cfg.load();if(t!==this.seq)return;this.options=this.cfg.options?this.cfg.options(o):N(o),this.ready=!0;let n=this.value==null?"":String(this.value);this.options.length&&(n===""||!this.options.some(i=>String(i.value)===n))&&(this.value=this.options[0].value)}catch(o){if(t!==this.seq)return;this.options=[],this.error=v(o)}finally{t===this.seq&&(this.loading=!1,this.emit())}}setValue(t){this.value=t;let o=this.validate();this.error=o?{message:o,unavailable:!1}:null,this.emit()}validate(){return this.cfg.validate?this.cfg.validate(this.value):null}get valid(){return this.validate()==null}reset(){this.value=this.cfg.value??"",this.error=null,this.emit()}dispose(){for(let t of this.depUnsubs)t();this.depUnsubs=[]}};function P(e){if(!e||typeof e!="object")return null;let r=e;if(r.error!==!0)return null;let t=typeof r.message=="string"&&r.message?r.message:"tool call failed",o=typeof r.hint=="string"&&r.hint?` \\u2014 ${r.hint}`:"";return`${t}${o}`}var s=class extends g{constructor(t){super();a(this,"loading",!1);a(this,"error",null);a(this,"lastResult",null);a(this,"cfg");this.cfg=t}async run(){if(this.loading)return;for(let n of this.cfg.fields??[]){let i=n.validate();if(i!=null){this.error={message:i,unavailable:!1},this.emit();return}}if(this.cfg.confirm&&typeof globalThis.confirm=="function"&&!globalThis.confirm(this.cfg.confirm))return;this.loading=!0,this.error=null,this.emit();let t;try{let n=typeof this.cfg.args=="function"?this.cfg.args():this.cfg.args??{};t=await l(this.cfg.tool,n)}catch(n){this.error=v(n),this.loading=!1,this.emit(),this.cfg.onError?.(this.error);return}let o=P(t)??this.cfg.checkResult?.(t)??null;if(o!=null){this.error={message:o,unavailable:!1},this.loading=!1,this.emit(),this.cfg.onError?.(this.error);return}return this.lastResult=t,this.loading=!1,this.emit(),this.cfg.onSuccess?.(t),t}reset(){this.error=null,this.lastResult=null,this.emit()}},d=class extends g{constructor(t){super();a(this,"data",null);a(this,"loading",!1);a(this,"refreshing",!1);a(this,"error",null);a(this,"done",!1);a(this,"cfg");a(this,"timer",null);a(this,"seq",0);this.cfg=t,(t.autoLoad??!0)&&this.load()}async load(){this.clearTimer();let t=++this.seq;this.data==null?this.loading=!0:this.refreshing=!0,this.error=null,this.emit();try{let n=await this.cfg.load();if(t!==this.seq)return;this.data=n,this.done=this.cfg.until?this.cfg.until(n):!0,this.cfg.pollEvery&&!this.done&&(this.timer=setTimeout(()=>void this.load(),this.cfg.pollEvery))}catch(n){if(t!==this.seq)return;this.error=v(n)}finally{t===this.seq&&(this.loading=!1,this.refreshing=!1,this.emit())}}refresh(){return this.load()}stop(){this.clearTimer()}clearTimer(){this.timer&&(clearTimeout(this.timer),this.timer=null)}},h=class extends g{constructor(t){super();a(this,"items",[]);a(this,"page",0);a(this,"pageSize");a(this,"total",0);a(this,"loading",!1);a(this,"error",null);a(this,"cfg");a(this,"seq",0);this.cfg=t,this.pageSize=t.pageSize??20,(t.autoLoad??!0)&&this.loadPage(0)}async loadPage(t){let o=++this.seq;this.loading=!0,this.error=null,this.emit();try{let n=await this.cfg.load({page:t,pageSize:this.pageSize});if(o!==this.seq)return;this.items=n.items??[],this.total=n.total??this.items.length,this.page=t}catch(n){if(o!==this.seq)return;this.error=v(n)}finally{o===this.seq&&(this.loading=!1,this.emit())}}next(){return this.loadPage(this.page+1)}prev(){return this.loadPage(Math.max(0,this.page-1))}get hasMore(){return(this.page+1)*this.pageSize<this.total}};function M(e,r){let t=r.error?.unavailable?"unavailable":r.loading?"loading":r.error?"error":"ready";e.setAttribute("data-lb-state",t),r.error?e.setAttribute("data-lb-error",r.error.message):e.removeAttribute("data-lb-error")}function D(e,r){let t=()=>r.setValue(e.value);e.addEventListener("change",t);let o=r.subscribe(()=>{M(e,r),e.disabled=r.loading,e.innerHTML="";for(let n of r.options){let i=document.createElement("option");i.value=String(n.value),i.textContent=n.label,e.appendChild(i)}e.value=r.value==null?"":String(r.value)});return()=>{e.removeEventListener("change",t),o()}}function z(e,r){let t=e.type==="checkbox",o=e.tagName==="SELECT"?"change":"input",n=()=>r.setValue(t?e.checked:e.value);e.addEventListener(o,n);let i=r.subscribe(()=>{if(t)e.checked=!!r.value;else{let u=r.value==null?"":String(r.value);e.value!==u&&(e.value=u)}e.setAttribute("data-lb-state",r.error?"error":"ready"),r.error?e.setAttribute("data-lb-error",r.error.message):e.removeAttribute("data-lb-error")});return()=>{e.removeEventListener(o,n),i()}}function F(e,r){let t=n=>{n.preventDefault(),r.run()};e.addEventListener("click",t);let o=r.subscribe(()=>{let n=r.error?.unavailable?"unavailable":r.loading?"loading":r.error?"error":r.lastResult!=null?"success":"idle";e.setAttribute("data-lb-state",n),"disabled"in e&&(e.disabled=r.loading),r.error?e.setAttribute("data-lb-error",r.error.message):e.removeAttribute("data-lb-error")});return()=>{e.removeEventListener("click",t),o()}}var q=["STILL_CHASING","COULD_NOT_REACH_STILL_TRYING","INTEREST_VALIDATED_OR_MEETING_PLANED","NOT_INTERESTED_LOST"],k=[{value:"",label:"Default ranking"},{value:"SCORE:DESC",label:"Score \\u2193"},{value:"SCORE:ASC",label:"Score \\u2191"},{value:"NAME:ASC",label:"Name A\\u2192Z"},{value:"NAME:DESC",label:"Name Z\\u2192A"},{value:"SIZE:DESC",label:"Size \\u2193"},{value:"SIZE:ASC",label:"Size \\u2191"},{value:"SECTOR:ASC",label:"Sector A\\u2192Z"},{value:"STATUS:ASC",label:"Status A\\u2192Z"},{value:"CONTACT_COUNT:DESC",label:"Contacts \\u2193"},{value:"LAST_PROSPECTING_ACTION_AT:DESC",label:"Last action \\u2193"},{value:"LAST_PROSPECTING_ACTION_AT:ASC",label:"Last action \\u2191"},{value:"EPILOGUE_STATUS_SET_AT:DESC",label:"Outcome set \\u2193"},{value:"LIKED:DESC",label:"Liked first"},{value:"DISLIKED:DESC",label:"Disliked first"}];function U(e){let r=String(e??"").trim().toUpperCase(),t=k.some(o=>o.value===r);return new b({kind:"select",value:t?r:"",load:async()=>k.slice()})}var m=[{value:"WANTED",label:"Wanted"},{value:"WON",label:"Won"},{value:"LOST",label:"Lost"},{value:"UNWANTED",label:"Unwanted"}],H={value:"",label:"\\u2014 Not set \\u2014"};function W(e){let r=String(e??"").trim().toUpperCase(),t=m.some(o=>o.value===r);return new b({kind:"select",value:t?r:"",validate:o=>String(o??"")===""?"Pick a status":null,load:async()=>t?m.slice():[H,...m]})}function $(e){let r=()=>{let t=typeof e.leadIds=="function"?e.leadIds():e.leadIds;return Array.isArray(t)?t:e.leadId?[e.leadId]:[]};return new s({tool:"leadbay_set_lead_status",fields:e.date?[e.status,e.date]:[e.status],confirm:e.confirm,args:()=>({lead_ids:r(),status:e.status.value,...e.date&&e.date.value?{status_date:e.date.value}:{},...e.ask?{_triggered_by:e.ask}:{}}),checkResult:t=>{let o=t?.failed;if(!Array.isArray(o)||o.length===0)return null;let n=r().length,i=o[0]?.message??"write rejected";return o.length===n?`Status not applied: ${i}`:`${o.length} of ${n} leads failed: ${i}`}})}function j(e){return new b({kind:"select",load:()=>l("leadbay_list_campaigns",{_triggered_by:e}),options:r=>(r?.campaigns??[]).map(o=>{let n=o?.campaign??o;return n?.id?{value:n.id,label:n.name??n.ai_generated_name??String(n.id)}:null}).filter(o=>o!=null)})}function V(e){return new s({tool:"leadbay_report_outreach",fields:e.note?[e.note]:[],args:()=>({lead_id:e.leadId,...e.status?{epilogue_status:e.status.value}:{},note:e.note?e.note.value:"",verification:{source:"user_confirmed",ref:e.ref??"logged from artifact"},_triggered_by:e.ask})})}function G(e){return new s({tool:"leadbay_add_note",fields:[e.note],args:()=>({leadId:e.leadId,note:e.note.value})})}function Z(e){return new s({tool:"leadbay_like_lead",args:{lead_id:e}})}function Y(e){return new s({tool:"leadbay_dislike_lead",args:{lead_id:e}})}function B(e,r){return new d({autoLoad:!1,load:()=>l("leadbay_account_history",{leadId:e,_triggered_by:r})})}function K(e,r){return new d({autoLoad:!1,load:()=>l("leadbay_research_lead_by_id",{leadId:e,_triggered_by:r})})}function J(e){let r=null;return new d({...e.autoLoad!==void 0?{autoLoad:e.autoLoad}:{},pollEvery:e.pollEvery??4e3,until:t=>!!t?.all_done,load:async()=>{if(!r){let t=await l("leadbay_enrich_titles",{...e.leadIds?{leadIds:e.leadIds}:{},titles:e.titles,...e.email!==void 0?{email:e.email}:{},...e.phone!==void 0?{phone:e.phone}:{},...e.confirm!==void 0?{confirm:e.confirm}:{},_triggered_by:e.ask});if(r=t?.bulk_id??null,!r)return{...t,all_done:!0,no_job:!0}}return l("leadbay_bulk_enrich_status",{bulk_id:r,_triggered_by:e.ask})}})}function Q(e){let r=()=>typeof e.order=="string"?e.order:String(e.order?.value??"");return new h({pageSize:e.pageSize??20,load:async({page:t,pageSize:o})=>{let n=await l("leadbay_pull_leads",{page:t,count:o,...e.lensId?{lensId:e.lensId}:{},...r()?{order:r()}:{},_triggered_by:e.ask}),i=n.leads??[];return{items:i,total:n.pagination?.total??i.length}}})}function X(e){let r=e.source??"followups",t=()=>typeof e.order=="string"?e.order:String(e.order?.value??"");return new h({pageSize:e.pageSize??20,load:async({page:o,pageSize:n})=>{let u=r==="campaign"?await l("leadbay_campaign_call_sheet",{campaign_id:e.campaignId,page:o,count:n,_triggered_by:e.ask}):await l("leadbay_pull_followups",{page:o,count:n,...e.city?{city:e.city}:{},...t()?{order:t()}:{},_triggered_by:e.ask}),w=u.leads??u.items??[];return{items:w,total:u.total_leads??u.pagination?.total??w.length}}})}function ee(e){return new d({load:()=>l("leadbay_team_activity",{weeks:e.weeks??4,_triggered_by:e.ask})})}var re={VERSION:x,configure:O,styles:R,call:l,field:e=>new b(e),action:e=>new s(e),resource:e=>new d(e),list:e=>new h(e),bindSelect:D,bindValue:z,bindAction:F,campaigns:j,outreach:V,note:G,like:Z,dislike:Y,leadStatus:W,setStatus:$,sortOrder:U,leadHistory:B,leadProfile:K,enrichment:J,callList:X,leadList:Q,teamActivity:ee,EPILOGUE_STATUSES:q,LEAD_STATUSES:m,SORT_ORDERS:k};typeof globalThis<"u"&&(globalThis.LeadbayArtifacts=re);})();';
+    ARTIFACT_USAGE_GUIDE = '# Leadbay Artifact Kit \u2014 headless domain components\n\nYou are building a single-file HTML **artifact** the user runs inside cowork. This\nkit gives you **headless view-models** that own a control\'s whole data lifecycle \u2014\nload/populate from a Leadbay call, hold value/state, poll, validate, and\nencapsulate the API call + business rules. **You own 100% of markup/layout/style.**\nThe library renders nothing. Inline the runtime once as a `<script>`; it exposes\none global `window.LeadbayArtifacts` (call it `lb`). Vanilla, no React, no build.\n\nPass every tool you use as the artifact\'s `mcp_tools` so the host permits it.\n\n## Two layers\n\n**Primitives** (generic):\n- `lb.field({ load, options, value, validate, dependsOn })` \u2014 a value + optionally\n  API-populated options. `.value/.setValue/.options/.loading/.error/.valid/.subscribe`.\n- `lb.action({ tool, args, fields, confirm, onSuccess, onError })` \u2014 a write/submit.\n  `.run()/.loading/.error/.lastResult/.subscribe`.\n- `lb.resource({ load, pollEvery?, until?, autoLoad? })` \u2014 one read that may change:\n  load-on-click or poll-until-`until`. `.data/.loading/.refreshing/.error/.done/.load()/.refresh()/.stop()/.subscribe`.\n- `lb.list({ load, pageSize })` \u2014 paginated rows. `.items/.page/.total/.loading/.loadPage(n)/.next()/.prev()/.hasMore/.subscribe`.\n\n`.error` is `{ message, unavailable } | null`. `subscribe(cb)` fires immediately\nthen on every change \u2014 render your own DOM from it.\n\n**Domain components** (pre-wired \u2014 bake in the tool name, arg shape, and footguns):\n\n| Call | Returns | For |\n|---|---|---|\n| `lb.campaigns(ask)` | field | a campaign `<select>`, options from `leadbay_list_campaigns` |\n| `lb.outreach({leadId, ask, status?, note?})` | action | log a call \u2192 `report_outreach` (verification + `_triggered_by` baked in) |\n| `lb.note({leadId, note})` | action | add a note \u2192 `add_note` |\n| `lb.like(leadId)` / `lb.dislike(leadId)` | action | taste signal |\n| `lb.leadStatus(current?)` | field | a status `<select>` (Wanted/Won/Lost/Unwanted) |\n| `lb.setStatus({leadId or leadIds, status, date?, ask})` | action | write the org CRM status \u2192 `set_lead_status` |\n| `lb.leadHistory(leadId, ask)` | resource (lazy) | notes + activities + engagement \u2192 `account_history` |\n| `lb.leadProfile(leadId, ask)` | resource (lazy) | full lead profile \u2192 `research_lead_by_id` |\n| `lb.sortOrder(current?)` | field | a sort `<select>` mirroring the app\'s TableSort |\n| `lb.leadList({lensId?, order?, ask})` | list | a sortable Discover batch \u2192 `pull_leads` |\n| `lb.callList({source:\'followups\'\\|\'campaign\', campaignId?, city?, ask})` | list | a cold-call list (Monitor or a campaign) |\n| `lb.enrichment({leadIds, titles, ask, pollEvery?})` | resource (polling) | launch + watch contact enrichment |\n| `lb.teamActivity({weeks, ask})` | resource | manager leaderboard + activity trend \u2192 `leadbay_team_activity` |\n\n`lb.EPILOGUE_STATUSES` = the 4 disposition values\n(`STILL_CHASING`, `COULD_NOT_REACH_STILL_TRYING`, `INTEREST_VALIDATED_OR_MEETING_PLANED`, `NOT_INTERESTED_LOST`).\n`lb.LEAD_STATUSES` = the 4 org CRM statuses as `{value,label}` (`WANTED`, `WON`, `LOST`, `UNWANTED`).\n`lb.SORT_ORDERS` = the sort options as `{value,label}`; values are the backend `FIELD:ASC|DESC` enum.\n\n**Sorting is a SERVER concern.** `lb.leadList` and `lb.callList` take an `order`\n(a `lb.sortOrder()` field or a literal) and send it upstream; the backend sorts\nthe whole lens / Monitor and returns the requested page of that. Never re-sort\nrows in the browser \u2014 you would be reordering one page of a larger set, showing\nleads that do not belong at that position. The empty value means "no order\nparam", i.e. the tab\'s own ranking, which is the right default. Changing the\nsort should reset to page 0. Campaign call sheets cannot sort:\n`leadbay_campaign_call_sheet` has no `order` param, and `lb.callList` drops it\nfor that source rather than sending something the tool would reject.\n\n**Two different systems.** Epilogue = how one outreach attempt went (drives\nfollow-up ranking). Lead status = the commercial outcome, org-wide \u2014 the same\nfield the website\'s status selector writes. A won deal is a LEAD STATUS;\n"she didn\'t pick up" is an EPILOGUE. Setting one never sets the other, so when\nthe user reports both in one breath, fire both actions.\n\n**Binding sugar** (optional; binds a view-model to YOUR native element, no style):\n`lb.bindSelect(selectEl, field)` (populates options + value), `lb.bindValue(inputEl, field)`,\n`lb.bindAction(buttonEl, action)`. They set `data-lb-state`\n(`ready|loading|error|success|unavailable`) + `data-lb-error` on your element as\nstyling hooks. For lists/resources, use `.subscribe()` and render yourself.\n\n`ask` is the user\'s request this artifact serves \u2014 it becomes `_triggered_by`.\n\n## The skin (optional) \u2014 `lb.styles()`\n\nCall it once and you get a small `lb-*` stylesheet, so every artifact you build\nshares one visual language instead of re-inventing padding and colours. It is\n**opt-in**: skip it and you get exactly the unstyled HTML you wrote. It injects\nno markup and never touches your `class` attributes.\n\n```js\nlb.styles();   // idempotent \u2014 safe to call per row\n```\n\n| Class | For |\n|---|---|\n| `lb-card` / `lb-card-head` / `lb-title` / `lb-sub` | a lead card + its header |\n| `lb-row` / `lb-stack` / `lb-spacer` | control row / vertical spacing / flex filler that right-aligns what follows |\n| `lb-link-out` | quiet external link (icon inherits currentColor) \u2014 "Open in Leadbay" |\n| `lb-select` / `lb-input` / `lb-btn` | form controls (state-aware, see below) |\n| `lb-msg` (`data-tone="error\\|ok"`) | inline feedback |\n| `lb-chip` (`data-status="WON\\|LOST"`) | a status pill |\n| `lb-table` | leads table |\n| `lb-spinner` | inline busy indicator |\n\nControls react to the `data-lb-state` the bind helpers already set \u2014 a bound\n`lb-btn` dims while loading, goes green on success, red on error, all with no\nextra CSS from you.\n\nThe palette is the **product design system**, ported from\n`frontend/packages/style/color.css` \u2014 same `--color-gray-1\u20269` ramp, same\nsemantic `--color-{green,red,blue,gold}-{background,foreground}` pairs, same\n`1rem` / `0.625rem` radii and `corner-shape: squircle` as the app\'s components.\nAn artifact therefore looks like Leadbay, not like a generic page.\n\nUse the tokens rather than hardcoded colours \u2014 the same rule the style package\nenforces. Re-theme by overriding them; don\'t fight specificity:\n\n```css\n:root { --lb-surface: var(--color-gray-2); --lb-radius: 0.5rem; }\n```\n\nDark mode works two ways: `data-theme="dark"` on `<html>` (the frontend\'s own\nhook) **and** `prefers-color-scheme`, because an artifact renders inside a host\nwhose theme attribute it cannot set. Never hardcode a light background over the\nskin.\n\nThe product face is `Nikkei Maru`; the stack names it first and falls back to\nthe system UI font. Do **not** add an `@font-face` \u2014 artifacts are inline-only\nand a remote font URL will silently fail.\n\n## What every lead card MUST carry\n\nA card is the artifact form of the `pull_leads` table, and it inherits that\ntable\'s rules. A card with a name and a button is not enough: the rep cannot\ntell *why* this lead is on screen. Four lines, in this order.\n\n```html\n<div class="lb-card">\n  <div class="lb-card-head">\n    <span class="lb-title"></span>              <!-- 1. company -->\n    <span class="lb-chips">                     <!-- 2. state -->\n      <span class="lb-chip" data-taste hidden></span>\n      <span class="lb-chip" data-status hidden></span>\n    </span>\n  </div>\n  <div class="lb-sub"></div>                    <!-- 3. firmographics -->\n  <div class="lb-sub" data-why></div>           <!-- 4. why it fits -->\n  <div class="lb-row"><!-- actions --></div>\n</div>\n```\n\n1. **Company** \u2014 `name`, linked to `website` (prefix `https://` on a bare host).\n   Never render the numeric `score`; use the `\u25B0\u2756\u25B1` bar if you want the signal.\n\n   Also give every card an **Open in Leadbay** link to the lead\'s panel in the\n   product. Put it at the **right-hand end of the card\'s last action row** \u2014\n   same row as the buttons, pushed right by an `lb-spacer`, not on a line of\n   its own. Style it `lb-link-out`: quiet text plus a plain arrow-up-right,\n   never a filled button. It is an escape hatch, not a call to action.\n\n   ```html\n   <div class="lb-row">\n     <button class="lb-btn">Like</button>\n     <button class="lb-btn">Set status</button>\n     <span class="lb-spacer"></span>          <!-- pushes the link right -->\n     <a class="lb-link-out" data-k="open" target="_blank" rel="noopener">\n       Open in Leadbay\n       <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"\n            stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">\n         <line x1="7" y1="17" x2="17" y2="7"/><polyline points="7 7 17 7 17 17"/>\n       </svg>\n     </a>\n   </div>\n   ```\n\n   Keep the arrow a bare diagonal stroke \u2014 the text already says where the link\n   goes, so the glyph only has to mark "leaves this page". Mark the `<svg>`\n   `aria-hidden="true"`: it is decorative, and the link text is the accessible\n   name.\n   **Pick the view the lead actually lives in** \u2014 the URL is\n   `/app/<view>?lead=<uuid>`, and the three views are `discover`, `monitor`,\n   `campaign`. Landing a Monitor lead on Discover drops the rep into a list\n   that does not contain it:\n\n   ```js\n   function leadUrl(lead, campaignId) {\n     const id = encodeURIComponent(lead.id);\n     // A campaign card carries TWO params \u2014 the campaign selects the list, the\n     // lead opens the panel inside it. Campaign wins even when in_monitor is\n     // also true, because that is the list the rep is looking at.\n     if (campaignId) {\n       return `https://leadbay.app/app/campaign?campaign=${encodeURIComponent(campaignId)}&lead=${id}`;\n     }\n     const view = lead.in_monitor ? "monitor" : "discover";\n     return `https://leadbay.app/app/${view}?lead=${id}`;\n   }\n   openEl.href = leadUrl(lead, campaignId);\n   ```\n\n   `in_monitor` / `in_discover` are booleans on the `pull_followups` payload \u2014\n   every follow-up carries `in_monitor: true`, so a call sheet must link to\n   `monitor`. `pull_leads` omits both flags entirely; its leads are the Discover\n   batch by definition, so `discover` is the default. A campaign card\n   (`lb.callList({source:"campaign", campaignId})`) needs `?campaign=<id>&lead=<id>`\n   \u2014 the param names are `CAMPAIGN_QUERY_PARAM` and `LEAD_QUERY_PARAM`, and the\n   app\'s own `useLeadPanel` preserves whatever params are already set, so the\n   two coexist by design. Omitting `campaign=` opens an empty campaign view.\n\n   Inline the glyph as SVG rather than an emoji or `\u2197` \u2014 it inherits\n   `currentColor` and scales with the text, so it stays legible in both themes.\n   `?lead=<uuid>` is the real deep-link (`LEAD_QUERY_PARAM` in the web app, read\n   on load; the panel is an overlay, so the view choice only decides what sits\n   behind it). This is the ONE place a card may use `lead.id`: as a link target,\n   never as visible text.\n2. **State chips** \u2014 taste (`data-taste`) and CRM status (`data-status`) are\n   INDEPENDENT axes; render both, hide the empty one. Never collapse to one chip.\n3. **Firmographics** \u2014 sector of activity first, then city, then size, then the\n   contact. `sector_id` is a RAW ID (`"5136"`), not a label: resolve it via\n   `leadbay_list_sectors` (1346 rows \u2014 fetch once, cache, never inline the lot)\n   or omit it. Never print the raw id.\n\n   **Always show whether the lead is reachable \u2014 and never merge the person\n   with the company\'s switchboard.** These are two separate lines:\n\n   ```js\n   // WHO \u2014 recommended_contact. Name, and job_title ONLY when present; on list\n   // payloads it is usually null, and inventing one is worse than omitting it.\n   const rc = lead.recommended_contact;\n   const who = rc ? [rc.first_name, rc.last_name].filter(Boolean).join(" ") : null;\n   const whoLine = who ? who + (rc.job_title ? " \xB7 " + rc.job_title : "") : "No named contact";\n\n   // HOW \u2014 company-level channels. `phone_numbers` and `email` belong to the\n   // COMPANY, not to `recommended_contact`. Rendering "Jean \xB7 \u260E 0123\u2026" claims a\n   // direct line that does not exist; it is the switchboard.\n   const phone = (lead.phone_numbers || [])[0] || null;\n   // The API returns the STRING "null" for a missing email \u2014 guard for it or\n   // you will print the word "null" as an address.\n   const email = lead.email && lead.email !== "null" ? lead.email : null;\n   const howLine = [phone && "\u260E " + phone, email && "\u2709 " + email].filter(Boolean)\n     .join(" \xB7 ") || "No direct channel \u2014 enrich to reveal";\n   ```\n\n   ```html\n   <div class="lb-sub">Sector \xB7 City \xB7 Size</div>\n   <div class="lb-sub">\u{1F464} Jean-Fran\xE7ois Froemer \xB7 G\xE9rant</div>   <!-- WHO -->\n   <div class="lb-sub">\u{1F3E2} \u260E 01 23 45 67 89</div>                 <!-- HOW: company -->\n   ```\n\n   Label the channel line as the **company\'s**, so a rep reading fast cannot\n   mistake it for a direct line. A per-contact email or phone exists only after\n   enrichment \u2014 `research_lead_by_id` exposes it as `contacts.reachable[]`, and\n   `_meta.has_reachable_contact` is the authoritative flag. The list payloads\n   carry neither, so a card built from `pull_leads` / `pull_followups` can only\n   ever show company channels. Say "enrich to reveal" rather than implying the\n   contact is callable.\n\n   Two things that look like reachability and are not: a `linkedin_page` alone\n   (the rep cannot message a URL without leaving the artifact \u2014 same rule\n   `research_lead_by_id` applies), and `contacts_count > 0` (it counts known\n   people, not people you can contact; a lead can show 2518 contacts and zero\n   channels). `pull_followups` carries `has_phone` as a ready-made boolean;\n   `pull_leads` omits it, so derive from `phone_numbers` there.\n4. **Why it fits** \u2014 one sentence, \u226420 words. Walk this chain and stop at the\n   first hit:\n\n   1. `short_description`\n   2. `description` (longer; only on `research_lead_by_id` /\n      `research_lead_by_name_fuzzy` \u2014 the trim payloads omit it)\n   3. top 2 `tags[].display_name`\n   4. `qualification_summary.best_response_excerpt`, trimmed to one sentence\n   5. `keywords`, first 3, joined with ` \xB7 `\n   6. the resolved sector label \u2014 better than nothing, and if step 3 already\n      printed the sector on the firmographics line, skip to step 7\n   7. the literal *"No description yet \u2014 run qualification to generate one"*\n\n   Never leave this line blank: a silent gap reads as a rendering bug, whereas\n   the fallback tells the rep the data is missing and what fixes it.\n\n   **The two list payloads are complementary, so the chain must span both.**\n   `pull_leads` returns `short_description` on every lead but no `sector_id`;\n   `pull_followups` returns `sector_id` but no `short_description` at all. A\n   card fed by one will fall through to a different step than the same card fed\n   by the other \u2014 that is expected, not a bug. Never call\n   `research_lead_by_id` per row just to fill this line: it is one request per\n   lead. Fetch it lazily when the rep expands a card.\n\n**Never show** on a card: `id`, `sector_id`, `location.pos`, `location.country`\n(unless city and state are both missing), `is_hq`, `*_in_progress`,\n`highlighted_fields`, `custom_fields`, `stale_at`, `deal_insights`,\n`need_attention*`, any count that is 0, any value that is the string `"null"`.\n\n**Minimum actions.** A card that only displays is a table row that costs more \u2014\nif you are not wiring an action, render the markdown table instead. Wire at\nleast one write, and prefer the set the rep actually needs:\n\n| Card is for | Wire |\n|---|---|\n| triage a discovery batch | `lb.like` / `lb.dislike` + `lb.setStatus` |\n| working a call list | `lb.outreach` (gated on a note) + `lb.leadHistory` |\n| pipeline review | `lb.setStatus` + `lb.note` |\n\nAlways render the `.error` branch of every view-model \u2014 a control that cannot\nreach the host must say so, not sit silent.\n\n## Recipe: cold-call sheet (one row per lead)\n\n```js\nconst lb = window.LeadbayArtifacts; lb.configure();\nconst ASK = "<the user\'s request>";\n\nconst list = lb.callList({ source: "campaign", campaignId: CID, ask: ASK });\nlist.subscribe((l) => renderRows(l.items, l.loading));   // your render\n\n// per lead row (call when you build a row):\nfunction wireRow(lead, els) {\n  const status = lb.field({ value: "STILL_CHASING" });   // static-enum <select>\n  const note   = lb.field({ validate: (v) => (v && v.trim() ? null : "Add a note") });\n  lb.bindValue(els.status, status);\n  lb.bindValue(els.note, note);\n  lb.bindAction(els.log,  lb.outreach({ leadId: lead.id, ask: ASK, status, note }));\n  lb.bindAction(els.like, lb.like(lead.id));\n\n  const history = lb.leadHistory(lead.id, ASK);          // lazy\n  history.subscribe((h) => renderHistory(els.history, h));\n  els.expand.onclick = () => history.load();             // load on click\n}\n```\n\n## Recipe: lead-status dropdown (Wanted / Won / Lost)\n\nThe org-wide CRM status, as a `<select>` + Apply button. You write the markup;\n`lb.leadStatus` fills the options and holds the value, `lb.setStatus` does the write.\n\n```html\n<div class="lb-card">\n  <div class="lb-card-head">\n    <span class="lb-title">Acme Corp</span>\n    <span class="lb-chips">\n      <span id="taste" class="lb-chip" data-taste="liked">Liked</span>\n      <span id="crm"   class="lb-chip" data-status="WANTED">Wanted</span>\n    </span>\n  </div>\n  <div class="lb-row">\n    <select id="st" class="lb-select"></select>\n    <button id="go" class="lb-btn">Apply</button>\n    <span id="msg" class="lb-msg"></span>\n  </div>\n</div>\n```\n\n**Two badges, never one.** Taste (`liked`/`disliked`, from `lb.like`/`lb.dislike`)\nand CRM status (`WANTED`/`WON`/`LOST`/`UNWANTED`, from `lb.setStatus`) are\nindependent axes \u2014 a lead can be liked *and* lost. Collapsing them into a single\nchip destroys information: the rep can no longer see that a lead they liked went\nnowhere. Render `data-taste` and `data-status` as separate chips inside\n`lb-chips`, and hide the one that has no value rather than reusing it.\n\n```js\nlb.styles();                                          // once per artifact \u2014 see below\n\nconst status = lb.leadStatus(lead.org_lead_status);   // seed with the CURRENT value\nconst save   = lb.setStatus({ leadId: lead.id, status, ask: ASK });\n\nlb.bindSelect(document.getElementById("st"), status); // populates the 4 options\nlb.bindAction(document.getElementById("go"), save);   // click \u2192 write\n\nsave.subscribe((a) => {                               // render your own feedback\n  msg.textContent = a.loading ? "Saving\u2026"\n    : a.error ? a.error.message                       // includes partial failures\n    : a.lastResult ? `Set to ${a.lastResult.status}` : "";\n  msg.dataset.tone = a.error ? "error" : a.lastResult ? "ok" : "";\n});\n```\n\nLoading / success / error styling comes free: `bindAction` and `bindSelect` set\n`data-lb-state` (`ready|loading|error|success|unavailable`) and the skin already\ntargets those attributes. No extra wiring.\n\nSave-on-change instead of an Apply button \u2014 drop `bindAction` and run it yourself:\n\n```js\ndocument.getElementById("st").addEventListener("change", () => save.run());\n```\n\n**Bulk apply** across checked rows \u2014 pass `leadIds` and a `confirm`, since one\nclick rewrites a field every rep in the org sees:\n\n```js\nconst bulk = lb.setStatus({\n  leadIds: () => checkedIds,        // \u2190 read at run() time, not at build time\n  status, ask: ASK,\n  confirm: "Set this status on every selected lead?",\n});\n```\n\n`leadIds` is read when the action runs, so a live selection works \u2014 but pass the\narray itself if your selection is fixed. A partial write (some leads rejected)\nsurfaces as `.error`, never as a green button: `setStatus` checks the `failed[]`\nthe tool returns.\n\nThe backend stamps the status date as "now" on every write, which is what a rep\nclicking a dropdown means. Don\'t add a date picker unless the user asks to\nbackdate \u2014 then pass an optional `date` field holding `YYYY-MM-DD`:\n`lb.setStatus({ leadId, status, date, ask })`.\n\n## Recipe: manager dashboard\n\n```js\nconst team = lb.teamActivity({ weeks: 4, ask: ASK });\nteam.subscribe((t) => {\n  if (t.loading) showSpinner();\n  if (t.data) {\n    renderLeaderboard(t.data.reps);   // sorted by total_activities; cols: name, notes, meetings_or_interest, lost\u2026\n    renderTrendChart(t.data.trend);   // [{date,count}] \u2192 Chart.js (allowed from CDN)\n  }\n});\nrefreshBtn.onclick = () => team.refresh();\n```\n\n## Recipe: live enrichment\n\n```js\nconst job = lb.enrichment({ leadIds: [LEAD], titles: ["CEO", "VP Sales"], ask: ASK });\njob.subscribe((j) => {\n  const p = j.data && j.data.overall_progress;            // {done,total,done_ratio}\n  renderBar(p);\n  if (j.done) renderContacts(j.data.leads);               // enriched contacts\n});\nrefreshBtn.onclick = () => job.refresh();\n```\n\n## Write-call rules\n\nThe domain factories handle these for you. If you hand-roll an action:\n`leadbay_report_outreach` args MUST include `verification:{source:"user_confirmed", ref}`\nAND `_triggered_by`; `leadbay_add_leads_to_campaign` needs `_triggered_by`;\n`add_note`/`like_lead`/`dislike_lead` take only their own args. `epilogue_status` is\none of `lb.EPILOGUE_STATUSES`. Snoozing (pushback) is advanced-gated \u2014 not\ncallable from a default artifact. Org lead status IS on the default surface:\nuse `lb.setStatus`, which owns the arg shape AND the partial-write check \u2014\n`leadbay_set_lead_status` writes each lead separately, so it can resolve 200\nwith a non-empty `failed[]`. Hand-rolling that action will report a green\nbutton over a write that never landed.\n\n## Degradation + live updates\n\nIf the host bridge is absent, a view-model\'s `.error` is set with `.error.unavailable\n=== true` (bind helpers set `data-lb-state="unavailable"`) \u2014 nothing throws. Every\ncall also has a **30s timeout** (configurable via `lb.configure({ timeoutMs })`): a\nhost call that never settles becomes `.error` with `code:"timeout"`, so a control is\nnever stuck loading forever \u2014 always render the `.error` branch so the user can retry.\nAuto-poll (`pollEvery`) depends on the cowork host serving FRESH reads; `.refresh()`\nis the guaranteed manual path \u2014 always wire a Refresh control for polling resources.';
   }
 });
 
@@ -25749,6 +26593,7 @@ __export(dist_exports, {
   sendFeedback: () => sendFeedback,
   setActiveLens: () => setActiveLens,
   setEpilogueStatus: () => setEpilogueStatus,
+  setLeadStatus: () => setLeadStatus,
   setPushback: () => setPushback,
   setQualificationQuestions: () => setQualificationQuestions,
   setTelemetry: () => setTelemetry,
@@ -25825,6 +26670,7 @@ var init_dist = __esm({
     init_delete_custom_field();
     init_like_lead();
     init_dislike_lead();
+    init_set_lead_status();
     init_set_telemetry();
     init_add_contact();
     init_remove_contact();
@@ -26076,6 +26922,13 @@ var init_dist = __esm({
       // to the agent without requiring LEADBAY_MCP_ADVANCED=1.
       likeLead,
       dislikeLead,
+      // Org-wide CRM status (WANTED/WON/LOST/UNWANTED). Granular-shaped but
+      // registered HERE, not in granularWriteTools: reps state deal outcomes in
+      // ordinary conversation, and the artifact-kit status dropdown calls it —
+      // both need it on the default surface without LEADBAY_MCP_ADVANCED=1.
+      // Distinct from setEpilogueStatus (outreach disposition), which stays
+      // advanced-gated.
+      setLeadStatus,
       // Campaign write composites — persist a hand-picked cohort of leads.
       // Backend POST endpoints; gated behind LEADBAY_MCP_WRITE=1 in MCP.
       createCampaign,
@@ -27260,7 +28113,7 @@ Build the final mappings yourself. Start from \`leadbay_resolve_import_rows.mapp
 
 # PHASE 5 \u2014 QUALIFY (optional) + REPORT
 
-Prefer \`leadbay_import_and_qualify\` when the user asks to qualify/research after import; otherwise use \`leadbay_import_leads\`. For large files or short client timeouts, pass \`wait_for_completion=false\` and poll \`leadbay_import_status\`. After import, qualify only lead IDs returned by the import. Rows that came back \`uncrawled\` are pending a background crawl (not failures); the leads Leadbay adds for them populate in the user's Leadbay account as the crawl completes \u2014 tell the user that, not that a tool call will fetch them (\`import_status\` refreshes status/progress only; \`pull_leads\` reads the active lens, so an imported lead outside it may not appear; re-running the import later re-reconciles those companies).
+Prefer \`leadbay_import_and_qualify\` when the user asks to qualify/research after import; otherwise use \`leadbay_import_leads\`. For large files or short client timeouts, pass \`wait_for_completion=false\` and poll \`leadbay_import_status\`. After import, qualify only lead IDs returned by the import. Rows that came back \`uncrawled\` are pending a background crawl (not failures); the leads Leadbay adds for them populate in the user's Leadbay account as the crawl completes \u2014 tell the user that, not that a tool call will fetch them (\`import_status\` reports the rows the wizard already placed, not leads a later crawl adds; \`pull_leads\` reads the active lens, so an imported lead outside it may not appear; re-running the import later re-reconciles those companies).
 
 **Deliver the augmented file back to the user**: the original file plus a new \`LEADBAY_ID\` column populated from the resolution step. This is the second deliverable of a job well done.
 
@@ -27825,10 +28678,17 @@ Research the company name or domain '{{arg:domain}}' for me using Leadbay.
 
 # PHASE 1 \u2014 RESOLVE + DEEP DIVE
 Call \`leadbay_research_lead_by_name_fuzzy\` with
-\`companyName:'{{arg:domain}}'\`. Omit \`lensId\`: the default search deliberately
-covers the user's visible Discover, Monitor, and Activate corpus, including
-other lenses and leads outside the active lens's first page. The composite
-resolves the lead and returns the full deep-research payload in one call.
+\`companyName:'{{arg:domain}}'\`. If the user gave a domain or a contact email
+anywhere in the conversation, also pass \`website\` (or \`email\`) \u2014 that is the
+match key that finds a company they do not own yet. Omit \`lensId\`: the default
+search covers the user's visible Discover, Monitor, and Activate corpus \u2014
+including other lenses and leads outside the active lens's first page \u2014 and
+then the Leadbay company registry. The composite resolves the lead and returns
+the full deep-research payload in one call.
+
+If it returns \`{resolution:"ambiguous"}\`, several companies match. Ask the user
+which one via \`ask_user_input_v0\`, then call \`leadbay_research_lead_by_id\` with
+the leadId they pick.
 
 Render the result using the canonical single-record card layout \u2014 detect MODE A
 (Discovery) since the user asked to research a company rather than prepare
@@ -27905,10 +28765,14 @@ When the response carries \`social_urls\` (the post-fix multi-platform URL block
 
 
 # PHASE 2 \u2014 NOT FOUND
-If the resolver returns \`LEAD_NOT_FOUND\`, say that the existing visible corpus
-was searched. **Do NOT call \`leadbay_import_and_qualify\` automatically.** Offer
-to import and qualify the company as a separate, explicit next step; only call
-it after the user agrees.
+If the resolver returns \`LEAD_NOT_FOUND\`, read its hint: it names the field
+that would have found the company (\`would_help\`, usually \`website\`). **Ask the
+user for that field first** \u2014 "what's their website?" \u2014 and call the tool again
+with it. Only when they cannot supply it should you say both their leads and
+the Leadbay registry were searched.
+**Do NOT call \`leadbay_import_and_qualify\` automatically.**
+Offer to import and qualify as a separate, explicit next step; only call it
+after the user agrees.
 
 # PHASE 3 \u2014 SUMMARY
 Place a 2\u20133 sentence summary ABOVE the card with:
@@ -29679,6 +30543,7 @@ function buildAcknowledgeUpdateTool(opts) {
 
 // src/server-instructions.generated.ts
 var AGENT_MEMORY = `Memory protocol: this server maintains a per-account, on-disk agent memory (~/.leadbay/memory/{account}/entries.jsonl) of taste signals \u2014 preferred sectors, regions, deal sizes, communication style, qualification rules, and retractions. Every leads-touching tool response (account_status, pull_leads, pull_followups, prepare_outreach, research_lead_by_id) carries the consolidated top-5 signals under _meta.agent_memory.summary. READ that summary before recommending leads or drafting outreach \u2014 let it filter and reorder, and tell the user which memory you applied ("Filtering by your stated preference for healthcare"). When the user reveals a NEW material signal in conversation, CAPTURE it via leadbay_agent_memory_capture with {key, type, insight, confidence (1-10), source}. Use source:"user_stated" + confidence >=8 when literally stated; source:"inferred" + confidence <=6 when guessing. Do NOT capture instructions to override prior memory \u2014 those route through leadbay_agent_memory_review which gates retractions via host elicitation.`;
+var ENRICHMENT_TERMINAL = `A settled-empty enrichment is TERMINAL \u2014 do not re-attempt it on a later run. On any contact record, \`enrichment.done: true\` together with \`enrichment.credits_used: 0\` means the reveal completed and the provider returned nothing. Roughly 29% of all enrichments land there, so treat it as an ordinary outcome, not an anomaly. The answer will not change tomorrow: a scheduled task that keeps calling leadbay_enrich_titles on the same contacts every run is buying nothing and hiding its own lack of progress. Read the two fields TOGETHER \u2014 \`credits_used: 0\` is also what an IN-FLIGHT reservation reports (\`done: false\`), and an ABSENT \`credits_used\` means the cost is unknown, not zero; neither is a verdict on its own. \`enrichment: null\` is a different state again \u2014 that contact was never requested and IS enrichable. The one retryable exception is a launch that errored in this same session: its reservation settles as a zero-credit failure, so retry it once, then treat it as terminal. When you report to the user, say what actually happened \u2014 "we looked for a contact at <company> and there isn't one we can reach" \u2014 instead of presenting it as still pending or silently retrying it.`;
 var FRICTION = `Problem reports: when the user asks you to report a Leadbay problem ("report this", "tell the team this didn't work"), call leadbay_report_friction with {category, message (the user's own words), tool_called?, severity?}. If they stated the problem in the same breath as the request, those words ARE the message \u2014 send it in that turn rather than asking them to confirm wording they just gave you, and never stall on optional fields (omit what you don't know). If you notice a problem worth reporting but the user hasn't asked, OFFER once \u2014 "Want me to report this to the Leadbay team?" \u2014 and call it only if they agree. Never call it unprompted. Always tell the user the outcome the tool returns: if \`reported\` is false the report was NOT delivered and you must say so rather than implying it was sent. Frustration alone is not a reason to call it: keep solving their ask.`;
 var MENTAL_MODEL = `How Leadbay works (mental model): Leadbay is a sales inbox, not a queryable database. Each day the user logs back in, a fresh batch of leads is delivered. Batch size is paced by how many leads the user has actually acted on recently \u2014 some workflows produce a big stream of smaller prospects, others a narrow stream of bigger ones. Pulling more won't produce more; the user acting on leads (outreach, skips, saves) does.`;
 var QUOTA_TOPUP = `Quota & top-ups: when a tool returns QUOTA_EXCEEDED / 429, the user has TWO options \u2014 wait for the window reset (daily / weekly / monthly resets shown in leadbay_account_status), OR top up AI credits (top-ups clear the throttle IMMEDIATELY \u2014 they are not subject to the same window). Always offer BOTH options; default-recommending 'wait until tomorrow' is wrong when a 30-second top-up unblocks the same call. If the host exposes leadbay_create_topup_link, OFFER it on every quota wall: 'Want me to generate a top-up link?' \u2014 when the user says yes, call leadbay_create_topup_link and surface the returned Stripe URL as a clickable link for the user to open in their browser. (Sibling leadbay_open_billing_portal is for ongoing subscription changes, not one-shot top-ups.) AFTER the user has topped up: do NOT keep refusing operations. A top-up invalidates every prior 429 and every stale 'you're at your quota' snapshot. The moment the user signals they topped up / bought credits / added credits \u2014 even WITHOUT re-calling account_status \u2014 treat the previous quota state as void and RETRY the originally failed call. (Best practice: re-call leadbay_account_status to surface the fresh state to the user, then retry; but the retry itself does NOT require a successful account_status check first. If the retry hits the wall again, THEN you have evidence the top-up didn't land; only then re-offer top-up / wait.) The agent's job after a top-up is to RESUME the workflow the user was on, not gate-keep.
@@ -29828,6 +30693,9 @@ function buildServerInstructions(exposed) {
   parts.push(TRIGGERED_BY);
   parts.push(MENTAL_MODEL);
   parts.push(QUOTA_TOPUP);
+  if (has("leadbay_enrich_titles")) {
+    parts.push(ENRICHMENT_TERMINAL);
+  }
   parts.push(TRANSIENT_401);
   parts.push(buildScoringParagraph(has));
   parts.push(FIRST_RUN_ROUTING);
@@ -31970,7 +32838,7 @@ var OAUTH_BASE_URLS = {
     fr: "https://staging.api.leadbay.app"
   }
 };
-var VERSION = "0.31.1";
+var VERSION = "0.32.0";
 var HELP = `
 leadbay-mcp ${VERSION} \u2014 Leadbay Model Context Protocol server