@signaliz/sdk 1.0.48 → 1.0.50

package/README.md

@@ -97,21 +97,22 @@ when the REST API supplies them, including after automatic row retries are
 exhausted.
 
 For an ambiguous single request or batch submission failure, retry with the
-same `idempotencyKey` to recover the original request or supported email job without duplicate
+same `idempotencyKey` to recover the original request or durable job without duplicate
 work.
 
-Each batch accepts up to 5,000 items. For Company Signals and Signal to Copy,
-the SDK chunks inputs into synchronous requests of at most 25 and waits for
-every chunk. It never returns queued work, job IDs, or polling instructions.
+Each batch accepts up to 5,000 items. For all four core products, batches larger
+than 25 use one recoverable REST job; the SDK waits for completion and retrieves
+every result page before returning, so callers never receive queued work or
+polling instructions. Find Email, Verify Email, and Signal to Copy use 500-row
+result pages, while Company Signals uses 25-row result pages.
 Exact duplicate tasks are single-flighted across each full batch without
 changing input order or result cardinality. Set `compactDuplicates: true` to
 return repeated successful rows as `duplicateOf` references to the zero-based
-canonical input index; the default remains expanded for compatibility. Find Email and Verify Email
-batches
-larger than 25 use one cache-aware recoverable REST job with 500-row result
-pages. Company Signal Enrichment and Signal to Copy always use client-side
-25-row chunks with terminal per-row results. Signal to Copy also shares company
-research across copy recipients.
+canonical input index; the default remains expanded for compatibility. Signal
+to Copy durable jobs use available company-signal data only. If any copy row
+explicitly requests `skipCache` or `enableDeepSearch`, the SDK preserves that
+fresh-research behavior by using synchronous client-side chunks of at most 25.
+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. Its `searchMode` defaults to
@@ -124,7 +125,8 @@ normally finishes within an agent turn; set `skipCache` or `enableDeepSearch`
 only when fresh or deeper research is required.
 Unclassified evidence is returned by signal enrichment but is not used to
 generate outreach copy.
-Each normalized signal also exposes `datePrecision`, `sourceProvenance`,
+Each normalized signal keeps `date` separate from crawl-time `detectedAt` and
+also exposes `datePrecision`, `hasSpecificDate`, `sourceProvenance`,
 `entityConfidence`, `classification`, `derived`, `evidencePublishedDate`,
 `signalFeedSource`, and the provider `metadata` needed for integrity audits.
 

package/dist/{chunk-NOOQDYOJ.mjs → chunk-BFMRS2FT.mjs}

