@leadbay/mcp 0.37.0 → 0.38.1

package/dist/bin.js

@@ -434,7 +434,7 @@ var init_client = __esm({
       // Cancelled while queued — nothing was ever put on the wire, which is what
       // makes this safe to report as "not sent" even for a write.
       cancelledBeforeSendError() {
-        return this.makeError("REQUEST_CANCELLED", "The request was cancelled before it was sent.", "Re-call the tool if you still want the result \u2014 nothing reached the API, so nothing was charged.");
+        return this.makeError("REQUEST_CANCELLED", "The request was cancelled before it was sent.", "Re-call the tool if you still want the result \u2014 nothing reached the API, so nothing ran.");
       }
       releaseSemaphore() {
         this.activeRequests--;
@@ -774,6 +774,11 @@ var init_client = __esm({
         if (status === 401) {
           return this.makeError("AUTH_EXPIRED", "Leadbay rejected this request (401)", retried ? "Tokens don't expire on a timer, so this isn't stale. Already auto-retried once and it 401'd again \u2014 usually a Leadbay-side hiccup, but can also mean the user logged out. Try again shortly, else report it." : "Tokens don't expire on a timer, so this isn't stale. This call wasn't auto-retried, so it's the first attempt \u2014 a Leadbay-side hiccup, or the user logged out. Try again once, else report it.", endpoint, null, status);
         }
+        const refusalCode = typeof parsed?.error === "string" ? parsed.error : parsed?.error?.code;
+        if (status === 429 && (refusalCode === "rate_limited" || refusalCode === "active_job_cap") && /^\/mcp\/(search|qualify)(\?|$)/.test(endpoint)) {
+          const wait = retryAfter ? `${retryAfter}s` : "a few minutes";
+          return this.makeError("QUOTA_EXCEEDED", refusalCode === "rate_limited" ? `Too many lead jobs started this hour \u2014 retry in ${wait}` : "Too many lead jobs running at once", (refusalCode === "rate_limited" ? `Leadbay starts at most 10 new lead jobs per org in a rolling hour. ` : `Leadbay runs at most 3 lead jobs per org at a time. `) + `This is a pacing limit, not credits: a top-up does not lift it, so do not offer one and do not talk about credits. Jobs already started keep running \u2014 read them with leadbay_lead_job_status meanwhile. ` + (refusalCode === "rate_limited" ? `Wait ${wait}, then retry the same call once. If it is refused again, the hour has not rolled over yet: wait longer rather than retrying in a loop.` : `Retry this call when one of the running jobs finishes.`), endpoint, retryAfter, status);
+        }
         if (status === 429 || status === 402 || parsed?.error === "quota_exceeded" || parsed?.error?.code === "quota_exceeded") {
           const hintBase = retryAfter ? `Wait ${retryAfter}s before retrying` : "Wait, then retry";
           return this.makeError(
@@ -1599,7 +1604,7 @@ account resurfaced:
 `;
     leadbay_account_status = `## WHEN TO USE
 
-Trigger phrases: "what's my account status", "how much quota do I have", "what lens am I on", "I topped up / I bought credits / I added credits".
+Trigger phrases: "what's my account status", "how much quota do I have", "what lens am I on", "I topped up / I bought credits / I added credits", "what version of Leadbay am I running".
 
 Do NOT use for: "show me leads" \u2192 \`leadbay_pull_leads\`.
 
@@ -1608,6 +1613,7 @@ Prefer when: meta question about account, quota, active lens, or top-up recovery
 Examples that SHOULD invoke this tool:
 - "What's my account status?"
 - "How much quota do I have left this week?"
+- "Which version of the Leadbay connector is this?"
 
 Examples that should NOT invoke this tool (sound similar, route elsewhere):
 - "Show me today's leads."
@@ -1633,6 +1639,8 @@ Show the user's account state \u2014 admin rights, language, last-active lens, q
 
 **After a user tops up, do NOT keep refusing \u2014 RETRY.** If the user signals they topped up / bought credits / added credits, the previous QUOTA_EXCEEDED is invalidated the moment the Stripe webhook lands. RE-CALL \`leadbay_account_status\` to pick up the new state AND retry the originally failed call. The retry itself does not require a successful account_status check first \u2014 a topped-up user has cleared the throttle whether or not your cached snapshot reflects it yet. If the retry hits the wall again, only then re-offer top-up / wait. **A stale quota snapshot is never a reason to gate-keep a topped-up user.**
 
+**\`mcp_version\`** is the version of the Leadbay MCP server answering the call. When the user asks which Leadbay version they are running, answer with it.
+
 **\`notifications\` block.** The response now includes a top-level \`notifications\` array listing background work the user (or agent) initiated that has since completed (\`bulk_enrich\`, \`bulk_qualify\`, \`import\`). These are signals to revise prior agent outputs the just-finished work might have made stale \u2014 they're NOT a pending-task list for the user. After revising (or confirming nothing is affected), call \`leadbay_acknowledge_notification(notification_id)\`. Full handling protocol below.
 
 ## GATE \u2014 INSPECT \`_meta.notifications\` ON EVERY RESPONSE
@@ -1661,7 +1669,7 @@ Some Leadbay tool responses include a \`_meta.notifications\` array listing **ba
 
 - **Previous turn / before an MCP restart, and the user has NOT asked about it** \u2014 don't poll for it in the background. Simply continue the conversation; the next time you call any tool, the completed-work entry appears in \`_meta.notifications\` (also on \`leadbay_account_status.notifications\`). This is the ambient push path \u2014 leave it to do its job. **But if the user explicitly asks for status or to "wait for it to finish"** (e.g. a multi-turn flow where a job was launched in a prior turn and this turn says "wait for enrichment to finish, then \u2026"), DO poll its status tool now until done, exactly as for a this-turn job below \u2014 the ambient push only surfaces *completed* work, so it can't answer a live "is it done / wait for it" request while the job is still running.
 - **This turn (you just launched it)** \u2014 the DEFAULT is: do NOT end your turn on the "launched" ack; stay active and poll the job's status tool in a loop until it reports done, then report the finished result yourself, rather than spinning forever or deferring the result to a later turn. (Two exceptions, detailed below: the user explicitly asked NOT to wait / to run it in the background; or it's a large qualification/import that's async by design \u2014 in those cases hand back the handle instead of looping.) Each status tool has its OWN terminal signal \u2014 poll until:
-  - \`leadbay_bulk_enrich_status\` \u2192 \`all_done:true\` \u2014 OR \`overall_progress.done\` holds steady across several SPACED polls (~15\u201330s apart) over at least ~90s\u20132 min of elapsed time (some contacts are unresolvable, so \`all_done\` can stay false forever). Don't call a plateau from the first few back-to-back reads \u2014 early on \`done\` sits flat while the backend spins up. Once the plateau is real, report what resolved and name what didn't.
+  - \`leadbay_bulk_enrich_status\` \u2192 \`all_done:true\` \u2014 OR \`overall_progress.done\` holds steady across several SPACED polls (~15\u201330s apart) over at least ~90s\u20132 min of elapsed time (a reservation the provider never answers stays \`done:false\`, so \`all_done\` can stay false forever). Don't call a plateau from the first few back-to-back reads \u2014 early on \`done\` sits flat while the backend spins up. Once the plateau is real, report what resolved and name what didn't.
   - \`leadbay_qualify_status\` \u2192 \`still_running\` is empty: every launched lead has finished or failed. (\`in_progress\` also reads \`false\` on the fast path, but it can be \`null\` on the legacy/fallback read \u2014 so treat an empty \`still_running\` as terminal on its own; only require \`in_progress:false\` when that field is actually present.) LIKE imports, large qualification runs are async by design: \`leadbay_bulk_qualify_leads\` defaults to \`wait_for_completion:false\` for \`count > 5\` or chained workflows because blocking can time out, and \`leadbay_qualify_status\` may take minutes/hours. So don't force a long polling loop on a big run \u2014 return the handle/progress and let completion arrive via \`_meta.notifications\` \u2014 UNLESS the user explicitly asked to wait, or it's a small run that finishes quickly. A small \`wait_for_completion:true\` run you can poll to \`still_running\` empty inline.
   - \`leadbay_import_status\` \u2192 \`status:"complete"\` (or \`"failed"\`). BUT imports are the exception to the stay-active loop: a large \`leadbay_import_leads({wait_for_completion:false})\` is meant to return a handle and resolve over minutes, and the tool does ONE refresh pass per call. Don't block the conversation looping on it \u2014 surface the returned progress/handle and let the completion arrive via \`_meta.notifications\` \u2014 UNLESS the user explicitly asked you to wait for the import, or it's a small import that finishes quickly.
 
@@ -1742,7 +1750,7 @@ days"), computed against now \u2014 mirroring the widget's "r\xE9initialis\xE9 d
 raw value is an ISO-8601 timestamp.
 
 **Top-up (optional, subordinate).** When \`quota.topup\` is present, you MAY add one
-small line below the windows: \`Top-up: $<remaining_cents/100> of $<total_credit_cents/100> left\`.
+small line below the windows: \`Top-up: $<(remaining_cents / 100).toFixed(2)> of $<(total_credit_cents / 100).toFixed(2)> left\`.
 Keep it secondary \u2014 the three window gauges are the headline. Omit when null.
 
 **Legend** (once, below): \`\` \`\u25B0\` used \xB7 \`\u25B1\` remaining \`\`.
@@ -1974,7 +1982,7 @@ WHEN NOT TO USE: the user wants a plain data answer (route to leadbay_pull_leads
 `;
     leadbay_bulk_enrich_status = `Check status + per-lead contacts for a bulk enrichment you previously launched via leadbay_enrich_titles. Pass the \`notification_id\` for the job counters in one call, and/or the \`lead_ids\` + \`titles\` + \`email\` / \`phone\` the launch returned for per-lead progress. \`lead_ids\` alone is a valid call and is the reliable one: the job lookup is a scan of your recent notifications, so an archived job may not be found, and an enrichment notification does not always carry counters (then the tool answers \`ENRICH_JOB_NO_COUNTERS\` with the backend's running/finished flag and asks for \`lead_ids\`) \u2014 but the leads always answer. When \`include_contacts=true\` (opt-in), includes each contact's email/phone_number/job_title/enrichment.done.
 
-WHEN TO USE: poll this REPEATEDLY after leadbay_enrich_titles returns a \`notification_id\`, staying active until the job is done \u2014 don't stop after one check, and don't hand the turn back to the user while progress is still climbing. "Done" = \`all_done:true\`, OR \`overall_progress.done\` has held steady across several SPACED polls (~15\u201330s apart) over at least ~90s\u20132 min of elapsed time (some contacts are unresolvable and never flip, so \`all_done\` can stay false forever \u2014 don't spin indefinitely). Do NOT declare a plateau from the first few back-to-back reads: right after launch, \`overall_progress.done\` can sit flat while the backend is still spinning the job up, so space your polls out and give it real elapsed time before treating a flat count as terminal. Also do NOT declare a plateau while the result carries \`partial_failures\` \u2014 a flat \`done\` there means a transient per-lead fetch error (e.g. a 429), NOT an unresolvable contact; keep polling (respecting any \`retry_after\`) or surface it as a temporary status failure, rather than reporting those leads as permanently unresolved. Default \`include_contacts=false\` for the cheap interim polls; set \`include_contacts=true\` on the read you report from to pull each lead's enriched contacts for the completion report.
+WHEN TO USE: poll this REPEATEDLY after leadbay_enrich_titles returns a \`notification_id\`, staying active until the job is done \u2014 don't stop after one check, and don't hand the turn back to the user while progress is still climbing. "Done" = \`all_done:true\`, OR \`overall_progress.done\` has held steady across several SPACED polls (~15\u201330s apart) over at least ~90s\u20132 min of elapsed time (a reservation the provider never answers stays \`done:false\`, so \`all_done\` can stay false forever \u2014 don't spin indefinitely; a contact with nothing found does flip, to \`done:true\` with \`credits_used:0\`). Do NOT declare a plateau from the first few back-to-back reads: right after launch, \`overall_progress.done\` can sit flat while the backend is still spinning the job up, so space your polls out and give it real elapsed time before treating a flat count as terminal. Also do NOT declare a plateau while the result carries \`partial_failures\` \u2014 a flat \`done\` there means a transient per-lead fetch error (e.g. a 429), NOT an unresolvable contact; keep polling (respecting any \`retry_after\`) or surface it as a temporary status failure, rather than reporting those leads as permanently unresolved. Default \`include_contacts=false\` for the cheap interim polls; set \`include_contacts=true\` on the read you report from to pull each lead's enriched contacts for the completion report.
 
 WHEN NOT TO USE: as a substitute for leadbay_research_lead_by_id \u2014 that already includes enriched contacts for a single lead.
 
@@ -2008,17 +2016,17 @@ a launcher only for a subset that never started, never for the whole batch:
   that are the ones that never started. Only then call
   \`leadbay_bulk_qualify_leads({leadIds, lensId})\` for exactly those ids. A lead
   that is merely slow looks identical to one that never launched over a few
-  polls, and re-launching it charges the user twice \u2014 when unsure, tell the user
+  polls, and re-launching it uses the user's quota twice \u2014 when unsure, tell the user
   rather than guess.
 
 
-## QUOTA \u2014 show where the user stands after the spend
+## QUOTA \u2014 show where the user stands after the run
 
 Enrichment consumes QUOTA (the per-window allowance), not a separate credit wall. Once the job is done (all_done, or a plateau \u2014 see WHEN TO USE), show the user their refreshed quota: call \`leadbay_account_status\` and render the per-window quota it returns (the canonical surface). The result's \`credits_remaining\` field is **advisory internal context only \u2014 do NOT display it**: it comes from \`billing.ai_credits\` (a consumed counter, not remaining), so printing \`_(N credits remaining)_\` can show a fresh/quota-backed account a false "0 remaining." Never render a credits balance; the \`leadbay_account_status\` quota gauge is the only place the user's standing is shown. Do NOT report a "credits used" figure for this run either: the per-contact cost can't be scoped to this specific enrichment (a lead's contact list mixes in earlier runs), so any "X used" number would be misleading. Do the account_status refresh ONCE at completion \u2014 not on every in-progress poll.
 
 ## COMPLETION REPORT \u2014 what to tell the user when the job is done
 
-The result always carries \`overall_progress:{done,total,done_ratio}\` and, with \`include_contacts:true\`, \`leads[]\` each with contacts' \`email\` / \`phone_number\` / \`job_title\` / \`enrichment.done\`. \`bulk_progress:{total_count,success_count,failure_count,quota_hit_count}\` is present only when you passed a \`notification_id\` AND the job was found; derive counts from \`overall_progress\` rather than assuming \`bulk_progress\` is there. With \`lead_ids\`, each entry carries \`enrichment_progress:{done,total}\` \u2014 \`done\` counts only contacts whose REQUESTED channel has landed, scoped to the \`titles\` this run enriched, so a lead's pre-existing CFO email cannot inflate a CEO run. A contact counts as done only when the REQUESTED channel actually landed \u2014 for a phone run, \`enrichment.done:true\` with no \`phone_number\` is NOT done (the contact may have been email-enriched earlier); read \`email\` / \`phone_number\` against the requested channels, don't rely on the \`enrichment.done\` flag alone (\`overall_progress\` already accounts for this). \`include_contacts\` returns each lead's FULL contact list (it fans out through \`leadbay_get_contacts\`), so it can include contacts of other roles that were enriched in earlier runs \u2014 filter your report to the \`titles\` this bulk enriched (match each contact's \`job_title\`), don't attribute a pre-existing email of an unrelated role to this run. Report it yourself in the SAME turn, without a reprompt and without deferring to a scheduled re-check: name which of the just-enriched contacts now have emails / phones, the done/total counts, and \u2014 if \`bulk_progress\` is present \u2014 any \`quota_hit_count\` (if non-zero, say some contacts were skipped because the quota window was exhausted, and point to \`leadbay_account_status\` for the wait-or-top-up choice). If you stopped on a plateau (not \`all_done\`), say so plainly \u2014 report the resolved contacts and name the ones that didn't resolve, keyed to the requested channel and the returned fields (no \`email\` \u2192 "no email found"; no \`phone_number\` \u2192 "no phone number found") \u2014 rather than implying the job fully finished. Then show refreshed quota via \`leadbay_account_status\` (see QUOTA above); do NOT print a credits-remaining line.
+The result always carries \`overall_progress:{done,total,done_ratio}\` and, with \`include_contacts:true\`, \`leads[]\` each with contacts' \`email\` / \`phone_number\` / \`job_title\` / \`enrichment.done\`. \`bulk_progress:{total_count,success_count,failure_count,quota_hit_count}\` is present only when you passed a \`notification_id\` AND the job was found; derive counts from \`overall_progress\` rather than assuming \`bulk_progress\` is there. With \`lead_ids\`, each entry carries \`enrichment_progress:{done,total}\` \u2014 \`total\` counts the reservations this run made (scoped to the \`titles\` it enriched, and to reservations whose \`enrichment.email_requested\` / \`phone_requested\` match the \`email\` / \`phone\` you pass, so a lead's pre-existing CFO email cannot inflate a CEO run) and \`done\` counts those that have settled (\`enrichment.done:true\`, found or not). The \`enrichment\` record sits on the \`source:"paid"\` entry and never carries \`email\` / \`phone_number\`: the revealed values land on the same person's \`source:"org"\` entry (match on name and \`job_title\`). Read what landed from the org entries \u2014 an org entry with \`email\` = email found, with \`phone_number\` = phone found \u2014 and a settled paid entry with \`credits_used:0\` = nothing found for that person. \`include_contacts\` returns each lead's FULL contact list (it fans out through \`leadbay_get_contacts\`), so it can include contacts of other roles that were enriched in earlier runs \u2014 filter your report to the \`titles\` this bulk enriched (match each contact's \`job_title\`), don't attribute a pre-existing email of an unrelated role to this run. Report it yourself in the SAME turn, without a reprompt and without deferring to a scheduled re-check: name which of the just-enriched contacts now have emails / phones, the done/total counts, and \u2014 if \`bulk_progress\` is present \u2014 any \`quota_hit_count\` (if non-zero, say some contacts were skipped because the quota window was exhausted, and point to \`leadbay_account_status\` for the wait-or-top-up choice). If you stopped on a plateau (not \`all_done\`), say so plainly \u2014 report the resolved contacts and name the ones that didn't resolve, keyed to the requested channel and the returned fields (no \`email\` \u2192 "no email found"; no \`phone_number\` \u2192 "no phone number found") \u2014 rather than implying the job fully finished. Then show refreshed quota via \`leadbay_account_status\` (see QUOTA above); do NOT print a credits-remaining line.
 `;
     leadbay_bulk_qualify_leads = `Pick the next N unqualified leads in the active lens and qualify them (run AI rescore + web fetch). Pass \`wait_for_completion:false\` to return quickly with \`{status:'running', notification_id}\`; poll leadbay_qualify_status with that id. With \`wait_for_completion\` omitted/true, the legacy behavior polls until the answers are populated or a budget is exhausted. Already-qualified leads (those with a non-null \`ai_agent_lead_score\`) are silently no-ops on the backend, so this composite paginates past them to find fresh candidates. On 429 mid-fanout, stops launching but keeps polling already-launched leads.
 
@@ -2035,7 +2043,7 @@ WHEN NOT TO USE: to qualify a single specific lead \u2014 that's leadbay_qualify
 Leadbay has no cancel. Once \`leadbay_enrich_titles\`, \`leadbay_bulk_qualify_leads\`,
 \`leadbay_import_leads\` or \`leadbay_import_and_qualify\` has returned a launched or
 running result, that work is queued on Leadbay and runs to completion, and the
-quota it costs is already committed. A discovery, preview or \`dry_run\` result
+quota it uses is already committed. A discovery, preview or \`dry_run\` result
 launched nothing and is not covered here.
 
 The user cancelling in the chat, a request timeout, or a closed stream stops YOUR
@@ -2043,7 +2051,7 @@ waiting, never the job. \`cancelled: true\` means we stopped watching, not that
 work stopped. What to do next depends on what you are holding:
 
 - **A handle.** Poll the status tool with it, and do not launch the work that
-  handle covers a second time \u2014 that spends the quota again on the same rows.
+  handle covers a second time \u2014 that uses the quota again on the same rows.
   \`leadbay_import_status\` takes \`importIds\`, so pass the values of \`import_ids\`
   under that name. A qualification started by \`leadbay_import_and_qualify\` has no
   notification of its own: resume it with
@@ -2057,7 +2065,7 @@ work stopped. What to do next depends on what you are holding:
   finished. Calling the same tool again with the same arguments will usually hand
   back the job already launched rather than starting a second one, but that guard
   is in-memory, five minutes, and per process, so it is best-effort \u2014 say what you
-  are about to re-run before you spend the user's quota on it.
+  are about to re-run before you use the user's quota on it.
 
 
 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\`.
@@ -2547,18 +2555,18 @@ WHEN NOT TO USE: for bulk enrichment by job title across many leads \u2014 use l
 ## A launched job cannot be stopped, and this tool has no retry guard
 
 Leadbay has no cancel. Once this call returns having actually launched, the work
-is queued on Leadbay and runs to completion, and the quota it costs is already
-committed. A \`dry_run\` result reached no backend and spent nothing. The user
+is queued on Leadbay and runs to completion, and the quota it uses is already
+committed. A \`dry_run\` result reached no backend and used nothing. The user
 cancelling in the chat, a request timeout, or a closed stream stops YOUR waiting,
 never the job.
 
 Unlike the composite launchers, this tool has **no double-launch guard**: calling
-it again always issues a new paid launch, even seconds later with identical
+it again always issues a new launch that uses quota again, even seconds later with identical
 arguments. So when a call returns nothing at all, do not simply retry. Read the
 record back first \u2014 \`leadbay_research_lead_by_id\` or \`leadbay_get_contacts\` for a
 lead, \`leadbay_account_status\` for background work that has since finished \u2014 to
 see whether the launch already landed, and tell the user what you are about to
-spend before spending it again.
+run before running it again.
 
 
 ## QUOTA, NOT CREDITS
@@ -2569,7 +2577,7 @@ Enrichment is gated by QUOTA (the per-window allowance in \`leadbay_account_stat
 
 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_enrich_titles = `Order contact enrichments by job title across many leads. Contacts are NOT returned by default with a lead (Leadbay keeps enrichment out-of-band to control cost); the agent requests them on demand via this tool when it's ready to actually reach out. Two modes: (A) NO \`titles\` param \u2014 returns the available titles + Leadbay's \`title_suggestions\` + \`auto_included_titles\` + a count of enrichable contacts, so the agent can ask the user which titles to enrich. (B) \`titles\` given \u2014 calls preview, then launches if there's anything enrichable. On 429 returns \`{status:'quota_exceeded'}\` cleanly. Selection lifecycle is wrapped in a try/finally so the user's selection is left clean even on error.
+    leadbay_enrich_titles = `Order contact enrichments by job title across many leads. Contacts are NOT returned by default with a lead (Leadbay keeps enrichment out-of-band); the agent requests them on demand via this tool when it's ready to actually reach out. Two modes: (A) NO \`titles\` param \u2014 returns the available titles + Leadbay's \`title_suggestions\` + \`auto_included_titles\` + a count of enrichable contacts, so the agent can ask the user which titles to enrich. (B) \`titles\` given \u2014 calls preview, then launches if there's anything enrichable. On 429 returns \`{status:'quota_exceeded'}\` cleanly. Selection lifecycle is wrapped in a try/finally so the user's selection is left clean even on error.
 
 WHEN TO USE: as the agent's go-to enrichment entry point, immediately before proposing outreach.
 
@@ -2580,7 +2588,7 @@ WHEN NOT TO USE: to enrich a single named contact \u2014 that's leadbay_enrich_c
 Leadbay has no cancel. Once \`leadbay_enrich_titles\`, \`leadbay_bulk_qualify_leads\`,
 \`leadbay_import_leads\` or \`leadbay_import_and_qualify\` has returned a launched or
 running result, that work is queued on Leadbay and runs to completion, and the
-quota it costs is already committed. A discovery, preview or \`dry_run\` result
+quota it uses is already committed. A discovery, preview or \`dry_run\` result
 launched nothing and is not covered here.
 
 The user cancelling in the chat, a request timeout, or a closed stream stops YOUR
@@ -2588,7 +2596,7 @@ waiting, never the job. \`cancelled: true\` means we stopped watching, not that
 work stopped. What to do next depends on what you are holding:
 
 - **A handle.** Poll the status tool with it, and do not launch the work that
-  handle covers a second time \u2014 that spends the quota again on the same rows.
+  handle covers a second time \u2014 that uses the quota again on the same rows.
   \`leadbay_import_status\` takes \`importIds\`, so pass the values of \`import_ids\`
   under that name. A qualification started by \`leadbay_import_and_qualify\` has no
   notification of its own: resume it with
@@ -2602,7 +2610,7 @@ work stopped. What to do next depends on what you are holding:
   finished. Calling the same tool again with the same arguments will usually hand
   back the job already launched rather than starting a second one, but that guard
   is in-memory, five minutes, and per process, so it is best-effort \u2014 say what you
-  are about to re-run before you spend the user's quota on it.
+  are about to re-run before you use the user's quota on it.
 
 
 ## ENRICHMENT CONSUMES QUOTA \u2014 the model to reason with
@@ -2611,17 +2619,17 @@ Each email reveal and each phone reveal **consumes quota** (the per-window daily
 
 ## CONSENT \u2014 email is the default channel; phone is opt-in; never launch silently
 
-The \`email\` channel defaults **ON**; \`phone\` defaults **OFF**. A bare "enrich these titles" is **NOT** consent to spend quota.
+The \`email\` channel defaults **ON**; \`phone\` defaults **OFF**. A bare "enrich these titles" is **NOT** consent to use quota.
 
 **When the user asks to enrich without naming channels, ASK which channels via \`ask_user_input_v0\`** \u2014 email is included by default, so the real question is whether to add phone: \`"Enrich email only, or email + phone? (phone reveals use more quota)"\` \u2192 \`["Email only", "Email + phone"]\`. Then launch with the chosen channels (\`email:true\` always; \`phone:true\` if they picked email + phone). Only skip this question if the user already named the channel(s) explicitly ("just emails", "get their phone numbers too", etc.).
 
-**To preview with ZERO spend risk on ANY host, pass \`dry_run:true\`** (or \`confirm:false\`). Either returns \`enrichable_contacts\` + the \`would_launch\` channels and launches nothing \u2014 guaranteed, regardless of host. Use this as your first call. Then surface the volume, get the user's explicit go-ahead (and channel choice, above), and re-call with \`confirm:true\` (and explicit \`email:true\`/\`phone:true\` for the channels they chose) to launch.
+**To preview with nothing launched on ANY host, pass \`dry_run:true\`** (or \`confirm:false\`). Either returns \`enrichable_contacts\` + the \`would_launch\` channels and launches nothing \u2014 guaranteed, regardless of host. Use this as your first call. Then surface the volume, get the user's explicit go-ahead (and channel choice, above), and re-call with \`confirm:true\` (and explicit \`email:true\`/\`phone:true\` for the channels they chose) to launch.
 
-Do NOT rely on a bare call (no \`confirm\`, no \`dry_run\`, no channels) as a "safe preview": on an elicitation-capable host it asks the user and withholds on decline (\`mode:"needs_confirmation"\`), but on a host WITHOUT elicitation (some direct/embedded callers) a bare call launches the default email spend directly. If you're unsure whether the host can elicit, use \`dry_run:true\`/\`confirm:false\` for the preview. Passing \`email:true\`/\`phone:true\` (or \`confirm:true\`) always counts as consent and launches.
+Do NOT rely on a bare call (no \`confirm\`, no \`dry_run\`, no channels) as a "safe preview": on an elicitation-capable host it asks the user and withholds on decline (\`mode:"needs_confirmation"\`), but on a host WITHOUT elicitation (some direct/embedded callers) a bare call launches the default email reveal directly. If you're unsure whether the host can elicit, use \`dry_run:true\`/\`confirm:false\` for the preview. Passing \`email:true\`/\`phone:true\` (or \`confirm:true\`) always counts as consent and launches.
 
 ## SHOW WHAT WILL RUN, AND WHERE QUOTA STANDS
 
-**BEFORE (confirm before launching).** The discover / preview_only / dry_run modes return \`enrichable_contacts\` (the volume that would be enriched). Tell the user plainly: **"This will enrich {enrichable_contacts} contacts (email + phone reveals consume quota)."** then confirm the channels + go-ahead via \`ask_user_input_v0\` before launching. Do NOT quote an exact cost or a "credits" figure \u2014 the per-reveal rate is backend-side and enrichment is gated by quota, not a credit balance. The \`credits_remaining\` field is advisory context only; never present it as a spend gate and never refuse based on it.
+**BEFORE (confirm before launching).** The discover / preview_only / dry_run modes return \`enrichable_contacts\` (the volume that would be enriched). Tell the user plainly: **"This will enrich {enrichable_contacts} contacts (email + phone reveals consume quota)."** then confirm the channels + go-ahead via \`ask_user_input_v0\` before launching. Do NOT quote an exact cost or a "credits" figure \u2014 the per-reveal rate is backend-side and enrichment is gated by quota, not a credit balance. The \`credits_remaining\` field is advisory context only; never present it as a gate and never refuse based on it.
 
 **AFTER (show refreshed quota).** Once the job is done (see the STAY ACTIVE section below), call \`leadbay_account_status\` and show the refreshed per-window quota \u2014 the canonical surface \u2014 so the user sees the usage they just consumed. Do NOT invent a "credits used" figure for the run (per-run cost can't be scoped reliably \u2014 a lead's contacts mix earlier enrichments).
 
@@ -2629,7 +2637,7 @@ Do NOT rely on a bare call (no \`confirm\`, no \`dry_run\`, no channels) as a "s
 
 When a launch returns \`mode:"launched"\` with a \`notification_id\`, the enrichment runs ASYNC on the backend \u2014 the tool returns immediately, before any email/phone is attached. **Unless the user explicitly said to start it in the background / not to wait** (e.g. "kick it off, I'll check later", "don't wait for it"), stay active and report in-turn \u2014 do NOT end your turn on the ack, and do NOT say "I'll let you know when it's done." (If the user DID ask you not to wait, honor that: hand back the \`notification_id\` and a one-line "running \u2014 you can ask any time". Only promise that completion will auto-surface via \`_meta.notifications\` when the launch returned a non-null \`notification_id\`; if \`notification_id\` is null (the nullable-backend path), say instead that you'll re-check when asked / they should ask again later \u2014 nothing surfaces automatically without a notification id. Don't force a poll loop against explicit intent.) In the default (stay-active) case: call \`leadbay_bulk_enrich_status({notification_id})\` in a loop, re-polling until the job is done (small batches typically finish in under ~2 min). Pass \`include_contacts:true\` on the read you intend to report from, so you get each lead's enriched contacts back. Note that \`include_contacts\` returns each lead's FULL contact list (it fans out through \`leadbay_get_contacts\`), which can include contacts of OTHER roles that were already enriched in earlier runs \u2014 so **filter your report to the \`titles\` you just enriched** (match each contact's \`job_title\` to the requested titles). Don't present a pre-existing CFO/Sales email as part of this CEO/Owner/Manager run. Then \u2014 on your own, without waiting for the user to reprompt \u2014 report the enrichment: which of the just-enriched contacts now have emails / phones, and the counts from \`overall_progress\` (\`done\`/\`total\`). \`leadbay_bulk_enrich_status\` also returns \`bulk_progress.success_count\` / \`failure_count\` / \`quota_hit_count\` on the notification fast path \u2014 use those when present, but the per-lead path returns \`overall_progress\` only, so don't assume \`bulk_progress\` exists (see the status tool's COMPLETION REPORT). Then show refreshed quota via \`leadbay_account_status\` (see AFTER above).
 
-**"Done" = \`all_done:true\` OR the resolvable work has plateaued.** Keep polling while \`overall_progress.done\` is still climbing. But \`total\` counts every matching contact, and some (unresolvable titles, contacts with no findable email) never flip to done \u2014 so a job can sit below 100% with \`all_done:false\` forever. A plateau is only real once the job has had time to run: do NOT declare it from the first few back-to-back reads (early on \`done\` can sit at its initial value while the backend is still spinning the job up). Give it at least ~90s\u20132 min of actual elapsed polling \u2014 space your polls out (~15\u201330s apart) rather than firing them back-to-back \u2014 and only treat the set as complete when \`overall_progress.done\` has held steady across several spaced polls over that window. Then stop polling and report what resolved, naming the ones that didn't. Key the "didn't resolve" wording off the channels the user actually requested and the returned contact fields (contacts carry \`email\` and \`phone_number\`) \u2014 a contact enriched for phone that came back with no \`phone_number\` is "no phone number found", one with no \`email\` is "no email found", email+phone that got neither is "no contact details found"; if \`quota_hit_count\` is non-zero say those were skipped because the quota window was exhausted. Do NOT hard-label every non-success as "no email found" when phone was requested. Do NOT spin indefinitely waiting for \`all_done\` on contacts the engine won't resolve, and do NOT \`ScheduleWakeup\` / defer the finished list to a later turn \u2014 deliver the resolved results in THIS reply.
+**"Done" = \`all_done:true\` OR the resolvable work has plateaued.** Keep polling while \`overall_progress.done\` is still climbing. But a reservation the provider never answers stays \`done:false\` \u2014 so a job can sit below 100% with \`all_done:false\` forever (a contact with no findable email does flip, to \`done:true\` with \`credits_used:0\`). A plateau is only real once the job has had time to run: do NOT declare it from the first few back-to-back reads (early on \`done\` can sit at its initial value while the backend is still spinning the job up). Give it at least ~90s\u20132 min of actual elapsed polling \u2014 space your polls out (~15\u201330s apart) rather than firing them back-to-back \u2014 and only treat the set as complete when \`overall_progress.done\` has held steady across several spaced polls over that window. Then stop polling and report what resolved, naming the ones that didn't. Key the "didn't resolve" wording off the channels the user actually requested and the returned contact fields (contacts carry \`email\` and \`phone_number\`) \u2014 a contact enriched for phone that came back with no \`phone_number\` is "no phone number found", one with no \`email\` is "no email found", email+phone that got neither is "no contact details found"; if \`quota_hit_count\` is non-zero say those were skipped because the quota window was exhausted. Do NOT hard-label every non-success as "no email found" when phone was requested. Do NOT spin indefinitely waiting for \`all_done\` on contacts the engine won't resolve, and do NOT \`ScheduleWakeup\` / defer the finished list to a later turn \u2014 deliver the resolved results in THIS reply.
 
 The \`_meta.notifications\` push is the FALLBACK for a job launched in an EARLIER turn or across an MCP restart \u2014 it is NOT a reason to stop early on a job you just launched this turn.
 
@@ -2771,8 +2779,8 @@ Examples that should NOT invoke this tool (sound similar, route elsewhere):
 
 3-col table of delivered leads in returned order: col 1 = 10-segment fit
 bar + linked company \xB7 location \xB7 size; col 2 = why-fits \u226420 words; col 3
-= contact + purchased channels. ALWAYS close with the honest funnel line
-(matched/examined/delivered/stop reason/spend) \u2014 especially on 0
+= contact + found channels. ALWAYS close with the honest funnel line
+(matched/examined/delivered/stop reason) \u2014 especially on 0
 delivered. Full algorithm below.
 
 ---
@@ -2780,19 +2788,19 @@ delivered. Full algorithm below.
 Submit a net-new lead search: the backend matches an ICP seed against the full
 company universe, applies hard filters, skips what the org already knows
 (\`novelty: org\`), optionally qualifies against the org's own intelligence
-(questions, tags, ideal buyer profile \u2014 frozen at submit), and optionally buys
+(questions, tags, ideal buyer profile \u2014 frozen at submit), and optionally reveals
 contact channels. Polls up to \`wait_seconds\` (default 45); a longer job returns
 \`still_running\` + \`next_poll\` \u2014 hand off to \`leadbay_lead_job_status\`. Jobs run
 \u226430 min, results kept 30 days.
 
-**Free vs paid \u2014 never spend silently.** Default (\`qualify: false\`,
+**Free vs usage quota \u2014 never use quota silently.** Default (\`qualify: false\`,
 \`channels: []\`) is FREE: company profile + fit score + cached research +
-contact identity. Paid: \`qualify: true\` (~94 cost_cents per candidate
-EXAMINED, capped by \`exploration_cap\`/\`max_cost\`) and \`channels\` (email 25c /
-phone 250c, success-only). Enforced in code: a paid call is WITHHELD unless it
+contact identity. \`qualify: true\` (per candidate EXAMINED, capped by
+\`exploration_cap\`/\`max_cost\`) and \`channels\` (only when a value is found) draw
+on the org's usage quota; nothing is invoiced. Enforced in code: such a call is WITHHELD unless it
 carries \`confirm: true\` \u2014 nothing is submitted and you get
 \`mode: "needs_confirmation"\` with a real quote to show the user. Re-call with
-\`confirm: true\` on their go-ahead ("spend / get their emails" counts).
+\`confirm: true\` on their go-ahead ("go ahead / get their emails" counts).
 \`confirm: false\` vetoes. Free needs no consent. **Preview free first** \u2014
 reshaping an off-profile seed is free, exploring it with \`qualify: true\` is
 not.
@@ -2800,7 +2808,7 @@ not.
 **Ad-hoc exclusions ("no chains") are enforced by NO tier** \u2014 \`filters\` has no
 exclusion key, and \`qualify\` scores against the org's FROZEN questions and IBP,
 which need not mention chains; the seed's inverse only shifts ranking.
-Violators can survive, be paid for and be delivered \u2014 post-filter them yourself
+Violators can survive, use quota and be delivered \u2014 post-filter them yourself
 and say the tier didn't enforce it. Durable enforcement \u2192
 \`leadbay_refine_prompt\`.
 
@@ -2847,9 +2855,9 @@ measured:
 
 **Parameter notes**
 - \`request_id\` (REQUIRED) is the retry contract: SAME value retrying the same
-  ask (same live job, no double spend); NEW for a changed ask. Derive from ask
+  ask (same live job, no double launch); NEW for a changed ask. Derive from ask
   + archetype + date: \`gyms-dallas-2026-07-28\`.
-- Never lower \`min_ai_score\` together with \`channels\` \u2014 that buys emails for
+- Never lower \`min_ai_score\` together with \`channels\` \u2014 that reveals emails for
   leads the AI just scored as junk.
 - \`count\` \u2264 50; \u22643 active jobs/org; \u226410 submits/hour (429 + Retry-After \u2014
   wait, don't hammer).
@@ -2889,7 +2897,7 @@ when nothing was delivered.
 **Column 3 \u2014 Contact**
 
 - \`[Name](linkedin) \xB7 role\` (linked name mandatory when a LinkedIn URL
-  exists; plain name otherwise). Below it, the PURCHASED channels only:
+  exists; plain name otherwise). Below it, the FOUND channels only:
   \`\u2709 value\` / \`\u260E value\` inline as plain text (they auto-linkify).
 - Channel statuses: \`delivered\` \u2192 show value; \`already_owned\` \u2192 value +
   *(already yours)*; \`masked\` \u2192 "on file \u2014 reveal via channels";
@@ -2900,16 +2908,17 @@ when nothing was delivered.
 
 **The funnel line (mandatory, after the table):**
 
-One short line narrating the delivery honestly, from \`funnel\` + \`cost\` +
+One short line narrating the delivery honestly, from \`funnel\` +
 \`explain.scope_notes\`:
 
 > Matched N \xB7 examined E \xB7 qualified Q \xB7 disqualified D \u2192 **delivered X of
-> the Y asked** \xB7 stopped: <stop_reason in plain words> \xB7 spent C.CC.
+> the Y asked** \xB7 stopped: <stop_reason in plain words>.
 
-**Money: divide, then symbol.** Every amount (\`cost.spent\`,
-\`estimated_cost.max\`, quotes) is \`cost_cents\` \u2014 divide by 100, two decimals,
-so \`165\` renders \`1.65\`, NEVER \`165.00\`. Symbol from the account region: US
-\`$\`, France \`\u20AC\`, unknown \u2192 bare. Never hard-code \`$\`: it misstates a charge.
+**No money, anywhere.** \`cost.*\`, \`estimated_cost.max\` and quotes are internal
+usage units. Never render them, never convert them to a currency, never call
+them a charge: the user's plan or top-up covers this work, and a price reads as
+a bill. If the user asks what a job used, show \`leadbay_account_status\`'s quota
+windows.
 
 "of the Y asked" needs \`summary.items_requested\`, which submits carry but a
 later \`leadbay_lead_job_status\` snapshot does not. Without it write **delivered
@@ -2917,7 +2926,7 @@ X** and stop \u2014 never back-fill Y from \`matched\`/\`examined\` (they count
 candidates), never guess it.
 
 Plain-word stop reasons: \`target_reached\` \u2192 omit (success), \`pool_exhausted\` \u2192
-"ran out of matching candidates", \`max_cost\` \u2192 "hit the cost cap", \`quota\` \u2192
+"ran out of matching candidates", \`max_cost\` \u2192 "hit the job's usage cap", \`quota\` \u2192
 "hit an org quota", \`time_budget\` \u2192 "hit the 30-min time budget".
 
 **When \`delivered\` is 0**: NEVER say just "no results". Render no table; give
@@ -2942,7 +2951,7 @@ table \`Ref \u2192 Outcome\` translating \`status_reason\` to plain words:
 \`low_confidence_identity\` \u2192 "couldn't safely match \u2014 check \`resolution.alternatives\`",
 \`no_matching_contact\` \u2192 "no contact with the requested title",
 \`disqualified\` \u2192 "evaluated: does not fit" (evidence is in the item when owned),
-\`enrichment_failed\` \u2192 "channel could not be sourced (not billed)".
+\`enrichment_failed\` \u2192 "channel could not be sourced (no quota used)".
 
 **\`items_truncated\`**: rows are a PREFIX, not the batch. Say so, and offer
 \`leadbay_lead_job_status(job_id, since: next_since)\` for the rest.
@@ -2991,10 +3000,10 @@ Pick the 2-3 options that match what actually happened \u2014 never all seven:
 | Observation | Suggest | Calls |
 |---|---|---|
 | Job still running (\`still_running: true\`) | "Check on it in ~1 min" | leadbay_lead_job_status(job_id, wait_seconds: 60) |
-| Free run delivered on-profile leads | "Qualify these N against your criteria (paid \u2014 \`dry_run\` first)" | leadbay_qualify_leads(prior_deliveries: {job_id}) |
+| Free run delivered on-profile leads | "Qualify these N against your criteria (uses quota \u2014 \`dry_run\` first)" | leadbay_qualify_leads(prior_deliveries: {job_id}) |
 | Delivered leads look right | "Draft outreach for the top ones" | leadbay_prepare_outreach |
 | Delivered 0 or off-profile | "Reshape the example and retry" (name the fix from funnel + scope_notes) | leadbay_find_new_leads (NEW request_id) |
-| Stopped at cost cap (\`stop_reason: max_cost\`) | "Raise the cap to X and get the remaining N" \u2014 X in the account's currency per the funnel-line rule, never a hard-coded \`$\` | leadbay_find_new_leads, NEW request_id (same-id only dedupes onto a LIVE job) + higher max_cost + \`count\` = the SHORTFALL (\`items_requested\` \u2212 delivered), not the original + \`exclude_lead_ids\` = the examined-but-REJECTED ids (novelty covers delivered; these are what it misses \u2014 without them the rerun re-buys the same losers) |
+| Stopped at the job's usage cap (\`stop_reason: max_cost\`) | "Raise the job's cap and get the remaining N" \u2014 no amount, no currency | leadbay_find_new_leads, NEW request_id (same-id only dedupes onto a LIVE job) + higher max_cost + \`count\` = the SHORTFALL (\`items_requested\` \u2212 delivered), not the original + \`exclude_lead_ids\` = the examined-but-REJECTED ids (novelty covers delivered; these are what it misses \u2014 without them the rerun re-buys the same losers) |
 | Stopped on org quota (\`stop_reason: quota\`) | "Check which window is exhausted and when it resets" \u2014 never a re-run: it cannot clear an org quota and burns a submit slot to stop in the same place | leadbay_account_status |
 | Stopped on org quota and the user does not want to wait | "Top up to finish this run" | leadbay_create_topup_link |
 | User wants these tracked in Leadbay | "Add the keepers to a campaign" | leadbay_create_campaign / leadbay_add_leads_to_campaign |
@@ -3484,7 +3493,7 @@ Per step: \`gate_label\` / \`gate_description\` are the widget's forward option,
 | 1 | Check my account | \`leadbay_account_status\` (no args) |
 | 2 | Pull today's leads | \`leadbay_pull_leads\` (no args) |
 | 3 | Draft the first email | \`leadbay_prepare_outreach\` \u2014 \`leadId\` ONLY, never \`enrich\` |
-| 4 | Find who to email | \`leadbay_enrich_titles\` \u2014 free preview, then a consented paid reveal |
+| 4 | Find who to email | \`leadbay_enrich_titles\` \u2014 free preview, then a reveal on consent |
 
 Steps 1, 2 and 3 carry \`branches[]\`, and steps 3 and 4 carry \`spend\` (+ \`quota_note\` on 4). Every step also carries \`explain\` (say this BEFORE firing) and \`next_steps\` (\`{question, options[]}\` \u2014 already the widget's shape, map it verbatim).
 
@@ -3496,9 +3505,9 @@ The manifest also carries **\`keep_going\`**: the closing cheat-sheet of *what y
 
 **Step 1 shows the real account, and is silent about two things.** The click is labelled *check my account status*, so deliver it: user + org, then the **full quota windows** the way the web app renders them \u2014 Daily / Weekly / Monthly with a \`\u25B0\u25B1\` gauge, % used, $ spent against the cap, resets countdown, and the per-resource breakdown. Never raw "credits". But apply the silence gate first: when \`quota\` is null, \`quota_error\` is set, or the org has \`unlimited_credits\`, say **nothing** about quota \u2014 never mention a 401, never suggest logging in again (the token is fine, the same response just read their account), and never announce "unlimited". And **never volunteer the lens**: the response withholds it unless the user asked, so there is nothing to report and no other tool to reach for. Both are pinned regressions (WORKFLOWS #30 / #31).
 
-**Step 3 drafts, and spends nothing.** Call \`leadbay_prepare_outreach\` with \`leadId\` alone \u2014 **never \`enrich: true\`**, which launches a paid contact reveal off the back of a *draft* click. \`recommended_contact\` returns with \`email\`/\`phone\` null; that is expected, and it is the hook for step 4. Render through \`message_compose_v1\` (2\u20133 strategy-labelled variants), address it to the job TITLE \u2014 no name exists yet, and inventing one is fabrication \u2014 and never send it or offer to.
+**Step 3 drafts, and uses no quota.** Call \`leadbay_prepare_outreach\` with \`leadId\` alone \u2014 **never \`enrich: true\`**, which launches a contact reveal off the back of a *draft* click. \`recommended_contact\` returns with \`email\`/\`phone\` null; that is expected, and it is the hook for step 4. Render through \`message_compose_v1\` (2\u20133 strategy-labelled variants), address it to the job TITLE \u2014 no name exists yet, and inventing one is fabrication \u2014 and never send it or offer to.
 
-**Step 4 runs in two beats \u2014 free first, paid only on consent.** Scoped to the ONE lead step 3 drafted for. Beat 1 omits \`titles\` and returns \`mode:"discover"\`, the free list of job titles at that company; say plainly that nothing has been spent. Beat 2 names the title the draft is addressed to, states the cost BEFORE they decide (one contact, one credit), and only on confirmation calls again with \`titles\` + \`confirm:true\` + \`email:true\` \u2014 polled via \`leadbay_bulk_enrich_status\` until done, reporting only what actually resolved. The gate click bought the free look, not the reveal: never launch without an explicit confirm.
+**Step 4 runs in two beats \u2014 free first, the reveal only on consent.** Scoped to the ONE lead step 3 drafted for. Beat 1 omits \`titles\` and returns \`mode:"discover"\`, the free list of job titles at that company; say plainly that nothing has run yet. Beat 2 names the title the draft is addressed to, says BEFORE they decide that revealing one contact uses a little of their plan's quota (no amount, no price), and only on confirmation calls again with \`titles\` + \`confirm:true\` + \`email:true\` \u2014 polled via \`leadbay_bulk_enrich_status\` until done, reporting only what actually resolved. The gate click bought the free look, not the reveal: never launch without an explicit confirm.
 
 ## Empty first batch is normal, not an error
 
@@ -3535,7 +3544,7 @@ WHEN NOT TO USE: discovery (use leadbay_pull_leads); single-lead deep dive (use
 Leadbay has no cancel. Once \`leadbay_enrich_titles\`, \`leadbay_bulk_qualify_leads\`,
 \`leadbay_import_leads\` or \`leadbay_import_and_qualify\` has returned a launched or
 running result, that work is queued on Leadbay and runs to completion, and the
-quota it costs is already committed. A discovery, preview or \`dry_run\` result
+quota it uses is already committed. A discovery, preview or \`dry_run\` result
 launched nothing and is not covered here.
 
 The user cancelling in the chat, a request timeout, or a closed stream stops YOUR
@@ -3543,7 +3552,7 @@ waiting, never the job. \`cancelled: true\` means we stopped watching, not that
 work stopped. What to do next depends on what you are holding:
 
 - **A handle.** Poll the status tool with it, and do not launch the work that
-  handle covers a second time \u2014 that spends the quota again on the same rows.
+  handle covers a second time \u2014 that uses the quota again on the same rows.
   \`leadbay_import_status\` takes \`importIds\`, so pass the values of \`import_ids\`
   under that name. A qualification started by \`leadbay_import_and_qualify\` has no
   notification of its own: resume it with
@@ -3557,7 +3566,7 @@ work stopped. What to do next depends on what you are holding:
   finished. Calling the same tool again with the same arguments will usually hand
   back the job already launched rather than starting a second one, but that guard
   is in-memory, five minutes, and per process, so it is best-effort \u2014 say what you
-  are about to re-run before you spend the user's quota on it.
+  are about to re-run before you use the user's quota on it.
 
 
 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[]\`, plus the ids that resume it: \`lead_ids\` + \`lens_id\` for leadbay_qualify_status, \`import_ids\` for leadbay_import_status. There is no qualification \`notification_id\` \u2014 the qualify phase runs per-lead, so no job notification exists; \`notification_ids[]\` are the file-import ones. Idempotent within a 5-min window. \`dry_run:'preview'\` returns mapping hints + custom-field candidates without importing.
@@ -3780,7 +3789,7 @@ a launcher only for a subset that never started, never for the whole batch:
   that are the ones that never started. Only then call
   \`leadbay_bulk_qualify_leads({leadIds, lensId})\` for exactly those ids. A lead
   that is merely slow looks identical to one that never launched over a few
-  polls, and re-launching it charges the user twice \u2014 when unsure, tell the user
+  polls, and re-launching it uses the user's quota twice \u2014 when unsure, tell the user
   rather than guess.
 
 
@@ -3847,18 +3856,18 @@ WHEN NOT TO USE: from agent flow \u2014 leadbay_enrich_titles handles selection
 ## A launched job cannot be stopped, and this tool has no retry guard
 
 Leadbay has no cancel. Once this call returns having actually launched, the work
-is queued on Leadbay and runs to completion, and the quota it costs is already
-committed. A \`dry_run\` result reached no backend and spent nothing. The user
+is queued on Leadbay and runs to completion, and the quota it uses is already
+committed. A \`dry_run\` result reached no backend and used nothing. The user
 cancelling in the chat, a request timeout, or a closed stream stops YOUR waiting,
 never the job.
 
 Unlike the composite launchers, this tool has **no double-launch guard**: calling
-it again always issues a new paid launch, even seconds later with identical
+it again always issues a new launch that uses quota again, even seconds later with identical
 arguments. So when a call returns nothing at all, do not simply retry. Read the
 record back first \u2014 \`leadbay_research_lead_by_id\` or \`leadbay_get_contacts\` for a
 lead, \`leadbay_account_status\` for background work that has since finished \u2014 to
 see whether the launch already landed, and tell the user what you are about to
-spend before spending it again.
+run before running it again.
 
 
 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\`.
@@ -3883,14 +3892,16 @@ Examples that should NOT invoke this tool (sound similar, route elsewhere):
 
 Terminal job -> render the full delivery per the lead-delivery table +
 honest funnel line. Still running -> one progress line (examined /
-delivered / spent so far) and offer to check again in ~1 min. Never
+delivered so far) and offer to check again in ~1 min. Never
 render UUIDs or cursors.
 
 ---
 
 Cumulative snapshot of a lead-delivery job: state, funnel counters, every
-item emitted so far (full lead payloads for delivered/degraded, honest
-status_reason for skipped), spend + breakdown, and the \`explain\` block
+item emitted so far (compact lead payloads for delivered/degraded, with
+one reason and the freshest signals; full evidence via
+\`leadbay_research_lead_by_id\`; honest status_reason for skipped), internal
+usage counters (never render them), and the \`explain\` block
 (basis, seed strategy, scope notes). Items are immutable once emitted \u2014
 polling never re-reads live data, so numbers only ever grow.
 
@@ -3899,7 +3910,7 @@ completion when the user asked for results "in this reply". \`since\` (from a
 prior poll's \`next_since\`) pages only the new items. Jobs terminalize
 server-side: past the 30-min wall clock a job reads \`completed_partial\`
 (time budget), past 30 days \`expired\` (items no longer listed \u2014 re-read
-billed leads via leadbay_qualify_leads \`prior_deliveries\`). A 404 means
+delivered leads via leadbay_qualify_leads \`prior_deliveries\`). A 404 means
 unknown job or another org's job.
 
 ---
@@ -3934,7 +3945,7 @@ when nothing was delivered.
 **Column 3 \u2014 Contact**
 
 - \`[Name](linkedin) \xB7 role\` (linked name mandatory when a LinkedIn URL
-  exists; plain name otherwise). Below it, the PURCHASED channels only:
+  exists; plain name otherwise). Below it, the FOUND channels only:
   \`\u2709 value\` / \`\u260E value\` inline as plain text (they auto-linkify).
 - Channel statuses: \`delivered\` \u2192 show value; \`already_owned\` \u2192 value +
   *(already yours)*; \`masked\` \u2192 "on file \u2014 reveal via channels";
@@ -3945,16 +3956,17 @@ when nothing was delivered.
 
 **The funnel line (mandatory, after the table):**
 
-One short line narrating the delivery honestly, from \`funnel\` + \`cost\` +
+One short line narrating the delivery honestly, from \`funnel\` +
 \`explain.scope_notes\`:
 
 > Matched N \xB7 examined E \xB7 qualified Q \xB7 disqualified D \u2192 **delivered X of
-> the Y asked** \xB7 stopped: <stop_reason in plain words> \xB7 spent C.CC.
+> the Y asked** \xB7 stopped: <stop_reason in plain words>.
 
-**Money: divide, then symbol.** Every amount (\`cost.spent\`,
-\`estimated_cost.max\`, quotes) is \`cost_cents\` \u2014 divide by 100, two decimals,
-so \`165\` renders \`1.65\`, NEVER \`165.00\`. Symbol from the account region: US
-\`$\`, France \`\u20AC\`, unknown \u2192 bare. Never hard-code \`$\`: it misstates a charge.
+**No money, anywhere.** \`cost.*\`, \`estimated_cost.max\` and quotes are internal
+usage units. Never render them, never convert them to a currency, never call
+them a charge: the user's plan or top-up covers this work, and a price reads as
+a bill. If the user asks what a job used, show \`leadbay_account_status\`'s quota
+windows.
 
 "of the Y asked" needs \`summary.items_requested\`, which submits carry but a
 later \`leadbay_lead_job_status\` snapshot does not. Without it write **delivered
@@ -3962,7 +3974,7 @@ X** and stop \u2014 never back-fill Y from \`matched\`/\`examined\` (they count
 candidates), never guess it.
 
 Plain-word stop reasons: \`target_reached\` \u2192 omit (success), \`pool_exhausted\` \u2192
-"ran out of matching candidates", \`max_cost\` \u2192 "hit the cost cap", \`quota\` \u2192
+"ran out of matching candidates", \`max_cost\` \u2192 "hit the job's usage cap", \`quota\` \u2192
 "hit an org quota", \`time_budget\` \u2192 "hit the 30-min time budget".
 
 **When \`delivered\` is 0**: NEVER say just "no results". Render no table; give
@@ -3987,7 +3999,7 @@ table \`Ref \u2192 Outcome\` translating \`status_reason\` to plain words:
 \`low_confidence_identity\` \u2192 "couldn't safely match \u2014 check \`resolution.alternatives\`",
 \`no_matching_contact\` \u2192 "no contact with the requested title",
 \`disqualified\` \u2192 "evaluated: does not fit" (evidence is in the item when owned),
-\`enrichment_failed\` \u2192 "channel could not be sourced (not billed)".
+\`enrichment_failed\` \u2192 "channel could not be sourced (no quota used)".
 
 **\`items_truncated\`**: rows are a PREFIX, not the batch. Say so, and offer
 \`leadbay_lead_job_status(job_id, since: next_since)\` for the rest.
@@ -4054,7 +4066,7 @@ is a status tool, keep it terse:
 |---|---|---|
 | Still running | "Keep waiting (~1 min) or leave it \u2014 results are kept 30 days" | leadbay_lead_job_status(job_id, wait_seconds: 60) |
 | Terminal (completed / partial / failed) | Render the delivery per the RENDERING block, then offer the matching find_new_leads / qualify_leads NEXT STEPS | \u2014 |
-| \`expired\` (past the 30-day window) | "Re-read the billed leads from your delivery ledger" \u2014 there is nothing left to render: the job terminalized and its items are no longer listed, so do NOT present an empty delivery as a result | leadbay_qualify_leads(prior_deliveries: {job_id}) |
+| \`expired\` (past the 30-day window) | "Re-read the delivered leads from your delivery ledger" \u2014 there is nothing left to render: the job terminalized and its items are no longer listed, so do NOT present an empty delivery as a result | leadbay_qualify_leads(prior_deliveries: {job_id}) |
 `;
     leadbay_like_lead = `## WHEN TO USE
 
@@ -4730,9 +4742,9 @@ Offer 2\u20133 follow-ups. Choose based on enrichment state + available channels
 | After a successful exchange                     | "Update qualification answers based on what you learned"      | leadbay_answer_clarification                           |
 The "log outreach" step is the most-important follow-up \u2014 it closes the loop and populates history for the next \`leadbay_prepare_outreach\` call. Detect intent from natural language: "I sent the email", "she didn't pick up", "left a voicemail", "they responded yes/no", etc.
 `;
-    leadbay_preview_bulk_enrichment = `Preview a bulk-enrichment cost given a set of job titles applied to the current selection. Returns \`{selected_leads, enriched_contacts, enrichable_contacts, title_suggestions, auto_included_titles, previously_enriched_titles}\`. \`previously_enriched_titles\` is a newer field (in prod soon) \u2014 when present, the agent can recommend repeating those titles for new leads.
+    leadbay_preview_bulk_enrichment = `Preview a bulk enrichment given a set of job titles applied to the current selection. Returns \`{selected_leads, enriched_contacts, enrichable_contacts, title_suggestions, auto_included_titles, previously_enriched_titles}\`. \`previously_enriched_titles\` is a newer field (in prod soon) \u2014 when present, the agent can recommend repeating those titles for new leads.
 
-WHEN TO USE: between selecting leads and launching, to know what the enrichment will cost.
+WHEN TO USE: between selecting leads and launching, to know how many contacts the enrichment will reveal.
 
 WHEN NOT TO USE: from agent flow \u2014 leadbay_enrich_titles wraps preview + launch with the right safety checks.
 `;
@@ -5127,18 +5139,18 @@ WHEN NOT TO USE: as the agent's bulk-qualify path \u2014 use leadbay_bulk_qualif
 ## A launched job cannot be stopped, and this tool has no retry guard
 
 Leadbay has no cancel. Once this call returns having actually launched, the work
-is queued on Leadbay and runs to completion, and the quota it costs is already
-committed. A \`dry_run\` result reached no backend and spent nothing. The user
+is queued on Leadbay and runs to completion, and the quota it uses is already
+committed. A \`dry_run\` result reached no backend and used nothing. The user
 cancelling in the chat, a request timeout, or a closed stream stops YOUR waiting,
 never the job.
 
 Unlike the composite launchers, this tool has **no double-launch guard**: calling
-it again always issues a new paid launch, even seconds later with identical
+it again always issues a new launch that uses quota again, even seconds later with identical
 arguments. So when a call returns nothing at all, do not simply retry. Read the
 record back first \u2014 \`leadbay_research_lead_by_id\` or \`leadbay_get_contacts\` for a
 lead, \`leadbay_account_status\` for background work that has since finished \u2014 to
 see whether the launch already landed, and tell the user what you are about to
-spend before spending it again.
+run before running it again.
 
 
 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\`.
@@ -5166,7 +5178,7 @@ Examples that should NOT invoke this tool (sound similar, route elsewhere):
 3-col table for delivered items (fit bar + company / why-fits \u226420 words /
 contact + channels) in returned order, then a compact Ref \u2192 Outcome table
 for skipped refs (not_in_universe, low_confidence_identity, ... in plain
-words), then the honest funnel + cost line. Full algorithm below.
+words), then the honest funnel line. Full algorithm below.
 
 ---
 
@@ -5181,29 +5193,29 @@ job; this tool polls up to \`wait_seconds\` (default 45) and hands off to
 **Refs are flexible; outcomes are per-item.** \`lead_refs\` accepts any mix of
 \`lead_id\`, \`website\`, \`name\`(+\`location\`), or a stable \`contact_id\` from a
 prior result (enrichment then targets exactly that person, never a re-match).
-\`prior_deliveries\` expands past MCP deliveries into refs \u2014 billed leads stay
+\`prior_deliveries\` expands past MCP deliveries into refs \u2014 delivered leads stay
 re-readable this way even after the 30-day result window. Duplicates collapse.
 A ref that can't be served comes back \`skipped\` with an honest
 \`status_reason\` (\`not_in_universe\`, \`low_confidence_identity\` with the
 \`resolution.alternatives\` to choose from, \`no_matching_contact\`, ...) \u2014 that
-is an ANSWER about the ref, not an error, and it costs nothing.
+is an ANSWER about the ref, not an error, and it uses no quota.
 
 **Disqualified \u2260 dropped.** Companies the org owns that fail qualification
 are DELIVERED with their negative evidence (question verdicts, tag misses,
 IBP reasoning) \u2014 "here's why to skip this account" is a deliverable.
 
-**Cost \u2014 never spend silently.** Resolution and identity are free.
-\`qualify: true\` (the default) costs ~94 cost_cents per lead needing FRESH
-research+scoring \u2014 but repeat calls reuse every fresh cached stage
-(\`from_cache\` flags on the items) and converge to near-zero cost. \`channels\`
-purchase verified email (25c) / phone (250c) on success only;
-\`already_owned\` values cost nothing.
+**Usage quota \u2014 never use it silently.** Resolution and identity are free.
+\`qualify: true\` (the default) draws on the org's usage quota for each lead
+needing FRESH research+scoring \u2014 but repeat calls reuse every fresh cached stage
+(\`from_cache\` flags on the items) and converge to near-zero. \`channels\` draw on
+it only when a verified email / phone is found; \`already_owned\` values are
+free. Nothing is invoiced.
 
-The gate is enforced in code, not just here: a PAID call (\`qualify\` left at
+The gate is enforced in code, not just here: a call that uses quota (\`qualify\` left at
 its default or set true, and/or any \`channels\`) is WITHHELD unless it carries
 \`confirm: true\`. Without it the tool submits nothing and returns
 \`mode: "needs_confirmation"\` with a real backend quote \u2014 show that quote to
-the user, get the go-ahead (an explicit "spend / get their emails" in their
+the user, get the go-ahead (an explicit "go ahead / get their emails" in their
 message counts), then re-call with \`confirm: true\`. \`confirm: false\` is a
 veto: nothing is submitted and no quote round-trip is made. A fully FREE
 call (\`qualify: false\`, no \`channels\`) needs no \`confirm\` and passes straight
@@ -5244,7 +5256,7 @@ when nothing was delivered.
 **Column 3 \u2014 Contact**
 
 - \`[Name](linkedin) \xB7 role\` (linked name mandatory when a LinkedIn URL
-  exists; plain name otherwise). Below it, the PURCHASED channels only:
+  exists; plain name otherwise). Below it, the FOUND channels only:
   \`\u2709 value\` / \`\u260E value\` inline as plain text (they auto-linkify).
 - Channel statuses: \`delivered\` \u2192 show value; \`already_owned\` \u2192 value +
   *(already yours)*; \`masked\` \u2192 "on file \u2014 reveal via channels";
@@ -5255,16 +5267,17 @@ when nothing was delivered.
 
 **The funnel line (mandatory, after the table):**
 
-One short line narrating the delivery honestly, from \`funnel\` + \`cost\` +
+One short line narrating the delivery honestly, from \`funnel\` +
 \`explain.scope_notes\`:
 
 > Matched N \xB7 examined E \xB7 qualified Q \xB7 disqualified D \u2192 **delivered X of
-> the Y asked** \xB7 stopped: <stop_reason in plain words> \xB7 spent C.CC.
+> the Y asked** \xB7 stopped: <stop_reason in plain words>.
 
-**Money: divide, then symbol.** Every amount (\`cost.spent\`,
-\`estimated_cost.max\`, quotes) is \`cost_cents\` \u2014 divide by 100, two decimals,
-so \`165\` renders \`1.65\`, NEVER \`165.00\`. Symbol from the account region: US
-\`$\`, France \`\u20AC\`, unknown \u2192 bare. Never hard-code \`$\`: it misstates a charge.
+**No money, anywhere.** \`cost.*\`, \`estimated_cost.max\` and quotes are internal
+usage units. Never render them, never convert them to a currency, never call
+them a charge: the user's plan or top-up covers this work, and a price reads as
+a bill. If the user asks what a job used, show \`leadbay_account_status\`'s quota
+windows.
 
 "of the Y asked" needs \`summary.items_requested\`, which submits carry but a
 later \`leadbay_lead_job_status\` snapshot does not. Without it write **delivered
@@ -5272,7 +5285,7 @@ X** and stop \u2014 never back-fill Y from \`matched\`/\`examined\` (they count
 candidates), never guess it.
 
 Plain-word stop reasons: \`target_reached\` \u2192 omit (success), \`pool_exhausted\` \u2192
-"ran out of matching candidates", \`max_cost\` \u2192 "hit the cost cap", \`quota\` \u2192
+"ran out of matching candidates", \`max_cost\` \u2192 "hit the job's usage cap", \`quota\` \u2192
 "hit an org quota", \`time_budget\` \u2192 "hit the 30-min time budget".
 
 **When \`delivered\` is 0**: NEVER say just "no results". Render no table; give
@@ -5297,7 +5310,7 @@ table \`Ref \u2192 Outcome\` translating \`status_reason\` to plain words:
 \`low_confidence_identity\` \u2192 "couldn't safely match \u2014 check \`resolution.alternatives\`",
 \`no_matching_contact\` \u2192 "no contact with the requested title",
 \`disqualified\` \u2192 "evaluated: does not fit" (evidence is in the item when owned),
-\`enrichment_failed\` \u2192 "channel could not be sourced (not billed)".
+\`enrichment_failed\` \u2192 "channel could not be sourced (no quota used)".
 
 **\`items_truncated\`**: rows are a PREFIX, not the batch. Say so, and offer
 \`leadbay_lead_job_status(job_id, since: next_since)\` for the rest.
@@ -5365,7 +5378,7 @@ Pick the 2-3 options that match what actually happened:
 | Fit leads with contacts delivered | "Draft outreach for the qualified ones" | leadbay_prepare_outreach |
 | Items skipped \`not_in_universe\` | "Import those companies first, then re-qualify" | leadbay_import_leads \u2192 leadbay_qualify_leads |
 | Items skipped \`low_confidence_identity\` | "Pick the right match" (show \`resolution.alternatives\`) | leadbay_qualify_leads with the chosen lead_id |
-| Contacts delivered without channels | "Purchase verified emails/phones for the keepers (state cost first)" | leadbay_qualify_leads(lead_refs with contact_id, channels) |
+| Contacts delivered without channels | "Get verified emails/phones for the keepers (uses quota \u2014 say so first)" | leadbay_qualify_leads(lead_refs with contact_id, channels) |
 | Disqualified with evidence | "Review why \u2014 adjust qualification questions if the criteria are off" | leadbay_get_qualification_questions |
 `;
     leadbay_qualify_status = `Retrieve the current state of a bulk_qualify_leads or import_and_qualify launch. Which ids to pass depends on which tool launched it, because only one of them creates a qualification job on the backend:
@@ -5411,7 +5424,7 @@ a launcher only for a subset that never started, never for the whole batch:
   that are the ones that never started. Only then call
   \`leadbay_bulk_qualify_leads({leadIds, lensId})\` for exactly those ids. A lead
   that is merely slow looks identical to one that never launched over a few
-  polls, and re-launching it charges the user twice \u2014 when unsure, tell the user
+  polls, and re-launching it uses the user's quota twice \u2014 when unsure, tell the user
   rather than guess.
 `;
     leadbay_recall_ordered_titles = `Show job titles the org has previously enriched, so the agent can repeat the same titles for new leads (or skip already-saturated ones). Two implementation paths: (1) PREFERRED \u2014 a selection-scoped preview call that reads \`previously_enriched_titles\` from the backend (newer prod field). (2) FALLBACK \u2014 live aggregation across each lead's enriched contacts. The composite picks transparently.
@@ -6946,7 +6959,7 @@ This tool MUTATES state. The caller (agent or human-in-the-loop) is responsible
     NO_COMMERCE_TOOL_DESCRIPTIONS = {
       leadbay_account_status: `## WHEN TO USE
 
-Trigger phrases: "what's my account status", "how much quota do I have", "what lens am I on", "I topped up / I bought credits / I added credits".
+Trigger phrases: "what's my account status", "how much quota do I have", "what lens am I on", "I topped up / I bought credits / I added credits", "what version of Leadbay am I running".
 
 Do NOT use for: "show me leads" \u2192 \`leadbay_pull_leads\`.
 
@@ -6955,6 +6968,7 @@ Prefer when: meta question about account, quota, active lens, or top-up recovery
 Examples that SHOULD invoke this tool:
 - "What's my account status?"
 - "How much quota do I have left this week?"
+- "Which version of the Leadbay connector is this?"
 
 Examples that should NOT invoke this tool (sound similar, route elsewhere):
 - "Show me today's leads."
@@ -6976,6 +6990,8 @@ Show the user's account state \u2014 admin rights, language, last-active lens, q
 
 **After a user tops up, do NOT keep refusing \u2014 RETRY.** If the user signals they topped up / bought credits / added credits, the previous QUOTA_EXCEEDED is invalidated the moment the Stripe webhook lands. RE-CALL \`leadbay_account_status\` to pick up the new state AND retry the originally failed call. The retry itself does not require a successful account_status check first \u2014 a topped-up user has cleared the throttle whether or not your cached snapshot reflects it yet. **A stale quota snapshot is never a reason to gate-keep a topped-up user.**
 
+**\`mcp_version\`** is the version of the Leadbay MCP server answering the call. When the user asks which Leadbay version they are running, answer with it.
+
 **\`notifications\` block.** The response now includes a top-level \`notifications\` array listing background work the user (or agent) initiated that has since completed (\`bulk_enrich\`, \`bulk_qualify\`, \`import\`). These are signals to revise prior agent outputs the just-finished work might have made stale \u2014 they're NOT a pending-task list for the user. After revising (or confirming nothing is affected), call \`leadbay_acknowledge_notification(notification_id)\`. Full handling protocol below.
 
 ## GATE \u2014 INSPECT \`_meta.notifications\` ON EVERY RESPONSE
@@ -7004,7 +7020,7 @@ Some Leadbay tool responses include a \`_meta.notifications\` array listing **ba
 
 - **Previous turn / before an MCP restart, and the user has NOT asked about it** \u2014 don't poll for it in the background. Simply continue the conversation; the next time you call any tool, the completed-work entry appears in \`_meta.notifications\` (also on \`leadbay_account_status.notifications\`). This is the ambient push path \u2014 leave it to do its job. **But if the user explicitly asks for status or to "wait for it to finish"** (e.g. a multi-turn flow where a job was launched in a prior turn and this turn says "wait for enrichment to finish, then \u2026"), DO poll its status tool now until done, exactly as for a this-turn job below \u2014 the ambient push only surfaces *completed* work, so it can't answer a live "is it done / wait for it" request while the job is still running.
 - **This turn (you just launched it)** \u2014 the DEFAULT is: do NOT end your turn on the "launched" ack; stay active and poll the job's status tool in a loop until it reports done, then report the finished result yourself, rather than spinning forever or deferring the result to a later turn. (Two exceptions, detailed below: the user explicitly asked NOT to wait / to run it in the background; or it's a large qualification/import that's async by design \u2014 in those cases hand back the handle instead of looping.) Each status tool has its OWN terminal signal \u2014 poll until:
-  - \`leadbay_bulk_enrich_status\` \u2192 \`all_done:true\` \u2014 OR \`overall_progress.done\` holds steady across several SPACED polls (~15\u201330s apart) over at least ~90s\u20132 min of elapsed time (some contacts are unresolvable, so \`all_done\` can stay false forever). Don't call a plateau from the first few back-to-back reads \u2014 early on \`done\` sits flat while the backend spins up. Once the plateau is real, report what resolved and name what didn't.
+  - \`leadbay_bulk_enrich_status\` \u2192 \`all_done:true\` \u2014 OR \`overall_progress.done\` holds steady across several SPACED polls (~15\u201330s apart) over at least ~90s\u20132 min of elapsed time (a reservation the provider never answers stays \`done:false\`, so \`all_done\` can stay false forever). Don't call a plateau from the first few back-to-back reads \u2014 early on \`done\` sits flat while the backend spins up. Once the plateau is real, report what resolved and name what didn't.
   - \`leadbay_qualify_status\` \u2192 \`still_running\` is empty: every launched lead has finished or failed. (\`in_progress\` also reads \`false\` on the fast path, but it can be \`null\` on the legacy/fallback read \u2014 so treat an empty \`still_running\` as terminal on its own; only require \`in_progress:false\` when that field is actually present.) LIKE imports, large qualification runs are async by design: \`leadbay_bulk_qualify_leads\` defaults to \`wait_for_completion:false\` for \`count > 5\` or chained workflows because blocking can time out, and \`leadbay_qualify_status\` may take minutes/hours. So don't force a long polling loop on a big run \u2014 return the handle/progress and let completion arrive via \`_meta.notifications\` \u2014 UNLESS the user explicitly asked to wait, or it's a small run that finishes quickly. A small \`wait_for_completion:true\` run you can poll to \`still_running\` empty inline.
   - \`leadbay_import_status\` \u2192 \`status:"complete"\` (or \`"failed"\`). BUT imports are the exception to the stay-active loop: a large \`leadbay_import_leads({wait_for_completion:false})\` is meant to return a handle and resolve over minutes, and the tool does ONE refresh pass per call. Don't block the conversation looping on it \u2014 surface the returned progress/handle and let the completion arrive via \`_meta.notifications\` \u2014 UNLESS the user explicitly asked you to wait for the import, or it's a small import that finishes quickly.
 
@@ -7085,7 +7101,7 @@ days"), computed against now \u2014 mirroring the widget's "r\xE9initialis\xE9 d
 raw value is an ISO-8601 timestamp.
 
 **Top-up (optional, subordinate).** When \`quota.topup\` is present, you MAY add one
-small line below the windows: \`Top-up: $<remaining_cents/100> of $<total_credit_cents/100> left\`.
+small line below the windows: \`Top-up: $<(remaining_cents / 100).toFixed(2)> of $<(total_credit_cents / 100).toFixed(2)> left\`.
 Keep it secondary \u2014 the three window gauges are the headline. Omit when null.
 
 **Legend** (once, below): \`\` \`\u25B0\` used \xB7 \`\u25B1\` remaining \`\`.
@@ -7119,8 +7135,8 @@ Examples that should NOT invoke this tool (sound similar, route elsewhere):
 
 3-col table of delivered leads in returned order: col 1 = 10-segment fit
 bar + linked company \xB7 location \xB7 size; col 2 = why-fits \u226420 words; col 3
-= contact + purchased channels. ALWAYS close with the honest funnel line
-(matched/examined/delivered/stop reason/spend) \u2014 especially on 0
+= contact + found channels. ALWAYS close with the honest funnel line
+(matched/examined/delivered/stop reason) \u2014 especially on 0
 delivered. Full algorithm below.
 
 ---
@@ -7128,19 +7144,19 @@ delivered. Full algorithm below.
 Submit a net-new lead search: the backend matches an ICP seed against the full
 company universe, applies hard filters, skips what the org already knows
 (\`novelty: org\`), optionally qualifies against the org's own intelligence
-(questions, tags, ideal buyer profile \u2014 frozen at submit), and optionally buys
+(questions, tags, ideal buyer profile \u2014 frozen at submit), and optionally reveals
 contact channels. Polls up to \`wait_seconds\` (default 45); a longer job returns
 \`still_running\` + \`next_poll\` \u2014 hand off to \`leadbay_lead_job_status\`. Jobs run
 \u226430 min, results kept 30 days.
 
-**Free vs paid \u2014 never spend silently.** Default (\`qualify: false\`,
+**Free vs usage quota \u2014 never use quota silently.** Default (\`qualify: false\`,
 \`channels: []\`) is FREE: company profile + fit score + cached research +
-contact identity. Paid: \`qualify: true\` (~94 cost_cents per candidate
-EXAMINED, capped by \`exploration_cap\`/\`max_cost\`) and \`channels\` (email 25c /
-phone 250c, success-only). Enforced in code: a paid call is WITHHELD unless it
+contact identity. \`qualify: true\` (per candidate EXAMINED, capped by
+\`exploration_cap\`/\`max_cost\`) and \`channels\` (only when a value is found) draw
+on the org's usage quota; nothing is invoiced. Enforced in code: such a call is WITHHELD unless it
 carries \`confirm: true\` \u2014 nothing is submitted and you get
 \`mode: "needs_confirmation"\` with a real quote to show the user. Re-call with
-\`confirm: true\` on their go-ahead ("spend / get their emails" counts).
+\`confirm: true\` on their go-ahead ("go ahead / get their emails" counts).
 \`confirm: false\` vetoes. Free needs no consent. **Preview free first** \u2014
 reshaping an off-profile seed is free, exploring it with \`qualify: true\` is
 not.
@@ -7148,7 +7164,7 @@ not.
 **Ad-hoc exclusions ("no chains") are enforced by NO tier** \u2014 \`filters\` has no
 exclusion key, and \`qualify\` scores against the org's FROZEN questions and IBP,
 which need not mention chains; the seed's inverse only shifts ranking.
-Violators can survive, be paid for and be delivered \u2014 post-filter them yourself
+Violators can survive, use quota and be delivered \u2014 post-filter them yourself
 and say the tier didn't enforce it. Durable enforcement \u2192
 \`leadbay_refine_prompt\`.
 
@@ -7195,9 +7211,9 @@ measured:
 
 **Parameter notes**
 - \`request_id\` (REQUIRED) is the retry contract: SAME value retrying the same
-  ask (same live job, no double spend); NEW for a changed ask. Derive from ask
+  ask (same live job, no double launch); NEW for a changed ask. Derive from ask
   + archetype + date: \`gyms-dallas-2026-07-28\`.
-- Never lower \`min_ai_score\` together with \`channels\` \u2014 that buys emails for
+- Never lower \`min_ai_score\` together with \`channels\` \u2014 that reveals emails for
   leads the AI just scored as junk.
 - \`count\` \u2264 50; \u22643 active jobs/org; \u226410 submits/hour (429 + Retry-After \u2014
   wait, don't hammer).
@@ -7237,7 +7253,7 @@ when nothing was delivered.
 **Column 3 \u2014 Contact**
 
 - \`[Name](linkedin) \xB7 role\` (linked name mandatory when a LinkedIn URL
-  exists; plain name otherwise). Below it, the PURCHASED channels only:
+  exists; plain name otherwise). Below it, the FOUND channels only:
   \`\u2709 value\` / \`\u260E value\` inline as plain text (they auto-linkify).
 - Channel statuses: \`delivered\` \u2192 show value; \`already_owned\` \u2192 value +
   *(already yours)*; \`masked\` \u2192 "on file \u2014 reveal via channels";
@@ -7248,16 +7264,17 @@ when nothing was delivered.
 
 **The funnel line (mandatory, after the table):**
 
-One short line narrating the delivery honestly, from \`funnel\` + \`cost\` +
+One short line narrating the delivery honestly, from \`funnel\` +
 \`explain.scope_notes\`:
 
 > Matched N \xB7 examined E \xB7 qualified Q \xB7 disqualified D \u2192 **delivered X of
-> the Y asked** \xB7 stopped: <stop_reason in plain words> \xB7 spent C.CC.
+> the Y asked** \xB7 stopped: <stop_reason in plain words>.
 
-**Money: divide, then symbol.** Every amount (\`cost.spent\`,
-\`estimated_cost.max\`, quotes) is \`cost_cents\` \u2014 divide by 100, two decimals,
-so \`165\` renders \`1.65\`, NEVER \`165.00\`. Symbol from the account region: US
-\`$\`, France \`\u20AC\`, unknown \u2192 bare. Never hard-code \`$\`: it misstates a charge.
+**No money, anywhere.** \`cost.*\`, \`estimated_cost.max\` and quotes are internal
+usage units. Never render them, never convert them to a currency, never call
+them a charge: the user's plan or top-up covers this work, and a price reads as
+a bill. If the user asks what a job used, show \`leadbay_account_status\`'s quota
+windows.
 
 "of the Y asked" needs \`summary.items_requested\`, which submits carry but a
 later \`leadbay_lead_job_status\` snapshot does not. Without it write **delivered
@@ -7265,7 +7282,7 @@ X** and stop \u2014 never back-fill Y from \`matched\`/\`examined\` (they count
 candidates), never guess it.
 
 Plain-word stop reasons: \`target_reached\` \u2192 omit (success), \`pool_exhausted\` \u2192
-"ran out of matching candidates", \`max_cost\` \u2192 "hit the cost cap", \`quota\` \u2192
+"ran out of matching candidates", \`max_cost\` \u2192 "hit the job's usage cap", \`quota\` \u2192
 "hit an org quota", \`time_budget\` \u2192 "hit the 30-min time budget".
 
 **When \`delivered\` is 0**: NEVER say just "no results". Render no table; give
@@ -7290,7 +7307,7 @@ table \`Ref \u2192 Outcome\` translating \`status_reason\` to plain words:
 \`low_confidence_identity\` \u2192 "couldn't safely match \u2014 check \`resolution.alternatives\`",
 \`no_matching_contact\` \u2192 "no contact with the requested title",
 \`disqualified\` \u2192 "evaluated: does not fit" (evidence is in the item when owned),
-\`enrichment_failed\` \u2192 "channel could not be sourced (not billed)".
+\`enrichment_failed\` \u2192 "channel could not be sourced (no quota used)".
 
 **\`items_truncated\`**: rows are a PREFIX, not the batch. Say so, and offer
 \`leadbay_lead_job_status(job_id, since: next_since)\` for the rest.
@@ -7339,10 +7356,10 @@ Pick the 2-3 options that match what actually happened \u2014 never all seven:
 | Observation | Suggest | Calls |
 |---|---|---|
 | Job still running (\`still_running: true\`) | "Check on it in ~1 min" | leadbay_lead_job_status(job_id, wait_seconds: 60) |
-| Free run delivered on-profile leads | "Qualify these N against your criteria (paid \u2014 \`dry_run\` first)" | leadbay_qualify_leads(prior_deliveries: {job_id}) |
+| Free run delivered on-profile leads | "Qualify these N against your criteria (uses quota \u2014 \`dry_run\` first)" | leadbay_qualify_leads(prior_deliveries: {job_id}) |
 | Delivered leads look right | "Draft outreach for the top ones" | leadbay_prepare_outreach |
 | Delivered 0 or off-profile | "Reshape the example and retry" (name the fix from funnel + scope_notes) | leadbay_find_new_leads (NEW request_id) |
-| Stopped at cost cap (\`stop_reason: max_cost\`) | "Raise the cap to X and get the remaining N" \u2014 X in the account's currency per the funnel-line rule, never a hard-coded \`$\` | leadbay_find_new_leads, NEW request_id (same-id only dedupes onto a LIVE job) + higher max_cost + \`count\` = the SHORTFALL (\`items_requested\` \u2212 delivered), not the original + \`exclude_lead_ids\` = the examined-but-REJECTED ids (novelty covers delivered; these are what it misses \u2014 without them the rerun re-buys the same losers) |
+| Stopped at the job's usage cap (\`stop_reason: max_cost\`) | "Raise the job's cap and get the remaining N" \u2014 no amount, no currency | leadbay_find_new_leads, NEW request_id (same-id only dedupes onto a LIVE job) + higher max_cost + \`count\` = the SHORTFALL (\`items_requested\` \u2212 delivered), not the original + \`exclude_lead_ids\` = the examined-but-REJECTED ids (novelty covers delivered; these are what it misses \u2014 without them the rerun re-buys the same losers) |
 | Stopped on org quota (\`stop_reason: quota\`) | "Check which window is exhausted and when it resets" \u2014 never a re-run: it cannot clear an org quota and burns a submit slot to stop in the same place | leadbay_account_status |
 | User wants these tracked in Leadbay | "Add the keepers to a campaign" | leadbay_create_campaign / leadbay_add_leads_to_campaign |
 `,
@@ -7941,7 +7958,7 @@ var init_get_contacts = __esm({
                     },
                     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."
+                      description: "Credits used by 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" }
@@ -12806,7 +12823,7 @@ var init_preview_bulk_enrichment = __esm({
     previewBulkEnrichment = {
       name: "leadbay_preview_bulk_enrichment",
       annotations: {
-        title: "Preview bulk enrichment cost",
+        title: "Preview bulk enrichment",
         readOnlyHint: true,
         destructiveHint: false,
         idempotentHint: true,
@@ -16749,9 +16766,9 @@ var init_getting_started = __esm({
             leadId: "<the highest-scoring lead id from step 2>"
           },
           forbidden_args: [
-            "enrich \u2014 enrich:true launches a PAID contact reveal off the back of a DRAFT click. They agreed to see an email written, not to spend. Gate 4 is where the reveal gets asked for, explicitly and on its own terms."
+            "enrich \u2014 enrich:true launches a contact reveal, which uses quota, off the back of a DRAFT click. They agreed to see an email written, not to reveal anyone. Gate 4 is where the reveal gets asked for, explicitly and on its own terms."
           ],
-          spend: "This gate spends NOTHING. Call leadbay_prepare_outreach with leadId and nothing else. `recommended_contact` comes back in its post-enrichment shape with email and phone still null \u2014 that is EXPECTED, not a failure, and it is precisely the hook for gate 4: an email written, and nobody to send it to yet. Do not apologise for the missing contact, and do not reach for another tool to fill it in.",
+          spend: "This gate uses NO quota. Call leadbay_prepare_outreach with leadId and nothing else. `recommended_contact` comes back in its post-enrichment shape with email and phone still null \u2014 that is EXPECTED, not a failure, and it is precisely the hook for gate 4: an email written, and nobody to send it to yet. Do not apologise for the missing contact, and do not reach for another tool to fill it in.",
           branches: [
             {
               when: "always",
@@ -16767,7 +16784,7 @@ var init_getting_started = __esm({
           n: 4,
           gate_label: "Find who to email",
           gate_description: "Reveal the person at that company to send the draft to.",
-          explain: "Point straight at the gap the draft just opened: they have an email ready and nobody to send it to \u2014 it's addressed to a job title, not a person. That's what this step fixes. Explain what enrichment IS: Leadbay can find which roles exist at that company, then reveal the actual human and how to reach them. WHY IT'S USEFUL: they ask for the operations director by name instead of pitching whoever answers the switchboard \u2014 the difference between a conversation and a dead end. Say plainly that the first look is free, and that revealing the contact costs credits and needs their say-so.",
+          explain: "Point straight at the gap the draft just opened: they have an email ready and nobody to send it to \u2014 it's addressed to a job title, not a person. That's what this step fixes. Explain what enrichment IS: Leadbay can find which roles exist at that company, then reveal the actual human and how to reach them. WHY IT'S USEFUL: they ask for the operations director by name instead of pitching whoever answers the switchboard \u2014 the difference between a conversation and a dead end. Say plainly that the first look is free, and that revealing the contact uses a little of their plan's quota and needs their say-so.",
           next_steps: {
             question: "Want to find out who to send that email to?",
             options: [
@@ -16790,8 +16807,8 @@ var init_getting_started = __esm({
             leadIds: "[<the ONE lead you drafted for at step 3>] \u2014 an ARRAY, always",
             lensId: "<the pinned lens id from step 2>"
           },
-          spend: "TWO BEATS \u2014 free preview FIRST, the real reveal only after the user confirms. Beat 1: call leadbay_enrich_titles with the drafted lead's id + lensId and NO titles / NO confirm / NO email / NO phone. That returns mode:'discover' \u2014 the FREE list of job titles at that company. Say plainly that nothing has been spent yet. Beat 2: name the title the draft is addressed to, tell them BEFORE they decide what it costs (one credit per contact revealed \u2014 here that is ONE contact, one credit), and ask them to confirm. Only then call leadbay_enrich_titles AGAIN with leadIds: [<that lead id>] \u2014 ALWAYS the array, even for a single lead: `leadId` singular is not a key this tool reads, so it is dropped and the paid call falls back to the default wishlist selection, charging for the whole batch \u2014 plus the chosen title, confirm:true and email:true. Poll leadbay_bulk_enrich_status with the returned notification_id and lead_ids until all_done (or the count plateaus), and report the contact that actually resolved. NEVER launch the reveal without an explicit confirm: silence is not consent, and neither is 'they clicked the gate'. If they decline, keep the draft and the title and move on \u2014 that is a normal outcome, not a failure.",
-          quota_note: "After the reveal, close the loop on gate 1 in one line: one credit per contact revealed, so this cost one. Then say the thing that makes it land \u2014 the draft from gate 3 now has a real person and a real address to go to. Re-check leadbay_account_status if you want to show the moved windows. This is where gate 1's numbers stop being abstract: they just watched them move, and got something for it. Keep it to a line; no pricing pitch."
+          spend: "TWO BEATS \u2014 free preview FIRST, the real reveal only after the user confirms. Beat 1: call leadbay_enrich_titles with the drafted lead's id + lensId and NO titles / NO confirm / NO email / NO phone. That returns mode:'discover' \u2014 the FREE list of job titles at that company. Say plainly that nothing has run yet. Beat 2: name the title the draft is addressed to, tell them BEFORE they decide that revealing it uses their plan's quota (here ONE contact; no amount, no price), and ask them to confirm. Only then call leadbay_enrich_titles AGAIN with leadIds: [<that lead id>] \u2014 ALWAYS the array, even for a single lead: `leadId` singular is not a key this tool reads, so it is dropped and the reveal falls back to the default wishlist selection, revealing the whole batch \u2014 plus the chosen title, confirm:true and email:true. Poll leadbay_bulk_enrich_status with the returned notification_id and lead_ids until all_done (or the count plateaus), and report the contact that actually resolved. NEVER launch the reveal without an explicit confirm: silence is not consent, and neither is 'they clicked the gate'. If they decline, keep the draft and the title and move on \u2014 that is a normal outcome, not a failure.",
+          quota_note: "After the reveal, close the loop on gate 1 in one line: the reveal used a little of their plan's quota, never a price. Then say the thing that makes it land \u2014 the draft from gate 3 now has a real person and a real address to go to. Re-check leadbay_account_status if you want to show the moved windows. This is where gate 1's numbers stop being abstract: they just watched them move, and got something for it. Keep it to a line; no pricing pitch."
         }
       ],
       keep_going: KEEP_GOING,
@@ -17796,6 +17813,11 @@ var init_account_status = __esm({
               agent_memory: { type: "object" }
             }
           },
+          // Set by the MCP server wrapper (NOT this composite) on every call.
+          mcp_version: {
+            type: "string",
+            description: "Version of the Leadbay MCP server answering this call. Answer 'what version of Leadbay are you running' with this value."
+          },
           // Auto-update block. Populated by the MCP server wrapper (NOT this
           // composite) when a newer release is published on GitHub AND the
           // user hasn't suppressed it. When present, the agent should prompt
@@ -19771,7 +19793,7 @@ async function launchOnSelection(client, args, ctx) {
       preview,
       lead_ids: leadIds,
       titles,
-      message: `An identical enrichment was started ${claim.seconds_since}s ago and has not returned its job id yet. Nothing was launched twice and no quota was spent.`,
+      message: `An identical enrichment was started ${claim.seconds_since}s ago and has not returned its job id yet. Nothing was launched twice and no quota was used.`,
       next_action: "Wait a few seconds and call leadbay_enrich_titles again with the same arguments \u2014 it will hand back the job id once the first call settles. Do not treat this as a running job; there is no id to poll yet."
     };
   }
@@ -19789,8 +19811,8 @@ async function launchOnSelection(client, args, ctx) {
       phone,
       notification_id: already.notification_id,
       launched_at: already.launched_at,
-      message: `An identical enrichment was launched ${already.seconds_since}s ago; this call did NOT spend quota again. Poll the original job rather than relaunching.`,
-      next_action: "Poll leadbay_bulk_enrich_status({notification_id, lead_ids, titles, email, phone, include_contacts: true}) until all_done, or until overall_progress.done holds steady across spaced polls (~15-30s apart) \u2014 unresolvable contacts never flip. Pass titles/email/phone every time: they scope counting to the roles and channel THIS run asked for, so a contact enriched earlier cannot report the run as finished. Then report what landed and name what didn't."
+      message: `An identical enrichment was launched ${already.seconds_since}s ago; this call did NOT use quota again. Poll the original job rather than relaunching.`,
+      next_action: "Poll leadbay_bulk_enrich_status({notification_id, lead_ids, titles, email, phone, include_contacts: true}) until all_done, or until overall_progress.done holds steady across spaced polls (~15-30s apart) \u2014 a reservation the provider never answers never flips. Pass titles/email/phone every time: they scope counting to the roles and channel THIS run asked for, so a contact enriched earlier cannot report the run as finished. Then report what landed and name what didn't."
     };
   }
   ctx?.progress?.({
@@ -19827,8 +19849,8 @@ async function launchOnSelection(client, args, ctx) {
     lead_ids: leadIds,
     notification_id: notificationId,
     launched_at: remembered.launched_at,
-    message: notificationId ? "Enrichment job launched (runs async). Unless the user asked NOT to wait, do NOT end your turn here \u2014 poll leadbay_bulk_enrich_status({notification_id, lead_ids, titles, email, phone}) until all_done OR until progress plateaus (overall_progress.done stops climbing across spaced polls \u2014 unresolvable contacts keep all_done:false forever), then report the finished contacts yourself. The notification_id keeps working across conversations and days; completion also surfaces via _meta.notifications / leadbay_account_status.notifications." : "Enrichment job launched, but the backend returned no notification_id, so there is no job id to poll. Poll leadbay_bulk_enrich_status({lead_ids, titles, email, phone}) instead \u2014 it answers per lead without a job id.",
-    next_action: notificationId ? "Unless the user explicitly asked NOT to wait, poll leadbay_bulk_enrich_status({notification_id, lead_ids, titles, email, phone, include_contacts: true}) until all_done \u2014 OR until overall_progress.done holds steady across several SPACED polls (~15-30s apart, ~90s-2min elapsed; don't call a plateau from the first back-to-back reads, and not while partial_failures is present \u2014 that's transient, respect retry_after). Carry titles/email/phone on every poll \u2014 they scope counting to the roles and channel THIS run asked for, and without them a contact enriched months ago counts as done and all_done flips true before anything landed. Then report the resolved enrichment in THIS turn, naming what landed and what didn't. If the user DID ask not to wait, hand back the notification_id \u2014 it resolves later from any conversation." : "Poll leadbay_bulk_enrich_status({lead_ids, titles, email, phone, include_contacts: true}) every ~30s. It scopes counting to these titles and treats a contact as done only when the REQUESTED channel landed, so you do not have to do that yourself. Stop once overall_progress.done stops growing across a couple of spaced re-checks (~90s-2min) \u2014 unresolvable contacts never flip."
+    message: notificationId ? "Enrichment job launched (runs async). Unless the user asked NOT to wait, do NOT end your turn here \u2014 poll leadbay_bulk_enrich_status({notification_id, lead_ids, titles, email, phone}) until all_done OR until progress plateaus (overall_progress.done stops climbing across spaced polls \u2014 a reservation the provider never answers keeps all_done:false forever), then report the finished contacts yourself. The notification_id keeps working across conversations and days; completion also surfaces via _meta.notifications / leadbay_account_status.notifications." : "Enrichment job launched, but the backend returned no notification_id, so there is no job id to poll. Poll leadbay_bulk_enrich_status({lead_ids, titles, email, phone}) instead \u2014 it answers per lead without a job id.",
+    next_action: notificationId ? "Unless the user explicitly asked NOT to wait, poll leadbay_bulk_enrich_status({notification_id, lead_ids, titles, email, phone, include_contacts: true}) until all_done \u2014 OR until overall_progress.done holds steady across several SPACED polls (~15-30s apart, ~90s-2min elapsed; don't call a plateau from the first back-to-back reads, and not while partial_failures is present \u2014 that's transient, respect retry_after). Carry titles/email/phone on every poll \u2014 they scope counting to the roles and channel THIS run asked for, and without them a contact enriched months ago counts as done and all_done flips true before anything landed. Then report the resolved enrichment in THIS turn, naming what landed and what didn't. If the user DID ask not to wait, hand back the notification_id \u2014 it resolves later from any conversation." : "Poll leadbay_bulk_enrich_status({lead_ids, titles, email, phone, include_contacts: true}) every ~30s. It scopes counting to these titles and to the channels this run asked for, and counts a reservation once it has settled, so you do not have to do that yourself. Stop once overall_progress.done stops growing across a couple of spaced re-checks (~90s-2min) \u2014 a reservation the provider never answers never flips."
   };
 }
 async function launchEnrichment(client, args, ctx) {
@@ -19901,14 +19923,14 @@ var init_enrich_titles = __esm({
           },
           confirm: {
             type: "boolean",
-            description: "Explicit spend decision for the paid enrichment. true = go ahead and launch. false = do NOT spend (a veto: returns mode:'needs_confirmation' and launches nothing, even on hosts without elicitation, and even if an email/phone channel was set). Omitted (and no explicit email/phone channel) \u2192 an elicitation-capable host asks the user before launching; a decline returns mode:'needs_confirmation'. Passing email:true/phone:true also counts as consent."
+            description: "Explicit go-ahead for the email/phone reveal (uses quota). true = go ahead and launch. false = do NOT launch (a veto: returns mode:'needs_confirmation' and launches nothing, even on hosts without elicitation, and even if an email/phone channel was set). Omitted (and no explicit email/phone channel) \u2192 an elicitation-capable host asks the user before launching; a decline returns mode:'needs_confirmation'. Passing email:true/phone:true also counts as consent."
           }
         },
         additionalProperties: false
       },
       outputSchema: {
         type: "object",
-        description: "Branchy return shape; the `mode` (or `status`) field tells the agent which branch it got. Modes: 'discover' (no titles passed), 'preview_only' (no enrichable contacts), 'dry_run', 'needs_confirmation' (paid launch withheld pending user consent), 'already_launched' (idempotent reuse), 'launch_in_flight' (an identical launch is mid-flight and has no id yet), 'launched' (happy path). Status: 'quota_exceeded' (429).",
+        description: "Branchy return shape; the `mode` (or `status`) field tells the agent which branch it got. Modes: 'discover' (no titles passed), 'preview_only' (no enrichable contacts), 'dry_run', 'needs_confirmation' (launch withheld pending user consent), 'already_launched' (idempotent reuse), 'launch_in_flight' (an identical launch is mid-flight and has no id yet), 'launched' (happy path). Status: 'quota_exceeded' (429).",
         properties: {
           mode: {
             type: "string",
@@ -19944,7 +19966,7 @@ var init_enrich_titles = __esm({
           },
           credits_remaining: {
             type: ["number", "string", "null"],
-            description: `Advisory-only balance (billing.ai_credits), present in discover / preview_only / dry_run modes. Enrichment is gated by QUOTA (email + phone reveals consume the per-window allowance in leadbay_account_status), NOT by this number \u2014 do NOT present it as a spend gate, do NOT say 'you have N credits', and NEVER refuse enrichment because it's low or zero. Confirm the run by naming enrichable_contacts + the channels, not a credit figure. Null = billing unavailable. The string "unlimited" = an internal/unlimited account: proceed freely and say nothing about credits or quota.`
+            description: `Advisory-only balance (billing.ai_credits), present in discover / preview_only / dry_run modes. Enrichment is gated by QUOTA (email + phone reveals consume the per-window allowance in leadbay_account_status), NOT by this number \u2014 do NOT present it as a gate, do NOT say 'you have N credits', and NEVER refuse enrichment because it's low or zero. Confirm the run by naming enrichable_contacts + the channels, not a credit figure. Null = billing unavailable. The string "unlimited" = an internal/unlimited account: proceed freely and say nothing about credits or quota.`
           },
           selected_lead_count: {
             type: "number",
@@ -20138,8 +20160,8 @@ var init_enrich_titles = __esm({
                     enrichable_contacts: preview2.enrichable_contacts,
                     credits_remaining: await readCreditsRemaining(client),
                     available_titles: availableTitles2,
-                    message: "Enrichment not launched \u2014 confirm:false was passed (spend declined). Title & LinkedIn are already on the contact (free); enrichment is the PAID email/phone reveal. Re-call with confirm:true (or email:true) to spend.",
-                    next_action: "Re-call leadbay_enrich_titles with confirm:true once the user approves the spend."
+                    message: "Enrichment not launched \u2014 confirm:false was passed (declined). Title & LinkedIn are already on the contact (free); enrichment is the email/phone reveal, which uses quota. Re-call with confirm:true (or email:true) to launch.",
+                    next_action: "Re-call leadbay_enrich_titles with confirm:true once the user approves the reveal."
                   }
                 };
               } else if (!willElicit) {
@@ -20218,8 +20240,8 @@ var init_enrich_titles = __esm({
             enrichable_contacts: preview.enrichable_contacts,
             credits_remaining: creditsRemaining,
             available_titles: availableTitles,
-            message: "Enrichment not launched \u2014 awaiting confirmation. Title & LinkedIn are already on the contact (free); enrichment is the PAID email/phone reveal. Re-call with confirm:true (or email:true) to spend.",
-            next_action: "Confirm the spend with the user, then call leadbay_enrich_titles again with confirm:true."
+            message: "Enrichment not launched \u2014 awaiting confirmation. Title & LinkedIn are already on the contact (free); enrichment is the email/phone reveal, which uses quota. Re-call with confirm:true (or email:true) to launch.",
+            next_action: "Confirm the reveal with the user, then call leadbay_enrich_titles again with confirm:true."
           };
         }
         return await launchEnrichment(client, {
@@ -20290,11 +20312,11 @@ var init_bulk_enrich_status = __esm({
           },
           email: {
             type: "boolean",
-            description: "The `email` flag the launch returned. A contact counts as done only once the requested channel has landed."
+            description: "The `email` flag the launch returned. Scopes counting to reservations that asked for email (`enrichment.email_requested`), so a contact reserved by an earlier phone-only run is not counted in this one."
           },
           phone: {
             type: "boolean",
-            description: "The `phone` flag the launch returned. Same rule as `email`."
+            description: "The `phone` flag the launch returned. Same rule as `email`, on `enrichment.phone_requested`."
           },
           include_contacts: {
             type: "boolean",
@@ -20379,22 +20401,21 @@ var init_bulk_enrich_status = __esm({
         }
         if (leadIds.length > 0) {
           const wantTitles = new Set((params.titles ?? []).map((t) => t.trim().toLowerCase()));
-          const channelResolved = (c) => {
-            if (c?.enrichment?.done !== true)
-              return false;
-            if (params.email && !c.email)
+          const inThisRun = (c) => {
+            if (params.email && c.enrichment.email_requested === false)
               return false;
-            if (params.phone && !c.phone_number)
+            if (params.phone && c.enrichment.phone_requested === false)
               return false;
             return true;
           };
+          const settled = (c) => c.enrichment.done === true;
           let doneSoFar = 0;
           const totalLeads = leadIds.length;
           const results = await pMap(leadIds, async (leadId) => {
             try {
               const out = await getContacts.execute(client, { leadId });
               const contacts = Array.isArray(out?.contacts) ? out.contacts : [];
-              const enrichable = contacts.filter((c) => c && c.enrichment && (wantTitles.size === 0 || typeof c.job_title === "string" && wantTitles.has(c.job_title.trim().toLowerCase())));
+              const enrichable = contacts.filter((c) => c && c.enrichment && inThisRun(c) && (wantTitles.size === 0 || typeof c.job_title === "string" && wantTitles.has(c.job_title.trim().toLowerCase())));
               const fe = Array.isArray(out?._fetch_errors) ? out._fetch_errors : [];
               doneSoFar += 1;
               ctx?.progress?.({
@@ -20413,7 +20434,7 @@ var init_bulk_enrich_status = __esm({
               return {
                 kind: "ok",
                 lead_id: leadId,
-                done: enrichable.filter(channelResolved).length,
+                done: enrichable.filter(settled).length,
                 total: enrichable.length,
                 ...includeContacts ? { contacts } : {}
               };
@@ -21552,7 +21573,7 @@ function mockedSubmitPreview(submit, tool, region) {
       error: true,
       code: "MALFORMED_SUBMIT_RESPONSE",
       message: `${tool}: the submit succeeded but the response carried no job_id, so the job cannot be polled.`,
-      hint: "The job may still be running server-side. Do not re-submit blindly \u2014 reuse the same request_id so a retry dedupes instead of double-spending."
+      hint: "The job may still be running server-side. Do not re-submit blindly \u2014 reuse the same request_id so a retry dedupes instead of launching twice."
     };
   }
   return {
@@ -21564,15 +21585,88 @@ function mockedSubmitPreview(submit, tool, region) {
     region
   };
 }
-function splitItems(snapshot) {
-  const leads = [];
-  const skipped = [];
-  for (const item of snapshot.items) {
-    if (item.status === "skipped")
-      skipped.push(item);
-    else
-      leads.push(item);
+function clip(s, n) {
+  if (typeof s !== "string" || s.length === 0)
+    return void 0;
+  return s.length <= n ? s : s.slice(0, n - 1).trimEnd() + "\u2026";
+}
+function compactContact(c) {
+  if (!c || typeof c !== "object")
+    return c ?? null;
+  const channels = {};
+  for (const [name, state] of Object.entries(c.channels ?? {})) {
+    const s = state;
+    channels[name] = s?.value != null ? { status: s.status, value: s.value } : { status: s?.status };
   }
+  return {
+    lead_contact_id: c.lead_contact_id,
+    name: c.name,
+    role: clip(c.role, 80),
+    linkedin: c.linkedin,
+    channels
+  };
+}
+function compactLead(lead, lean = false) {
+  const company = lead.company ?? {};
+  const fit = lead.fit ?? {};
+  const q = fit.components?.qualification ?? {};
+  const answers = Array.isArray(q.questions) ? q.questions : [];
+  const best = answers.filter((a) => a?.verdict === "yes").sort((a, b) => (b?.score ?? 0) - (a?.score ?? 0))[0];
+  const signals = (Array.isArray(lead.signals) ? lead.signals : []).filter((s) => s?.summary).sort((a, b) => Number(!!b.hot) - Number(!!a.hot) || String(b.date ?? "").localeCompare(String(a.date ?? ""))).slice(0, MAX_SIGNALS).map((s) => ({ summary: clip(s.summary, SIGNAL_CHARS), date: s.date, source_url: s.source_url }));
+  const location = company.location ? { city: company.location.city, region: company.location.region, country: company.location.country } : void 0;
+  return {
+    lead_id: lead.lead_id,
+    company: {
+      name: company.name,
+      website: company.website,
+      location,
+      employees: company.employees,
+      // Kept on trimmed rows too: it is the rendering rules' last fallback for
+      // "why it fits" once the reason and the tags are gone.
+      description: clip(company.description ?? company.short_description, lean ? 80 : 140)
+    },
+    fit: {
+      available: fit.available,
+      score: fit.score,
+      reasoning: lean ? void 0 : clip(best?.reasoning ?? q.ibp?.reasoning, LEAD_REASON_CHARS),
+      components: {
+        qualification: {
+          available: q.available,
+          ai_score: q.ai_score,
+          matched_tags: lean ? void 0 : (Array.isArray(q.matched_tags) ? q.matched_tags : []).map((t) => typeof t === "string" ? t : t?.tag).filter(Boolean)
+        }
+      }
+    },
+    signals: lean ? void 0 : signals,
+    contact: compactContact(lead.contact),
+    alternative_contacts: lean ? void 0 : (Array.isArray(lead.alternative_contacts) ? lead.alternative_contacts : []).slice(0, MAX_ALTERNATIVE_CONTACTS).map(compactContact),
+    // Unbounded, so only full rows carry it: they are measured, trimmed rows
+    // are only reserved for.
+    custom_fields: !lean && Array.isArray(lead.custom_fields) && lead.custom_fields.length > 0 ? lead.custom_fields : void 0,
+    evidence_trimmed: lean ? true : void 0
+  };
+}
+function splitItems(snapshot) {
+  const leanRow = (item) => ({
+    ref: item.ref,
+    status: item.status,
+    status_reason: item.status_reason,
+    ...item.resolution ? { resolution: item.resolution } : {},
+    seq: item.seq,
+    ...item.lead ? { lead: compactLead(item.lead, true) } : {}
+  });
+  const skipped = snapshot.items.filter((i) => i.status === "skipped").map(leanRow);
+  const rows = snapshot.items.filter((i) => i.status !== "skipped");
+  let room = RESULT_CHARS - JSON.stringify(skipped).length;
+  const leads = rows.map((item, i) => {
+    const { from_cache: _fromCache, ...rest } = item;
+    const full = item.lead ? { ...rest, lead: compactLead(item.lead) } : rest;
+    const fullChars = JSON.stringify(full).length;
+    const reserve = (rows.length - i - 1) * LEAN_ROW_CHARS;
+    const out = fullChars + reserve <= room ? full : leanRow(item);
+    room -= out === full ? fullChars : JSON.stringify(out).length;
+    return out;
+  });
   return { leads, skipped };
 }
 function compactBody(body) {
@@ -21623,7 +21717,7 @@ function rejectMalformedExclusions(ids) {
     error: true,
     code: "INVALID_EXCLUDE_LEAD_ID",
     message: `exclude_lead_ids has ${bad.length} entr${bad.length === 1 ? "y" : "ies"} that is not a lead id: ${bad.join(", ")}.`,
-    hint: "Drop or fix those entries and re-call \u2014 every entry must be a non-blank lead id string. Silently skipping them would run the search without an exclusion you asked for, and could re-deliver and charge for that exact lead."
+    hint: "Drop or fix those entries and re-call \u2014 every entry must be a non-blank lead id string. Silently skipping them would run the search without an exclusion you asked for, and could re-deliver that exact lead and use quota on it again."
   };
 }
 function rejectOversizedExclusions(ids) {
@@ -21678,7 +21772,7 @@ function readSpendFlag(value, field) {
     error: true,
     code: "BAD_INPUT",
     message: `${field} must be a boolean (got ${Array.isArray(value) ? "array" : typeof value}: ${JSON.stringify(value)}).`,
-    hint: `Re-call the tool with ${field}: true or ${field}: false as a JSON boolean, not a string or a number. This flag decides whether the user is charged, so an unrecognised value is refused rather than guessed.`
+    hint: `Re-call the tool with ${field}: true or ${field}: false as a JSON boolean, not a string or a number. This flag decides whether the run uses the org's quota, so an unrecognised value is refused rather than guessed.`
   };
 }
 function rejectCountryLocations(locations, region) {
@@ -21729,7 +21823,7 @@ function clampWaitSeconds(requested, fallback) {
     return fallback;
   return Math.min(Math.max(requested, 0), 180);
 }
-var TERMINAL_JOB_STATES, MCP_JOB_POLL, SNAPSHOT_TIMEOUT_MS, PAGE_LIMIT, MAX_JOB_ITEMS, MIN_PAGES, maxPagesFor, JOB_ID_CHARSET, MAX_JOB_ID_LENGTH, UUID_RE2, COUNTRY_ALIASES, SUBNATIONAL_EXEMPTIONS, ALL_EXEMPTIONS, COUNTRY_LOCATION_VALUES, MAX_EXCLUDE_LEAD_IDS, MAX_LEAD_REFS;
+var TERMINAL_JOB_STATES, MCP_JOB_POLL, SNAPSHOT_TIMEOUT_MS, PAGE_LIMIT, MAX_JOB_ITEMS, MIN_PAGES, maxPagesFor, JOB_ID_CHARSET, MAX_JOB_ID_LENGTH, UUID_RE2, LEAD_REASON_CHARS, SIGNAL_CHARS, MAX_SIGNALS, MAX_ALTERNATIVE_CONTACTS, RESULT_CHARS, LEAN_ROW_CHARS, COUNTRY_ALIASES, SUBNATIONAL_EXEMPTIONS, ALL_EXEMPTIONS, COUNTRY_LOCATION_VALUES, MAX_EXCLUDE_LEAD_IDS, MAX_LEAD_REFS;
 var init_mcp_job_helpers = __esm({
   "../core/dist/composite/_mcp-job-helpers.js"() {
     "use strict";
@@ -21749,6 +21843,12 @@ var init_mcp_job_helpers = __esm({
     JOB_ID_CHARSET = /^[A-Za-z0-9._~-]+$/;
     MAX_JOB_ID_LENGTH = 200;
     UUID_RE2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    LEAD_REASON_CHARS = 180;
+    SIGNAL_CHARS = 140;
+    MAX_SIGNALS = 2;
+    MAX_ALTERNATIVE_CONTACTS = 1;
+    RESULT_CHARS = 52e3;
+    LEAN_ROW_CHARS = 700;
     COUNTRY_ALIASES = [
       "united states",
       "united states of america",
@@ -21862,7 +21962,7 @@ var init_find_new_leads = __esm({
           },
           qualify: {
             type: "boolean",
-            description: "Run fresh AI qualification and drop candidates scoring below min_ai_score. PAID: ~94 cost_cents per candidate EXAMINED (survivor or not). Default false (free)."
+            description: "Run fresh AI qualification and drop candidates scoring below min_ai_score. Uses the org's usage quota for every candidate EXAMINED (survivor or not). Default false (free)."
           },
           min_ai_score: {
             type: "number",
@@ -21881,7 +21981,7 @@ var init_find_new_leads = __esm({
           channels: {
             type: "array",
             items: { type: "string", enum: ["email", "phone"] },
-            description: "Contact channels to PURCHASE (email 25c, phone 250c, billed on success only). Empty = free identity tier."
+            description: "Contact channels to find (email, phone). Uses the org's usage quota only when a value is found. Empty = free identity tier."
           },
           exclude_lead_ids: {
             type: "array",
@@ -21895,7 +21995,7 @@ var init_find_new_leads = __esm({
           },
           max_cost: {
             type: "number",
-            description: "Spend cap for the whole job in cost_cents. Defaults by plan tier (500/2000/5000). The job stops honestly at the cap (stop_reason max_cost)."
+            description: "Usage cap for the whole job, in internal units. Leave it unset: the default (100000) covers any job. What the requested channels need is kept for them; a cap below that is refused, naming the minimum. Never show it to the user as money."
           },
           exploration_cap: {
             type: "number",
@@ -21903,20 +22003,20 @@ var init_find_new_leads = __esm({
           },
           request_id: {
             type: "string",
-            description: "REQUIRED idempotency key. Derive it from the ask (e.g. 'gyms-texas-2026-07-28'); REUSE the exact same value when retrying the same ask \u2014 a duplicate returns the SAME job instead of double-spending. Use a NEW value only for a genuinely new ask."
+            description: "REQUIRED idempotency key. Derive it from the ask (e.g. 'gyms-texas-2026-07-28'); REUSE the exact same value when retrying the same ask \u2014 a duplicate returns the SAME job instead of launching twice. Use a NEW value only for a genuinely new ask."
           },
           lang: { type: "string", description: "Output language (default: user's language)." },
           confirm: {
             type: "boolean",
-            description: "Explicit spend decision, required only for a PAID search (qualify:true and/or channels). true = the user approved the quote, go ahead. false = a veto (returns mode:'needs_confirmation', spends nothing). Omitted on a paid call \u2192 the tool withholds the submit and returns a free quote to show the user first. The default FREE search (no qualify, no channels) needs no confirm."
+            description: "Explicit go-ahead, required only for a search that uses quota (qualify:true and/or channels). true = the user approved the quote, go ahead. false = a veto (returns mode:'needs_confirmation', uses nothing). Omitted on such a call \u2192 the tool withholds the submit and returns a free quote to show the user first. The default FREE search (no qualify, no channels) needs no confirm."
           },
           dry_run: {
             type: "boolean",
-            description: "Validate + worst-case cost estimate + quota forecast. No job, no spend. Use before the first PAID run of a session."
+            description: "Validate + worst-case usage estimate + quota forecast. No job, uses nothing. Use before the first quota-using run of a session."
           },
           wait_seconds: {
             type: "number",
-            description: "How long to poll before returning (default 45, max 180, 0 = submit + one snapshot). Free searches usually finish inside the window; paid exploration can take minutes \u2014 the result then carries still_running:true and the job_id to check with leadbay_lead_job_status."
+            description: "How long to poll before returning (default 45, max 180, 0 = submit + one snapshot). Free searches usually finish inside the window; qualified exploration can take minutes \u2014 the result then carries still_running:true and the job_id to check with leadbay_lead_job_status."
           }
         },
         required: ["count", "request_id"],
@@ -22018,13 +22118,13 @@ var init_find_new_leads = __esm({
             submitted: false,
             vetoed,
             paid_because: [
-              buysQualification ? "qualify: true (~94 cost_cents per candidate EXAMINED)" : null,
+              buysQualification ? "qualify: true (uses quota per candidate examined)" : null,
               buysChannels ? `channels requested: ${params.channels.join(", ")}` : null
             ].filter(Boolean),
             quote: forecast,
             estimated_cost: forecast?.estimated_cost ?? null,
             items_requested: forecast?.items_requested ?? null,
-            hint: vetoed ? "confirm:false vetoed the spend \u2014 nothing was submitted. Re-call with confirm:true to proceed, or drop qualify/channels for a free search." : "Show the user this worst-case quote and get an explicit go-ahead, then re-call with confirm:true. For a free search instead: omit qualify and channels.",
+            hint: vetoed ? "confirm:false vetoed the run \u2014 nothing was submitted. Re-call with confirm:true to proceed, or drop qualify/channels for a free search." : "Tell the user what will run and that it uses their plan's quota (no amounts, no money), get an explicit go-ahead, then re-call with confirm:true. For a free search instead: omit qualify and channels.",
             region: client.region
           };
         }
@@ -22240,7 +22340,7 @@ var init_qualify_leads = __esm({
           },
           prior_deliveries: {
             type: "object",
-            description: "Selector expanding the org's past MCP deliveries into refs \u2014 billed leads stay re-readable after result expiry. Combine with lead_refs or use alone.",
+            description: "Selector expanding the org's past MCP deliveries into refs \u2014 delivered leads stay re-readable after result expiry. Combine with lead_refs or use alone.",
             properties: {
               job_id: { type: "string" },
               since: { type: "string", description: "ISO instant lower bound." },
@@ -22250,7 +22350,7 @@ var init_qualify_leads = __esm({
           },
           qualify: {
             type: "boolean",
-            description: "Fresh AI qualification (default true; ~94 cost_cents per lead needing fresh research+scoring, cache-free when a fresh dossier exists). Owned disqualified leads come back WITH their negative evidence."
+            description: "Fresh AI qualification (default true; uses the org's usage quota for each lead needing fresh research+scoring, none when a fresh dossier exists). Owned disqualified leads come back WITH their negative evidence."
           },
           contact_titles: {
             type: "array",
@@ -22265,24 +22365,24 @@ var init_qualify_leads = __esm({
           channels: {
             type: "array",
             items: { type: "string", enum: ["email", "phone"] },
-            description: "Channels to PURCHASE (email 25c, phone 250c, success-only, already-owned values are free). Empty = free identity tier."
+            description: "Channels to find (email, phone). Uses the org's usage quota only when a value is found; already-owned values are free. Empty = free identity tier."
           },
           max_cost: {
             type: "number",
-            description: "Spend cap in cost_cents (plan-tier default when unset)."
+            description: "Usage cap in internal units; leave it unset (default 100000). What the requested channels need is kept for them; a cap below that is refused, naming the minimum. Never show it as money."
           },
           request_id: {
             type: "string",
-            description: "Recommended idempotency key \u2014 REUSE the same value when retrying the same batch so a retry returns the SAME job instead of re-spending."
+            description: "Recommended idempotency key \u2014 REUSE the same value when retrying the same batch so a retry returns the SAME job instead of running it again."
           },
           lang: { type: "string", description: "Output language (default: user's language)." },
           confirm: {
             type: "boolean",
-            description: "Explicit spend decision for the PAID work (fresh qualification and/or channel purchases). true = the user approved the quote, go ahead. false = a veto (returns mode:'needs_confirmation', spends nothing). Omitted on a paid call \u2192 the tool withholds the submit and returns a free quote to show the user first. A fully FREE call (qualify:false and no channels) needs no confirm."
+            description: "Explicit go-ahead for the work that uses quota (fresh qualification and/or channels). true = the user approved, go ahead. false = a veto (returns mode:'needs_confirmation', uses nothing). Omitted on such a call \u2192 the tool withholds the submit and returns a free quote to show the user first. A fully FREE call (qualify:false and no channels) needs no confirm."
           },
           dry_run: {
             type: "boolean",
-            description: "Validate + worst-case cost + quota forecast. No job, no spend."
+            description: "Validate + worst-case usage + quota forecast. No job, uses nothing."
           },
           wait_seconds: {
             type: "number",
@@ -22342,7 +22442,7 @@ var init_qualify_leads = __esm({
             quote: forecast,
             estimated_cost: forecast?.estimated_cost ?? null,
             items_requested: forecast?.items_requested ?? null,
-            hint: vetoed ? "confirm:false vetoed the spend \u2014 nothing was submitted. Re-call with confirm:true to proceed, or qualify:false with no channels for a free pass." : "Show the user this worst-case quote and get an explicit go-ahead, then re-call with confirm:true. For a free pass instead: qualify:false and no channels.",
+            hint: vetoed ? "confirm:false vetoed the run \u2014 nothing was submitted. Re-call with confirm:true to proceed, or qualify:false with no channels for a free pass." : "Tell the user what will run and that it uses their plan's quota (no amounts, no money), get an explicit go-ahead, then re-call with confirm:true. For a free pass instead: qualify:false and no channels.",
             region: client.region
           };
         }
@@ -24542,7 +24642,7 @@ What Leadbay does need is anything that changes **who it should find**. When the
 
 Build me a Leadbay campaign from scratch{{arg:campaign_name_paren}} \u2014 a cohort of **{{arg:count_or_default}}** fully-actionable leads: each in-ICP, high \`ai_agent_lead_score\`, AND with a reachable buyer contact. {{arg:audience_block}} {{arg:job_titles_block}}
 
-**Run this end-to-end, autonomously, without pausing.** Do NOT stop to confirm the audience, do NOT stop to confirm the enrichment spend, do NOT ask me to pick, and do NOT stop to hand off \u2014 just keep discovering, qualifying, enriching, and swapping until the cohort holds **{{arg:count_or_default}}** leads that each meet EVERY requirement (in-ICP, high \`ai_agent_lead_score\`, and a reachable target-title contact whose email/phone actually landed). The ONLY reasons to stop short: the lens genuinely can't supply that many buyer-ready in-ICP leads, or enrichment quota is exhausted (a backend 429). In those cases, finish with whatever you locked and tell me plainly how many you got and why it stopped. Enrichment consumes quota, not credits \u2014 never pre-refuse on a credit balance.
+**Run this end-to-end, autonomously, without pausing.** Do NOT stop to confirm the audience, do NOT stop to confirm the enrichment, do NOT ask me to pick, and do NOT stop to hand off \u2014 just keep discovering, qualifying, enriching, and swapping until the cohort holds **{{arg:count_or_default}}** leads that each meet EVERY requirement (in-ICP, high \`ai_agent_lead_score\`, and a reachable target-title contact whose email/phone actually landed). The ONLY reasons to stop short: the lens genuinely can't supply that many buyer-ready in-ICP leads, or enrichment quota is exhausted (a backend 429). In those cases, finish with whatever you locked and tell me plainly how many you got and why it stopped. Enrichment consumes quota, not credits \u2014 never pre-refuse on a credit balance.
 
 GATE \u2014 DEFER TO TOOL RENDERING. When you call a Leadbay composite that ships its own RENDERING block (every composite in 0.9.0+ does), render the response using that block's recipe verbatim \u2014 score bars, glyph palette, column order, hide-list, link priorities, all of it. Do NOT substitute prose, a numbered list, or a different column structure even when an orchestrating prompt's body suggests alternate framing. Prompt-specific commentary (motivational nudges, summaries, next-action recommendations) belongs ABOVE or BELOW the canonical table, never in place of it.
 
@@ -24580,7 +24680,7 @@ If \`pull_leads\` itself fails and you have no prior batch, then yes \u2014 retr
 Leadbay has no cancel. Once \`leadbay_enrich_titles\`, \`leadbay_bulk_qualify_leads\`,
 \`leadbay_import_leads\` or \`leadbay_import_and_qualify\` has returned a launched or
 running result, that work is queued on Leadbay and runs to completion, and the
-quota it costs is already committed. A discovery, preview or \`dry_run\` result
+quota it uses is already committed. A discovery, preview or \`dry_run\` result
 launched nothing and is not covered here.
 
 The user cancelling in the chat, a request timeout, or a closed stream stops YOUR
@@ -24588,7 +24688,7 @@ waiting, never the job. \`cancelled: true\` means we stopped watching, not that
 work stopped. What to do next depends on what you are holding:
 
 - **A handle.** Poll the status tool with it, and do not launch the work that
-  handle covers a second time \u2014 that spends the quota again on the same rows.
+  handle covers a second time \u2014 that uses the quota again on the same rows.
   \`leadbay_import_status\` takes \`importIds\`, so pass the values of \`import_ids\`
   under that name. A qualification started by \`leadbay_import_and_qualify\` has no
   notification of its own: resume it with
@@ -24602,7 +24702,7 @@ work stopped. What to do next depends on what you are holding:
   finished. Calling the same tool again with the same arguments will usually hand
   back the job already launched rather than starting a second one, but that guard
   is in-memory, five minutes, and per process, so it is best-effort \u2014 say what you
-  are about to re-run before you spend the user's quota on it.
+  are about to re-run before you use the user's quota on it.
 
 
 
@@ -24701,7 +24801,7 @@ If I named specific leads, seed with those (still apply the Phase 3 buyer-covera
 
 # PHASE 3 \u2014 ENRICH THE RIGHT CONTACTS (load-bearing)
 
-This is the phase that decides whether the campaign is worth a salesperson's time. Contacts aren't attached by default and enrichment is paid \u2014 so spend it ONLY on the people who would actually **buy what I sell**, at the target titles, not on whoever is most senior.
+This is the phase that decides whether the campaign is worth a salesperson's time. Contacts aren't attached by default and enrichment uses quota \u2014 so use it ONLY on the people who would actually **buy what I sell**, at the target titles, not on whoever is most senior.
 
 **Step A \u2014 settle the target titles / buyer persona.**
 
@@ -24727,7 +24827,7 @@ Call \`leadbay_recall_ordered_titles({leadIds, lensId})\` and \`leadbay_enrich_t
 
 Tell me what you swapped in one line ("dropped Corbett + RBS \u2014 ops-only; swapped in Acme + Globex which have Sales VPs").
 
-**Step C \u2014 enrich (NO confirm gate \u2014 just spend).** You do NOT need my permission: I authorized this spend by asking for the campaign. Do NOT call \`ask_user_input_v0\`, do NOT ask "enrich these N now?", do NOT wait. State the persona + titles + "enriching {enrichable_contacts} contacts (email + phone, consumes quota)" in one line for the record, then immediately launch: \`leadbay_enrich_titles({leadIds, lensId, titles:[...chosen], email:true, phone:true})\`. Enrich up to {{arg:count_or_default}} best target-title contacts. Do NOT quote a "credits" figure or refuse on a credit balance \u2014 the only real limit is quota (a backend 429). If a 429 stops you mid-run, keep the leads already enriched, note how many landed, and continue to Phase 4 with those.
+**Step C \u2014 enrich (NO confirm gate \u2014 just launch).** You do NOT need my permission: I authorized this enrichment by asking for the campaign. Do NOT call \`ask_user_input_v0\`, do NOT ask "enrich these N now?", do NOT wait. State the persona + titles + "enriching {enrichable_contacts} contacts (email + phone, consumes quota)" in one line for the record, then immediately launch: \`leadbay_enrich_titles({leadIds, lensId, titles:[...chosen], email:true, phone:true})\`. Enrich up to {{arg:count_or_default}} best target-title contacts. Do NOT quote a "credits" figure or refuse on a credit balance \u2014 the only real limit is quota (a backend 429). If a 429 stops you mid-run, keep the leads already enriched, note how many landed, and continue to Phase 4 with those.
 
 **Step D \u2014 poll + count only landed.** Poll \`leadbay_bulk_enrich_status\` until done (enrichment can take several minutes \u2014 keep polling, don't render an empty sheet prematurely). Once \`all_done\`, call \`leadbay_account_status\` and show my refreshed quota so I see what the run consumed. A lead only counts toward the {{arg:count_or_default}} once its target-title contact actually landed (email/phone present); if some came back empty, swap + enrich replacements (loop back to Step B.5) until the cohort is genuinely {{arg:count_or_default}} deep or the lens is exhausted.
 
@@ -24752,7 +24852,7 @@ Building a campaign is NOT outreaching \u2014 do not send anything and do not ca
 # Iron laws
 
 - **Run to the goal, autonomously.** Keep discovering \u2192 qualifying \u2192 enriching \u2192 swapping until the cohort holds {{arg:count_or_default}} leads that are ALL in-ICP, high-score, and buyer-covered \u2014 or the lens is genuinely exhausted. Do NOT stop early, do NOT ask me to pick, do NOT hand off mid-flow.
-- **No confirm gates. No pauses.** Do NOT confirm the audience switch, and do NOT confirm the enrichment spend (no \`ask_user_input_v0\` before enriching) \u2014 asking for the campaign IS the authorization. The only acceptable stops are lens exhaustion or a backend 429.
+- **No confirm gates. No pauses.** Do NOT confirm the audience switch, and do NOT confirm the enrichment (no \`ask_user_input_v0\` before enriching) \u2014 asking for the campaign IS the authorization. The only acceptable stops are lens exhaustion or a backend 429.
 - Enrichment targets MY buyer titles \u2014 the people who would actually buy what *I* sell (my given titles, or the persona derived from my product/ICP) \u2014 NOT generic seniority. For a sales/prospecting tool that means the revenue org; a Director of Operations, COO, or logistics manager is useless no matter how senior.
 - Selection is DATA-DRIVEN (\`leadbay_recall_ordered_titles\` + \`leadbay_enrich_titles\` discovery) but FILTERED to the target titles \u2014 never blindly repeat past-enriched or suggested titles that don't match who buys my product.
 - The FINAL cohort must be all buyer-ready: a lead counts only once its target-title contact actually landed. Drop/swap + re-enrich any lead with no reachable buyer rather than shipping it empty.
@@ -24802,7 +24902,7 @@ If \`pull_leads\` itself fails and you have no prior batch, then yes \u2014 retr
 Leadbay has no cancel. Once \`leadbay_enrich_titles\`, \`leadbay_bulk_qualify_leads\`,
 \`leadbay_import_leads\` or \`leadbay_import_and_qualify\` has returned a launched or
 running result, that work is queued on Leadbay and runs to completion, and the
-quota it costs is already committed. A discovery, preview or \`dry_run\` result
+quota it uses is already committed. A discovery, preview or \`dry_run\` result
 launched nothing and is not covered here.
 
 The user cancelling in the chat, a request timeout, or a closed stream stops YOUR
@@ -24810,7 +24910,7 @@ waiting, never the job. \`cancelled: true\` means we stopped watching, not that
 work stopped. What to do next depends on what you are holding:
 
 - **A handle.** Poll the status tool with it, and do not launch the work that
-  handle covers a second time \u2014 that spends the quota again on the same rows.
+  handle covers a second time \u2014 that uses the quota again on the same rows.
   \`leadbay_import_status\` takes \`importIds\`, so pass the values of \`import_ids\`
   under that name. A qualification started by \`leadbay_import_and_qualify\` has no
   notification of its own: resume it with
@@ -24824,7 +24924,7 @@ work stopped. What to do next depends on what you are holding:
   finished. Calling the same tool again with the same arguments will usually hand
   back the job already launched rather than starting a second one, but that guard
   is in-memory, five minutes, and per process, so it is best-effort \u2014 say what you
-  are about to re-run before you spend the user's quota on it.
+  are about to re-run before you use the user's quota on it.
 
 
 
@@ -25064,7 +25164,7 @@ If \`pull_leads\` itself fails and you have no prior batch, then yes \u2014 retr
 Leadbay has no cancel. Once \`leadbay_enrich_titles\`, \`leadbay_bulk_qualify_leads\`,
 \`leadbay_import_leads\` or \`leadbay_import_and_qualify\` has returned a launched or
 running result, that work is queued on Leadbay and runs to completion, and the
-quota it costs is already committed. A discovery, preview or \`dry_run\` result
+quota it uses is already committed. A discovery, preview or \`dry_run\` result
 launched nothing and is not covered here.
 
 The user cancelling in the chat, a request timeout, or a closed stream stops YOUR
@@ -25072,7 +25172,7 @@ waiting, never the job. \`cancelled: true\` means we stopped watching, not that
 work stopped. What to do next depends on what you are holding:
 
 - **A handle.** Poll the status tool with it, and do not launch the work that
-  handle covers a second time \u2014 that spends the quota again on the same rows.
+  handle covers a second time \u2014 that uses the quota again on the same rows.
   \`leadbay_import_status\` takes \`importIds\`, so pass the values of \`import_ids\`
   under that name. A qualification started by \`leadbay_import_and_qualify\` has no
   notification of its own: resume it with
@@ -25086,7 +25186,7 @@ work stopped. What to do next depends on what you are holding:
   finished. Calling the same tool again with the same arguments will usually hand
   back the job already launched rather than starting a second one, but that guard
   is in-memory, five minutes, and per process, so it is best-effort \u2014 say what you
-  are about to re-run before you spend the user's quota on it.
+  are about to re-run before you use the user's quota on it.
 
 
 
@@ -25273,7 +25373,7 @@ days"), computed against now \u2014 mirroring the widget's "r\xE9initialis\xE9 d
 raw value is an ISO-8601 timestamp.
 
 **Top-up (optional, subordinate).** When \`quota.topup\` is present, you MAY add one
-small line below the windows: \`Top-up: $<remaining_cents/100> of $<total_credit_cents/100> left\`.
+small line below the windows: \`Top-up: $<(remaining_cents / 100).toFixed(2)> of $<(total_credit_cents / 100).toFixed(2)> left\`.
 Keep it secondary \u2014 the three window gauges are the headline. Omit when null.
 
 **Legend** (once, below): \`\` \`\u25B0\` used \xB7 \`\u25B1\` remaining \`\`.
@@ -25442,9 +25542,9 @@ Say plainly that this only **drafts** \u2014 nothing is sent, and they see it fi
 On click: call \`leadbay_prepare_outreach\` with \`leadId\` = the top lead's id,
 **and nothing else**.
 
-**This gate spends NOTHING. Never pass \`enrich: true\`** \u2014 that launches a paid
+**This gate uses NO quota. Never pass \`enrich: true\`** \u2014 that launches a
 contact reveal off the back of a *draft* click. They agreed to see an email
-written, not to spend. GATE 4 is where the reveal gets asked for, on its own
+written, not to reveal anyone. GATE 4 is where the reveal gets asked for, on its own
 terms.
 
 \`recommended_contact\` comes back in its post-enrichment shape with \`email\` and
@@ -25478,7 +25578,7 @@ pitching whoever answers the switchboard \u2014 the difference between a
 conversation and a dead end.
 
 Say plainly that the first look is **free**, and that revealing the contact
-costs credits and needs their say-so.
+uses a little of their plan's quota and needs their say-so.
 
 **First, check \`leadbay_enrich_titles\` is in your tool set.** On a read-only
 deployment it is not registered, and a gate whose tool cannot run is a dead
@@ -25491,23 +25591,23 @@ does nothing.
 
 This gate runs in **TWO BEATS**. Do not collapse them.
 
-## BEAT 1 \u2014 the free look (spends nothing)
+## BEAT 1 \u2014 the free look (uses no quota)
 
 On click: call \`leadbay_enrich_titles\` with \`leadIds\` = **the one lead you
 drafted for at GATE 3** and \`lensId\` = the pinned lens id.
 
-**This call must spend NOTHING.** Omit \`titles\` entirely: that returns
+**This call must use NO quota.** Omit \`titles\` entirely: that returns
 \`mode:"discover"\`, the free preview of which job titles exist at that company.
 Do NOT pass \`titles\`, \`confirm=true\`, \`email=true\` or \`phone=true\` on this call
-\u2014 any one of them launches the paid reveal before the user has chosen anything.
+\u2014 any one of them launches the reveal before the user has chosen anything.
 
-Present the discovered titles and say plainly: "nothing spent yet."
+Present the discovered titles and say plainly: "nothing revealed yet."
 
-## BEAT 2 \u2014 reveal the person the draft is for (spends credits)
+## BEAT 2 \u2014 reveal the person the draft is for (uses quota)
 
-Name the title the GATE 3 draft is addressed to, and tell them the cost
-**before** they decide: one credit per contact revealed \u2014 here that's **one
-contact, one credit**. Then ask them to confirm.
+Name the title the GATE 3 draft is addressed to, and tell them **before** they
+decide that revealing **one contact** uses a little of their plan's quota. No
+amount, no price. Then ask them to confirm.
 
 **Wait for an explicit confirmation.** Silence is not consent, and neither is
 "they clicked the gate earlier" \u2014 the gate click bought the free look, not the
@@ -25515,13 +25615,13 @@ reveal.
 
 Once confirmed, call \`leadbay_enrich_titles\` AGAIN with
 \`leadIds: [<the drafted lead's id>]\` \u2014 **the array, always, even for one lead**
-\u2014 plus the chosen \`titles\`, \`confirm: true\` and \`email: true\`. That's the real,
-paid reveal.
+\u2014 plus the chosen \`titles\`, \`confirm: true\` and \`email: true\`. That's the real
+reveal.
 
 \`leadIds\` is the only key this tool reads for scope. A singular \`leadId\` is not
 a parameter: it is silently ignored, and the call then falls back to the
 account's **default wishlist selection** while \`confirm\`/\`email\` are set \u2014 so
-it would reveal and charge for the whole batch instead of the one lead the user
+it would reveal the whole batch instead of the one lead the user
 agreed to.
 
 It returns a \`notification_id\` and runs async \u2014 poll \`leadbay_bulk_enrich_status\`
@@ -25530,8 +25630,8 @@ count plateaus across a few spaced polls. Then report the contact that actually
 resolved: name, title, and the email/phone that came back. Contacts sometimes
 don't resolve; say so honestly rather than implying success.
 
-**Then close the loop** \u2014 one line: one credit per contact revealed, so this
-cost one. And say the thing that makes it land: the draft from GATE 3 now has a
+**Then close the loop** \u2014 one line: the reveal used a little of their plan's
+quota, never a price. And say the thing that makes it land: the draft from GATE 3 now has a
 real person and a real address to go to. This is the moment GATE 1's quota
 numbers stop being abstract, because they just watched them move and got
 something for it. Don't turn it into a pricing pitch.
@@ -25891,12 +25991,12 @@ Call \`leadbay_find_new_leads\` with the seed, \`filters\`, \`count\`,
 from the ask + the ARCHETYPE + today's date. \`count\` is the TOTAL I asked
 for, not a per-search number: with two archetypes and a request for 10,
 split it (5 + 5, or whatever weighting fits my ask) rather than sending 10
-to each \u2014 otherwise I get 20 leads and, on the paid pass, pay for 20.
+to each \u2014 otherwise I get 20 leads and, on the qualifying pass, use quota on 20.
 
 When you RETRY a search \u2014 it timed out, or the job is still live \u2014 reuse the
 \`request_id\` you already sent, verbatim. Do not recompute it: rederiving from
 "today's date" after midnight yields a new key, the backend cannot dedupe, and
-a second paid, novelty-claiming search launches. Roll the date only when I am
+a second quota-using, novelty-claiming search launches. Roll the date only when I am
 genuinely asking for a new batch. The archetype component is not
 optional: \`request_id\` is the idempotency key, so two archetype searches
 sharing one id dedupe to the same job and the second archetype is never
@@ -25911,52 +26011,54 @@ kind of companies I asked for?
 - **Off-profile or empty** (terminal) \u2192 read \`funnel\` +
   \`explain.scope_notes\`, tell me what went wrong in one line (wrong
   archetype? too narrow a filter? thin universe?), reshape the seed or
-  filters, and retry under a NEW request_id. Reshaping is free; do not pay
-  to explore a bad seed.
+  filters, and retry under a NEW request_id. Reshaping is free; do not use
+  quota to explore a bad seed.
 
-# PHASE 4 \u2014 PAID DEPTH (only with my explicit go-ahead)
+# PHASE 4 \u2014 QUALIFIED DEPTH (uses my plan's quota; only with my explicit go-ahead)
 
 When I want qualification evidence and/or reachable contacts:
-1. Quote first: \`dry_run: true\` on the tool you will actually run, with the
-   exact flags I asked for, and tell me the worst-case cost in plain money.
+1. Check first: \`dry_run: true\` on the tool you will actually run, with the
+   exact flags I asked for. Tell me what will run (how many companies, which
+   channels) and that it uses my plan's quota. No amounts and no money: my plan
+   or top-up covers this, and a price reads as a bill.
    The two tools take DIFFERENT flags \u2014 passing the wrong one is rejected
    outright (\`additionalProperties: false\`):
    - \`leadbay_qualify_leads\`: \`qualify: true\`, \`contact_titles\`,
      \`title_gate\`, \`channels\`, \`max_cost\`. **No \`min_ai_score\`.**
    - \`leadbay_find_new_leads\`: the same, PLUS \`min_ai_score\` and \`count\`.
 2. On my go-ahead, prefer feeding the free preview's deliveries to
-   \`leadbay_qualify_leads\` (\`prior_deliveries: {job_id}\`) \u2014 one paid pass PER
+   \`leadbay_qualify_leads\` (\`prior_deliveries: {job_id}\`) \u2014 one qualifying pass PER
    preview job when Phase 3 ran several archetypes, or merge their delivered
    refs into a single \`lead_refs\` call. Never qualify just the first job and
    call it done: the other archetypes are part of what I asked for. It only
-   spends on
-   companies already known to match. Paid calls need \`confirm: true\`; without
+   uses quota on
+   companies already known to match. Calls that use quota need \`confirm: true\`; without
    it the tool withholds the submit and hands back a quote instead of
-   spending. That applies to \`leadbay_find_new_leads\` too whenever you set
+   running. That applies to \`leadbay_find_new_leads\` too whenever you set
    \`qualify: true\` or ask for channels.
 
    If the preview delivered FEWER than I asked for, do both halves and do not
    conflate them: qualify what the preview already found, and run the fresh
    search only for the SHORTFALL \u2014 \`count\` = what is still missing, never the
    original number, under a NEW \`request_id\`. Reusing the preview's id dedupes
-   the paid submit back into the free job; keeping the original count buys a
+   the qualifying submit back into the free job; keeping the original count runs a
    whole second batch, because \`novelty: org\` already excludes everything the
    preview delivered.
 
-   The same arithmetic applies AFTER the paid pass. A full-count preview can
+   The same arithmetic applies AFTER the qualifying pass. A full-count preview can
    still end short once qualification disqualifies rows or a strict title /
    channel match misses: what I asked for is n QUALIFIED, CONTACTABLE leads,
    not n examined. Count the delivered-and-callable rows; if they fall short,
-   tell me the gap in one line and offer to top it up \u2014 another shortfall-sized
-   search under a NEW \`request_id\`, quoted first like any paid run. Never
-   silently hand back fewer than I asked for and paid toward.
+   tell me the gap in one line and offer to fill the gap \u2014 another shortfall-sized
+   search under a NEW \`request_id\`, confirmed first like any run that uses
+   quota. Never silently hand back fewer than I asked for.
 
-   Pass the leads already EXAMINED-AND-REJECTED into that top-up's
+   Pass the leads already EXAMINED-AND-REJECTED into that search's
    \`exclude_lead_ids\` \u2014 disqualified and skipped, from both the preview and
-   the paid pass. \`novelty: org\` already excludes prior DELIVERIES, so
+   the qualifying pass. \`novelty: org\` already excludes prior DELIVERIES, so
    delivered ids are redundant there; the rejected ones are exactly what it
-   misses, and without them the top-up re-picks the same misses and charges
-   again to close no gap. **\`exclude_lead_ids\` caps at 500** \u2014 a wide
+   misses, and without them that search re-picks the same misses and uses
+   quota again to close no gap. **\`exclude_lead_ids\` caps at 500** \u2014 a wide
    \`exploration_cap\` can examine more than that, so send the most recent 500
    rejects rather than an over-long list the tool refuses outright.
 3. While the job runs, poll with \`leadbay_lead_job_status\`
@@ -25972,7 +26074,7 @@ best fit is under 30, say "weak matches only" and propose reshaping before
 showing more than 3.
 
 Render per the lead-delivery table, then ALWAYS the funnel line: matched /
-examined / qualified / disqualified / delivered / stop reason / spend. Zero
+examined / qualified / disqualified / delivered / stop reason. Zero
 delivered gets a diagnosis and a concrete next move, never a shrug. Close
 with NEXT STEPS from the tool description \u2014 and STOP; take no further action
 without my say-so.
@@ -26127,7 +26229,7 @@ If \`pull_leads\` itself fails and you have no prior batch, then yes \u2014 retr
 Leadbay has no cancel. Once \`leadbay_enrich_titles\`, \`leadbay_bulk_qualify_leads\`,
 \`leadbay_import_leads\` or \`leadbay_import_and_qualify\` has returned a launched or
 running result, that work is queued on Leadbay and runs to completion, and the
-quota it costs is already committed. A discovery, preview or \`dry_run\` result
+quota it uses is already committed. A discovery, preview or \`dry_run\` result
 launched nothing and is not covered here.
 
 The user cancelling in the chat, a request timeout, or a closed stream stops YOUR
@@ -26135,7 +26237,7 @@ waiting, never the job. \`cancelled: true\` means we stopped watching, not that
 work stopped. What to do next depends on what you are holding:
 
 - **A handle.** Poll the status tool with it, and do not launch the work that
-  handle covers a second time \u2014 that spends the quota again on the same rows.
+  handle covers a second time \u2014 that uses the quota again on the same rows.
   \`leadbay_import_status\` takes \`importIds\`, so pass the values of \`import_ids\`
   under that name. A qualification started by \`leadbay_import_and_qualify\` has no
   notification of its own: resume it with
@@ -26149,7 +26251,7 @@ work stopped. What to do next depends on what you are holding:
   finished. Calling the same tool again with the same arguments will usually hand
   back the job already launched rather than starting a second one, but that guard
   is in-memory, five minutes, and per process, so it is best-effort \u2014 say what you
-  are about to re-run before you spend the user's quota on it.
+  are about to re-run before you use the user's quota on it.
 
 
 
@@ -26840,7 +26942,7 @@ If \`pull_leads\` itself fails and you have no prior batch, then yes \u2014 retr
 Leadbay has no cancel. Once \`leadbay_enrich_titles\`, \`leadbay_bulk_qualify_leads\`,
 \`leadbay_import_leads\` or \`leadbay_import_and_qualify\` has returned a launched or
 running result, that work is queued on Leadbay and runs to completion, and the
-quota it costs is already committed. A discovery, preview or \`dry_run\` result
+quota it uses is already committed. A discovery, preview or \`dry_run\` result
 launched nothing and is not covered here.
 
 The user cancelling in the chat, a request timeout, or a closed stream stops YOUR
@@ -26848,7 +26950,7 @@ waiting, never the job. \`cancelled: true\` means we stopped watching, not that
 work stopped. What to do next depends on what you are holding:
 
 - **A handle.** Poll the status tool with it, and do not launch the work that
-  handle covers a second time \u2014 that spends the quota again on the same rows.
+  handle covers a second time \u2014 that uses the quota again on the same rows.
   \`leadbay_import_status\` takes \`importIds\`, so pass the values of \`import_ids\`
   under that name. A qualification started by \`leadbay_import_and_qualify\` has no
   notification of its own: resume it with
@@ -26862,7 +26964,7 @@ work stopped. What to do next depends on what you are holding:
   finished. Calling the same tool again with the same arguments will usually hand
   back the job already launched rather than starting a second one, but that guard
   is in-memory, five minutes, and per process, so it is best-effort \u2014 say what you
-  are about to re-run before you spend the user's quota on it.
+  are about to re-run before you use the user's quota on it.
 
 
 
@@ -27083,11 +27185,11 @@ Cash-to-capture is not available: it needs \`ca12\` from my invoicing system, wh
 
 # PHASE 5 \u2014 CONTACTS (consent-gated)
 
-Each card needs a reachable decision-maker. \`leadbay_enrich_titles({leadIds, lensId})\` in discovery mode first \u2014 that reveals what's enrichable and spends nothing. Render whatever contact detail is already on the record; many accounts already carry a named contact.
+Each card needs a reachable decision-maker. \`leadbay_enrich_titles({leadIds, lensId})\` in discovery mode first \u2014 that reveals what's enrichable and uses no quota. Render whatever contact detail is already on the record; many accounts already carry a named contact.
 
-**Do NOT stop and wait for enrichment consent before delivering.** Asking for a plan is not authorization to spend quota on {{arg:count_or_default}} accounts \u2014 but neither is it a reason to end the turn on a spending question with no plan attached. Ship the ranked plan (Phase 6), then **offer** the paid reveal alongside it. The discovery call returned no \`titles\`, so it only told you what's *available* \u2014 **the offer must therefore carry the titles you propose to enrich AND the channels**, not just a volume: "enrich N contacts at these titles (\`<the titles you picked from available_titles / title_suggestions>\`), email only / email + phone \u2014 reveals consume quota". A bare "yes" to a volume-only question is not a mandate to pick titles yourself, and re-running discovery instead of launching wastes a turn.
+**Do NOT stop and wait for enrichment consent before delivering.** Asking for a plan is not authorization to use quota on {{arg:count_or_default}} accounts \u2014 but neither is it a reason to end the turn on a consent question with no plan attached. Ship the ranked plan (Phase 6), then **offer** the reveal alongside it. The discovery call returned no \`titles\`, so it only told you what's *available* \u2014 **the offer must therefore carry the titles you propose to enrich AND the channels**, not just a volume: "enrich N contacts at these titles (\`<the titles you picked from available_titles / title_suggestions>\`), email only / email + phone \u2014 reveals consume quota". A bare "yes" to a volume-only question is not a mandate to pick titles yourself, and re-running discovery instead of launching wastes a turn.
 
-\u26A0 **Do NOT quote a cost or a credits figure.** The per-reveal rate is backend-side and enrichment is gated by quota, not a credit balance; \`credits_remaining\` is advisory context only. A spend number invented to make the offer concrete is the same failure as an invented euro on a card.
+\u26A0 **Do NOT quote a cost or a credits figure.** The per-reveal rate is backend-side and enrichment is gated by quota, not a credit balance; \`credits_remaining\` is advisory context only. A usage number invented to make the offer concrete is the same failure as an invented euro on a card.
 
 On an explicit yes, launch with the agreed \`titles\` + channels, then poll \`leadbay_bulk_enrich_status\` until done and **keep the \`notification_id\` handles** for the deck.
 
@@ -27235,9 +27337,9 @@ ChatGPT exposes the same routing pattern via \`_meta.openai/outputTemplate\`. We
 - One short intro sentence in chat is enough \u2014 "Here are your 5 NYC follow-ups." Then route into the widget.
 
 
-\u26A0 **The deck's contact layer depends on what actually happened in Phase 5.** Bind a \`leadbay_bulk_enrich_status\` resource ONLY if a paid reveal was launched and you hold a \`notification_id\`. If the user accepted the deck but not the reveal, render the contacts already on record and carry the paid-reveal offer inside the deck \u2014 never wire a status resource with no handle (it renders permanently empty) and never launch enrichment from the deck to manufacture one.
+\u26A0 **The deck's contact layer depends on what actually happened in Phase 5.** Bind a \`leadbay_bulk_enrich_status\` resource ONLY if a reveal was launched and you hold a \`notification_id\`. If the user accepted the deck but not the reveal, render the contacts already on record and carry the reveal offer inside the deck \u2014 never wire a status resource with no handle (it renders permanently empty) and never launch enrichment from the deck to manufacture one.
 
-On acceptance, call \`leadbay_artifact_kit\`, read its \`usage_guide\` before writing any code, and build a single-file deck. Wire the live layer from the handles you kept: a poll-until-done resource per \`notification_id\` for the qualification pills, and one over \`leadbay_bulk_enrich_status\` for the contacts. \u26A0 **If enrichment already ran this session, bind the existing \`notification_id\` \u2014 re-launching enrichment from the deck double-spends my quota.** Per-card notes and outcomes go through the pre-wired note/outreach view-models (they carry the required verification and \`_triggered_by\` fields; hand-rolling those is where it breaks). Keep the checklists in local storage, and always wire a Refresh \u2014 auto-poll is host-dependent. List every tool the deck calls in its \`mcp_tools\`, and render the bridge-unavailable branch, or the pills silently show empty.
+On acceptance, call \`leadbay_artifact_kit\`, read its \`usage_guide\` before writing any code, and build a single-file deck. Wire the live layer from the handles you kept: a poll-until-done resource per \`notification_id\` for the qualification pills, and one over \`leadbay_bulk_enrich_status\` for the contacts. \u26A0 **If enrichment already ran this session, bind the existing \`notification_id\` \u2014 re-launching enrichment from the deck uses my quota twice.** Per-card notes and outcomes go through the pre-wired note/outreach view-models (they carry the required verification and \`_triggered_by\` fields; hand-rolling those is where it breaks). Keep the checklists in local storage, and always wire a Refresh \u2014 auto-poll is host-dependent. List every tool the deck calls in its \`mcp_tools\`, and render the bridge-unavailable branch, or the pills silently show empty.
 
 # Iron laws
 
@@ -27247,7 +27349,7 @@ On acceptance, call \`leadbay_artifact_kit\`, read its \`usage_guide\` before wr
 - **Deliver first, ask alongside.** Do not end a turn without a ranked list of real accounts. The benchmark, the Tier-1 threshold, the territory, a missing lens, a short question set and an unanswered enrichment offer are all NON-blocking \u2014 carry them next to the plan. Only an unresolvable identity mismatch (whose plan is this?) may stop delivery.
 - **One motif per account, from the closed set of six**, with its deciding evidence stated.
 - **The org's real qualification questions**, read from Leadbay \u2014 never invented.
-- **Consent before any paid enrichment**, and never re-launch a bulk that already exists.
+- **Consent before any enrichment**, and never re-launch a bulk that already exists.
 - **Offer the deck; don't force it.** The chat answer must stand alone as useful.
 - Carry the captured \`lensId\` on the calls whose schema **accepts** it (\`leadbay_pull_leads\`, \`leadbay_bulk_qualify_leads\`, \`leadbay_enrich_titles\`). Do NOT add it to \`leadbay_pull_followups\`, \`leadbay_scan_portfolio_signals\`, \`leadbay_qualify_status\` or \`leadbay_bulk_enrich_status\` \u2014 they declare no such argument and reject unknown properties.
 - Building a plan is not outreaching \u2014 do not send anything and do not call \`leadbay_report_outreach\`.
@@ -27299,7 +27401,7 @@ Call \`leadbay_campaign_call_sheet({campaign_id})\`. The response carries \`summ
 
 - "\u{1F4DE} Start calling now" \u2014 IF \`ready_for_calling\`. Top option when phones are there.
 - "\u2709 Email session instead" \u2014 IF \`ready_for_emailing\` AND \`email_ratio > phone_ratio\`. Don't surface this when calling is more obvious.
-- "\u{1F527} Enrich titles first" \u2014 IF \`needs_enrichment\`. Top option when most leads have no contacts. Phrase as "<N> leads have no reachable contact yet \u2014 enrich titles before we start?" so the user understands the cost.
+- "\u{1F527} Enrich titles first" \u2014 IF \`needs_enrichment\`. Top option when most leads have no contacts. Phrase as "<N> leads have no reachable contact yet \u2014 enrich titles before we start?" so the user knows it uses quota.
 - "\u{1F5FA} View on a map" \u2014 IF \`travel_friendly\` **AND** the user hasn't previously signaled disinterest in maps (check your conversation memory; if you've seen the user dismiss map renders before in this session or saved a "no maps" preference, drop this option).
 
 If the MCP prompt argument \`mode\` was actually supplied, skip the proposal and jump to the matching mode below. If \`mode\` was omitted, do not treat \`call_sheet\` as implicit user consent \u2014 propose first.
@@ -27357,7 +27459,7 @@ Optional: offer to review the \`leadbay_campaign_progression\` for the same camp
 - If the user dictates an outcome that doesn't cleanly map to one of the four epilogue values, ASK ONCE before guessing.
 `;
 var PROMPT_META = {
-  leadbay_build_campaign: { "name": "leadbay_build_campaign", "short_description": 'Build a sales campaign from scratch, autonomously, to a target size:\ndiscover on the lens, qualify, and enrich the buyer titles until `count`\nleads each have a reachable target-title contact \u2014 no pauses, no confirm\ngates. Saves via `leadbay_create_campaign` and renders a one-tap\ncall/email view via `leadbay_campaign_call_sheet`. Trigger on "build me a\ncampaign", "build N leads", "create a campaign from scratch". Work an\nexisting one with `leadbay_work_campaign`.\n', "arguments": [{ "name": "audience", "description": "Optional: a fresh audience to target (e.g. 'dental clinics in Texas'). Omit to build from your ACTIVE lens \u2014 the default.", "required": false }, { "name": "campaign_name", "description": "Optional: a name for the campaign. Omit and one is derived from the lens/audience + date (or the backend AI-names it).", "required": false }, { "name": "count", "description": "Optional: how many fully-actionable leads to build (default 20). The loop keeps discovering, qualifying and enriching until this many in-ICP leads each have a reachable target-title contact \u2014 or the lens is exhausted. Higher counts take longer and consume more quota.", "required": false }, { "name": "job_titles", "description": "Optional: the exact buyer job titles to enrich, comma-separated (e.g. 'VP Sales, Head of Growth, Director of Business Development'). Omit and the buyer persona is derived from what you sell. A lead only counts toward the target when it has a reachable contact matching one of these titles.", "required": false }], "expected_calls": ["leadbay_account_status", "leadbay_pull_leads", "leadbay_bulk_qualify_leads", "leadbay_qualify_status", "leadbay_recall_ordered_titles", "leadbay_enrich_titles", "leadbay_bulk_enrich_status", "leadbay_create_campaign", "leadbay_add_leads_to_campaign", "leadbay_campaign_call_sheet", "leadbay_campaign_progression", "leadbay_new_lens", "leadbay_adjust_audience"], "failure_modes": ["Pauses to confirm before enriching (or asks 'enrich these N now?' via ask_user_input_v0) \u2014 this prompt runs to goal with NO confirm gate; asking for the campaign IS the authorization. Never stop for a spend confirmation.", "Stops to confirm a lens switch when the user named a fresh audience \u2014 naming the audience IS the authorization; switch, state which lens in one line, and don't ask.", "Pauses at any point to ask the user to choose, confirm, or hand off \u2014 the only acceptable stops are lens exhaustion (can't supply the count) or a backend 429 (quota out). Anything else is purpose drift.", "Stops at fewer than the target `count` of actionable leads without looping back to pull / qualify / enrich more \u2014 must run to the target, or honestly report the lens is exhausted and offer to widen.", "Counts a lead toward `count` before its target-title contact actually landed (email/phone present) \u2014 an empty enrichment doesn't count; swap and re-enrich until the cohort is genuinely `count` deep.", "Enriches by seniority instead of by buyer persona \u2014 picks COO / Director of Operations / Mgr of Logistics / CFO / CTO because they sound senior, when the user sells a SALES tool whose buyer is the revenue org (VP/Head/Director of Sales, BD, growth, marketing). Operations people never buy a sales tool; this hands the salesperson a useless list.", "When no titles are given, fails to derive the user's buyer persona from their product/ICP before choosing titles \u2014 jumps straight to generic exec titles instead of working out who buys what THIS user sells. (When titles ARE given, use them verbatim \u2014 don't substitute 'more senior' ones.)", "Blindly repeats leadbay_recall_ordered_titles / discovery suggestions even when they are off-persona (e.g. operations roles a prior session wrongly enriched) \u2014 recall is a filtered input, not the answer.", "Poor coverage \u2014 leaves picked leads with no target-title contact (or 0 enrichments on some leads) and ships them anyway, so the salesperson opens the campaign to half-empty rows. Swap them out and refill to the count instead.", "Creates the campaign before qualifying / picking \u2014 seeds a campaign with unvetted leads. Qualify and lock the buyer-covered cohort FIRST, then leadbay_create_campaign.", "Ends at 'campaign created' without rendering the leadbay_campaign_call_sheet view \u2014 the ready-to-work view IS the deliverable; stopping short is purpose drift.", "Runs the calling / outcome / follow-up loop, or calls leadbay_work_campaign itself, instead of stopping at the call sheet \u2014 this prompt BUILDS and stops; work_campaign is a separate session the user starts later.", "Auto-sends outreach or calls leadbay_report_outreach \u2014 building a campaign is not outreaching. No send, no log.", "Re-pulls leadbay_pull_leads without the captured lensId \u2014 a mid-session lens shift discards the cohort being built.", "Renders the picked leads or the call sheet as prose instead of the canonical per-tool RENDERING layout."] },
+  leadbay_build_campaign: { "name": "leadbay_build_campaign", "short_description": 'Build a sales campaign from scratch, autonomously, to a target size:\ndiscover on the lens, qualify, and enrich the buyer titles until `count`\nleads each have a reachable target-title contact \u2014 no pauses, no confirm\ngates. Saves via `leadbay_create_campaign` and renders a one-tap\ncall/email view via `leadbay_campaign_call_sheet`. Trigger on "build me a\ncampaign", "build N leads", "create a campaign from scratch". Work an\nexisting one with `leadbay_work_campaign`.\n', "arguments": [{ "name": "audience", "description": "Optional: a fresh audience to target (e.g. 'dental clinics in Texas'). Omit to build from your ACTIVE lens \u2014 the default.", "required": false }, { "name": "campaign_name", "description": "Optional: a name for the campaign. Omit and one is derived from the lens/audience + date (or the backend AI-names it).", "required": false }, { "name": "count", "description": "Optional: how many fully-actionable leads to build (default 20). The loop keeps discovering, qualifying and enriching until this many in-ICP leads each have a reachable target-title contact \u2014 or the lens is exhausted. Higher counts take longer and consume more quota.", "required": false }, { "name": "job_titles", "description": "Optional: the exact buyer job titles to enrich, comma-separated (e.g. 'VP Sales, Head of Growth, Director of Business Development'). Omit and the buyer persona is derived from what you sell. A lead only counts toward the target when it has a reachable contact matching one of these titles.", "required": false }], "expected_calls": ["leadbay_account_status", "leadbay_pull_leads", "leadbay_bulk_qualify_leads", "leadbay_qualify_status", "leadbay_recall_ordered_titles", "leadbay_enrich_titles", "leadbay_bulk_enrich_status", "leadbay_create_campaign", "leadbay_add_leads_to_campaign", "leadbay_campaign_call_sheet", "leadbay_campaign_progression", "leadbay_new_lens", "leadbay_adjust_audience"], "failure_modes": ["Pauses to confirm before enriching (or asks 'enrich these N now?' via ask_user_input_v0) \u2014 this prompt runs to goal with NO confirm gate; asking for the campaign IS the authorization. Never stop for an enrichment confirmation.", "Stops to confirm a lens switch when the user named a fresh audience \u2014 naming the audience IS the authorization; switch, state which lens in one line, and don't ask.", "Pauses at any point to ask the user to choose, confirm, or hand off \u2014 the only acceptable stops are lens exhaustion (can't supply the count) or a backend 429 (quota out). Anything else is purpose drift.", "Stops at fewer than the target `count` of actionable leads without looping back to pull / qualify / enrich more \u2014 must run to the target, or honestly report the lens is exhausted and offer to widen.", "Counts a lead toward `count` before its target-title contact actually landed (email/phone present) \u2014 an empty enrichment doesn't count; swap and re-enrich until the cohort is genuinely `count` deep.", "Enriches by seniority instead of by buyer persona \u2014 picks COO / Director of Operations / Mgr of Logistics / CFO / CTO because they sound senior, when the user sells a SALES tool whose buyer is the revenue org (VP/Head/Director of Sales, BD, growth, marketing). Operations people never buy a sales tool; this hands the salesperson a useless list.", "When no titles are given, fails to derive the user's buyer persona from their product/ICP before choosing titles \u2014 jumps straight to generic exec titles instead of working out who buys what THIS user sells. (When titles ARE given, use them verbatim \u2014 don't substitute 'more senior' ones.)", "Blindly repeats leadbay_recall_ordered_titles / discovery suggestions even when they are off-persona (e.g. operations roles a prior session wrongly enriched) \u2014 recall is a filtered input, not the answer.", "Poor coverage \u2014 leaves picked leads with no target-title contact (or 0 enrichments on some leads) and ships them anyway, so the salesperson opens the campaign to half-empty rows. Swap them out and refill to the count instead.", "Creates the campaign before qualifying / picking \u2014 seeds a campaign with unvetted leads. Qualify and lock the buyer-covered cohort FIRST, then leadbay_create_campaign.", "Ends at 'campaign created' without rendering the leadbay_campaign_call_sheet view \u2014 the ready-to-work view IS the deliverable; stopping short is purpose drift.", "Runs the calling / outcome / follow-up loop, or calls leadbay_work_campaign itself, instead of stopping at the call sheet \u2014 this prompt BUILDS and stops; work_campaign is a separate session the user starts later.", "Auto-sends outreach or calls leadbay_report_outreach \u2014 building a campaign is not outreaching. No send, no log.", "Re-pulls leadbay_pull_leads without the captured lensId \u2014 a mid-session lens shift discards the cohort being built.", "Renders the picked leads or the call sheet as prose instead of the canonical per-tool RENDERING layout."] },
   leadbay_daily_check_in: { "name": "leadbay_daily_check_in", "short_description": 'Morning DISCOVERY workflow \u2014 new leads from the lens wishlist. Trigger\non "show me leads", "what\'s new today", "let\'s prospect", "run my check-in",\n"my morning check-in", "I do this every day", "every morning". Recurrence\nlanguage always means this prompt. Do NOT trigger on follow-up phrasings\n("follow up", "before my trip") \u2014 those go to `leadbay_followup_check_in`.\n', "arguments": [], "expected_calls": ["leadbay_account_status", "leadbay_pull_leads", "leadbay_research_lead_by_id", "leadbay_bulk_qualify_leads", "leadbay_enrich_contacts"], "failure_modes": ["Calls leadbay_report_outreach without explicit user authorization", "Surfaces fewer than 10 leads when more are available, or fails to top up via leadbay_qualify_top_n when the batch is short", `Replaces the canonical pull_leads table layout with prose per row (the per-tool RENDERING block is the structural contract; "Today's nudges" goes above it, not in place of it)`, "Skips the nudge paragraph entirely \u2014 the table alone is fine but adding the nudge is the value-add", `Skips deep research on promising leads (Phase 4) \u2014 the agent must call leadbay_research_lead_by_id on each when the user's intent is to research specific leads; Phase 4 is intentionally skipped for batch-view requests ("show me today's leads", "run my morning check-in") per the Phase 4 skip gate`, "Triggers contact enrichment without asking the user first (it consumes quota)", "Skips the STOP byproduct and proposes next actions on its own", 'Fires 10 parallel leadbay_research_lead_by_id calls and treats "stream closed" errors as terminal \u2014 must serialize and retry singletons', "Re-pulls leadbay_pull_leads without passing the captured lensId, allowing a backend lens shift to discard the Phase 2 batch", 'Treats a "Request timed out" from leadbay_bulk_qualify_leads as terminal instead of retrying with wait_for_completion:false + qualify_status polling', 'Triggers on a follow-up query (e.g., "leads I should follow up with") that should have routed to `leadbay_followup_check_in` \u2014 the two entry points are different data sources (Discover wishlist vs Monitor view) per \xA71.6'] },
   leadbay_extend_my_lens: { "name": "leadbay_extend_my_lens", "short_description": "Add more leads to the current lens on demand \u2014 for users whose appetite\nexceeds the standard daily fill. The agent picks seeds silently from\nwhat's already on the lens, fires the extra refill, and surfaces the\nqueue confirmation. The user never reviews the seed list.\n", "arguments": [{ "name": "extra_count", "description": "How many extra leads to add. Optional. Omit to use the backend default.", "required": false }], "expected_calls": ["leadbay_account_status", "leadbay_seed_candidates", "leadbay_extend_lens", "leadbay_pull_leads"], "failure_modes": ["Surfaces the seed candidate list to the user instead of picking silently \u2014 the user asked for MORE LEADS, not a candidate review meeting", "Skips the seeded path and calls `leadbay_extend_lens` with no `seed_lead_ids`, losing the bias signal the recommender needs", "On 429, silently retries instead of surfacing the three options (smaller / wait / upgrade) via your host's choice widget (`ask_user_input_v0` or `AskUserQuestion`)", "Forgets to pre-check `LENS_EXTRA_REFILL` quota in `leadbay_account_status` and burns a wasted API call", "Skips the post-queue pull-leads suggestion, so the user doesn't see what just got added"] },
   leadbay_followup_check_in: { "name": "leadbay_followup_check_in", "short_description": 'Follow-up check-in: surface KNOWN leads from the Monitor view needing\nre-engagement. Trigger on "follow up", "already known leads", "what\'s\noverdue", "before my trip", "who should I re-engage". Do NOT trigger on\n"show me today\'s leads", "my morning check-in", "run my check-in",\n"I do this every day", "every morning" \u2014 those go to\n`leadbay_daily_check_in`.\n', "arguments": [], "expected_calls": ["leadbay_pull_followups", "leadbay_research_lead_by_id", "leadbay_prepare_outreach"], "failure_modes": ["Calls leadbay_pull_leads (the Discover entry point) instead of leadbay_pull_followups \u2014 these are different data sources; the Discover queue does NOT contain Monitor's known-but-cold pipeline", 'Iterates pages of leadbay_pull_leads filtering by engagement_count to "fake" a follow-up view (a real bug observed in 0.9.0 \u2014 the right move is to call pull_followups directly)', "Replaces the canonical pull_followups table layout with prose per row (the per-tool RENDERING block is the structural contract; commentary belongs above or below)", 'Skips the cross-mode pivot offer at the end ("Want to see NEW leads from your wishlist instead?" routes to leadbay_pull_leads)'] },
@@ -27367,7 +27469,7 @@ reveal who to send it to. Use when the user is new or asks to be SHOWN how
 Leadbay works ("walk me through Leadbay", "I'm new", "how do I use this",
 "give me a tour"). Don't use it for orientation prose with no clicking \u2014
 that's leadbay_prospecting_overview.
-`, "arguments": [], "expected_calls": ["leadbay_account_status", "leadbay_pull_leads", "leadbay_prepare_outreach", "leadbay_enrich_titles", "leadbay_bulk_enrich_status"], "failure_modes": ['Presents a gate as prose ("let me know if you want me to pull your leads") instead of CALLING the host choice widget \u2014 the click IS the lesson, and prose turns the walkthrough into a lecture', "Runs a step's tool WITHOUT firing that step's widget first and waiting for the click \u2014 the walkthrough becomes an automated demo the user only watches, which is the exact opposite of learning by doing", "Fires the widget without the EXPLAIN beat, so the user gets an unexplained button and learns nothing about what a lens or an enrichment actually is", 'Answers gate 1 with a bare "you\'re connected as X at Y" when the quota IS readable \u2014 the user clicked a button labelled `check my account status`, so the quota windows (Daily/Weekly/Monthly gauges, % used, $ spent, resets) ARE the answer, not an optional extra', 'Renders quota as raw "credits" instead of the web app\'s percentage + dollar-spend gauges, or dumps raw `resource_type` strings the user has never seen', "Opens with a wall of text \u2014 previewing all four steps, explaining lenses up front, or writing several paragraphs before the first widget. The opening is TWO lines then the button; a first-run user wants to see it work, not read a syllabus", `Ends the first message without firing gate 1's widget, leaving the user to reply "ok" before anything happens`, "Rewrites the gate's own `next_steps` payload (its `question`, `label` or `description`) instead of mapping it into the widget verbatim, or merges two gates into a single multi-option widget", 'Fires a THIRD option, or turns the exit into an alternative route ("show me my lenses instead") \u2014 each gate carries exactly one forward action plus the `I\'m done for now` exit, never a menu of paths', `Fires a single-option widget \u2014 the host requires 2\u20134 options, so a lone option is rejected or silently degrades to prose ("say the word and I'll check it"), which is the exact defect this rule exists to prevent`, 'Launches the PAID reveal at gate 4 BEFORE the user has picked leads and confirmed \u2014 beat 1 must be the free `mode:"discover"` preview (no `titles`, no `confirm`, no `email`, no `phone`); the gate click bought the free look, not the reveal, and silence is never consent', "Stops at the free preview after the user DID pick leads and confirm \u2014 they asked for real contact details, so the second call must actually run with `confirm:true` and the chosen titles", "Reports the enrichment without polling `leadbay_bulk_enrich_status` to completion, so it claims contacts it never actually saw resolve", `Reveals contacts and never says what it cost \u2014 the user just spent credits and deserves the one-line "N contacts = N credits", which is also what makes gate 1's quota numbers concrete`, 'Reports "no leads" on an empty batch while `computing_wishlist` / `computing_scores` is true \u2014 the lens is still building; render the tool\'s own two-option warm-up widget verbatim and pause', "Rewords, reorders or prose-ifies the `next_steps` payload from `leadbay_pull_leads` instead of mapping `options[]` into the widget verbatim", "Runs all four steps in one turn without waiting for the user's click between gates \u2014 the walkthrough is a sequence of gates, not a script to recite", "Skips `leadbay_pull_leads` and jumps straight to enrichment, leaving gate 4 with no `leadIds` to scope", "Passes a singular `leadId` to `leadbay_enrich_titles` on the confirmed reveal \u2014 that key does not exist on this tool, so it is dropped and the paid call falls back to the whole default wishlist selection, charging for far more than the one lead the user agreed to. it is always the `leadIds` ARRAY, even for a single lead", "Drops the pinned `lens.id` between gates, so gate 4 enriches against a different lens than the one the user just saw", "Ends the completed walkthrough without the `keep_going` cheat-sheet \u2014 the buttons disappear with the tour, so a user who was never told what to TYPE learned to click a tutorial and nothing about using Leadbay tomorrow", "Invents phrases for the cheat-sheet, or rewords them into something that sounds nicer but doesn't match the tool's real triggers \u2014 teaching a phrase that doesn't route is worse than teaching none", "SENDS the gate 3 draft, or offers to send it \u2014 the walkthrough drafts and stops there; the email is the user's to judge, and nothing leaves the chat", "Passes `enrich:true` to `leadbay_prepare_outreach` at gate 3 \u2014 that launches a PAID contact reveal off the back of a DRAFT click, spending credits the user never agreed to", "Invents a contact NAME for the gate 3 draft \u2014 `recommended_contact` still has null email/name at that point, so the draft is addressed to the job TITLE; a fabricated name is the one thing that makes the whole draft untrustworthy", "Treats the null email at gate 3 as a failure \u2014 apologising for it, retrying, or calling another tool to fill it in. It is the setup for gate 4 \u2014 an email written, nobody to send it to yet", "Pastes the drafted email into chat prose alongside `message_compose_v1` instead of letting the composer BE the answer", "Enriches leads other than the one it drafted for at gate 3 \u2014 gate 4 reveals the person that email is going to, so it is scoped to that ONE lead, one contact, one credit", "Renders the cheat-sheet on the exit and stops there, dropping the 1:1 offer \u2014 the observed failure is that the agent feels finished once the table is on screen, so the user who just stepped out never hears about the help that would bring them back. ENDING B is not complete without the offer, and the offer goes LAST", "Treats the exit click as ENDING C (typed off-script) and closes in silence, or treats a typed request as ENDING B and buries their real answer under a cheat-sheet and a booking link", "Turns the exit offer into a pitch \u2014 several sentences, a re-opened gate, or an argument for finishing the tour. They said they were done; it is one line and a link", "Fires the 1:1 offer mid-tour, or at a user who left by TYPING a different request \u2014 a booking link on top of their real question is an interruption, not an offer", "Runs the four gates at a user whose actual problem is SETUP \u2014 the connector isn't installed, they can't sign in, or their Leadbay tools aren't appearing. The tour assumes a working connection and cannot fix any of it; the setup guide can", "Pastes the setup-guide link mid-tour, between gates, instead of once at the closing \u2014 a link in the middle of the walkthrough invites the user to leave the thing they're doing"] },
+`, "arguments": [], "expected_calls": ["leadbay_account_status", "leadbay_pull_leads", "leadbay_prepare_outreach", "leadbay_enrich_titles", "leadbay_bulk_enrich_status"], "failure_modes": ['Presents a gate as prose ("let me know if you want me to pull your leads") instead of CALLING the host choice widget \u2014 the click IS the lesson, and prose turns the walkthrough into a lecture', "Runs a step's tool WITHOUT firing that step's widget first and waiting for the click \u2014 the walkthrough becomes an automated demo the user only watches, which is the exact opposite of learning by doing", "Fires the widget without the EXPLAIN beat, so the user gets an unexplained button and learns nothing about what a lens or an enrichment actually is", 'Answers gate 1 with a bare "you\'re connected as X at Y" when the quota IS readable \u2014 the user clicked a button labelled `check my account status`, so the quota windows (Daily/Weekly/Monthly gauges, % used, $ spent, resets) ARE the answer, not an optional extra', 'Renders quota as raw "credits" instead of the web app\'s percentage + dollar-spend gauges, or dumps raw `resource_type` strings the user has never seen', "Opens with a wall of text \u2014 previewing all four steps, explaining lenses up front, or writing several paragraphs before the first widget. The opening is TWO lines then the button; a first-run user wants to see it work, not read a syllabus", `Ends the first message without firing gate 1's widget, leaving the user to reply "ok" before anything happens`, "Rewrites the gate's own `next_steps` payload (its `question`, `label` or `description`) instead of mapping it into the widget verbatim, or merges two gates into a single multi-option widget", 'Fires a THIRD option, or turns the exit into an alternative route ("show me my lenses instead") \u2014 each gate carries exactly one forward action plus the `I\'m done for now` exit, never a menu of paths', `Fires a single-option widget \u2014 the host requires 2\u20134 options, so a lone option is rejected or silently degrades to prose ("say the word and I'll check it"), which is the exact defect this rule exists to prevent`, 'Launches the contact reveal at gate 4 BEFORE the user has picked leads and confirmed \u2014 beat 1 must be the free `mode:"discover"` preview (no `titles`, no `confirm`, no `email`, no `phone`); the gate click bought the free look, not the reveal, and silence is never consent', "Stops at the free preview after the user DID pick leads and confirm \u2014 they asked for real contact details, so the second call must actually run with `confirm:true` and the chosen titles", "Reports the enrichment without polling `leadbay_bulk_enrich_status` to completion, so it claims contacts it never actually saw resolve", "Reveals contacts and never says the reveal used a little of their plan's quota \u2014 that one line, with no amount and no price, is what makes gate 1's quota numbers concrete", 'Reports "no leads" on an empty batch while `computing_wishlist` / `computing_scores` is true \u2014 the lens is still building; render the tool\'s own two-option warm-up widget verbatim and pause', "Rewords, reorders or prose-ifies the `next_steps` payload from `leadbay_pull_leads` instead of mapping `options[]` into the widget verbatim", "Runs all four steps in one turn without waiting for the user's click between gates \u2014 the walkthrough is a sequence of gates, not a script to recite", "Skips `leadbay_pull_leads` and jumps straight to enrichment, leaving gate 4 with no `leadIds` to scope", "Passes a singular `leadId` to `leadbay_enrich_titles` on the confirmed reveal \u2014 that key does not exist on this tool, so it is dropped and the reveal falls back to the whole default wishlist selection, revealing far more than the one lead the user agreed to. it is always the `leadIds` ARRAY, even for a single lead", "Drops the pinned `lens.id` between gates, so gate 4 enriches against a different lens than the one the user just saw", "Ends the completed walkthrough without the `keep_going` cheat-sheet \u2014 the buttons disappear with the tour, so a user who was never told what to TYPE learned to click a tutorial and nothing about using Leadbay tomorrow", "Invents phrases for the cheat-sheet, or rewords them into something that sounds nicer but doesn't match the tool's real triggers \u2014 teaching a phrase that doesn't route is worse than teaching none", "SENDS the gate 3 draft, or offers to send it \u2014 the walkthrough drafts and stops there; the email is the user's to judge, and nothing leaves the chat", "Passes `enrich:true` to `leadbay_prepare_outreach` at gate 3 \u2014 that launches a contact reveal off the back of a DRAFT click, using quota the user never agreed to", "Invents a contact NAME for the gate 3 draft \u2014 `recommended_contact` still has null email/name at that point, so the draft is addressed to the job TITLE; a fabricated name is the one thing that makes the whole draft untrustworthy", "Treats the null email at gate 3 as a failure \u2014 apologising for it, retrying, or calling another tool to fill it in. It is the setup for gate 4 \u2014 an email written, nobody to send it to yet", "Pastes the drafted email into chat prose alongside `message_compose_v1` instead of letting the composer BE the answer", "Enriches leads other than the one it drafted for at gate 3 \u2014 gate 4 reveals the person that email is going to, so it is scoped to that ONE lead, one contact", "Renders the cheat-sheet on the exit and stops there, dropping the 1:1 offer \u2014 the observed failure is that the agent feels finished once the table is on screen, so the user who just stepped out never hears about the help that would bring them back. ENDING B is not complete without the offer, and the offer goes LAST", "Treats the exit click as ENDING C (typed off-script) and closes in silence, or treats a typed request as ENDING B and buries their real answer under a cheat-sheet and a booking link", "Turns the exit offer into a pitch \u2014 several sentences, a re-opened gate, or an argument for finishing the tour. They said they were done; it is one line and a link", "Fires the 1:1 offer mid-tour, or at a user who left by TYPING a different request \u2014 a booking link on top of their real question is an interruption, not an offer", "Runs the four gates at a user whose actual problem is SETUP \u2014 the connector isn't installed, they can't sign in, or their Leadbay tools aren't appearing. The tour assumes a working connection and cannot fix any of it; the setup guide can", "Pastes the setup-guide link mid-tour, between gates, instead of once at the closing \u2014 a link in the middle of the walkthrough invites the user to leave the thing they're doing"] },
   leadbay_import_file: { "name": "leadbay_import_file", "short_description": "Import a user-supplied CSV/file into Leadbay through five phases with\nevidence gates \u2014 scan, derive, resolve identities, preserve & commit,\nthen optionally qualify and report. The job is to maximize how many\nrows the Leadbay system actually ingests and matches.\n", "arguments": [{ "name": "file", "description": "Path or user-visible name of the CSV/file to import. If omitted, use the file the user attached or referenced.", "required": false }, { "name": "instruction", "description": 'Additional user goal, e.g. "then qualify the leads", "preserve owner phone as a custom field", or "only import restaurants in Manhattan".', "required": false }], "expected_calls": ["leadbay_resolve_import_rows", "leadbay_list_mappable_fields", "leadbay_create_custom_field", "leadbay_import_leads", "leadbay_import_and_qualify", "leadbay_add_note", "leadbay_import_status"], "failure_modes": ["Picks LEADBAY_ID from score alone, name-only, fuzzy-name-only, root-domain-only, brand-only, postcode-only, or city-only evidence", "Drops meaningful business notes or CRM record links instead of preserving them as custom fields or lead notes", "Treats a consumer mailbox domain (gmail.com, hotmail.com, ...) as the company domain", "Skips deriving company_domain from a business email when no website column exists (this kills match rate)", "Skips the COLUMN PRESERVATION PLAN byproduct before importing", "Skips the DECISION LOG byproduct before writing LEADBAY_ID", "Returns the imported records WITHOUT writing LEADBAY_ID values back into the user's file (leaves the user no audit trail of what matched)", "Fabricates leadIds, contact emails, or mapping IDs not present in the file or a tool response"] },
   leadbay_log_outreach: { "name": "leadbay_log_outreach", "short_description": "Log outreach (an email I sent, a call I made, a meeting I had) on a\nspecific lead. Captures verification so the SDR pipeline trusts the entry.\n", "arguments": [{ "name": "lead_id", "description": "The lead UUID. Get it from leadbay_pull_leads or leadbay_research_lead_by_id.", "required": true }, { "name": "summary", "description": "1-2 sentences describing what I did (e.g. 'Sent intro email to CTO citing recent Hornsea contract').", "required": true }], "expected_calls": ["leadbay_report_outreach"], "failure_modes": ["Calls leadbay_report_outreach without first collecting a verification source", "Fabricates a gmail_message_id or calendar_event_id (the human team treats verification as canonical)", "Records outreach to a different lead_id than the one the user supplied", "Skips the dry_run step when the user is unsure what would be sent"] },
   leadbay_new_leads: { "name": "leadbay_new_leads", "short_description": `Guided net-new lead delivery \u2014 turn a described need ("gyms around Dallas
@@ -27377,7 +27479,7 @@ Trigger when the user DESCRIBES who they want: "get me N companies that
 <profile>", "we're entering <market>". A bare "find me new leads" with no
 profile, and "today's leads", are the daily lens batch \u2014 leadbay_pull_leads.
 "Qualify these companies I have" is leadbay_qualify_leads.
-`, "arguments": [{ "name": "need", "description": "What the user is looking for, in their own words (e.g. '10 gyms around Dallas that would buy modular flooring, with phone numbers'). Optional \u2014 the session starts by asking when absent.", "required": false }], "expected_calls": ["leadbay_find_new_leads", "leadbay_lead_job_status", "leadbay_qualify_leads"], "failure_modes": ["Passes the user's raw sentence as `query` instead of crafting an example_lead description (vendor-vocabulary trap \u2014 measured 0 delivered from a raw query vs on-profile results from a crafted example)", "Invents a distinctive brand name in example_lead.name (pulls matching toward name-lookalikes)", 'Puts event language ("hiring", "expanding", "just raised") into the seed description', "Launches qualify:true or channels without a dry_run quote and the user's explicit go-ahead", "Retries a failed/timed-out submit with a NEW request_id (double-spend) \u2014 the same ask must reuse the same request_id", 'Reports "no results" without narrating the funnel + scope_notes and proposing a concrete fix', "Renders delivered leads as freeform prose instead of the canonical lead-delivery table", "Blends two distinct buyer archetypes into one seed description instead of running one search per archetype", "Passes a country name in filters.locations (silently matches a same-named town \u2014 whole-country intent means OMITTING locations) or a nested employees object instead of the flat employees_min/employees_max", "Renders rows that visibly violate the user's exclusions, or presents a best-fit-under-30 table as an answer instead of flagging weak matches"] },
+`, "arguments": [{ "name": "need", "description": "What the user is looking for, in their own words (e.g. '10 gyms around Dallas that would buy modular flooring, with phone numbers'). Optional \u2014 the session starts by asking when absent.", "required": false }], "expected_calls": ["leadbay_find_new_leads", "leadbay_lead_job_status", "leadbay_qualify_leads"], "failure_modes": ["Passes the user's raw sentence as `query` instead of crafting an example_lead description (vendor-vocabulary trap \u2014 measured 0 delivered from a raw query vs on-profile results from a crafted example)", "Invents a distinctive brand name in example_lead.name (pulls matching toward name-lookalikes)", 'Puts event language ("hiring", "expanding", "just raised") into the seed description', "Launches qualify:true or channels without a dry_run quote and the user's explicit go-ahead", "Retries a failed/timed-out submit with a NEW request_id (double launch) \u2014 the same ask must reuse the same request_id", 'Reports "no results" without narrating the funnel + scope_notes and proposing a concrete fix', "Renders delivered leads as freeform prose instead of the canonical lead-delivery table", "Blends two distinct buyer archetypes into one seed description instead of running one search per archetype", "Passes a country name in filters.locations (silently matches a same-named town \u2014 whole-country intent means OMITTING locations) or a nested employees object instead of the flat employees_min/employees_max", "Renders rows that visibly violate the user's exclusions, or presents a best-fit-under-30 table as an answer instead of flagging weak matches"] },
   leadbay_plan_tour_in_city: { "name": "leadbay_plan_tour_in_city", "short_description": 'Use whenever the user names a city they\'ll be in and asks who to see\n\u2014 "I\'m in SF next Tuesday, who\'s worth meeting?", "I\'m going to Berlin\n\u2014 who should I visit?", "plan my <city> tour". Any in-person/visit\nintent tied to a place routes here, NOT to `leadbay_pull_leads`. It\nsurfaces follow-ups + fresh Discover leads in the city via\n`leadbay_tour_plan`, ALWAYS offers to plot them on a map (rendering it\non yes), then offers outreach drafts + campaign persistence.\n', "arguments": [{ "name": "city", "description": "City or region the user is visiting (e.g. 'Limoges', 'Bay Area'). Used as the geo filter for both Monitor and Discover lookups. A country is not a city: this workspace already covers exactly one country, and a country name here silently fences the tour to a same-named village. Do NOT omit the argument to recover \u2014 a city-less tour returns arbitrary leads from across the whole workspace, which is not an itinerary. Ask which city or region the visit is to.", "required": true }, { "name": "date", "description": "When the visit is (e.g. 'May 24', 'next Thursday'). Surfaced in the outreach drafts as 'I'll be in <city> on <date>'.", "required": false }], "expected_calls": ["leadbay_tour_plan", "leadbay_research_lead_by_id", "leadbay_prepare_outreach", "leadbay_create_campaign"], "failure_modes": ["Calls leadbay_followups_map (Monitor-only) instead of leadbay_tour_plan \u2014 loses the Discover (fresh-lead) half that the user explicitly asked for", "Calls leadbay_pull_leads then drops the geo filter \u2014 returns the lens-wide wishlist instead of city-relevant fresh leads", 'Skips the campaign-persist step ("would you like to save these as a tour?") \u2014 leaves the rep with a one-shot map but no follow-up artifact', "Creates a campaign WITHOUT asking the user first \u2014 the persist step is high-intent; offer it, don't assume", "Fabricates lead_ids when seeding the campaign instead of using the ids returned by tour_plan"] },
   leadbay_prospecting_overview: { "name": "leadbay_prospecting_overview", "short_description": `Orientation for working with Leadbay from any host \u2014 discovery vs.
 follow-up, the outreach loop, outcome recording, imports, pushback /
@@ -27390,7 +27492,7 @@ should I follow up on" to "I'll send via lemlist".
   leadbay_refine_audience: { "name": "leadbay_refine_audience", "short_description": "Refine the kind of leads Leadbay surfaces beyond firmographics, with a\nfree-text instruction. Handles the clarification round-trip if the new\nprompt is ambiguous.\n", "arguments": [{ "name": "instruction", "description": "The refinement (e.g. 'focus on hospitals running their own IT'). Set to plain English.", "required": true }], "expected_calls": ["leadbay_refine_prompt", "leadbay_account_status"], "failure_modes": ["Calls leadbay_answer_clarification on the user's behalf instead of surfacing the clarification verbatim", "Glosses over the clarification options instead of presenting them as offered", "Promises immediate effect when status='applied' actually triggers an async intelligence recompute"] },
   leadbay_research_a_domain: { "name": "leadbay_research_a_domain", "short_description": "Resolve a company by name or domain across the user's visible Discover,\nMonitor, and Activate corpus, then return everything Leadbay knows about it.\n", "arguments": [{ "name": "domain", "description": "Company name or domain (for example 'Acme Corporation' or 'acme.com'). The legacy argument key remains `domain` for client compatibility.", "required": true }], "expected_calls": ["leadbay_research_lead_by_name_fuzzy"], "failure_modes": ["Fabricates qualification answers not present in any tool response", "Calls leadbay_import_and_qualify before searching the existing visible corpus", "Treats the active lens as the entire search universe when the user did not request a lens scope", "Imports a missing company without the user's explicit permission", "Renders the research result as a freeform narrative instead of the canonical research-company-card layout (the card with header score bar, pill row, signal sections, contacts table is the structural contract; commentary belongs ABOVE or BELOW it)"] },
   leadbay_setup_team_prospecting: { "name": "leadbay_setup_team_prospecting", "short_description": "Manager-led prospecting setup: conversationally turn a natural-language\naudience ask into a Leadbay lens, validate the candidate leads, and\npersist them as one or more named campaigns the rep(s) can work\nthrough. Closes #3630 US3 end-to-end (within the current\ncreator-scoped campaign visibility model).\n", "arguments": [{ "name": "audience", "description": "Natural-language audience description (e.g. 'plumbing companies with 10-50 employees in Seine-Maritime'). The lens-creation step (`leadbay_refine_prompt` \u2192 `leadbay_create_lens`) interprets it. A country name is not a scope here \u2014 this workspace already covers exactly one country, so drop it and keep the rest of the description; a DIFFERENT country cannot be targeted at all.", "required": true }, { "name": "rep_split", "description": "Optional: how to split the validated leads into per-rep campaigns. Free text \u2014 e.g. 'split by city' or 'one campaign per rep: John gets Tulsa, Sarah gets OKC'. Splitting by country is not a split \u2014 the workspace is single-country.", "required": false }], "expected_calls": ["leadbay_refine_prompt", "leadbay_create_lens", "leadbay_promote_lens", "leadbay_pull_leads", "leadbay_research_lead_by_id", "leadbay_create_campaign", "leadbay_add_leads_to_campaign"], "failure_modes": ["Skips the validation step \u2014 creates a campaign of unvetted leads from a freshly-created lens without giving the manager a chance to drop weak fits", "Creates ONE campaign for all reps without asking about the split \u2014 the user explicitly mentioned per-rep distribution and the prompt should honor it", "Pretends the backend supports cross-user assignment \u2014 campaigns are owned by the caller (creator-scoped). Surface this honestly instead of fabricating an assignment model", "Asks ALL clarifying questions inline before tool calls \u2014 instead, run the lens refinement loop with `leadbay_refine_prompt` which handles the clarification protocol natively"] },
-  leadbay_top_accounts_to_activate: { "name": "leadbay_top_accounts_to_activate", "short_description": 'Build a ranked account-conquest plan from Leadbay data \u2014 the accounts worth\nactivating, each with a motif, a pitch and a checklist, ranked by the\nstrongest Leadbay signal. Every figure carries its source, and anything\nLeadbay can\'t measure is shown as OMITTED rather than estimated. Uses\n`leadbay_bulk_qualify_leads` and `leadbay_enrich_titles`. Trigger on\n"top 50 accounts to activate", "who should we go after".\n', "arguments": [{ "name": "count", "description": "Optional: how many accounts the plan should hold (default 50).", "required": false }, { "name": "territory", "description": "Optional: restrict the plan to a territory (e.g. 'Indre-et-Loire', 'R\xE9gion Ouest'). Sets geography on the Discover lens. A country is not a territory \u2014 this workspace already covers exactly one country.", "required": false }], "expected_calls": ["leadbay_account_status", "leadbay_get_qualification_questions", "leadbay_pull_leads", "leadbay_pull_followups", "leadbay_bulk_qualify_leads", "leadbay_qualify_status", "leadbay_scan_portfolio_signals", "leadbay_enrich_titles", "leadbay_bulk_enrich_status", "leadbay_account_history", "leadbay_artifact_kit", "leadbay_new_lens", "leadbay_adjust_audience"], "failure_modes": ["Invents, estimates or proxies a revenue-realized figure \u2014 the single worst failure. Leadbay does not hold what an account buys, and headcount, sector and lead score are NOT proxies for it.", "Sorts by cash-to-capture, synthesizing a revenue figure per account purely to make that ranking work. Leadbay has no revenue data: rank by the Leadbay signal, say so in the header, and never invent the key.", "Emits \u20AC figures with no provenance class, so modelled numbers read as measured fact in front of a paying client.", "Skips the PROVENANCE LEDGER, or drops un-sourceable fields from it instead of rendering them as OMITTED \u2014 which hides the gap.", "Fabricates registry/TAM counts (France or regional company counts) instead of querying the registry or marking the figure NOT COMPUTED. Leadbay does not proxy SIRENE.", "Invents the five qualification questions from this prompt's own recommendations instead of reading the org's actual questions via leadbay_get_qualification_questions.", "Leaves the deck's live layer dead \u2014 qualification and enrichment handles never wired in, so the pills and contacts stay empty while the deck still looks finished.", "Invents lead ids to make the qualification pills appear populated.", "Fabricates a plausible-sounding signal ('just won a public tender') for an account whose signals were never read. No signal read means an explicit dash.", "Assigns a motif outside the closed set of six, or assigns SAUVETAGE / PLAN DE COMPTE / MONT\xC9E EN GAMME / R\xC9VEIL from a lead score or sector when order history was never available.", "Labels Monitor membership as 'is a client' \u2014 Monitor is a Leadbay view whose membership is decided by lens scoring, not by whether the company ever bought anything.", "Launches paid enrichment on the whole plan without consent. Asking for a plan is not authorization to spend on 50 accounts.", "Re-launches enrichment from inside the built deck when a bulk handle already exists this session \u2014 double-spends the user's quota.", "Forces the interactive deck without offering it first, or ships the deck INSTEAD of a chat answer that stands on its own.", "Refuses the task because revenue data is missing, instead of delivering the conquest plan and naming what a cash-ranked version would need.", "Ends the turn without a ranked list of real accounts \u2014 gating the whole plan on a NON-blocking question (a MISSING territory, a missing lens, or a 3-vs-5 qualification-question gap) so the user gets a plan-of-a-plan. Only two things may stop delivery: an unresolvable company-identity mismatch, and a territory naming a foreign or supra-national scope. Every other open question rides alongside the delivered plan.", "Stops after the discovery contact preview to wait for enrichment consent, delivering no plan that turn \u2014 the ranked plan ships first; the paid reveal is offered alongside it.", "Renders a contact channel enrichment never returned (e.g. a phone link when only email was approved and revealed) instead of showing the returned channels and marking the rest omitted."] },
+  leadbay_top_accounts_to_activate: { "name": "leadbay_top_accounts_to_activate", "short_description": 'Build a ranked account-conquest plan from Leadbay data \u2014 the accounts worth\nactivating, each with a motif, a pitch and a checklist, ranked by the\nstrongest Leadbay signal. Every figure carries its source, and anything\nLeadbay can\'t measure is shown as OMITTED rather than estimated. Uses\n`leadbay_bulk_qualify_leads` and `leadbay_enrich_titles`. Trigger on\n"top 50 accounts to activate", "who should we go after".\n', "arguments": [{ "name": "count", "description": "Optional: how many accounts the plan should hold (default 50).", "required": false }, { "name": "territory", "description": "Optional: restrict the plan to a territory (e.g. 'Indre-et-Loire', 'R\xE9gion Ouest'). Sets geography on the Discover lens. A country is not a territory \u2014 this workspace already covers exactly one country.", "required": false }], "expected_calls": ["leadbay_account_status", "leadbay_get_qualification_questions", "leadbay_pull_leads", "leadbay_pull_followups", "leadbay_bulk_qualify_leads", "leadbay_qualify_status", "leadbay_scan_portfolio_signals", "leadbay_enrich_titles", "leadbay_bulk_enrich_status", "leadbay_account_history", "leadbay_artifact_kit", "leadbay_new_lens", "leadbay_adjust_audience"], "failure_modes": ["Invents, estimates or proxies a revenue-realized figure \u2014 the single worst failure. Leadbay does not hold what an account buys, and headcount, sector and lead score are NOT proxies for it.", "Sorts by cash-to-capture, synthesizing a revenue figure per account purely to make that ranking work. Leadbay has no revenue data: rank by the Leadbay signal, say so in the header, and never invent the key.", "Emits \u20AC figures with no provenance class, so modelled numbers read as measured fact in front of a paying client.", "Skips the PROVENANCE LEDGER, or drops un-sourceable fields from it instead of rendering them as OMITTED \u2014 which hides the gap.", "Fabricates registry/TAM counts (France or regional company counts) instead of querying the registry or marking the figure NOT COMPUTED. Leadbay does not proxy SIRENE.", "Invents the five qualification questions from this prompt's own recommendations instead of reading the org's actual questions via leadbay_get_qualification_questions.", "Leaves the deck's live layer dead \u2014 qualification and enrichment handles never wired in, so the pills and contacts stay empty while the deck still looks finished.", "Invents lead ids to make the qualification pills appear populated.", "Fabricates a plausible-sounding signal ('just won a public tender') for an account whose signals were never read. No signal read means an explicit dash.", "Assigns a motif outside the closed set of six, or assigns SAUVETAGE / PLAN DE COMPTE / MONT\xC9E EN GAMME / R\xC9VEIL from a lead score or sector when order history was never available.", "Labels Monitor membership as 'is a client' \u2014 Monitor is a Leadbay view whose membership is decided by lens scoring, not by whether the company ever bought anything.", "Launches enrichment on the whole plan without consent. Asking for a plan is not authorization to use quota on 50 accounts.", "Re-launches enrichment from inside the built deck when a bulk handle already exists this session \u2014 uses the user's quota twice.", "Forces the interactive deck without offering it first, or ships the deck INSTEAD of a chat answer that stands on its own.", "Refuses the task because revenue data is missing, instead of delivering the conquest plan and naming what a cash-ranked version would need.", "Ends the turn without a ranked list of real accounts \u2014 gating the whole plan on a NON-blocking question (a MISSING territory, a missing lens, or a 3-vs-5 qualification-question gap) so the user gets a plan-of-a-plan. Only two things may stop delivery: an unresolvable company-identity mismatch, and a territory naming a foreign or supra-national scope. Every other open question rides alongside the delivered plan.", "Stops after the discovery contact preview to wait for enrichment consent, delivering no plan that turn \u2014 the ranked plan ships first; the reveal is offered alongside it.", "Renders a contact channel enrichment never returned (e.g. a phone link when only email was approved and revealed) instead of showing the returned channels and marking the rest omitted."] },
   leadbay_work_campaign: { "name": "leadbay_work_campaign", "short_description": "Work a campaign as a real outreach session: pick the campaign,\nassess what the user has (phones / emails / coords), then PROPOSE\nthe right session mode (call sheet, email sheet, enrich titles\nfirst, map). After they pick, render \u2014 and as they dictate\noutcomes per lead, record both note + epilogue via\n`leadbay_report_outreach` in one round trip.\n", "arguments": [{ "name": "campaign", "description": "Campaign name (fuzzy match against your own campaigns) or campaign UUID. Omit to list and pick interactively.", "required": false }, { "name": "mode", "description": "Optional: skip the readiness-assessment proposal and jump directly into 'call_sheet' / 'email_sheet' / 'map' / 'enrich_first'. Omit (recommended) and let the prompt propose based on the data.", "required": false }], "expected_calls": ["leadbay_list_campaigns", "leadbay_campaign_call_sheet", "leadbay_enrich_titles", "leadbay_report_outreach"], "failure_modes": ["Renders the call sheet immediately without proposing the right mode \u2014 if 60% of leads have no contacts, calling is futile; enrich first. Always assess `readiness` first.", "Auto-renders the map widget without asking \u2014 maps are intrusive when the user just wants to scroll a list. Map mode is a proposed option, not a default.", "Proposes map mode after the user has previously said they don't like maps \u2014 check conversation memory before adding 'View on a map' to the options list.", "Calls `leadbay_campaign_progression` instead of `leadbay_campaign_call_sheet` \u2014 progression has counts but no phones / LinkedIn / call-ready data; the user can't actually dial from progression rows.", "Renders contacts WITHOUT making the phone number a `[bare](tel:URL)` link \u2014 on mobile that breaks one-tap calling, which is the whole point of the cheat sheet.", "Records outreach WITHOUT epilogue_status \u2014 leaves the lead's pipeline state unchanged; the rep then sees the same lead surfaced again next session.", "Records outreach WITHOUT verification \u2014 verification.source/ref is REQUIRED. For calls, pass `{source: 'user_confirmed', ref: <user's exact words>}`.", "Loops through ALL leads in a 50-lead campaign before recording any outreach \u2014 the call-then-record loop must be per-lead, not batched."] }
 };
 var PROMPT_CATALOG_HEADER = `This server exposes the following workflow prompts via \`prompts/list\` and \`prompts/get\`. Some MCP clients render them as slash commands; if your client does not, you (the agent) should invoke them directly via \`prompts/get\` when the user's request matches one of the triggers described below.`;
@@ -28436,7 +28538,7 @@ function buildAcknowledgeUpdateTool(opts) {
 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_REFRESH = `Show the refreshed quota AFTER a paid action has actually COMPLETED: when leadbay_bulk_enrich_status reports the job done \u2014 all_done, OR a plateau you've decided is terminal (overall_progress.done stopped climbing across spaced polls, so some contacts are unresolvable and all_done stays false) \u2014 OR a top-up the user confirmed landed, call leadbay_account_status once and render the refreshed quota \u2014 the per-window %/$ gauge (Daily/Weekly/Monthly) it returns \u2014 so the user sees where they now stand. Wait for genuine completion: leadbay_enrich_contacts only LAUNCHES an async reveal (it returns a hint to check back in ~60s), so do NOT refresh quota right after it \u2014 the usage isn't reflected yet. For that single-contact flow, refresh only once a re-read of the lead's contacts (leadbay_research_lead_by_id; leadbay_get_contacts where exposed) shows the REQUESTED channel actually landed \u2014 the requested email and/or phone_number present \u2014 NOT enrichment.done alone (that flag is already true for a contact enriched on the other channel earlier, so a phone reveal could otherwise trigger the refresh before phone_number arrives). This is the canonical quota surface; do NOT hand-roll a 'credits' line in its place. Skip it only when account_status reports unlimited_credits, quota_error, or a null quota (nothing to show), or when billing is genuinely unavailable. Do it ONCE per completed action \u2014 not after every poll while work is still in progress.`;
+var QUOTA_REFRESH = `Show the refreshed quota AFTER a quota-using action has actually COMPLETED: when leadbay_bulk_enrich_status reports the job done \u2014 all_done, OR a plateau you've decided is terminal (overall_progress.done stopped climbing across spaced polls, so some contacts are unresolvable and all_done stays false) \u2014 OR a top-up the user confirmed landed, call leadbay_account_status once and render the refreshed quota \u2014 the per-window %/$ gauge (Daily/Weekly/Monthly) it returns \u2014 so the user sees where they now stand. Wait for genuine completion: leadbay_enrich_contacts only LAUNCHES an async reveal (it returns a hint to check back in ~60s), so do NOT refresh quota right after it \u2014 the usage isn't reflected yet. For that single-contact flow, refresh only once a re-read of the lead's contacts (leadbay_research_lead_by_id; leadbay_get_contacts where exposed) shows the REQUESTED channel actually landed \u2014 the requested email and/or phone_number present \u2014 NOT enrichment.done alone (that flag is already true for a contact enriched on the other channel earlier, so a phone reveal could otherwise trigger the refresh before phone_number arrives). This is the canonical quota surface; do NOT hand-roll a 'credits' line in its place. Skip it only when account_status reports unlimited_credits, quota_error, or a null quota (nothing to show), or when billing is genuinely unavailable. Do it ONCE per completed action \u2014 not after every poll while work is still in progress.`;
 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.`;
 var TRANSIENT_401 = `Transient 401s (DO NOT narrate as an auth problem): Leadbay bearer tokens do NOT expire on a timer, and the client already auto-retried this call once before surfacing it. So a lone AUTH_EXPIRED / 401 from a tool is almost always a brief Leadbay-side hiccup, NOT a sign the user must sign in again. When you see ONE, just silently retry the operation once more and carry on \u2014 do NOT tell the user to log in again, reconnect the connector, reauthorize, or 're-load Leadbay', and do NOT surface the bare '401' to them at all. Only if calls keep failing across several attempts should you mention it \u2014 and then frame it as a possible Leadbay-side issue or a possible logout (you cannot tell which from here), and offer to report it to the team. Never turn a one-off 401 into a 'your connection needs re-authenticating' message; that is the wrong read on a connection that is actually working.`;
 var TRIGGERED_BY = `Trigger provenance (MANDATORY): every Leadbay composite-tool call MUST carry a non-empty \`_triggered_by\` argument \u2014 the verbatim slice of the user's most recent message that this call is acting upon. Quote literally; do NOT paraphrase, summarize, or substitute a one-word label like "leads" or "request" (those are rejected). If you are acting WITHOUT a fresh user message (a memory recall, a scheduled run, a self-initiated retry), pass the actual instruction you are acting on \u2014 the recalled directive, the schedule's intent, or the original request being retried \u2014 so the value is always a real, auditable trace. Strip any secrets the user pasted (API keys, passwords, card numbers, full home addresses) \u2014 replace with [REDACTED]. A composite call missing or blanking this field is rejected with LAST_PROMPT_REQUIRED; just re-call with the field set. This is a protocol requirement on EVERY composite invocation (not just the first), independent of any telemetry setting.`;
@@ -28575,7 +28677,7 @@ function buildProtocolPrimitivesParagraph(has) {
     }
     if (deliveryRunners.length > 0) {
       clauses.push(
-        "On " + deliveryRunners.map((n) => `leadbay_${n}`).join(", ") + " the job is BACKEND-owned and likewise keeps running. Any work already paid for still completes; poll `leadbay_lead_job_status` with the `job_id` later to collect it."
+        "On " + deliveryRunners.map((n) => `leadbay_${n}`).join(", ") + " the job is BACKEND-owned and likewise keeps running. Any work already launched still completes; poll `leadbay_lead_job_status` with the `job_id` later to collect it."
       );
     }
     parts.push(
@@ -29136,6 +29238,9 @@ ${url}
         }) === true
       }));
       await maybeAttachUpdate(name, result);
+      if (name === "leadbay_account_status" && result !== null && typeof result === "object" && !Array.isArray(result) && result.error !== true) {
+        result.mcp_version = serverVersion;
+      }
       maybeAttachNotifications(result);
       if (result && typeof result === "object" && result.error === true) {
         const envText = formatErrorForLLM(result);
@@ -30787,7 +30892,7 @@ var OAUTH_BASE_URLS = {
     fr: "https://staging.api.leadbay.app"
   }
 };
-var VERSION = "0.37.0";
+var VERSION = "0.38.1";
 var HELP = `
 leadbay-mcp ${VERSION} \u2014 Leadbay Model Context Protocol server