@signaliz/sdk 1.0.34 → 1.0.37

package/README.md

@@ -72,6 +72,9 @@ 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
@@ -80,10 +83,12 @@ when a caller explicitly overrides the cadence.
 Exact duplicate tasks are single-flighted across each full batch without
 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; Company Signal Enrichment uses 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.
+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-BGVNI5E2.mjs → chunk-WHD7INKU.mjs}

@@ -22,16 +22,19 @@ function parseError(status, body) {
       details: body.error.details
     });
   }
+  const code = typeof body?.error_code === "string" && body.error_code.trim() ? body.error_code.trim() : `HTTP_${status}`;
   return new SignalizError({
-    code: `HTTP_${status}`,
+    code,
     message: body?.message || body?.error || `Request failed with status ${status}`,
-    errorType: mapErrorType(void 0, status)
+    errorType: mapErrorType(code, status),
+    details: body?.details || (body?.retry_eligible !== void 0 ? { retry_eligible: body.retry_eligible } : void 0)
   });
 }
 function mapErrorType(code, status) {
   if (code === "RATE_LIMITED" || status === 429) return "rate_limited";
   if (code === "VALIDATION_ERROR" || status === 400) return "validation";
   if (code === "NOT_FOUND" || status === 404) return "not_found";
+  if (code === "NO_SUPPORTED_SIGNAL") return "not_found";
   if (code === "AUTH_EXPIRED" || status === 401) return "auth_expired";
   if (code === "INSUFFICIENT_CREDITS" || status === 402) return "insufficient_credits";
   if (code === "TIMEOUT" || status === 504) return "timeout";
@@ -431,12 +434,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 +533,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 +577,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 +593,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 +625,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,22 +725,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/find-email" || path === "api/v1/verify-email") && uniqueTasks.length > 25) {
-      const label = path === "api/v1/find-email" ? "Find Email" : "Verify Email";
+    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),
-        label
+        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 || `${label} 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]],
@@ -851,6 +885,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,
@@ -860,6 +895,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

@@ -49,16 +49,19 @@ function parseError(status, body) {
       details: body.error.details
     });
   }
+  const code = typeof body?.error_code === "string" && body.error_code.trim() ? body.error_code.trim() : `HTTP_${status}`;
   return new SignalizError({
-    code: `HTTP_${status}`,
+    code,
     message: body?.message || body?.error || `Request failed with status ${status}`,
-    errorType: mapErrorType(void 0, status)
+    errorType: mapErrorType(code, status),
+    details: body?.details || (body?.retry_eligible !== void 0 ? { retry_eligible: body.retry_eligible } : void 0)
   });
 }
 function mapErrorType(code, status) {
   if (code === "RATE_LIMITED" || status === 429) return "rate_limited";
   if (code === "VALIDATION_ERROR" || status === 400) return "validation";
   if (code === "NOT_FOUND" || status === 404) return "not_found";
+  if (code === "NO_SUPPORTED_SIGNAL") return "not_found";
   if (code === "AUTH_EXPIRED" || status === 401) return "auth_expired";
   if (code === "INSUFFICIENT_CREDITS" || status === 402) return "insufficient_credits";
   if (code === "TIMEOUT" || status === 504) return "timeout";
@@ -458,12 +461,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 +560,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 +604,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 +620,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 +652,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,22 +752,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/find-email" || path === "api/v1/verify-email") && uniqueTasks.length > 25) {
-      const label = path === "api/v1/find-email" ? "Find Email" : "Verify Email";
+    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),
-        label
+        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 || `${label} 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]],
@@ -878,6 +912,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,
@@ -887,6 +922,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-BGVNI5E2.mjs";
+} from "./chunk-WHD7INKU.mjs";
 export {
   Signaliz,
   SignalizError

package/dist/mcp-config.js

@@ -53,16 +53,19 @@ function parseError(status, body) {
       details: body.error.details
     });
   }
+  const code = typeof body?.error_code === "string" && body.error_code.trim() ? body.error_code.trim() : `HTTP_${status}`;
   return new SignalizError({
-    code: `HTTP_${status}`,
+    code,
     message: body?.message || body?.error || `Request failed with status ${status}`,
-    errorType: mapErrorType(void 0, status)
+    errorType: mapErrorType(code, status),
+    details: body?.details || (body?.retry_eligible !== void 0 ? { retry_eligible: body.retry_eligible } : void 0)
   });
 }
 function mapErrorType(code, status) {
   if (code === "RATE_LIMITED" || status === 429) return "rate_limited";
   if (code === "VALIDATION_ERROR" || status === 400) return "validation";
   if (code === "NOT_FOUND" || status === 404) return "not_found";
+  if (code === "NO_SUPPORTED_SIGNAL") return "not_found";
   if (code === "AUTH_EXPIRED" || status === 401) return "auth_expired";
   if (code === "INSUFFICIENT_CREDITS" || status === 402) return "insufficient_credits";
   if (code === "TIMEOUT" || status === 504) return "timeout";
@@ -462,12 +465,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 +564,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 +608,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 +624,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 +656,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,22 +756,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/find-email" || path2 === "api/v1/verify-email") && uniqueTasks.length > 25) {
-      const label = path2 === "api/v1/find-email" ? "Find Email" : "Verify Email";
+    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),
-        label
+        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 || `${label} 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]],
@@ -882,6 +916,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,
@@ -891,6 +926,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-BGVNI5E2.mjs";
+} from "./chunk-WHD7INKU.mjs";
 
 // src/mcp-config.ts
 import * as fs from "fs";

package/package.json

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