@@ -457,6 +457,7 @@ var Signaliz = class {
     );
   }
   async enrichCompanySignals(params) {
+    validateCoreProductMaxWaitMs(params.maxWaitMs);
     const request = companySignalRequestBody(params);
     const data = await this.client.post("api/v1/company-signals", request);
     if (isCoreProductDryRun(data)) return normalizeCoreProductDryRunResult(data);
@@ -465,6 +466,7 @@ var Signaliz = class {
   }
   async enrichCompanies(companies, options) {
     validateBatchSize(companies);
+    companies.forEach((params) => validateCoreProductMaxWaitMs(params.maxWaitMs));
     if (options?.dryRun === true) {
       return this.runCoreProductDryRun(
         "api/v1/company-signals",
@@ -522,7 +524,10 @@ var Signaliz = class {
       request: signalToCopyRequestBody(params)
     }));
     const uniqueRequests = deduplicated.uniqueItems;
-    const uniqueResults = await this.runSignalCopyBatchChunks(uniqueRequests, options);
+    const requiresFreshResearch = uniqueRequests.some(
+      (request) => request.skipCache === true || request.enableDeepSearch === true
+    );
+    const uniqueResults = uniqueRequests.length > 25 && !requiresFreshResearch ? await this.runRecoverableSignalCopyBatch(uniqueRequests, options) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
     const results = requests.map((_, index) => ({
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index
@@ -648,6 +653,35 @@ var Signaliz = class {
     if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
     return rows;
   }
+  async runRecoverableSignalCopyBatch(requests, options) {
+    const rows = await this.runRecoverableCoreBatchJob(
+      "api/v1/signal-to-copy",
+      requests.map(signalToCopyRequestBody),
+      "Signal to Copy",
+      500,
+      20 * 6e4,
+      options?.idempotencyKey
+    );
+    const results = new Array(requests.length);
+    for (const row of rows) {
+      const index = Number(row.index);
+      if (recoverableJobRowFailed(row)) {
+        results[index] = batchItemFailure(
+          index,
+          row.error || row._error || row.message || row.failure_reason || "Signal to Copy item failed",
+          row
+        );
+        continue;
+      }
+      try {
+        assertTerminalSignalResponse(row, "Signal to Copy");
+        results[index] = { index, success: true, data: normalizeSignalToCopyResult(row) };
+      } catch (error) {
+        results[index] = batchItemFailure(index, error instanceof Error ? error.message : String(error), row);
+      }
+    }
+    return results;
+  }
   async runSignalCopyBatchChunk(requests, concurrency, rowRateLimitAttempt = 0) {
     const results = new Array(requests.length);
     const rateLimited = [];
@@ -700,8 +734,8 @@ var Signaliz = class {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
-    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 } : void 0;
-    if (path !== "api/v1/company-signals" && recoverableBatch && 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 } : path === "api/v1/company-signals" ? { label: "Company Signals", pageSize: 25, maxWaitMs: 20 * 6e4 } : void 0;
+    if (recoverableBatch && uniqueTasks.length > 25) {
       const rows = await this.runRecoverableCoreBatchJob(
         path,
         uniqueTasks.map((task) => task.request),
@@ -710,12 +744,16 @@ var Signaliz = class {
         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 || `${recoverableBatch.label} item failed` : void 0
-      }));
+      const uniqueResults2 = new Array(uniqueTasks.length);
+      for (const raw of rows) {
+        const index = Number(raw.index);
+        uniqueResults2[index] = {
+          index: uniqueTasks[index].index,
+          success: !recoverableJobRowFailed(raw),
+          raw,
+          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]],
         index: task.index
@@ -901,6 +939,15 @@ function normalizeFindEmailResult(data) {
     verifiedAt: typeof data.verified_at === "string" ? data.verified_at : null,
     needsReverification,
     providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
+    creditsUsed: data.credits_used,
+    estimatedExternalCostUsd: data.estimated_external_cost_usd,
+    billingMetadata: data.billing_metadata,
+    resultReturnedFrom: data.result_returned_from,
+    cacheHit: data.cache_hit,
+    freshEnrichmentUsed: data.fresh_enrichment_used,
+    liveProviderCalled: data.live_provider_called,
+    openrouterCalled: data.openrouter_called,
+    byoOpenrouterUsed: data.byo_openrouter_used,
     error: found ? void 0 : data.error ?? "No verified email found",
     errorCode: found ? void 0 : data.error_code ?? "EMAIL_NOT_FOUND",
     raw: data
@@ -910,6 +957,7 @@ function normalizeVerifyEmailResult(email, data) {
   const verificationStatus = String(data.verification_status ?? "").toLowerCase();
   const verified = data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus);
   return {
+    success: data.success !== false,
     email: data.email ?? email,
     status: String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
     verificationRunId: data.verification_run_id ?? data.run_id,
@@ -918,9 +966,20 @@ function normalizeVerifyEmailResult(email, data) {
     isValid: data.is_valid ?? data.valid ?? verified,
     isDeliverable: data.is_deliverable ?? data.deliverable ?? verified,
     isCatchAll: data.email_is_catch_all ?? data.is_catch_all ?? data.catch_all ?? data.diagnostics?.is_catch_all ?? false,
+    verifiedForSending: data.verified_for_sending === true,
+    verificationVerdict: data.verification_verdict ?? data.verification_status ?? "unknown",
     confidenceScore: data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
     provider: data.provider,
     verificationSource: data.verification_source,
+    billingReplayed: data.billing_replayed,
+    creditsUsed: data.credits_used,
+    billingMetadata: data.billing_metadata,
+    resultReturnedFrom: data.result_returned_from,
+    cacheHit: data.cache_hit,
+    freshEnrichmentUsed: data.fresh_enrichment_used,
+    liveProviderCalled: data.live_provider_called,
+    openrouterCalled: data.openrouter_called,
+    byoOpenrouterUsed: data.byo_openrouter_used,
     raw: data
   };
 }
@@ -964,8 +1023,10 @@ function normalizeCompanySignalResult(params, data) {
         title: signal.title ?? "",
         type: signal.type ?? signal.signal_type ?? "unknown",
         content: signal.content ?? signal.description ?? "",
-        date: signal.date ?? signal.detected_at ?? null,
+        date: signal.date ?? null,
+        detectedAt: signal.detected_at ?? null,
         datePrecision: signal.date_precision,
+        hasSpecificDate: signal.has_specific_date ?? metadata?.has_specific_date,
         sourceUrl: signal.source_url ?? signal.url ?? null,
         sourceType: signal.source_type,
         sourceProvenance: signal.source_provenance,
@@ -994,7 +1055,10 @@ function normalizeCompanySignalResult(params, data) {
     billingMetadata: data.billing_metadata,
     resultReturnedFrom: data.result_returned_from,
     cacheHit: data.cache_hit,
+    freshEnrichmentUsed: data.fresh_enrichment_used,
     liveProviderCalled: data.live_provider_called,
+    aiProviderCalled: data.ai_provider_called,
+    byoAiUsed: data.byo_ai_used,
     metadata: data.metadata,
     raw: data
   };
@@ -1100,6 +1164,7 @@ function signalToCopyRequestBody(params) {
   });
 }
 function validateSignalToCopyParams(params) {
+  validateCoreProductMaxWaitMs(params.maxWaitMs);
   if (typeof params.signalRunId === "string" && params.signalRunId.trim()) return;
   const missing = [
     ["companyDomain", params.companyDomain],
@@ -1111,6 +1176,12 @@ function validateSignalToCopyParams(params) {
     throw new TypeError(`Signal to Copy requires signalRunId or: ${missing.join(", ")}`);
   }
 }
+function validateCoreProductMaxWaitMs(value) {
+  if (value === void 0) return;
+  if (!Number.isInteger(value) || value < 1e4 || value > 12e4) {
+    throw new RangeError("maxWaitMs must be an integer between 10000 and 120000");
+  }
+}
 function normalizeSignalToCopyResult(data) {
   return {
     success: data.success ?? true,

package/dist/index.d.mts

@@ -92,11 +92,21 @@ interface FindEmailResult {
     verifiedAt: string | null;
     needsReverification: boolean;
     providerUsed: string;
+    creditsUsed?: number;
+    estimatedExternalCostUsd?: number;
+    billingMetadata?: Record<string, unknown>;
+    resultReturnedFrom?: string;
+    cacheHit?: boolean;
+    freshEnrichmentUsed?: boolean;
+    liveProviderCalled?: boolean;
+    openrouterCalled?: boolean;
+    byoOpenrouterUsed?: boolean;
     error?: string;
     errorCode?: string;
     raw: Record<string, unknown>;
 }
 interface VerifyEmailResult {
+    success: boolean;
     email: string;
     /** Execution state. Processing results are never send-safe. */
     status: 'processing' | 'completed';
@@ -107,9 +117,21 @@ interface VerifyEmailResult {
     isValid: boolean;
     isDeliverable: boolean;
     isCatchAll: boolean;
+    /** Explicit send-safety verdict. Missing or false never becomes true by inference. */
+    verifiedForSending: boolean;
+    verificationVerdict: string;
     confidenceScore: number;
     provider?: string;
     verificationSource?: string;
+    billingReplayed?: boolean;
+    creditsUsed?: number;
+    billingMetadata?: Record<string, unknown>;
+    resultReturnedFrom?: string;
+    cacheHit?: boolean;
+    freshEnrichmentUsed?: boolean;
+    liveProviderCalled?: boolean;
+    openrouterCalled?: boolean;
+    byoOpenrouterUsed?: boolean;
     raw: Record<string, unknown>;
 }
 interface VerifyEmailOptions {
@@ -164,7 +186,9 @@ interface CompanySignal {
     type: string;
     content: string;
     date?: string | null;
+    detectedAt?: string | null;
     datePrecision?: string;
+    hasSpecificDate?: boolean;
     sourceUrl?: string | null;
     sourceType?: string;
     sourceProvenance?: string;
@@ -201,7 +225,10 @@ interface CompanySignalEnrichmentResult {
     billingMetadata?: Record<string, unknown>;
     resultReturnedFrom?: string;
     cacheHit?: boolean;
+    freshEnrichmentUsed?: boolean;
     liveProviderCalled?: boolean;
+    aiProviderCalled?: boolean;
+    byoAiUsed?: boolean;
     metadata?: Record<string, unknown>;
     raw: Record<string, unknown>;
 }
@@ -311,6 +338,7 @@ declare class Signaliz {
     private runCoreProductDryRun;
     private runSignalCopyBatchChunks;
     private runRecoverableCoreBatchJob;
+    private runRecoverableSignalCopyBatch;
     private runSignalCopyBatchChunk;
     private runCoreBatchRound;
     listTools(): Promise<MCPToolInfo[]>;

package/dist/index.d.ts

@@ -92,11 +92,21 @@ interface FindEmailResult {
     verifiedAt: string | null;
     needsReverification: boolean;
     providerUsed: string;
+    creditsUsed?: number;
+    estimatedExternalCostUsd?: number;
+    billingMetadata?: Record<string, unknown>;
+    resultReturnedFrom?: string;
+    cacheHit?: boolean;
+    freshEnrichmentUsed?: boolean;
+    liveProviderCalled?: boolean;
+    openrouterCalled?: boolean;
+    byoOpenrouterUsed?: boolean;
     error?: string;
     errorCode?: string;
     raw: Record<string, unknown>;
 }
 interface VerifyEmailResult {
+    success: boolean;
     email: string;
     /** Execution state. Processing results are never send-safe. */
     status: 'processing' | 'completed';
@@ -107,9 +117,21 @@ interface VerifyEmailResult {
     isValid: boolean;
     isDeliverable: boolean;
     isCatchAll: boolean;
+    /** Explicit send-safety verdict. Missing or false never becomes true by inference. */
+    verifiedForSending: boolean;
+    verificationVerdict: string;
     confidenceScore: number;
     provider?: string;
     verificationSource?: string;
+    billingReplayed?: boolean;
+    creditsUsed?: number;
+    billingMetadata?: Record<string, unknown>;
+    resultReturnedFrom?: string;
+    cacheHit?: boolean;
+    freshEnrichmentUsed?: boolean;
+    liveProviderCalled?: boolean;
+    openrouterCalled?: boolean;
+    byoOpenrouterUsed?: boolean;
     raw: Record<string, unknown>;
 }
 interface VerifyEmailOptions {
@@ -164,7 +186,9 @@ interface CompanySignal {
     type: string;
     content: string;
     date?: string | null;
+    detectedAt?: string | null;
     datePrecision?: string;
+    hasSpecificDate?: boolean;
     sourceUrl?: string | null;
     sourceType?: string;
     sourceProvenance?: string;
@@ -201,7 +225,10 @@ interface CompanySignalEnrichmentResult {
     billingMetadata?: Record<string, unknown>;
     resultReturnedFrom?: string;
     cacheHit?: boolean;
+    freshEnrichmentUsed?: boolean;
     liveProviderCalled?: boolean;
+    aiProviderCalled?: boolean;
+    byoAiUsed?: boolean;
     metadata?: Record<string, unknown>;
     raw: Record<string, unknown>;
 }
@@ -311,6 +338,7 @@ declare class Signaliz {
     private runCoreProductDryRun;
     private runSignalCopyBatchChunks;
     private runRecoverableCoreBatchJob;
+    private runRecoverableSignalCopyBatch;
     private runSignalCopyBatchChunk;
     private runCoreBatchRound;
     listTools(): Promise<MCPToolInfo[]>;

package/dist/index.js

@@ -484,6 +484,7 @@ var Signaliz = class {
     );
   }
   async enrichCompanySignals(params) {
+    validateCoreProductMaxWaitMs(params.maxWaitMs);
     const request = companySignalRequestBody(params);
     const data = await this.client.post("api/v1/company-signals", request);
     if (isCoreProductDryRun(data)) return normalizeCoreProductDryRunResult(data);
@@ -492,6 +493,7 @@ var Signaliz = class {
   }
   async enrichCompanies(companies, options) {
     validateBatchSize(companies);
+    companies.forEach((params) => validateCoreProductMaxWaitMs(params.maxWaitMs));
     if (options?.dryRun === true) {
       return this.runCoreProductDryRun(
         "api/v1/company-signals",
@@ -549,7 +551,10 @@ var Signaliz = class {
       request: signalToCopyRequestBody(params)
     }));
     const uniqueRequests = deduplicated.uniqueItems;
-    const uniqueResults = await this.runSignalCopyBatchChunks(uniqueRequests, options);
+    const requiresFreshResearch = uniqueRequests.some(
+      (request) => request.skipCache === true || request.enableDeepSearch === true
+    );
+    const uniqueResults = uniqueRequests.length > 25 && !requiresFreshResearch ? await this.runRecoverableSignalCopyBatch(uniqueRequests, options) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
     const results = requests.map((_, index) => ({
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index
@@ -675,6 +680,35 @@ var Signaliz = class {
     if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
     return rows;
   }
+  async runRecoverableSignalCopyBatch(requests, options) {
+    const rows = await this.runRecoverableCoreBatchJob(
+      "api/v1/signal-to-copy",
+      requests.map(signalToCopyRequestBody),
+      "Signal to Copy",
+      500,
+      20 * 6e4,
+      options?.idempotencyKey
+    );
+    const results = new Array(requests.length);
+    for (const row of rows) {
+      const index = Number(row.index);
+      if (recoverableJobRowFailed(row)) {
+        results[index] = batchItemFailure(
+          index,
+          row.error || row._error || row.message || row.failure_reason || "Signal to Copy item failed",
+          row
+        );
+        continue;
+      }
+      try {
+        assertTerminalSignalResponse(row, "Signal to Copy");
+        results[index] = { index, success: true, data: normalizeSignalToCopyResult(row) };
+      } catch (error) {
+        results[index] = batchItemFailure(index, error instanceof Error ? error.message : String(error), row);
+      }
+    }
+    return results;
+  }
   async runSignalCopyBatchChunk(requests, concurrency, rowRateLimitAttempt = 0) {
     const results = new Array(requests.length);
     const rateLimited = [];
@@ -727,8 +761,8 @@ var Signaliz = class {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
-    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 } : void 0;
-    if (path !== "api/v1/company-signals" && recoverableBatch && 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 } : path === "api/v1/company-signals" ? { label: "Company Signals", pageSize: 25, maxWaitMs: 20 * 6e4 } : void 0;
+    if (recoverableBatch && uniqueTasks.length > 25) {
       const rows = await this.runRecoverableCoreBatchJob(
         path,
         uniqueTasks.map((task) => task.request),
@@ -737,12 +771,16 @@ var Signaliz = class {
         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 || `${recoverableBatch.label} item failed` : void 0
-      }));
+      const uniqueResults2 = new Array(uniqueTasks.length);
+      for (const raw of rows) {
+        const index = Number(raw.index);
+        uniqueResults2[index] = {
+          index: uniqueTasks[index].index,
+          success: !recoverableJobRowFailed(raw),
+          raw,
+          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]],
         index: task.index
@@ -928,6 +966,15 @@ function normalizeFindEmailResult(data) {
     verifiedAt: typeof data.verified_at === "string" ? data.verified_at : null,
     needsReverification,
     providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
+    creditsUsed: data.credits_used,
+    estimatedExternalCostUsd: data.estimated_external_cost_usd,
+    billingMetadata: data.billing_metadata,
+    resultReturnedFrom: data.result_returned_from,
+    cacheHit: data.cache_hit,
+    freshEnrichmentUsed: data.fresh_enrichment_used,
+    liveProviderCalled: data.live_provider_called,
+    openrouterCalled: data.openrouter_called,
+    byoOpenrouterUsed: data.byo_openrouter_used,
     error: found ? void 0 : data.error ?? "No verified email found",
     errorCode: found ? void 0 : data.error_code ?? "EMAIL_NOT_FOUND",
     raw: data
@@ -937,6 +984,7 @@ function normalizeVerifyEmailResult(email, data) {
   const verificationStatus = String(data.verification_status ?? "").toLowerCase();
   const verified = data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus);
   return {
+    success: data.success !== false,
     email: data.email ?? email,
     status: String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
     verificationRunId: data.verification_run_id ?? data.run_id,
@@ -945,9 +993,20 @@ function normalizeVerifyEmailResult(email, data) {
     isValid: data.is_valid ?? data.valid ?? verified,
     isDeliverable: data.is_deliverable ?? data.deliverable ?? verified,
     isCatchAll: data.email_is_catch_all ?? data.is_catch_all ?? data.catch_all ?? data.diagnostics?.is_catch_all ?? false,
+    verifiedForSending: data.verified_for_sending === true,
+    verificationVerdict: data.verification_verdict ?? data.verification_status ?? "unknown",
     confidenceScore: data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
     provider: data.provider,
     verificationSource: data.verification_source,
+    billingReplayed: data.billing_replayed,
+    creditsUsed: data.credits_used,
+    billingMetadata: data.billing_metadata,
+    resultReturnedFrom: data.result_returned_from,
+    cacheHit: data.cache_hit,
+    freshEnrichmentUsed: data.fresh_enrichment_used,
+    liveProviderCalled: data.live_provider_called,
+    openrouterCalled: data.openrouter_called,
+    byoOpenrouterUsed: data.byo_openrouter_used,
     raw: data
   };
 }
@@ -991,8 +1050,10 @@ function normalizeCompanySignalResult(params, data) {
         title: signal.title ?? "",
         type: signal.type ?? signal.signal_type ?? "unknown",
         content: signal.content ?? signal.description ?? "",
-        date: signal.date ?? signal.detected_at ?? null,
+        date: signal.date ?? null,
+        detectedAt: signal.detected_at ?? null,
         datePrecision: signal.date_precision,
+        hasSpecificDate: signal.has_specific_date ?? metadata?.has_specific_date,
         sourceUrl: signal.source_url ?? signal.url ?? null,
         sourceType: signal.source_type,
         sourceProvenance: signal.source_provenance,
@@ -1021,7 +1082,10 @@ function normalizeCompanySignalResult(params, data) {
     billingMetadata: data.billing_metadata,
     resultReturnedFrom: data.result_returned_from,
     cacheHit: data.cache_hit,
+    freshEnrichmentUsed: data.fresh_enrichment_used,
     liveProviderCalled: data.live_provider_called,
+    aiProviderCalled: data.ai_provider_called,
+    byoAiUsed: data.byo_ai_used,
     metadata: data.metadata,
     raw: data
   };
@@ -1127,6 +1191,7 @@ function signalToCopyRequestBody(params) {
   });
 }
 function validateSignalToCopyParams(params) {
+  validateCoreProductMaxWaitMs(params.maxWaitMs);
   if (typeof params.signalRunId === "string" && params.signalRunId.trim()) return;
   const missing = [
     ["companyDomain", params.companyDomain],
@@ -1138,6 +1203,12 @@ function validateSignalToCopyParams(params) {
     throw new TypeError(`Signal to Copy requires signalRunId or: ${missing.join(", ")}`);
   }
 }
+function validateCoreProductMaxWaitMs(value) {
+  if (value === void 0) return;
+  if (!Number.isInteger(value) || value < 1e4 || value > 12e4) {
+    throw new RangeError("maxWaitMs must be an integer between 10000 and 120000");
+  }
+}
 function normalizeSignalToCopyResult(data) {
   return {
     success: data.success ?? true,

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -488,6 +488,7 @@ var Signaliz = class {
     );
   }
   async enrichCompanySignals(params) {
+    validateCoreProductMaxWaitMs(params.maxWaitMs);
     const request = companySignalRequestBody(params);
     const data = await this.client.post("api/v1/company-signals", request);
     if (isCoreProductDryRun(data)) return normalizeCoreProductDryRunResult(data);
@@ -496,6 +497,7 @@ var Signaliz = class {
   }
   async enrichCompanies(companies, options) {
     validateBatchSize(companies);
+    companies.forEach((params) => validateCoreProductMaxWaitMs(params.maxWaitMs));
     if (options?.dryRun === true) {
       return this.runCoreProductDryRun(
         "api/v1/company-signals",
@@ -553,7 +555,10 @@ var Signaliz = class {
       request: signalToCopyRequestBody(params)
     }));
     const uniqueRequests = deduplicated.uniqueItems;
-    const uniqueResults = await this.runSignalCopyBatchChunks(uniqueRequests, options);
+    const requiresFreshResearch = uniqueRequests.some(
+      (request) => request.skipCache === true || request.enableDeepSearch === true
+    );
+    const uniqueResults = uniqueRequests.length > 25 && !requiresFreshResearch ? await this.runRecoverableSignalCopyBatch(uniqueRequests, options) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
     const results = requests.map((_, index) => ({
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index
@@ -679,6 +684,35 @@ var Signaliz = class {
     if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
     return rows;
   }
+  async runRecoverableSignalCopyBatch(requests, options) {
+    const rows = await this.runRecoverableCoreBatchJob(
+      "api/v1/signal-to-copy",
+      requests.map(signalToCopyRequestBody),
+      "Signal to Copy",
+      500,
+      20 * 6e4,
+      options?.idempotencyKey
+    );
+    const results = new Array(requests.length);
+    for (const row of rows) {
+      const index = Number(row.index);
+      if (recoverableJobRowFailed(row)) {
+        results[index] = batchItemFailure(
+          index,
+          row.error || row._error || row.message || row.failure_reason || "Signal to Copy item failed",
+          row
+        );
+        continue;
+      }
+      try {
+        assertTerminalSignalResponse(row, "Signal to Copy");
+        results[index] = { index, success: true, data: normalizeSignalToCopyResult(row) };
+      } catch (error) {
+        results[index] = batchItemFailure(index, error instanceof Error ? error.message : String(error), row);
+      }
+    }
+    return results;
+  }
   async runSignalCopyBatchChunk(requests, concurrency, rowRateLimitAttempt = 0) {
     const results = new Array(requests.length);
     const rateLimited = [];
@@ -731,8 +765,8 @@ var Signaliz = class {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
-    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 } : void 0;
-    if (path2 !== "api/v1/company-signals" && recoverableBatch && 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 } : path2 === "api/v1/company-signals" ? { label: "Company Signals", pageSize: 25, maxWaitMs: 20 * 6e4 } : void 0;
+    if (recoverableBatch && uniqueTasks.length > 25) {
       const rows = await this.runRecoverableCoreBatchJob(
         path2,
         uniqueTasks.map((task) => task.request),
@@ -741,12 +775,16 @@ var Signaliz = class {
         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 || `${recoverableBatch.label} item failed` : void 0
-      }));
+      const uniqueResults2 = new Array(uniqueTasks.length);
+      for (const raw of rows) {
+        const index = Number(raw.index);
+        uniqueResults2[index] = {
+          index: uniqueTasks[index].index,
+          success: !recoverableJobRowFailed(raw),
+          raw,
+          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]],
         index: task.index
@@ -932,6 +970,15 @@ function normalizeFindEmailResult(data) {
     verifiedAt: typeof data.verified_at === "string" ? data.verified_at : null,
     needsReverification,
     providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
+    creditsUsed: data.credits_used,
+    estimatedExternalCostUsd: data.estimated_external_cost_usd,
+    billingMetadata: data.billing_metadata,
+    resultReturnedFrom: data.result_returned_from,
+    cacheHit: data.cache_hit,
+    freshEnrichmentUsed: data.fresh_enrichment_used,
+    liveProviderCalled: data.live_provider_called,
+    openrouterCalled: data.openrouter_called,
+    byoOpenrouterUsed: data.byo_openrouter_used,
     error: found ? void 0 : data.error ?? "No verified email found",
     errorCode: found ? void 0 : data.error_code ?? "EMAIL_NOT_FOUND",
     raw: data
@@ -941,6 +988,7 @@ function normalizeVerifyEmailResult(email, data) {
   const verificationStatus = String(data.verification_status ?? "").toLowerCase();
   const verified = data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus);
   return {
+    success: data.success !== false,
     email: data.email ?? email,
     status: String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
     verificationRunId: data.verification_run_id ?? data.run_id,
@@ -949,9 +997,20 @@ function normalizeVerifyEmailResult(email, data) {
     isValid: data.is_valid ?? data.valid ?? verified,
     isDeliverable: data.is_deliverable ?? data.deliverable ?? verified,
     isCatchAll: data.email_is_catch_all ?? data.is_catch_all ?? data.catch_all ?? data.diagnostics?.is_catch_all ?? false,
+    verifiedForSending: data.verified_for_sending === true,
+    verificationVerdict: data.verification_verdict ?? data.verification_status ?? "unknown",
     confidenceScore: data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
     provider: data.provider,
     verificationSource: data.verification_source,
+    billingReplayed: data.billing_replayed,
+    creditsUsed: data.credits_used,
+    billingMetadata: data.billing_metadata,
+    resultReturnedFrom: data.result_returned_from,
+    cacheHit: data.cache_hit,
+    freshEnrichmentUsed: data.fresh_enrichment_used,
+    liveProviderCalled: data.live_provider_called,
+    openrouterCalled: data.openrouter_called,
+    byoOpenrouterUsed: data.byo_openrouter_used,
     raw: data
   };
 }
@@ -995,8 +1054,10 @@ function normalizeCompanySignalResult(params, data) {
         title: signal.title ?? "",
         type: signal.type ?? signal.signal_type ?? "unknown",
         content: signal.content ?? signal.description ?? "",
-        date: signal.date ?? signal.detected_at ?? null,
+        date: signal.date ?? null,
+        detectedAt: signal.detected_at ?? null,
         datePrecision: signal.date_precision,
+        hasSpecificDate: signal.has_specific_date ?? metadata?.has_specific_date,
         sourceUrl: signal.source_url ?? signal.url ?? null,
         sourceType: signal.source_type,
         sourceProvenance: signal.source_provenance,
@@ -1025,7 +1086,10 @@ function normalizeCompanySignalResult(params, data) {
     billingMetadata: data.billing_metadata,
     resultReturnedFrom: data.result_returned_from,
     cacheHit: data.cache_hit,
+    freshEnrichmentUsed: data.fresh_enrichment_used,
     liveProviderCalled: data.live_provider_called,
+    aiProviderCalled: data.ai_provider_called,
+    byoAiUsed: data.byo_ai_used,
     metadata: data.metadata,
     raw: data
   };
@@ -1131,6 +1195,7 @@ function signalToCopyRequestBody(params) {
   });
 }
 function validateSignalToCopyParams(params) {
+  validateCoreProductMaxWaitMs(params.maxWaitMs);
   if (typeof params.signalRunId === "string" && params.signalRunId.trim()) return;
   const missing = [
     ["companyDomain", params.companyDomain],
@@ -1142,6 +1207,12 @@ function validateSignalToCopyParams(params) {
     throw new TypeError(`Signal to Copy requires signalRunId or: ${missing.join(", ")}`);
   }
 }
+function validateCoreProductMaxWaitMs(value) {
+  if (value === void 0) return;
+  if (!Number.isInteger(value) || value < 1e4 || value > 12e4) {
+    throw new RangeError("maxWaitMs must be an integer between 10000 and 120000");
+  }
+}
 function normalizeSignalToCopyResult(data) {
   return {
     success: data.success ?? true,

package/dist/mcp-config.mjs

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

package/package.json

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