@signaliz/sdk 1.0.33 → 1.0.36

package/README.md

@@ -72,18 +72,23 @@ const signalBatch = await signaliz.enrichCompanies(companies, { concurrency: 5 }
 const copyBatch = await signaliz.createSignalCopyBatch(copyRequests, { concurrency: 5 });
 ```
 
+For an ambiguous submission failure, retry with the same
+`idempotencyKey` to recover the original job without duplicate work.
+
 Each batch accepts up to 5,000 items. Company Signal Enrichment transparently
 resumes long-running research through the same `/company-signals` endpoint;
 callers never need an internal Trigger.dev status URL. The SDK follows the
 server's adaptive polling hints by default and still honors `pollIntervalMs`
 when a caller explicitly overrides the cadence.
 Exact duplicate tasks are single-flighted across each full batch without
-changing input order or result cardinality. Verify Email batches larger than 25
-use one cache-aware recoverable REST job with 500-row result pages; Find Email
-and Company Signal Enrichment use 25-row REST chunks. Signal to Copy batches
-larger than 25 use one recoverable REST job when they can reuse available signal
-data; fresh or deep-search requests keep the 25-row path. Signal to Copy also
-shares company research across copy recipients.
+changing input order or result cardinality. Find Email and Verify Email batches
+larger than 25 use one cache-aware recoverable REST job with 500-row result
+pages. Uniform Company Signal Enrichment batches larger than 25 use one
+cache-aware recoverable REST job with 25-row result pages; heterogeneous,
+no-wait, and per-run recovery inputs keep the 25-row request path. Signal to
+Copy batches larger than 25 use one recoverable REST job when they can reuse
+available signal data; fresh or deep-search requests keep the 25-row path.
+Signal to Copy also shares company research across copy recipients.
 
 Company Signal Enrichment defaults `online` and `enableDeepSearch` to `true`
 unless the caller explicitly disables them. Signal to Copy AI returns three

package/dist/{chunk-H6HOY73X.mjs → chunk-WKE2PNXT.mjs}

@@ -431,12 +431,21 @@ var Signaliz = class {
     validateBatchSize(companies);
     const startedAt = Date.now();
     const results = new Array(companies.length);
-    let pending = companies.map((params, index) => ({
+    const initialTasks = companies.map((params, index) => ({
       index,
       request: companySignalRequestBody(params)
     }));
+    const recoverableBatch = companySignalRecoverableBatchOptions(companies, initialTasks);
+    let pending = initialTasks;
+    let firstRound = true;
     while (pending.length > 0) {
-      const round = await this.runCoreBatchRound("api/v1/company-signals", pending, options);
+      const round = await this.runCoreBatchRound(
+        "api/v1/company-signals",
+        pending,
+        options,
+        firstRound ? recoverableBatch : void 0
+      );
+      firstRound = false;
       const taskByIndex = new Map(pending.map((task) => [task.index, task]));
       const nextPending = [];
       let nextDelayMs = 6e4;
@@ -521,7 +530,7 @@ var Signaliz = class {
     const canUseRecoverableAvailableDataJob = uniqueRequests.length > 25 && uniqueRequests.every(
       (params) => params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
     );
-    const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
+    const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests, options) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
     const results = requests.map((_, index) => ({
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index
@@ -565,11 +574,14 @@ var Signaliz = class {
     }
     return uniqueResults;
   }
-  async runAvailableSignalCopyBatchJob(requests) {
+  async runAvailableSignalCopyBatchJob(requests, options) {
     const rows = await this.runRecoverableCoreBatchJob(
       "api/v1/signal-to-copy",
       requests.map(signalToCopyRequestBody),
-      "Signal to Copy"
+      "Signal to Copy",
+      500,
+      20 * 6e4,
+      options?.idempotencyKey
     );
     const results = new Array(requests.length);
     for (const row of rows) {
@@ -578,19 +590,28 @@ var Signaliz = class {
     }
     return results;
   }
-  async runRecoverableCoreBatchJob(path, requests, label) {
+  async runRecoverableCoreBatchJob(path, requests, label, pageSize = 500, maxWaitMs = 20 * 6e4, idempotencyKey) {
     const startedAt = Date.now();
-    const maxWaitMs = 20 * 6e4;
-    const submission = await this.client.post(path, {
-      requests,
-      idempotency_key: newBatchIdempotencyKey(label)
-    });
+    const submissionIdempotencyKey = idempotencyKey?.trim() || newBatchIdempotencyKey(label);
+    let submission;
+    try {
+      submission = await this.client.post(path, {
+        requests,
+        idempotency_key: submissionIdempotencyKey
+      });
+    } catch (error) {
+      if (error instanceof SignalizError && !error.isRetryable) throw error;
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(
+        `${label} batch submission was not confirmed. Retry with idempotency key "${submissionIdempotencyKey}" to recover the same job. ${message}`
+      );
+    }
     const jobId = String(submission.job_id || "").trim();
     if (!jobId) throw new Error(`${label} batch did not return a recoverable job_id`);
     let status = await this.client.post(path, {
       job_id: jobId,
       page: 1,
-      page_size: 500
+      page_size: pageSize
     });
     while (!["completed", "partial", "failed"].includes(String(status.status || "").toLowerCase())) {
       if (Date.now() - startedAt >= maxWaitMs) {
@@ -601,21 +622,28 @@ var Signaliz = class {
       status = await this.client.post(path, {
         job_id: jobId,
         page: 1,
-        page_size: 500
+        page_size: pageSize
       });
     }
     const totalPages = Math.max(1, Number(status.total_pages || 1));
     const pages = [Array.isArray(status.results) ? status.results : []];
     if (totalPages > 1) {
-      const remainingPages = await Promise.all(Array.from(
-        { length: totalPages - 1 },
-        (_, index) => this.client.post(path, {
+      const pageNumbers = Array.from({ length: totalPages - 1 }, (_, index) => index + 2);
+      const remainingPages = await runBatch(
+        pageNumbers,
+        async (page) => await this.client.post(path, {
           job_id: jobId,
-          page: index + 2,
-          page_size: 500
-        })
-      ));
-      for (const page of remainingPages) pages.push(Array.isArray(page.results) ? page.results : []);
+          page,
+          page_size: pageSize
+        }),
+        { concurrency: Math.min(10, pageNumbers.length) }
+      );
+      for (const page of remainingPages.results) {
+        if (!page.success || !page.data) {
+          throw new Error(`${label} batch result page ${page.index + 2} failed: ${page.error || "unknown error"}`);
+        }
+        pages.push(Array.isArray(page.data.results) ? page.data.results : []);
+      }
     }
     const rows = pages.flat();
     if (rows.length !== requests.length) {
@@ -694,21 +722,25 @@ var Signaliz = class {
     }
     return results;
   }
-  async runCoreBatchRound(path, tasks, options) {
+  async runCoreBatchRound(path, tasks, options, companyRecoverableBatch) {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
-    if (path === "api/v1/verify-email" && uniqueTasks.length > 25) {
+    const recoverableBatch = path === "api/v1/find-email" ? { label: "Find Email", pageSize: 500, maxWaitMs: 20 * 6e4 } : path === "api/v1/verify-email" ? { label: "Verify Email", pageSize: 500, maxWaitMs: 20 * 6e4 } : companyRecoverableBatch;
+    if (recoverableBatch && uniqueTasks.length > 25) {
       const rows = await this.runRecoverableCoreBatchJob(
         path,
         uniqueTasks.map((task) => task.request),
-        "Verify Email"
+        recoverableBatch.label,
+        recoverableBatch.pageSize,
+        recoverableBatch.maxWaitMs,
+        options?.idempotencyKey
       );
       const uniqueResults2 = rows.map((raw) => ({
         index: uniqueTasks[Number(raw.index)].index,
         success: !recoverableJobRowFailed(raw),
         raw,
-        error: recoverableJobRowFailed(raw) ? raw.error || raw._error || raw.message || raw.failure_reason || "Verify Email item failed" : void 0
+        error: recoverableJobRowFailed(raw) ? raw.error || raw._error || raw.message || raw.failure_reason || `${recoverableBatch.label} item failed` : void 0
       }));
       return tasks.map((task, index) => ({
         ...uniqueResults2[deduplicated.sourceIndexByInput[index]],
@@ -773,7 +805,7 @@ var Signaliz = class {
   }
 };
 function recoverableJobRowFailed(row) {
-  return row.success === false || String(row._status || "").toLowerCase() === "failed";
+  return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
 function newBatchIdempotencyKey(label) {
   const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
@@ -850,6 +882,7 @@ function companySignalRequestBody(params) {
     lookback_days: params.lookbackDays,
     online,
     enable_deep_search: params.enableDeepSearch ?? online,
+    include_summary: params.includeSummary,
     enable_outreach_intelligence: params.enableOutreachIntelligence,
     enable_predictive_intelligence: params.enablePredictiveIntelligence,
     skip_cache: params.skipCache,
@@ -859,6 +892,29 @@ function companySignalRequestBody(params) {
     max_wait_ms: params.maxWaitMs
   });
 }
+function companySignalRecoverableBatchOptions(companies, tasks) {
+  if (companies.length <= 25 || companies.some((params) => params.waitForResult === false || Boolean(params.signalRunId))) {
+    return void 0;
+  }
+  const maxWaitMs = Math.max(1e3, companies[0].maxWaitMs ?? 20 * 6e4);
+  if (companies.some((params) => Math.max(1e3, params.maxWaitMs ?? 20 * 6e4) !== maxWaitMs)) {
+    return void 0;
+  }
+  const configKey = (request) => {
+    const {
+      company_domain: _companyDomain,
+      company_name: _companyName,
+      signal_run_id: _signalRunId,
+      wait_for_result: _waitForResult,
+      max_wait_ms: _maxWaitMs,
+      ...config
+    } = request;
+    return JSON.stringify(config);
+  };
+  const sharedConfig = configKey(tasks[0].request);
+  if (tasks.some((task) => configKey(task.request) !== sharedConfig)) return void 0;
+  return { label: "Company Signals", pageSize: 25, maxWaitMs };
+}
 function normalizeCompanySignalResult(params, data) {
   return {
     success: data.success ?? true,

package/dist/index.d.mts

@@ -9,6 +9,8 @@ interface SignalizConfig {
 interface BatchOptions {
     /** Maximum simultaneous API requests. Defaults to 10; allowed range is 1-50. */
     concurrency?: number;
+    /** Stable key for safely retrying an ambiguous recoverable batch submission. */
+    idempotencyKey?: string;
 }
 interface BatchItemResult<T> {
     index: number;
@@ -88,6 +90,7 @@ interface CompanySignalEnrichmentParams {
     lookbackDays?: number;
     online?: boolean;
     enableDeepSearch?: boolean;
+    includeSummary?: boolean;
     enableOutreachIntelligence?: boolean;
     enablePredictiveIntelligence?: boolean;
     skipCache?: boolean;

package/dist/index.d.ts

@@ -9,6 +9,8 @@ interface SignalizConfig {
 interface BatchOptions {
     /** Maximum simultaneous API requests. Defaults to 10; allowed range is 1-50. */
     concurrency?: number;
+    /** Stable key for safely retrying an ambiguous recoverable batch submission. */
+    idempotencyKey?: string;
 }
 interface BatchItemResult<T> {
     index: number;
@@ -88,6 +90,7 @@ interface CompanySignalEnrichmentParams {
     lookbackDays?: number;
     online?: boolean;
     enableDeepSearch?: boolean;
+    includeSummary?: boolean;
     enableOutreachIntelligence?: boolean;
     enablePredictiveIntelligence?: boolean;
     skipCache?: boolean;

package/dist/index.js

@@ -458,12 +458,21 @@ var Signaliz = class {
     validateBatchSize(companies);
     const startedAt = Date.now();
     const results = new Array(companies.length);
-    let pending = companies.map((params, index) => ({
+    const initialTasks = companies.map((params, index) => ({
       index,
       request: companySignalRequestBody(params)
     }));
+    const recoverableBatch = companySignalRecoverableBatchOptions(companies, initialTasks);
+    let pending = initialTasks;
+    let firstRound = true;
     while (pending.length > 0) {
-      const round = await this.runCoreBatchRound("api/v1/company-signals", pending, options);
+      const round = await this.runCoreBatchRound(
+        "api/v1/company-signals",
+        pending,
+        options,
+        firstRound ? recoverableBatch : void 0
+      );
+      firstRound = false;
       const taskByIndex = new Map(pending.map((task) => [task.index, task]));
       const nextPending = [];
       let nextDelayMs = 6e4;
@@ -548,7 +557,7 @@ var Signaliz = class {
     const canUseRecoverableAvailableDataJob = uniqueRequests.length > 25 && uniqueRequests.every(
       (params) => params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
     );
-    const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
+    const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests, options) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
     const results = requests.map((_, index) => ({
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index
@@ -592,11 +601,14 @@ var Signaliz = class {
     }
     return uniqueResults;
   }
-  async runAvailableSignalCopyBatchJob(requests) {
+  async runAvailableSignalCopyBatchJob(requests, options) {
     const rows = await this.runRecoverableCoreBatchJob(
       "api/v1/signal-to-copy",
       requests.map(signalToCopyRequestBody),
-      "Signal to Copy"
+      "Signal to Copy",
+      500,
+      20 * 6e4,
+      options?.idempotencyKey
     );
     const results = new Array(requests.length);
     for (const row of rows) {
@@ -605,19 +617,28 @@ var Signaliz = class {
     }
     return results;
   }
-  async runRecoverableCoreBatchJob(path, requests, label) {
+  async runRecoverableCoreBatchJob(path, requests, label, pageSize = 500, maxWaitMs = 20 * 6e4, idempotencyKey) {
     const startedAt = Date.now();
-    const maxWaitMs = 20 * 6e4;
-    const submission = await this.client.post(path, {
-      requests,
-      idempotency_key: newBatchIdempotencyKey(label)
-    });
+    const submissionIdempotencyKey = idempotencyKey?.trim() || newBatchIdempotencyKey(label);
+    let submission;
+    try {
+      submission = await this.client.post(path, {
+        requests,
+        idempotency_key: submissionIdempotencyKey
+      });
+    } catch (error) {
+      if (error instanceof SignalizError && !error.isRetryable) throw error;
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(
+        `${label} batch submission was not confirmed. Retry with idempotency key "${submissionIdempotencyKey}" to recover the same job. ${message}`
+      );
+    }
     const jobId = String(submission.job_id || "").trim();
     if (!jobId) throw new Error(`${label} batch did not return a recoverable job_id`);
     let status = await this.client.post(path, {
       job_id: jobId,
       page: 1,
-      page_size: 500
+      page_size: pageSize
     });
     while (!["completed", "partial", "failed"].includes(String(status.status || "").toLowerCase())) {
       if (Date.now() - startedAt >= maxWaitMs) {
@@ -628,21 +649,28 @@ var Signaliz = class {
       status = await this.client.post(path, {
         job_id: jobId,
         page: 1,
-        page_size: 500
+        page_size: pageSize
       });
     }
     const totalPages = Math.max(1, Number(status.total_pages || 1));
     const pages = [Array.isArray(status.results) ? status.results : []];
     if (totalPages > 1) {
-      const remainingPages = await Promise.all(Array.from(
-        { length: totalPages - 1 },
-        (_, index) => this.client.post(path, {
+      const pageNumbers = Array.from({ length: totalPages - 1 }, (_, index) => index + 2);
+      const remainingPages = await runBatch(
+        pageNumbers,
+        async (page) => await this.client.post(path, {
           job_id: jobId,
-          page: index + 2,
-          page_size: 500
-        })
-      ));
-      for (const page of remainingPages) pages.push(Array.isArray(page.results) ? page.results : []);
+          page,
+          page_size: pageSize
+        }),
+        { concurrency: Math.min(10, pageNumbers.length) }
+      );
+      for (const page of remainingPages.results) {
+        if (!page.success || !page.data) {
+          throw new Error(`${label} batch result page ${page.index + 2} failed: ${page.error || "unknown error"}`);
+        }
+        pages.push(Array.isArray(page.data.results) ? page.data.results : []);
+      }
     }
     const rows = pages.flat();
     if (rows.length !== requests.length) {
@@ -721,21 +749,25 @@ var Signaliz = class {
     }
     return results;
   }
-  async runCoreBatchRound(path, tasks, options) {
+  async runCoreBatchRound(path, tasks, options, companyRecoverableBatch) {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
-    if (path === "api/v1/verify-email" && uniqueTasks.length > 25) {
+    const recoverableBatch = path === "api/v1/find-email" ? { label: "Find Email", pageSize: 500, maxWaitMs: 20 * 6e4 } : path === "api/v1/verify-email" ? { label: "Verify Email", pageSize: 500, maxWaitMs: 20 * 6e4 } : companyRecoverableBatch;
+    if (recoverableBatch && uniqueTasks.length > 25) {
       const rows = await this.runRecoverableCoreBatchJob(
         path,
         uniqueTasks.map((task) => task.request),
-        "Verify Email"
+        recoverableBatch.label,
+        recoverableBatch.pageSize,
+        recoverableBatch.maxWaitMs,
+        options?.idempotencyKey
       );
       const uniqueResults2 = rows.map((raw) => ({
         index: uniqueTasks[Number(raw.index)].index,
         success: !recoverableJobRowFailed(raw),
         raw,
-        error: recoverableJobRowFailed(raw) ? raw.error || raw._error || raw.message || raw.failure_reason || "Verify Email item failed" : void 0
+        error: recoverableJobRowFailed(raw) ? raw.error || raw._error || raw.message || raw.failure_reason || `${recoverableBatch.label} item failed` : void 0
       }));
       return tasks.map((task, index) => ({
         ...uniqueResults2[deduplicated.sourceIndexByInput[index]],
@@ -800,7 +832,7 @@ var Signaliz = class {
   }
 };
 function recoverableJobRowFailed(row) {
-  return row.success === false || String(row._status || "").toLowerCase() === "failed";
+  return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
 function newBatchIdempotencyKey(label) {
   const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
@@ -877,6 +909,7 @@ function companySignalRequestBody(params) {
     lookback_days: params.lookbackDays,
     online,
     enable_deep_search: params.enableDeepSearch ?? online,
+    include_summary: params.includeSummary,
     enable_outreach_intelligence: params.enableOutreachIntelligence,
     enable_predictive_intelligence: params.enablePredictiveIntelligence,
     skip_cache: params.skipCache,
@@ -886,6 +919,29 @@ function companySignalRequestBody(params) {
     max_wait_ms: params.maxWaitMs
   });
 }
+function companySignalRecoverableBatchOptions(companies, tasks) {
+  if (companies.length <= 25 || companies.some((params) => params.waitForResult === false || Boolean(params.signalRunId))) {
+    return void 0;
+  }
+  const maxWaitMs = Math.max(1e3, companies[0].maxWaitMs ?? 20 * 6e4);
+  if (companies.some((params) => Math.max(1e3, params.maxWaitMs ?? 20 * 6e4) !== maxWaitMs)) {
+    return void 0;
+  }
+  const configKey = (request) => {
+    const {
+      company_domain: _companyDomain,
+      company_name: _companyName,
+      signal_run_id: _signalRunId,
+      wait_for_result: _waitForResult,
+      max_wait_ms: _maxWaitMs,
+      ...config
+    } = request;
+    return JSON.stringify(config);
+  };
+  const sharedConfig = configKey(tasks[0].request);
+  if (tasks.some((task) => configKey(task.request) !== sharedConfig)) return void 0;
+  return { label: "Company Signals", pageSize: 25, maxWaitMs };
+}
 function normalizeCompanySignalResult(params, data) {
   return {
     success: data.success ?? true,

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   Signaliz,
   SignalizError
-} from "./chunk-H6HOY73X.mjs";
+} from "./chunk-WKE2PNXT.mjs";
 export {
   Signaliz,
   SignalizError

package/dist/mcp-config.js

@@ -462,12 +462,21 @@ var Signaliz = class {
     validateBatchSize(companies);
     const startedAt = Date.now();
     const results = new Array(companies.length);
-    let pending = companies.map((params, index) => ({
+    const initialTasks = companies.map((params, index) => ({
       index,
       request: companySignalRequestBody(params)
     }));
+    const recoverableBatch = companySignalRecoverableBatchOptions(companies, initialTasks);
+    let pending = initialTasks;
+    let firstRound = true;
     while (pending.length > 0) {
-      const round = await this.runCoreBatchRound("api/v1/company-signals", pending, options);
+      const round = await this.runCoreBatchRound(
+        "api/v1/company-signals",
+        pending,
+        options,
+        firstRound ? recoverableBatch : void 0
+      );
+      firstRound = false;
       const taskByIndex = new Map(pending.map((task) => [task.index, task]));
       const nextPending = [];
       let nextDelayMs = 6e4;
@@ -552,7 +561,7 @@ var Signaliz = class {
     const canUseRecoverableAvailableDataJob = uniqueRequests.length > 25 && uniqueRequests.every(
       (params) => params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
     );
-    const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
+    const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests, options) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
     const results = requests.map((_, index) => ({
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index
@@ -596,11 +605,14 @@ var Signaliz = class {
     }
     return uniqueResults;
   }
-  async runAvailableSignalCopyBatchJob(requests) {
+  async runAvailableSignalCopyBatchJob(requests, options) {
     const rows = await this.runRecoverableCoreBatchJob(
       "api/v1/signal-to-copy",
       requests.map(signalToCopyRequestBody),
-      "Signal to Copy"
+      "Signal to Copy",
+      500,
+      20 * 6e4,
+      options?.idempotencyKey
     );
     const results = new Array(requests.length);
     for (const row of rows) {
@@ -609,19 +621,28 @@ var Signaliz = class {
     }
     return results;
   }
-  async runRecoverableCoreBatchJob(path2, requests, label) {
+  async runRecoverableCoreBatchJob(path2, requests, label, pageSize = 500, maxWaitMs = 20 * 6e4, idempotencyKey) {
     const startedAt = Date.now();
-    const maxWaitMs = 20 * 6e4;
-    const submission = await this.client.post(path2, {
-      requests,
-      idempotency_key: newBatchIdempotencyKey(label)
-    });
+    const submissionIdempotencyKey = idempotencyKey?.trim() || newBatchIdempotencyKey(label);
+    let submission;
+    try {
+      submission = await this.client.post(path2, {
+        requests,
+        idempotency_key: submissionIdempotencyKey
+      });
+    } catch (error) {
+      if (error instanceof SignalizError && !error.isRetryable) throw error;
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(
+        `${label} batch submission was not confirmed. Retry with idempotency key "${submissionIdempotencyKey}" to recover the same job. ${message}`
+      );
+    }
     const jobId = String(submission.job_id || "").trim();
     if (!jobId) throw new Error(`${label} batch did not return a recoverable job_id`);
     let status = await this.client.post(path2, {
       job_id: jobId,
       page: 1,
-      page_size: 500
+      page_size: pageSize
     });
     while (!["completed", "partial", "failed"].includes(String(status.status || "").toLowerCase())) {
       if (Date.now() - startedAt >= maxWaitMs) {
@@ -632,21 +653,28 @@ var Signaliz = class {
       status = await this.client.post(path2, {
         job_id: jobId,
         page: 1,
-        page_size: 500
+        page_size: pageSize
       });
     }
     const totalPages = Math.max(1, Number(status.total_pages || 1));
     const pages = [Array.isArray(status.results) ? status.results : []];
     if (totalPages > 1) {
-      const remainingPages = await Promise.all(Array.from(
-        { length: totalPages - 1 },
-        (_, index) => this.client.post(path2, {
+      const pageNumbers = Array.from({ length: totalPages - 1 }, (_, index) => index + 2);
+      const remainingPages = await runBatch(
+        pageNumbers,
+        async (page) => await this.client.post(path2, {
           job_id: jobId,
-          page: index + 2,
-          page_size: 500
-        })
-      ));
-      for (const page of remainingPages) pages.push(Array.isArray(page.results) ? page.results : []);
+          page,
+          page_size: pageSize
+        }),
+        { concurrency: Math.min(10, pageNumbers.length) }
+      );
+      for (const page of remainingPages.results) {
+        if (!page.success || !page.data) {
+          throw new Error(`${label} batch result page ${page.index + 2} failed: ${page.error || "unknown error"}`);
+        }
+        pages.push(Array.isArray(page.data.results) ? page.data.results : []);
+      }
     }
     const rows = pages.flat();
     if (rows.length !== requests.length) {
@@ -725,21 +753,25 @@ var Signaliz = class {
     }
     return results;
   }
-  async runCoreBatchRound(path2, tasks, options) {
+  async runCoreBatchRound(path2, tasks, options, companyRecoverableBatch) {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
-    if (path2 === "api/v1/verify-email" && uniqueTasks.length > 25) {
+    const recoverableBatch = path2 === "api/v1/find-email" ? { label: "Find Email", pageSize: 500, maxWaitMs: 20 * 6e4 } : path2 === "api/v1/verify-email" ? { label: "Verify Email", pageSize: 500, maxWaitMs: 20 * 6e4 } : companyRecoverableBatch;
+    if (recoverableBatch && uniqueTasks.length > 25) {
       const rows = await this.runRecoverableCoreBatchJob(
         path2,
         uniqueTasks.map((task) => task.request),
-        "Verify Email"
+        recoverableBatch.label,
+        recoverableBatch.pageSize,
+        recoverableBatch.maxWaitMs,
+        options?.idempotencyKey
       );
       const uniqueResults2 = rows.map((raw) => ({
         index: uniqueTasks[Number(raw.index)].index,
         success: !recoverableJobRowFailed(raw),
         raw,
-        error: recoverableJobRowFailed(raw) ? raw.error || raw._error || raw.message || raw.failure_reason || "Verify Email item failed" : void 0
+        error: recoverableJobRowFailed(raw) ? raw.error || raw._error || raw.message || raw.failure_reason || `${recoverableBatch.label} item failed` : void 0
       }));
       return tasks.map((task, index) => ({
         ...uniqueResults2[deduplicated.sourceIndexByInput[index]],
@@ -804,7 +836,7 @@ var Signaliz = class {
   }
 };
 function recoverableJobRowFailed(row) {
-  return row.success === false || String(row._status || "").toLowerCase() === "failed";
+  return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
 function newBatchIdempotencyKey(label) {
   const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
@@ -881,6 +913,7 @@ function companySignalRequestBody(params) {
     lookback_days: params.lookbackDays,
     online,
     enable_deep_search: params.enableDeepSearch ?? online,
+    include_summary: params.includeSummary,
     enable_outreach_intelligence: params.enableOutreachIntelligence,
     enable_predictive_intelligence: params.enablePredictiveIntelligence,
     skip_cache: params.skipCache,
@@ -890,6 +923,29 @@ function companySignalRequestBody(params) {
     max_wait_ms: params.maxWaitMs
   });
 }
+function companySignalRecoverableBatchOptions(companies, tasks) {
+  if (companies.length <= 25 || companies.some((params) => params.waitForResult === false || Boolean(params.signalRunId))) {
+    return void 0;
+  }
+  const maxWaitMs = Math.max(1e3, companies[0].maxWaitMs ?? 20 * 6e4);
+  if (companies.some((params) => Math.max(1e3, params.maxWaitMs ?? 20 * 6e4) !== maxWaitMs)) {
+    return void 0;
+  }
+  const configKey = (request) => {
+    const {
+      company_domain: _companyDomain,
+      company_name: _companyName,
+      signal_run_id: _signalRunId,
+      wait_for_result: _waitForResult,
+      max_wait_ms: _maxWaitMs,
+      ...config
+    } = request;
+    return JSON.stringify(config);
+  };
+  const sharedConfig = configKey(tasks[0].request);
+  if (tasks.some((task) => configKey(task.request) !== sharedConfig)) return void 0;
+  return { label: "Company Signals", pageSize: 25, maxWaitMs };
+}
 function normalizeCompanySignalResult(params, data) {
   return {
     success: data.success ?? true,

package/dist/mcp-config.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   Signaliz
-} from "./chunk-H6HOY73X.mjs";
+} from "./chunk-WKE2PNXT.mjs";
 
 // src/mcp-config.ts
 import * as fs from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/sdk",
-  "version": "1.0.33",
+  "version": "1.0.36",
   "description": "Signaliz SDK for Find Email, Verify Email, Company Signal Enrichment, and Signal to Copy AI.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",