@signaliz/sdk 1.0.57 → 1.0.58

package/README.md

@@ -87,7 +87,8 @@ const copy = await signaliz.signalToCopy({
 });
 
 // Company Signals and Signal to Copy are hard synchronous contracts: these
-// methods return complete data or throw a terminal error in this same call.
+// methods return complete data, an explicit success:false result, or throw a
+// non-2xx terminal error in this same call.
 ```
 
 The four row-oriented products support bounded batch execution over the same REST endpoints.
@@ -112,6 +113,12 @@ Failed rows preserve `errorCode`, `retryEligible`, and `retryAfterSeconds`
 when the REST API supplies them, including after automatic row retries are
 exhausted.
 
+Every single-result method treats an error payload as `success: false`, even if
+an upstream HTTP 200 omits or contradicts the success flag. Find Email also
+withholds any email from a contradictory error response. Verify Email, Company
+Signals, and Signal to Copy expose normalized `error` and `errorCode` fields;
+the original response remains available in `raw`.
+
 For an ambiguous single request or batch submission failure, retry with the
 same `idempotencyKey` to recover the original request, durable job, or provider
 run without duplicate work or spend. The key is portable across REST API, MCP,

package/dist/{chunk-SZ3H5W5L.mjs → chunk-EAKP4DSS.mjs}

@@ -692,7 +692,7 @@ var Signaliz = class {
     }
     for (let index = 0; index < requests.length; index += 1) {
       const item = data.results[index];
-      if (item.success === false) {
+      if (coreProductResponseFailed(item)) {
         if (rowRateLimitAttempt < MAX_ROW_RATE_LIMIT_RETRIES && isRetryableRowRateLimit({
           index,
           success: false,
@@ -701,7 +701,11 @@ var Signaliz = class {
           rateLimited.push({ index, params: requests[index], raw: item });
           continue;
         }
-        results[index] = batchItemFailure(index, item.error || item.message || "Signal to Copy failed", item);
+        results[index] = batchItemFailure(
+          index,
+          coreProductErrorMessage(item) || "Signal to Copy failed",
+          item
+        );
         continue;
       }
       try {
@@ -802,9 +806,9 @@ var Signaliz = class {
         const raw = chunkResult.data[index];
         uniqueResults[chunk.offset + index] = {
           index: chunk.tasks[index].index,
-          success: raw.success !== false,
+          success: !coreProductResponseFailed(raw),
           raw,
-          error: raw.success === false ? raw.error || raw.message || raw.error_code || `${path} item failed` : void 0
+          error: coreProductResponseFailed(raw) ? coreProductErrorMessage(raw) || coreProductErrorCode(raw) || `${path} item failed` : void 0
         };
       }
     }
@@ -874,7 +878,7 @@ function batchItemFailure(index, error, raw) {
   };
 }
 function recoverableJobRowFailed(row) {
-  return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
+  return coreProductResponseFailed(row) || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
 function newBatchIdempotencyKey(label) {
   const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
@@ -924,7 +928,9 @@ function normalizeCoreProductDryRunResult(data) {
   };
 }
 function normalizeFindEmailResult(data) {
-  const email = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
+  const failed = coreProductResponseFailed(data);
+  const rawEmail = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
+  const email = failed ? null : rawEmail;
   const found = Boolean(email) && data.found !== false;
   const verificationStatus = data.verification_status ?? (data.is_valid === true ? "valid" : data.status ?? "unknown");
   const rawFreshness = String(data.verification_freshness ?? "").toLowerCase();
@@ -934,7 +940,7 @@ function normalizeFindEmailResult(data) {
   const verified = !explicitlyNotSendSafe && (data.is_valid === true || data.isValid === true || data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase()));
   const verificationAgeDays = typeof data.verification_age_days === "number" && Number.isFinite(data.verification_age_days) ? data.verification_age_days : null;
   return {
-    success: data.success !== false && found,
+    success: !failed && found,
     found,
     email,
     firstName: data.first_name,
@@ -961,26 +967,29 @@ function normalizeFindEmailResult(data) {
     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",
+    error: found ? void 0 : coreProductErrorMessage(data) ?? "No verified email found",
+    errorCode: found ? void 0 : coreProductErrorCode(data) ?? "EMAIL_NOT_FOUND",
     raw: data
   };
 }
 function normalizeVerifyEmailResult(email, data) {
+  const failed = coreProductResponseFailed(data);
   const verificationStatus = String(data.verification_status ?? "").toLowerCase();
-  const verified = data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus);
+  const verified = !failed && (data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus));
   return {
-    success: data.success !== false,
+    success: !failed,
+    error: failed ? coreProductErrorMessage(data) : void 0,
+    errorCode: failed ? coreProductErrorCode(data) : void 0,
     email: data.email ?? email,
-    status: String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
+    status: !failed && String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
     verificationRunId: data.verification_run_id ?? data.run_id,
     retryAfterMs: data.retry_after_ms,
     nextPollAfterSeconds: data.next_poll_after_seconds,
-    isValid: data.is_valid ?? data.valid ?? verified,
-    isDeliverable: data.is_deliverable ?? data.deliverable ?? verified,
+    isValid: failed ? false : data.is_valid ?? data.valid ?? verified,
+    isDeliverable: failed ? false : data.is_deliverable ?? data.deliverable ?? verified,
     isMalformed: data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed",
     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,
+    verifiedForSending: !failed && 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,
@@ -1025,9 +1034,12 @@ function companySignalRequestBody(params) {
   });
 }
 function normalizeCompanySignalResult(params, data) {
-  const rawSignals = data.signals ?? data.signal_feed ?? [];
+  const failed = coreProductResponseFailed(data);
+  const rawSignals = failed ? [] : data.signals ?? data.signal_feed ?? [];
   return {
-    success: data.success ?? true,
+    success: !failed,
+    error: failed ? coreProductErrorMessage(data) : void 0,
+    errorCode: failed ? coreProductErrorCode(data) : void 0,
     status: data.status,
     signalRunId: data.signal_run_id ?? data.run_id ?? params.signalRunId,
     company: {
@@ -1324,11 +1336,15 @@ function finalizeCoreBatch(total, startedAt, round, normalize, options) {
   const results = new Array(total);
   for (const item of round) {
     if (!item.success || !item.raw) {
-      results[item.index] = batchItemFailure(
+      const failure = batchItemFailure(
         item.index,
         item.error || "Signaliz batch item failed",
         item.raw ?? item
       );
+      if (item.raw?.is_malformed === true) {
+        failure.data = normalize(item);
+      }
+      results[item.index] = failure;
       continue;
     }
     try {
@@ -1401,17 +1417,21 @@ function validateCoreProductMaxWaitMs(value) {
   }
 }
 function normalizeSignalToCopyResult(data) {
+  const failed = coreProductResponseFailed(data);
   return {
-    success: data.success ?? true,
+    success: !failed,
+    error: failed ? coreProductErrorMessage(data) : void 0,
+    errorCode: failed ? coreProductErrorCode(data) : void 0,
     status: data.status,
-    runId: data.signal_run_id ?? data.run_id,
+    runId: data.run_id ?? data.signal_run_id,
+    companySignalRunId: data.company_signal_run_id,
     resumeContextPersisted: data.resume_context_persisted,
-    strongestSignal: data.strongest_signal ?? "",
-    whyNow: data.why_now ?? "",
-    subjectLine: data.subject_line ?? "",
-    openingLine: data.opening_line ?? "",
-    confidence: data.confidence ?? 0,
-    evidenceUrl: data.evidence_url ?? "",
+    strongestSignal: failed ? "" : data.strongest_signal ?? "",
+    whyNow: failed ? "" : data.why_now ?? "",
+    subjectLine: failed ? "" : data.subject_line ?? "",
+    openingLine: failed ? "" : data.opening_line ?? "",
+    confidence: failed ? 0 : data.confidence ?? 0,
+    evidenceUrl: failed ? "" : data.evidence_url ?? "",
     researchPrompt: data.research_prompt,
     empty: data.empty,
     emptyReason: data.empty_reason,
@@ -1424,7 +1444,7 @@ function normalizeSignalToCopyResult(data) {
     liveProviderCalled: data.live_provider_called,
     aiProviderCalled: data.ai_provider_called,
     byoAiUsed: data.byo_ai_used,
-    variations: (data.variations ?? []).map((variation) => ({
+    variations: (failed ? [] : data.variations ?? []).map((variation) => ({
       style: variation.style,
       subjectLine: variation.subject_line ?? "",
       openingLine: variation.opening_line ?? "",
@@ -1436,8 +1456,32 @@ function normalizeSignalToCopyResult(data) {
   };
 }
 function isPendingSignalResponse(data) {
+  if (coreProductResponseFailed(data)) return false;
   return ["triggered", "queued", "processing", "pending", "pending_version", "waiting_for_deploy"].includes(String(data.status || "").toLowerCase());
 }
+function coreProductResponseFailed(data) {
+  if (data.success === false) return true;
+  if (typeof data.error_code === "string" && data.error_code.trim()) return true;
+  if (typeof data.error === "string" && data.error.trim()) return true;
+  if (data.error && typeof data.error === "object" && Object.keys(data.error).length > 0) return true;
+  return ["failed", "error", "cancelled", "canceled"].includes(String(data.status || "").toLowerCase());
+}
+function coreProductErrorMessage(data) {
+  const nested = data.error && typeof data.error === "object" ? data.error : void 0;
+  const candidates = [nested?.message, data.message, typeof data.error === "string" ? data.error : void 0];
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.trim()) return candidate.trim();
+  }
+  return void 0;
+}
+function coreProductErrorCode(data) {
+  const nested = data.error && typeof data.error === "object" ? data.error : void 0;
+  const candidates = [data.error_code, nested?.code, data.code];
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.trim()) return candidate.trim();
+  }
+  return void 0;
+}
 function assertTerminalSignalResponse(data, capability) {
   if (isPendingSignalResponse(data) || data.job_id) {
     throw new Error(`${capability} violated the synchronous response contract.`);

package/dist/index.d.mts

@@ -116,6 +116,8 @@ interface FindEmailResult {
 }
 interface VerifyEmailResult {
     success: boolean;
+    error?: string;
+    errorCode?: string;
     email: string;
     /** Execution state. Processing results are never send-safe. */
     status: 'processing' | 'completed';
@@ -216,6 +218,8 @@ interface CompanySignal {
 }
 interface CompanySignalEnrichmentResult {
     success: boolean;
+    error?: string;
+    errorCode?: string;
     status?: string;
     signalRunId?: string;
     company: {
@@ -353,12 +357,15 @@ interface SignalToCopyVariation {
     openingLine: string;
     cta: string;
     prediction?: string;
-    email?: string;
+    email: string;
 }
 interface SignalToCopyResult {
     success: boolean;
+    error?: string;
+    errorCode?: string;
     status?: string;
     runId?: string;
+    companySignalRunId?: string;
     resumeContextPersisted?: boolean;
     strongestSignal: string;
     whyNow: string;

package/dist/index.d.ts

@@ -116,6 +116,8 @@ interface FindEmailResult {
 }
 interface VerifyEmailResult {
     success: boolean;
+    error?: string;
+    errorCode?: string;
     email: string;
     /** Execution state. Processing results are never send-safe. */
     status: 'processing' | 'completed';
@@ -216,6 +218,8 @@ interface CompanySignal {
 }
 interface CompanySignalEnrichmentResult {
     success: boolean;
+    error?: string;
+    errorCode?: string;
     status?: string;
     signalRunId?: string;
     company: {
@@ -353,12 +357,15 @@ interface SignalToCopyVariation {
     openingLine: string;
     cta: string;
     prediction?: string;
-    email?: string;
+    email: string;
 }
 interface SignalToCopyResult {
     success: boolean;
+    error?: string;
+    errorCode?: string;
     status?: string;
     runId?: string;
+    companySignalRunId?: string;
     resumeContextPersisted?: boolean;
     strongestSignal: string;
     whyNow: string;

package/dist/index.js

@@ -719,7 +719,7 @@ var Signaliz = class {
     }
     for (let index = 0; index < requests.length; index += 1) {
       const item = data.results[index];
-      if (item.success === false) {
+      if (coreProductResponseFailed(item)) {
         if (rowRateLimitAttempt < MAX_ROW_RATE_LIMIT_RETRIES && isRetryableRowRateLimit({
           index,
           success: false,
@@ -728,7 +728,11 @@ var Signaliz = class {
           rateLimited.push({ index, params: requests[index], raw: item });
           continue;
         }
-        results[index] = batchItemFailure(index, item.error || item.message || "Signal to Copy failed", item);
+        results[index] = batchItemFailure(
+          index,
+          coreProductErrorMessage(item) || "Signal to Copy failed",
+          item
+        );
         continue;
       }
       try {
@@ -829,9 +833,9 @@ var Signaliz = class {
         const raw = chunkResult.data[index];
         uniqueResults[chunk.offset + index] = {
           index: chunk.tasks[index].index,
-          success: raw.success !== false,
+          success: !coreProductResponseFailed(raw),
           raw,
-          error: raw.success === false ? raw.error || raw.message || raw.error_code || `${path} item failed` : void 0
+          error: coreProductResponseFailed(raw) ? coreProductErrorMessage(raw) || coreProductErrorCode(raw) || `${path} item failed` : void 0
         };
       }
     }
@@ -901,7 +905,7 @@ function batchItemFailure(index, error, raw) {
   };
 }
 function recoverableJobRowFailed(row) {
-  return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
+  return coreProductResponseFailed(row) || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
 function newBatchIdempotencyKey(label) {
   const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
@@ -951,7 +955,9 @@ function normalizeCoreProductDryRunResult(data) {
   };
 }
 function normalizeFindEmailResult(data) {
-  const email = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
+  const failed = coreProductResponseFailed(data);
+  const rawEmail = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
+  const email = failed ? null : rawEmail;
   const found = Boolean(email) && data.found !== false;
   const verificationStatus = data.verification_status ?? (data.is_valid === true ? "valid" : data.status ?? "unknown");
   const rawFreshness = String(data.verification_freshness ?? "").toLowerCase();
@@ -961,7 +967,7 @@ function normalizeFindEmailResult(data) {
   const verified = !explicitlyNotSendSafe && (data.is_valid === true || data.isValid === true || data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase()));
   const verificationAgeDays = typeof data.verification_age_days === "number" && Number.isFinite(data.verification_age_days) ? data.verification_age_days : null;
   return {
-    success: data.success !== false && found,
+    success: !failed && found,
     found,
     email,
     firstName: data.first_name,
@@ -988,26 +994,29 @@ function normalizeFindEmailResult(data) {
     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",
+    error: found ? void 0 : coreProductErrorMessage(data) ?? "No verified email found",
+    errorCode: found ? void 0 : coreProductErrorCode(data) ?? "EMAIL_NOT_FOUND",
     raw: data
   };
 }
 function normalizeVerifyEmailResult(email, data) {
+  const failed = coreProductResponseFailed(data);
   const verificationStatus = String(data.verification_status ?? "").toLowerCase();
-  const verified = data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus);
+  const verified = !failed && (data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus));
   return {
-    success: data.success !== false,
+    success: !failed,
+    error: failed ? coreProductErrorMessage(data) : void 0,
+    errorCode: failed ? coreProductErrorCode(data) : void 0,
     email: data.email ?? email,
-    status: String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
+    status: !failed && String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
     verificationRunId: data.verification_run_id ?? data.run_id,
     retryAfterMs: data.retry_after_ms,
     nextPollAfterSeconds: data.next_poll_after_seconds,
-    isValid: data.is_valid ?? data.valid ?? verified,
-    isDeliverable: data.is_deliverable ?? data.deliverable ?? verified,
+    isValid: failed ? false : data.is_valid ?? data.valid ?? verified,
+    isDeliverable: failed ? false : data.is_deliverable ?? data.deliverable ?? verified,
     isMalformed: data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed",
     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,
+    verifiedForSending: !failed && 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,
@@ -1052,9 +1061,12 @@ function companySignalRequestBody(params) {
   });
 }
 function normalizeCompanySignalResult(params, data) {
-  const rawSignals = data.signals ?? data.signal_feed ?? [];
+  const failed = coreProductResponseFailed(data);
+  const rawSignals = failed ? [] : data.signals ?? data.signal_feed ?? [];
   return {
-    success: data.success ?? true,
+    success: !failed,
+    error: failed ? coreProductErrorMessage(data) : void 0,
+    errorCode: failed ? coreProductErrorCode(data) : void 0,
     status: data.status,
     signalRunId: data.signal_run_id ?? data.run_id ?? params.signalRunId,
     company: {
@@ -1351,11 +1363,15 @@ function finalizeCoreBatch(total, startedAt, round, normalize, options) {
   const results = new Array(total);
   for (const item of round) {
     if (!item.success || !item.raw) {
-      results[item.index] = batchItemFailure(
+      const failure = batchItemFailure(
         item.index,
         item.error || "Signaliz batch item failed",
         item.raw ?? item
       );
+      if (item.raw?.is_malformed === true) {
+        failure.data = normalize(item);
+      }
+      results[item.index] = failure;
       continue;
     }
     try {
@@ -1428,17 +1444,21 @@ function validateCoreProductMaxWaitMs(value) {
   }
 }
 function normalizeSignalToCopyResult(data) {
+  const failed = coreProductResponseFailed(data);
   return {
-    success: data.success ?? true,
+    success: !failed,
+    error: failed ? coreProductErrorMessage(data) : void 0,
+    errorCode: failed ? coreProductErrorCode(data) : void 0,
     status: data.status,
-    runId: data.signal_run_id ?? data.run_id,
+    runId: data.run_id ?? data.signal_run_id,
+    companySignalRunId: data.company_signal_run_id,
     resumeContextPersisted: data.resume_context_persisted,
-    strongestSignal: data.strongest_signal ?? "",
-    whyNow: data.why_now ?? "",
-    subjectLine: data.subject_line ?? "",
-    openingLine: data.opening_line ?? "",
-    confidence: data.confidence ?? 0,
-    evidenceUrl: data.evidence_url ?? "",
+    strongestSignal: failed ? "" : data.strongest_signal ?? "",
+    whyNow: failed ? "" : data.why_now ?? "",
+    subjectLine: failed ? "" : data.subject_line ?? "",
+    openingLine: failed ? "" : data.opening_line ?? "",
+    confidence: failed ? 0 : data.confidence ?? 0,
+    evidenceUrl: failed ? "" : data.evidence_url ?? "",
     researchPrompt: data.research_prompt,
     empty: data.empty,
     emptyReason: data.empty_reason,
@@ -1451,7 +1471,7 @@ function normalizeSignalToCopyResult(data) {
     liveProviderCalled: data.live_provider_called,
     aiProviderCalled: data.ai_provider_called,
     byoAiUsed: data.byo_ai_used,
-    variations: (data.variations ?? []).map((variation) => ({
+    variations: (failed ? [] : data.variations ?? []).map((variation) => ({
       style: variation.style,
       subjectLine: variation.subject_line ?? "",
       openingLine: variation.opening_line ?? "",
@@ -1463,8 +1483,32 @@ function normalizeSignalToCopyResult(data) {
   };
 }
 function isPendingSignalResponse(data) {
+  if (coreProductResponseFailed(data)) return false;
   return ["triggered", "queued", "processing", "pending", "pending_version", "waiting_for_deploy"].includes(String(data.status || "").toLowerCase());
 }
+function coreProductResponseFailed(data) {
+  if (data.success === false) return true;
+  if (typeof data.error_code === "string" && data.error_code.trim()) return true;
+  if (typeof data.error === "string" && data.error.trim()) return true;
+  if (data.error && typeof data.error === "object" && Object.keys(data.error).length > 0) return true;
+  return ["failed", "error", "cancelled", "canceled"].includes(String(data.status || "").toLowerCase());
+}
+function coreProductErrorMessage(data) {
+  const nested = data.error && typeof data.error === "object" ? data.error : void 0;
+  const candidates = [nested?.message, data.message, typeof data.error === "string" ? data.error : void 0];
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.trim()) return candidate.trim();
+  }
+  return void 0;
+}
+function coreProductErrorCode(data) {
+  const nested = data.error && typeof data.error === "object" ? data.error : void 0;
+  const candidates = [data.error_code, nested?.code, data.code];
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.trim()) return candidate.trim();
+  }
+  return void 0;
+}
 function assertTerminalSignalResponse(data, capability) {
   if (isPendingSignalResponse(data) || data.job_id) {
     throw new Error(`${capability} violated the synchronous response contract.`);

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -723,7 +723,7 @@ var Signaliz = class {
     }
     for (let index = 0; index < requests.length; index += 1) {
       const item = data.results[index];
-      if (item.success === false) {
+      if (coreProductResponseFailed(item)) {
         if (rowRateLimitAttempt < MAX_ROW_RATE_LIMIT_RETRIES && isRetryableRowRateLimit({
           index,
           success: false,
@@ -732,7 +732,11 @@ var Signaliz = class {
           rateLimited.push({ index, params: requests[index], raw: item });
           continue;
         }
-        results[index] = batchItemFailure(index, item.error || item.message || "Signal to Copy failed", item);
+        results[index] = batchItemFailure(
+          index,
+          coreProductErrorMessage(item) || "Signal to Copy failed",
+          item
+        );
         continue;
       }
       try {
@@ -833,9 +837,9 @@ var Signaliz = class {
         const raw = chunkResult.data[index];
         uniqueResults[chunk.offset + index] = {
           index: chunk.tasks[index].index,
-          success: raw.success !== false,
+          success: !coreProductResponseFailed(raw),
           raw,
-          error: raw.success === false ? raw.error || raw.message || raw.error_code || `${path2} item failed` : void 0
+          error: coreProductResponseFailed(raw) ? coreProductErrorMessage(raw) || coreProductErrorCode(raw) || `${path2} item failed` : void 0
         };
       }
     }
@@ -905,7 +909,7 @@ function batchItemFailure(index, error, raw) {
   };
 }
 function recoverableJobRowFailed(row) {
-  return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
+  return coreProductResponseFailed(row) || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
 function newBatchIdempotencyKey(label) {
   const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
@@ -955,7 +959,9 @@ function normalizeCoreProductDryRunResult(data) {
   };
 }
 function normalizeFindEmailResult(data) {
-  const email = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
+  const failed = coreProductResponseFailed(data);
+  const rawEmail = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
+  const email = failed ? null : rawEmail;
   const found = Boolean(email) && data.found !== false;
   const verificationStatus = data.verification_status ?? (data.is_valid === true ? "valid" : data.status ?? "unknown");
   const rawFreshness = String(data.verification_freshness ?? "").toLowerCase();
@@ -965,7 +971,7 @@ function normalizeFindEmailResult(data) {
   const verified = !explicitlyNotSendSafe && (data.is_valid === true || data.isValid === true || data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase()));
   const verificationAgeDays = typeof data.verification_age_days === "number" && Number.isFinite(data.verification_age_days) ? data.verification_age_days : null;
   return {
-    success: data.success !== false && found,
+    success: !failed && found,
     found,
     email,
     firstName: data.first_name,
@@ -992,26 +998,29 @@ function normalizeFindEmailResult(data) {
     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",
+    error: found ? void 0 : coreProductErrorMessage(data) ?? "No verified email found",
+    errorCode: found ? void 0 : coreProductErrorCode(data) ?? "EMAIL_NOT_FOUND",
     raw: data
   };
 }
 function normalizeVerifyEmailResult(email, data) {
+  const failed = coreProductResponseFailed(data);
   const verificationStatus = String(data.verification_status ?? "").toLowerCase();
-  const verified = data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus);
+  const verified = !failed && (data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus));
   return {
-    success: data.success !== false,
+    success: !failed,
+    error: failed ? coreProductErrorMessage(data) : void 0,
+    errorCode: failed ? coreProductErrorCode(data) : void 0,
     email: data.email ?? email,
-    status: String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
+    status: !failed && String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
     verificationRunId: data.verification_run_id ?? data.run_id,
     retryAfterMs: data.retry_after_ms,
     nextPollAfterSeconds: data.next_poll_after_seconds,
-    isValid: data.is_valid ?? data.valid ?? verified,
-    isDeliverable: data.is_deliverable ?? data.deliverable ?? verified,
+    isValid: failed ? false : data.is_valid ?? data.valid ?? verified,
+    isDeliverable: failed ? false : data.is_deliverable ?? data.deliverable ?? verified,
     isMalformed: data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed",
     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,
+    verifiedForSending: !failed && 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,
@@ -1056,9 +1065,12 @@ function companySignalRequestBody(params) {
   });
 }
 function normalizeCompanySignalResult(params, data) {
-  const rawSignals = data.signals ?? data.signal_feed ?? [];
+  const failed = coreProductResponseFailed(data);
+  const rawSignals = failed ? [] : data.signals ?? data.signal_feed ?? [];
   return {
-    success: data.success ?? true,
+    success: !failed,
+    error: failed ? coreProductErrorMessage(data) : void 0,
+    errorCode: failed ? coreProductErrorCode(data) : void 0,
     status: data.status,
     signalRunId: data.signal_run_id ?? data.run_id ?? params.signalRunId,
     company: {
@@ -1355,11 +1367,15 @@ function finalizeCoreBatch(total, startedAt, round, normalize, options) {
   const results = new Array(total);
   for (const item of round) {
     if (!item.success || !item.raw) {
-      results[item.index] = batchItemFailure(
+      const failure = batchItemFailure(
         item.index,
         item.error || "Signaliz batch item failed",
         item.raw ?? item
       );
+      if (item.raw?.is_malformed === true) {
+        failure.data = normalize(item);
+      }
+      results[item.index] = failure;
       continue;
     }
     try {
@@ -1432,17 +1448,21 @@ function validateCoreProductMaxWaitMs(value) {
   }
 }
 function normalizeSignalToCopyResult(data) {
+  const failed = coreProductResponseFailed(data);
   return {
-    success: data.success ?? true,
+    success: !failed,
+    error: failed ? coreProductErrorMessage(data) : void 0,
+    errorCode: failed ? coreProductErrorCode(data) : void 0,
     status: data.status,
-    runId: data.signal_run_id ?? data.run_id,
+    runId: data.run_id ?? data.signal_run_id,
+    companySignalRunId: data.company_signal_run_id,
     resumeContextPersisted: data.resume_context_persisted,
-    strongestSignal: data.strongest_signal ?? "",
-    whyNow: data.why_now ?? "",
-    subjectLine: data.subject_line ?? "",
-    openingLine: data.opening_line ?? "",
-    confidence: data.confidence ?? 0,
-    evidenceUrl: data.evidence_url ?? "",
+    strongestSignal: failed ? "" : data.strongest_signal ?? "",
+    whyNow: failed ? "" : data.why_now ?? "",
+    subjectLine: failed ? "" : data.subject_line ?? "",
+    openingLine: failed ? "" : data.opening_line ?? "",
+    confidence: failed ? 0 : data.confidence ?? 0,
+    evidenceUrl: failed ? "" : data.evidence_url ?? "",
     researchPrompt: data.research_prompt,
     empty: data.empty,
     emptyReason: data.empty_reason,
@@ -1455,7 +1475,7 @@ function normalizeSignalToCopyResult(data) {
     liveProviderCalled: data.live_provider_called,
     aiProviderCalled: data.ai_provider_called,
     byoAiUsed: data.byo_ai_used,
-    variations: (data.variations ?? []).map((variation) => ({
+    variations: (failed ? [] : data.variations ?? []).map((variation) => ({
       style: variation.style,
       subjectLine: variation.subject_line ?? "",
       openingLine: variation.opening_line ?? "",
@@ -1467,8 +1487,32 @@ function normalizeSignalToCopyResult(data) {
   };
 }
 function isPendingSignalResponse(data) {
+  if (coreProductResponseFailed(data)) return false;
   return ["triggered", "queued", "processing", "pending", "pending_version", "waiting_for_deploy"].includes(String(data.status || "").toLowerCase());
 }
+function coreProductResponseFailed(data) {
+  if (data.success === false) return true;
+  if (typeof data.error_code === "string" && data.error_code.trim()) return true;
+  if (typeof data.error === "string" && data.error.trim()) return true;
+  if (data.error && typeof data.error === "object" && Object.keys(data.error).length > 0) return true;
+  return ["failed", "error", "cancelled", "canceled"].includes(String(data.status || "").toLowerCase());
+}
+function coreProductErrorMessage(data) {
+  const nested = data.error && typeof data.error === "object" ? data.error : void 0;
+  const candidates = [nested?.message, data.message, typeof data.error === "string" ? data.error : void 0];
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.trim()) return candidate.trim();
+  }
+  return void 0;
+}
+function coreProductErrorCode(data) {
+  const nested = data.error && typeof data.error === "object" ? data.error : void 0;
+  const candidates = [data.error_code, nested?.code, data.code];
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.trim()) return candidate.trim();
+  }
+  return void 0;
+}
 function assertTerminalSignalResponse(data, capability) {
   if (isPendingSignalResponse(data) || data.job_id) {
     throw new Error(`${capability} violated the synchronous response contract.`);

package/dist/mcp-config.mjs

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

package/package.json

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