@leadbay/mcp 0.2.2 → 0.3.0

package/dist/{chunk-FJBO2MY2.js → chunk-NED7ATJI.js}

@@ -17,7 +17,7 @@ function httpsRequest(method, url, headers, body) {
     const start = Date.now();
     const parsed = new URL(url);
     const reqHeaders = { ...headers };
-    if (body) {
+    if (body !== void 0) {
       reqHeaders["Content-Length"] = Buffer.byteLength(body);
     }
     const req = https.request({
@@ -39,7 +39,7 @@ function httpsRequest(method, url, headers, body) {
       });
     });
     req.on("error", reject);
-    if (body)
+    if (body !== void 0)
       req.write(body);
     req.end();
   });
@@ -52,6 +52,14 @@ function createClient(config = {}) {
   }
   return new LeadbayClient(baseUrl, config.token, region);
 }
+function formatLoginError(status, body, baseUrl) {
+  const trimmed = body.trim();
+  const head = `login failed (${status}) at ${baseUrl}`;
+  const hint = status === 401 ? " (wrong email or password?)" : status === 429 ? " (rate-limited; wait and retry)" : status >= 500 ? " (server error; try again shortly)" : "";
+  if (!trimmed)
+    return head + hint;
+  return `${head}: ${trimmed.slice(0, 200)}${hint}`;
+}
 async function resolveRegion(email, password, startWith = "us") {
   const order = startWith === "fr" ? ["fr", "us"] : ["us", "fr"];
   let lastErr = null;
@@ -71,12 +79,13 @@ async function resolveRegion(email, password, startWith = "us") {
           };
         }
       }
-      lastErr = { status: res.status, body: res.body, region };
+      lastErr = { kind: "http", status: res.status, body: res.body, region, baseUrl };
     } catch (e) {
-      lastErr = { error: e, region };
+      lastErr = { kind: "network", error: e, region, baseUrl };
     }
   }
-  throw new Error(`Leadbay login failed in both regions (us, fr). Last response: ${JSON.stringify(lastErr)}`);
+  const detail = lastErr?.kind === "http" ? formatLoginError(lastErr.status, lastErr.body, lastErr.baseUrl) : lastErr?.kind === "network" ? `network error at ${lastErr.baseUrl}: ${lastErr.error?.message ?? String(lastErr.error)}` : "no attempts made";
+  throw new Error(`Leadbay login failed in both regions (us, fr). ${detail}`);
 }
 var _mockFixtures = null;
 var _mockJournal = [];
@@ -300,6 +309,43 @@ var LeadbayClient = class {
       this.releaseSemaphore();
     }
   }
+  // Like request(), but the caller supplies the Content-Type and the already-
+  // serialized body (string for text payloads such as CSV; Buffer for binary
+  // uploads). Auth, semaphore, error mapping, _lastMeta, and mock-mode all
+  // mirror request() exactly. Used by leadbay_import_leads to upload CSVs to
+  // the wizard at POST /1.5/imports.
+  async requestRawBinary(method, path, contentType, body) {
+    if (process.env.LEADBAY_MOCK === "1") {
+      return this.mockRequestBinary(method, path, contentType, body);
+    }
+    if (!this.token) {
+      throw this.makeError("NOT_AUTHENTICATED", "Not logged in to Leadbay", "Set LEADBAY_TOKEN in your MCP client config, or run: npx -y @leadbay/mcp install --email <you> --region <us|fr>", path);
+    }
+    await this.acquireSemaphore();
+    try {
+      const url = `${this._baseUrl}/1.5${path}`;
+      const headers = {
+        Authorization: `Bearer ${this.token}`,
+        "Content-Type": contentType
+      };
+      const res = await httpsRequest(method, url, headers, body);
+      this._lastMeta = {
+        region: this._region,
+        endpoint: `${method} ${path}`,
+        latency_ms: res.latency_ms,
+        retry_after: parseRetryAfter(res.headers["retry-after"])
+      };
+      if (res.status === 204) {
+        return null;
+      }
+      if (res.status < 200 || res.status >= 300) {
+        throw this.mapErrorResponse(res.status, res.body, path, res.headers);
+      }
+      return JSON.parse(res.body);
+    } finally {
+      this.releaseSemaphore();
+    }
+  }
   mockRequest(method, path, body) {
     const fullPath = `/1.5${path}`;
     this._lastMeta = {
@@ -323,6 +369,39 @@ var LeadbayClient = class {
       would_call: { method, path: fullPath, body }
     };
   }
+  mockRequestBinary(method, path, contentType, body) {
+    const fullPath = `/1.5${path}`;
+    this._lastMeta = {
+      region: this._region,
+      endpoint: `${method} ${path}`,
+      latency_ms: 0,
+      retry_after: null
+    };
+    if (method === "GET") {
+      const fixture = findMockFixture("GET", fullPath);
+      if (!fixture) {
+        throw this.makeError("MOCK_NOT_FOUND", `LEADBAY_MOCK=1: no fixture for GET ${path}`, `Add a fixture to LEADBAY_MOCK_DIR (default: ./.context/leadbay-live-shapes/) \u2014 run a probe script to generate one.`, path);
+      }
+      if (fixture.status === 204)
+        return null;
+      return fixture.body;
+    }
+    const journalBody = {
+      _binary: true,
+      length: Buffer.byteLength(body),
+      content_type: contentType
+    };
+    _mockJournal.push({
+      method,
+      path: fullPath,
+      body: journalBody,
+      ts: Date.now()
+    });
+    return {
+      mocked: true,
+      would_call: { method, path: fullPath, body: journalBody }
+    };
+  }
   mapErrorResponse(status, rawBody, endpoint, headers) {
     let parsed;
     try {
@@ -587,6 +666,11 @@ var getLeadProfile = {
   },
   execute: async (client, params) => {
     const lensId = params.lensId ?? await client.resolveDefaultLens();
+    void client.request("POST", "/interactions", [
+      { type: "LEAD_SEEN", leadId: params.leadId, lensId: String(lensId) },
+      { type: "LEAD_CLICKED", leadId: params.leadId, lensId: String(lensId) }
+    ]).catch(() => {
+    });
     const [leadResult, qualResult, contactsResult, paidContactsResult, webFetchResult] = await Promise.allSettled([
       client.request("GET", `/lenses/${lensId}/leads/${params.leadId}`),
       client.request("GET", `/leads/${params.leadId}/ai_agent_responses`),
@@ -1322,12 +1406,12 @@ var setUserPrompt = {
         would_call: {
           method: "POST",
           path: `/organizations/${orgId}/user_prompt`,
-          body: { prompt: params.prompt }
+          body: { user_prompt: params.prompt }
         }
       };
     }
     await client.requestVoid("POST", `/organizations/${orgId}/user_prompt`, {
-      prompt: params.prompt
+      user_prompt: params.prompt
     });
     client.invalidateMe();
     return { set: true };
@@ -1802,6 +1886,11 @@ var researchLead = {
   execute: async (client, params, ctx) => {
     const lensId = params.lensId ?? await client.resolveDefaultLens();
     const leadId = params.leadId;
+    void client.request("POST", "/interactions", [
+      { type: "LEAD_SEEN", leadId, lensId: String(lensId) },
+      { type: "LEAD_CLICKED", leadId, lensId: String(lensId) }
+    ]).catch(() => {
+    });
     const [profileR, qualR, contactsR, webFetchR] = await Promise.allSettled([
       client.request("GET", `/lenses/${lensId}/leads/${leadId}`),
       client.request("GET", `/leads/${leadId}/ai_agent_responses`),
@@ -2190,6 +2279,510 @@ var bulkQualifyLeads = {
   }
 };
 
+// ../core/dist/composite/import-leads.js
+import { randomUUID } from "crypto";
+var CHUNK_SIZE = 100;
+var POLL_INTERVAL_MS = 2e3;
+var DEFAULT_PER_PHASE_BUDGET_MS = 6e4;
+var DEFAULT_TOTAL_BUDGET_MS2 = 3e5;
+var STABILIZATION_POLLS = 2;
+var PUBLIC_MAILBOX_DOMAINS = /* @__PURE__ */ new Set([
+  "gmail.com",
+  "googlemail.com",
+  "yahoo.com",
+  "ymail.com",
+  "outlook.com",
+  "hotmail.com",
+  "live.com",
+  "icloud.com",
+  "me.com",
+  "mac.com",
+  "aol.com",
+  "proton.me",
+  "protonmail.com",
+  "tutanota.com",
+  "gmx.com",
+  "gmx.net",
+  "gmx.de",
+  "mail.com",
+  "yandex.com",
+  "yandex.ru",
+  "qq.com",
+  "163.com",
+  "126.com"
+]);
+function normalizeDomain(input) {
+  if (!input || typeof input !== "string")
+    return null;
+  let v = input.trim().toLowerCase();
+  if (!v)
+    return null;
+  v = v.replace(/^https?:\/\//, "");
+  v = v.replace(/^www\./, "");
+  v = v.split("/")[0].split("?")[0].split("#")[0];
+  v = v.replace(/\.+$/, "");
+  if (!v)
+    return null;
+  if (/\s/.test(v))
+    return null;
+  if (!v.includes("."))
+    return null;
+  if (v.startsWith(".") || v.endsWith("."))
+    return null;
+  const parts = v.split(".");
+  if (parts.length < 2)
+    return null;
+  if (parts.some((p) => p.length === 0))
+    return null;
+  const tld = parts[parts.length - 1];
+  if (!/^[a-z]{2,}$/.test(tld) && !tld.startsWith("xn--"))
+    return null;
+  if (!/^[a-z0-9-]+$/.test(parts[parts.length - 2]))
+    return null;
+  return v;
+}
+function escapeCsvCell(raw) {
+  if (raw == null)
+    return "";
+  let s = String(raw);
+  const trimmed = s.replace(/^[\s\r\n\t]+/, "");
+  if (trimmed.length > 0) {
+    const first = trimmed[0];
+    if (first === "=" || first === "+" || first === "-" || first === "@") {
+      s = "'" + s;
+    }
+  }
+  if (/[",\n\r]/.test(s)) {
+    s = '"' + s.replace(/"/g, '""') + '"';
+  }
+  return s;
+}
+function synthesizeCsv(rows) {
+  const lines = ["MCP_ROW_ID,LEAD_NAME,LEAD_WEBSITE"];
+  for (const r of rows) {
+    lines.push([escapeCsvCell(r.rowId), escapeCsvCell(r.name), escapeCsvCell(r.website)].join(","));
+  }
+  return lines.join("\n") + "\n";
+}
+function chunkAt100(items) {
+  if (items.length === 0)
+    return [];
+  const chunks = [];
+  for (let i = 0; i < items.length; i += CHUNK_SIZE) {
+    chunks.push(items.slice(i, i + CHUNK_SIZE));
+  }
+  return chunks;
+}
+function checkAborted(signal) {
+  if (signal?.aborted) {
+    throw Object.assign(new Error("aborted"), { name: "AbortError" });
+  }
+}
+async function sleepWithAbort(ms, signal) {
+  if (!signal) {
+    await new Promise((r) => setTimeout(r, ms));
+    return;
+  }
+  if (signal.aborted) {
+    checkAborted(signal);
+  }
+  await new Promise((resolve, reject) => {
+    const t = setTimeout(() => {
+      signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(t);
+      signal.removeEventListener("abort", onAbort);
+      reject(Object.assign(new Error("aborted"), { name: "AbortError" }));
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function readCell(record, key) {
+  const want = key.toLowerCase();
+  const arr = record.records;
+  if (Array.isArray(arr)) {
+    for (const c of arr) {
+      const k = (c?.column_name ?? c?.key ?? c?.field ?? "").toString().toLowerCase();
+      if (k === want) {
+        const v = c?.value ?? null;
+        return v != null ? String(v) : null;
+      }
+    }
+  }
+  const cells = record.cells;
+  if (cells && typeof cells === "object" && !Array.isArray(cells)) {
+    for (const [k, v] of Object.entries(cells)) {
+      if (k.toLowerCase() === want) {
+        return v != null ? String(v) : null;
+      }
+    }
+  }
+  if (Array.isArray(cells)) {
+    for (const c of cells) {
+      const k = (c?.key ?? c?.field ?? c?.column_name ?? "").toString().toLowerCase();
+      if (k === want) {
+        const v = c?.value ?? null;
+        return v != null ? String(v) : null;
+      }
+    }
+  }
+  return null;
+}
+function buildInputLookup(inputs) {
+  const validInputs = [];
+  const malformed = [];
+  const byDomain = /* @__PURE__ */ new Map();
+  const byRowId = /* @__PURE__ */ new Map();
+  inputs.forEach((inp, i) => {
+    void i;
+    const norm = normalizeDomain(inp.domain ?? "");
+    if (!norm) {
+      malformed.push(inp.domain ?? "");
+      return;
+    }
+    if (byDomain.has(norm))
+      return;
+    const rowId = randomUUID();
+    const idx = validInputs.length;
+    validInputs.push({ index: idx, rowId, domain: norm, name: inp.name?.trim() || norm });
+    byDomain.set(norm, idx);
+    byRowId.set(rowId, idx);
+  });
+  return { validInputs, malformed, byDomain, byRowId };
+}
+async function pollUntil(fn, done, budgetMs, signal, ctx, label) {
+  const deadline = Date.now() + budgetMs;
+  let last;
+  while (true) {
+    checkAborted(signal);
+    last = await fn();
+    if (done(last))
+      return last;
+    if (Date.now() >= deadline) {
+      ctx?.logger?.warn?.(`import-leads: ${label} budget exhausted (${budgetMs}ms)`);
+      return last;
+    }
+    await sleepWithAbort(POLL_INTERVAL_MS, signal);
+  }
+}
+async function pollPreprocess(client, importId, budgetMs, ctx, signal) {
+  const result = await pollUntil(() => client.request("GET", `/imports/${importId}`), (r) => Boolean(r.pre_processing?.finished), budgetMs, signal, ctx, "preprocess");
+  if (!result.pre_processing?.finished) {
+    throw client.makeError("IMPORT_BUDGET_EXHAUSTED", `Preprocess phase did not finish within ${budgetMs}ms`, `Increase per_phase_budget_ms (current: ${budgetMs}) or split the batch. importId=${importId}.`, `GET /imports/${importId}`);
+  }
+  if (result.pre_processing.error) {
+    throw client.makeError("IMPORT_PREPROCESS_FAILED", `Preprocess failed: ${result.pre_processing.error}`, `Check the input domains. importId=${importId} for backend debugging.`, `GET /imports/${importId}`);
+  }
+  return result;
+}
+async function pollProcess(client, importId, budgetMs, ctx, signal) {
+  const result = await pollUntil(() => client.request("GET", `/imports/${importId}`), (r) => Boolean(r.processing?.finished), budgetMs, signal, ctx, "process");
+  if (!result.processing?.finished) {
+    throw client.makeError("IMPORT_BUDGET_EXHAUSTED", `Process phase did not finish within ${budgetMs}ms`, `Increase per_phase_budget_ms (current: ${budgetMs}) or split the batch. importId=${importId}.`, `GET /imports/${importId}`);
+  }
+  if (result.processing.error != null) {
+    throw client.makeError("IMPORT_PROCESSING_FAILED", `Backend processing failed: ${result.processing.error}`, `importId=${importId}.`, `GET /imports/${importId}`);
+  }
+  return result;
+}
+async function pollRecordsToTerminal(client, importId, budgetMs, expectedRowCount, ctx, signal) {
+  const deadline = Date.now() + budgetMs;
+  const maxPagesPerPoll = Math.max(2, Math.ceil(expectedRowCount / 100) * 2 + 4);
+  let stableCounts = 0;
+  let lastSnapshot = null;
+  while (true) {
+    checkAborted(signal);
+    let total = 0;
+    let transient = 0;
+    let pagesFetched = 0;
+    let exhaustedPagination = false;
+    const records = [];
+    for (let page = 0; page < maxPagesPerPoll; page++) {
+      checkAborted(signal);
+      const qs = `count=100&page=${page}&automatic_match=true&manual_match=true&no_match=true&matching=true&importing=true&imported=true`;
+      const res = await client.request("GET", `/imports/${importId}/records?${qs}`);
+      pagesFetched++;
+      records.push(...res.items);
+      total = res.pagination.total ?? records.length;
+      for (const r of res.items) {
+        const status = (r.status ?? "").toString().toUpperCase();
+        const matchType = (r.match_type ?? r.matchType ?? "").toString().toUpperCase();
+        const isTerminal = matchType === "NO_MATCH" || status === "IMPORTED";
+        if (!isTerminal)
+          transient++;
+      }
+      const totalPages = res.pagination.pages ?? 0;
+      if (page + 1 >= totalPages) {
+        exhaustedPagination = true;
+        break;
+      }
+    }
+    if (!exhaustedPagination) {
+      throw client.makeError("IMPORT_PAGINATION_RUNAWAY", `Records pagination exceeded ${maxPagesPerPoll} pages`, `importId=${importId}. Please file a bug at https://github.com/leadbay/leadclaw/issues.`, `GET /imports/${importId}/records`);
+    }
+    const snapshot = { total, transient };
+    const settled = transient === 0;
+    const stableVsLast = lastSnapshot != null && lastSnapshot.total === snapshot.total && lastSnapshot.transient === snapshot.transient;
+    if (settled && stableVsLast) {
+      stableCounts++;
+    } else if (settled) {
+      stableCounts = 1;
+    } else {
+      stableCounts = 0;
+    }
+    lastSnapshot = snapshot;
+    if (settled && stableCounts >= STABILIZATION_POLLS) {
+      return records;
+    }
+    if (Date.now() >= deadline) {
+      ctx?.logger?.warn?.(`import-leads: records did not stabilize (transient=${transient}, total=${total}); returning best-effort`);
+      throw client.makeError("IMPORT_NOT_TERMINAL", `Backend hasn't fully settled records within ${budgetMs}ms`, `Retry leadbay_import_leads with the same domains in 30s, or split the batch. importId=${importId}.`, `GET /imports/${importId}/records`);
+    }
+    await sleepWithAbort(POLL_INTERVAL_MS, signal);
+  }
+}
+async function runOneChunk(client, chunk, chunkIdx, totalChunks, dryRun, perPhaseBudgetMs, totalDeadline, ctx, signal, onImportId) {
+  const csv = synthesizeCsv(chunk.map((c) => ({ rowId: c.rowId, name: c.name, website: c.domain })));
+  const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const fileName = `mcp-import-${ts}-${chunkIdx}.csv`;
+  ctx?.logger?.info?.(`import-leads: uploading chunk ${chunkIdx + 1}/${totalChunks} (${chunk.length} rows, ${csv.length}B)`);
+  const upload = await client.requestRawBinary("POST", `/imports?file_name=${encodeURIComponent(fileName)}`, "text/csv", csv);
+  const importId = upload.id;
+  onImportId(importId);
+  const phaseBudget = Math.min(perPhaseBudgetMs, Math.max(1, totalDeadline - Date.now()));
+  await pollPreprocess(client, importId, phaseBudget, ctx, signal);
+  ctx?.logger?.info?.(`import-leads: preprocess done for importId=${importId}`);
+  if (dryRun) {
+    return { importId, records: [] };
+  }
+  const mappings = {
+    fields: { LEAD_NAME: "LEAD_NAME", LEAD_WEBSITE: "LEAD_WEBSITE" },
+    statuses: {},
+    default_status: null
+  };
+  await client.requestVoid("POST", `/imports/${importId}/update_mappings`, mappings);
+  ctx?.logger?.info?.(`import-leads: mappings committed for importId=${importId}`);
+  const phaseBudget2 = Math.min(perPhaseBudgetMs, Math.max(1, totalDeadline - Date.now()));
+  await pollProcess(client, importId, phaseBudget2, ctx, signal);
+  ctx?.logger?.info?.(`import-leads: process done for importId=${importId}`);
+  const phaseBudget3 = Math.min(perPhaseBudgetMs, Math.max(1, totalDeadline - Date.now()));
+  const records = await pollRecordsToTerminal(client, importId, phaseBudget3, chunk.length, ctx, signal);
+  ctx?.logger?.info?.(`import-leads: ${records.length} records terminal for importId=${importId}`);
+  return { importId, records };
+}
+function reconcileOneChunk(chunk, byRowIdGlobal, byDomainGlobal, validInputsGlobal, matched, notImported) {
+  const seenInputIndex = /* @__PURE__ */ new Set();
+  const sortedRecords = [...chunk.records].sort((a, b) => {
+    const aHasLead = a.lead?.id ? 0 : 1;
+    const bHasLead = b.lead?.id ? 0 : 1;
+    return aHasLead - bHasLead;
+  });
+  for (const rec of sortedRecords) {
+    let inputIdx;
+    const rowIdCell = readCell(rec, "MCP_ROW_ID");
+    if (rowIdCell && byRowIdGlobal.has(rowIdCell)) {
+      inputIdx = byRowIdGlobal.get(rowIdCell);
+    }
+    if (inputIdx === void 0) {
+      const websiteCell = readCell(rec, "LEAD_WEBSITE");
+      if (websiteCell) {
+        const norm = normalizeDomain(websiteCell);
+        if (norm && byDomainGlobal.has(norm)) {
+          inputIdx = byDomainGlobal.get(norm);
+        }
+      }
+    }
+    if (inputIdx === void 0 && rec.lead?.website) {
+      const norm = normalizeDomain(rec.lead.website);
+      if (norm && byDomainGlobal.has(norm)) {
+        inputIdx = byDomainGlobal.get(norm);
+      }
+    }
+    if (inputIdx === void 0)
+      continue;
+    if (seenInputIndex.has(inputIdx)) {
+      if (!matched.has(inputIdx) && !notImported.has(inputIdx)) {
+        const inp2 = validInputsGlobal[inputIdx];
+        notImported.set(inputIdx, { domain: inp2.domain, reason: "ambiguous" });
+      }
+      continue;
+    }
+    seenInputIndex.add(inputIdx);
+    const inp = validInputsGlobal[inputIdx];
+    const matchType = (rec.match_type ?? rec.matchType ?? "").toString();
+    if (rec.lead?.id) {
+      matched.set(inputIdx, {
+        domain: inp.domain,
+        leadId: rec.lead.id,
+        name: rec.lead.name ?? null
+      });
+    } else if (matchType === "NO_MATCH") {
+      const reason = PUBLIC_MAILBOX_DOMAINS.has(inp.domain) ? "no_match" : "uncrawled";
+      notImported.set(inputIdx, { domain: inp.domain, reason });
+    } else {
+      notImported.set(inputIdx, { domain: inp.domain, reason: "internal_error" });
+    }
+  }
+}
+var importLeads = {
+  name: "leadbay_import_leads",
+  description: "Import a list of company domains and get back stable Leadbay leadIds for downstream chaining into leadbay_bulk_qualify_leads / leadbay_research_lead.\n\n\u26A0\uFE0F MUTATES USER STATE. This tool wraps Leadbay's CRM-import wizard. Each call:\n  - creates a row in the user's CRM-imports list (visible in the web UI)\n  - touches onboarding state (startFileless, onboarding step \u2192 PROCESSING)\nSuitable for occasional automation. NOT suitable for high-cadence (>5 calls/day) \u2014 wait for the backend programmatic endpoint (issue: leadbay/backend prolonged-import-with-crawl).\n\nReturns: leads = leadIds for domains Leadbay already knows about (via crawler). not_imported = domains Leadbay doesn't know yet, with a reason. The tool does NOT create new leads for unknown domains; the caller decides what to do.\n\nWhen to use: you have a list of domains from another system (CRM, analytics, email correspondents) and need to map them to Leadbay leadIds.\nWhen NOT to use: for prospect discovery (use leadbay_pull_leads); for one specific company's profile (use leadbay_research_company); when you can't tolerate the side effects above.\n\nRequires: LEADBAY_MCP_WRITE=1 (MCP) or exposeWrite=true (OpenClaw); admin role on the Leadbay account; active billing.",
+  write: true,
+  version: "0.1.0",
+  inputSchema: {
+    type: "object",
+    properties: {
+      domains: {
+        type: "array",
+        description: "List of company domains to map to Leadbay leadIds.",
+        items: {
+          type: "object",
+          properties: {
+            domain: {
+              type: "string",
+              description: "Company domain (e.g. 'apple.com'). Protocol/path are stripped."
+            },
+            name: {
+              type: "string",
+              description: "Optional display name override; defaults to the domain."
+            }
+          },
+          required: ["domain"]
+        }
+      },
+      dry_run: {
+        type: "boolean",
+        description: "If true, run preprocess only \u2014 do NOT commit lead-CRM linking. Note: an import row still appears in the user's CRM-imports list as 'incomplete'. Use to verify domain format / wizard reachability without polluting the CRM."
+      },
+      per_phase_budget_ms: {
+        type: "number",
+        description: `Single poll-loop cap (default ${DEFAULT_PER_PHASE_BUDGET_MS}ms).`
+      },
+      total_budget_ms: {
+        type: "number",
+        description: `Overall cap across all phases (default ${DEFAULT_TOTAL_BUDGET_MS2}ms).`
+      }
+    },
+    required: ["domains"]
+  },
+  execute: async (client, params, ctx) => {
+    const signal = ctx?.signal;
+    const dryRun = Boolean(params.dry_run);
+    const perPhaseBudget = params.per_phase_budget_ms ?? DEFAULT_PER_PHASE_BUDGET_MS;
+    const totalBudget = params.total_budget_ms ?? DEFAULT_TOTAL_BUDGET_MS2;
+    const totalDeadline = Date.now() + totalBudget;
+    if (!Array.isArray(params.domains) || params.domains.length === 0) {
+      throw client.makeError("IMPORT_EMPTY_INPUT", "domains[] must contain at least one entry", "Pass at least one domain in domains[].", "POST /imports");
+    }
+    const me = await client.resolveMe();
+    if (!me.admin) {
+      throw client.makeError("IMPORT_ADMIN_REQUIRED", "This tool requires admin role on the Leadbay account", "Ask the account owner to grant import permission, or use a token from an admin user.", "POST /imports");
+    }
+    const lookup = buildInputLookup(params.domains);
+    if (lookup.validInputs.length === 0) {
+      const not_imported2 = lookup.malformed.map((d) => ({
+        domain: d,
+        reason: "malformed"
+      }));
+      return {
+        leads: [],
+        not_imported: not_imported2,
+        importIds: [],
+        region: client.region,
+        dry_run: dryRun || void 0,
+        _meta: client.lastMeta ?? {
+          region: client.region,
+          endpoint: "POST /imports",
+          latency_ms: null,
+          retry_after: null
+        }
+      };
+    }
+    const chunks = chunkAt100(lookup.validInputs);
+    ctx?.logger?.info?.(`import-leads: ${lookup.validInputs.length} domains \u2192 ${chunks.length} chunk(s); dry_run=${dryRun}, totalBudgetMs=${totalBudget}`);
+    const importIds = [];
+    const matched = /* @__PURE__ */ new Map();
+    const notImported = /* @__PURE__ */ new Map();
+    let cancelled = false;
+    const recordImportId = (id) => {
+      if (!importIds.includes(id))
+        importIds.push(id);
+    };
+    try {
+      for (let i = 0; i < chunks.length; i++) {
+        const chunk = chunks[i];
+        const out = await runOneChunk(client, chunk, i, chunks.length, dryRun, perPhaseBudget, totalDeadline, ctx, signal, recordImportId);
+        if (!dryRun) {
+          reconcileOneChunk(out, lookup.byRowId, lookup.byDomain, lookup.validInputs, matched, notImported);
+        } else {
+          for (const c of chunk) {
+            notImported.set(c.index, { domain: c.domain, reason: "dry_run" });
+          }
+        }
+      }
+    } catch (err) {
+      if (err?.name === "AbortError") {
+        cancelled = true;
+        ctx?.logger?.info?.(`import-leads: aborted via signal; importIds=${importIds.join(",")}`);
+      } else if (err?.error === true) {
+        if (err.code === "FORBIDDEN") {
+          throw client.makeError("IMPORT_ADMIN_REQUIRED", err.message || "Insufficient permissions for /imports", "This tool requires admin role on the Leadbay account. Ask the account owner.", err._meta?.endpoint);
+        }
+        if (err.code === "BILLING_SUSPENDED") {
+          throw client.makeError("IMPORT_BILLING_REQUIRED", err.message || "Active billing required for imports", "Upgrade at https://app.leadbay.ai/billing, then retry.", err._meta?.endpoint);
+        }
+        throw err;
+      } else {
+        throw err;
+      }
+    }
+    for (const m of lookup.malformed) {
+      notImported.set(-1 - notImported.size, { domain: m, reason: "malformed" });
+    }
+    const leads = [];
+    const not_imported = [];
+    if (dryRun) {
+      for (const inp of lookup.validInputs) {
+        not_imported.push({ domain: inp.domain, reason: "dry_run" });
+      }
+    } else {
+      for (const inp of lookup.validInputs) {
+        const m = matched.get(inp.index);
+        if (m) {
+          leads.push(m);
+          continue;
+        }
+        const ni = notImported.get(inp.index);
+        if (ni) {
+          not_imported.push(ni);
+          continue;
+        }
+        not_imported.push({ domain: inp.domain, reason: "internal_error" });
+      }
+    }
+    for (const [k, v] of notImported) {
+      if (k < 0)
+        not_imported.push(v);
+    }
+    return {
+      leads,
+      not_imported,
+      importIds,
+      region: client.region,
+      cancelled: cancelled || void 0,
+      dry_run: dryRun || void 0,
+      _meta: client.lastMeta ?? {
+        region: client.region,
+        endpoint: "POST /imports",
+        latency_ms: null,
+        retry_after: null
+      }
+    };
+  }
+};
+
 // ../core/dist/composite/enrich-titles.js
 var DEFAULT_CANDIDATE_COUNT = 25;
 var enrichTitles = {
@@ -2421,7 +3014,7 @@ import { mkdir as mkdirAsync, lstat, open as fsOpen, readFile, rename, stat, unl
 import { constants as fsConstants } from "fs";
 import { dirname, resolve as resolvePath } from "path";
 import { homedir, platform } from "os";
-import { createHash, randomUUID } from "crypto";
+import { createHash, randomUUID as randomUUID2 } from "crypto";
 var DEFAULT_IDEMPOTENCY_WINDOW_MS = 5 * 60 * 1e3;
 var TTL_MS = 30 * 24 * 60 * 60 * 1e3;
 var UUIDV4_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
@@ -2675,7 +3268,7 @@ var LocalBulkStore = class {
         };
       }
       const record = {
-        bulk_id: randomUUID(),
+        bulk_id: randomUUID2(),
         launched_at: new Date(nowMs).toISOString(),
         lead_ids,
         titles,
@@ -3205,14 +3798,14 @@ var refinePrompt = {
         would_call: {
           method: "POST",
           path: `/organizations/${orgId}/user_prompt`,
-          body: { prompt: params.prompt }
+          body: { user_prompt: params.prompt }
         }
       };
     }
     const postedAt = Date.now();
     const STALE_GUARD_MS = 5e3;
     await client.requestVoid("POST", `/organizations/${orgId}/user_prompt`, {
-      prompt: params.prompt
+      user_prompt: params.prompt
     });
     client.invalidateMe();
     const attempts = params.clarification_poll_attempts ?? DEFAULT_POLL_ATTEMPTS;
@@ -3521,7 +4114,8 @@ var compositeWriteTools = [
   adjustAudience,
   refinePrompt,
   answerClarification,
-  reportOutreach
+  reportOutreach,
+  importLeads
 ];
 var compositeTools = [
   ...compositeReadTools,
@@ -3532,6 +4126,7 @@ var tools = [...compositeTools, ...granularTools];
 export {
   REGIONS,
   createClient,
+  formatLoginError,
   resolveRegion,
   getMockJournal,
   clearMockJournal,
@@ -3582,6 +4177,7 @@ export {
   recallOrderedTitles,
   accountStatus,
   bulkQualifyLeads,
+  importLeads,
   enrichTitles,
   isValidBulkId,
   LocalBulkStore,