@signaliz/sdk 1.0.57 → 1.0.59

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,16 @@ 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. This includes
+`ok: false`, non-empty error fields or error arrays, and terminal provider
+statuses such as `timed_out` or `crashed`; an informational `message` alone is
+not an error. Find Email withholds the email and every send-safe indicator,
+Verify Email withholds deliverability and confidence, and Company Signals and
+Signal to Copy withhold contradictory signals, narratives, and copy. Normalized
+`error` and `errorCode` fields explain the failure while the original response
+remains available in `raw` for audit.
+
 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-VKBUQTDS.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,20 +940,20 @@ 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,
     lastName: data.last_name,
-    confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
-    verificationStatus,
-    isVerified: verified,
-    isVerifiedForSending: !needsReverification && data.verified_for_sending === true,
+    confidence: failed ? 0 : data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
+    verificationStatus: failed ? "error" : verificationStatus,
+    isVerified: !failed && verified,
+    isVerifiedForSending: !failed && !needsReverification && data.verified_for_sending === true,
     isCatchAll: data.email_is_catch_all === true || data.is_catch_all === true,
     verificationFreshness,
     verificationAgeDays,
     verifiedAt: typeof data.verified_at === "string" ? data.verified_at : null,
-    needsReverification,
+    needsReverification: failed || needsReverification,
     providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
     creditsUsed: data.credits_used,
     estimatedExternalCostUsd: data.estimated_external_cost_usd,
@@ -961,28 +967,32 @@ 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));
+  const malformed = data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed";
   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,
-    isMalformed: data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed",
+    isValid: failed ? false : data.is_valid ?? data.valid ?? verified,
+    isDeliverable: failed ? false : data.is_deliverable ?? data.deliverable ?? verified,
+    isMalformed: 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,
-    verificationVerdict: data.verification_verdict ?? data.verification_status ?? "unknown",
-    confidenceScore: data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
+    verifiedForSending: !failed && data.verified_for_sending === true,
+    verificationVerdict: failed ? malformed ? "malformed" : "error" : data.verification_verdict ?? data.verification_status ?? "unknown",
+    confidenceScore: failed ? 0 : data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
     provider: data.provider,
     verificationSource: data.verification_source,
     billingReplayed: data.billing_replayed,
@@ -1025,9 +1035,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: {
@@ -1052,16 +1065,16 @@ function normalizeCompanySignalResult(params, data) {
         classification: signal.signal_classification ?? null
       };
     }),
-    signalCount: data.signal_count ?? data.total_signals ?? rawSignals.length,
-    signalSummary: data.signal_summary ?? null,
-    intelligence: data.intelligence ?? null,
-    copyFuel: data.copy_fuel ?? null,
-    evidenceValidation: data.evidence_validation,
-    evidenceSources: data.metadata?.evidence_sources ?? data.evidence_sources,
-    evidenceCount: data.evidence_count,
-    evidenceCountTotal: data.evidence_count_total,
-    evidenceSourcesOmitted: data.evidence_sources_omitted,
-    evidenceScope: data.evidence_scope,
+    signalCount: failed ? 0 : data.signal_count ?? data.total_signals ?? rawSignals.length,
+    signalSummary: failed ? null : data.signal_summary ?? null,
+    intelligence: failed ? null : data.intelligence ?? null,
+    copyFuel: failed ? null : data.copy_fuel ?? null,
+    evidenceValidation: failed ? void 0 : data.evidence_validation,
+    evidenceSources: failed ? [] : data.metadata?.evidence_sources ?? data.evidence_sources,
+    evidenceCount: failed ? 0 : data.evidence_count,
+    evidenceCountTotal: failed ? 0 : data.evidence_count_total,
+    evidenceSourcesOmitted: failed ? 0 : data.evidence_sources_omitted,
+    evidenceScope: failed ? void 0 : data.evidence_scope,
     billingMetadata: data.billing_metadata,
     resultReturnedFrom: data.result_returned_from,
     cacheHit: data.cache_hit,
@@ -1324,11 +1337,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,21 +1418,25 @@ 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,
-    researchMetadata: data.research_metadata,
+    researchMetadata: failed ? void 0 : data.research_metadata,
     billingMetadata: data.billing_metadata,
     resultReturnedFrom: data.result_returned_from,
     cacheHit: data.cache_hit,
@@ -1424,7 +1445,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 +1457,56 @@ 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 || data.ok === false) return true;
+  if (hasCoreProductFailureValue(data.error_code) || hasCoreProductFailureValue(data.errorCode)) return true;
+  if (hasCoreProductFailureValue(data.error) || hasCoreProductFailureValue(data.error_message) || hasCoreProductFailureValue(data.errorMessage)) return true;
+  if (Array.isArray(data.errors) && data.errors.length > 0) return true;
+  return ["failed", "error", "cancelled", "canceled", "crashed", "timed_out", "system_failure"].includes(String(data.status || "").toLowerCase());
+}
+function hasCoreProductFailureValue(value) {
+  if (typeof value === "string") return value.trim().length > 0;
+  if (Array.isArray(value)) return value.length > 0;
+  if (value && typeof value === "object") return Object.keys(value).length > 0;
+  return value === true || typeof value === "number" && value !== 0;
+}
+function coreProductErrorMessage(data) {
+  const nested = data.error && typeof data.error === "object" ? data.error : void 0;
+  const firstError = Array.isArray(data.errors) ? data.errors[0] : void 0;
+  const candidates = [
+    nested?.message,
+    firstError?.message,
+    data.error_message,
+    data.errorMessage,
+    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 firstError = Array.isArray(data.errors) ? data.errors[0] : void 0;
+  const details = firstError?.details && typeof firstError.details === "object" ? firstError.details : void 0;
+  const candidates = [
+    data.error_code,
+    data.errorCode,
+    nested?.code,
+    details?.error_code,
+    details?.legacy_error_code,
+    firstError?.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,20 +967,20 @@ 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,
     lastName: data.last_name,
-    confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
-    verificationStatus,
-    isVerified: verified,
-    isVerifiedForSending: !needsReverification && data.verified_for_sending === true,
+    confidence: failed ? 0 : data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
+    verificationStatus: failed ? "error" : verificationStatus,
+    isVerified: !failed && verified,
+    isVerifiedForSending: !failed && !needsReverification && data.verified_for_sending === true,
     isCatchAll: data.email_is_catch_all === true || data.is_catch_all === true,
     verificationFreshness,
     verificationAgeDays,
     verifiedAt: typeof data.verified_at === "string" ? data.verified_at : null,
-    needsReverification,
+    needsReverification: failed || needsReverification,
     providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
     creditsUsed: data.credits_used,
     estimatedExternalCostUsd: data.estimated_external_cost_usd,
@@ -988,28 +994,32 @@ 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));
+  const malformed = data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed";
   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,
-    isMalformed: data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed",
+    isValid: failed ? false : data.is_valid ?? data.valid ?? verified,
+    isDeliverable: failed ? false : data.is_deliverable ?? data.deliverable ?? verified,
+    isMalformed: 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,
-    verificationVerdict: data.verification_verdict ?? data.verification_status ?? "unknown",
-    confidenceScore: data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
+    verifiedForSending: !failed && data.verified_for_sending === true,
+    verificationVerdict: failed ? malformed ? "malformed" : "error" : data.verification_verdict ?? data.verification_status ?? "unknown",
+    confidenceScore: failed ? 0 : data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
     provider: data.provider,
     verificationSource: data.verification_source,
     billingReplayed: data.billing_replayed,
@@ -1052,9 +1062,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: {
@@ -1079,16 +1092,16 @@ function normalizeCompanySignalResult(params, data) {
         classification: signal.signal_classification ?? null
       };
     }),
-    signalCount: data.signal_count ?? data.total_signals ?? rawSignals.length,
-    signalSummary: data.signal_summary ?? null,
-    intelligence: data.intelligence ?? null,
-    copyFuel: data.copy_fuel ?? null,
-    evidenceValidation: data.evidence_validation,
-    evidenceSources: data.metadata?.evidence_sources ?? data.evidence_sources,
-    evidenceCount: data.evidence_count,
-    evidenceCountTotal: data.evidence_count_total,
-    evidenceSourcesOmitted: data.evidence_sources_omitted,
-    evidenceScope: data.evidence_scope,
+    signalCount: failed ? 0 : data.signal_count ?? data.total_signals ?? rawSignals.length,
+    signalSummary: failed ? null : data.signal_summary ?? null,
+    intelligence: failed ? null : data.intelligence ?? null,
+    copyFuel: failed ? null : data.copy_fuel ?? null,
+    evidenceValidation: failed ? void 0 : data.evidence_validation,
+    evidenceSources: failed ? [] : data.metadata?.evidence_sources ?? data.evidence_sources,
+    evidenceCount: failed ? 0 : data.evidence_count,
+    evidenceCountTotal: failed ? 0 : data.evidence_count_total,
+    evidenceSourcesOmitted: failed ? 0 : data.evidence_sources_omitted,
+    evidenceScope: failed ? void 0 : data.evidence_scope,
     billingMetadata: data.billing_metadata,
     resultReturnedFrom: data.result_returned_from,
     cacheHit: data.cache_hit,
@@ -1351,11 +1364,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,21 +1445,25 @@ 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,
-    researchMetadata: data.research_metadata,
+    researchMetadata: failed ? void 0 : data.research_metadata,
     billingMetadata: data.billing_metadata,
     resultReturnedFrom: data.result_returned_from,
     cacheHit: data.cache_hit,
@@ -1451,7 +1472,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 +1484,56 @@ 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 || data.ok === false) return true;
+  if (hasCoreProductFailureValue(data.error_code) || hasCoreProductFailureValue(data.errorCode)) return true;
+  if (hasCoreProductFailureValue(data.error) || hasCoreProductFailureValue(data.error_message) || hasCoreProductFailureValue(data.errorMessage)) return true;
+  if (Array.isArray(data.errors) && data.errors.length > 0) return true;
+  return ["failed", "error", "cancelled", "canceled", "crashed", "timed_out", "system_failure"].includes(String(data.status || "").toLowerCase());
+}
+function hasCoreProductFailureValue(value) {
+  if (typeof value === "string") return value.trim().length > 0;
+  if (Array.isArray(value)) return value.length > 0;
+  if (value && typeof value === "object") return Object.keys(value).length > 0;
+  return value === true || typeof value === "number" && value !== 0;
+}
+function coreProductErrorMessage(data) {
+  const nested = data.error && typeof data.error === "object" ? data.error : void 0;
+  const firstError = Array.isArray(data.errors) ? data.errors[0] : void 0;
+  const candidates = [
+    nested?.message,
+    firstError?.message,
+    data.error_message,
+    data.errorMessage,
+    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 firstError = Array.isArray(data.errors) ? data.errors[0] : void 0;
+  const details = firstError?.details && typeof firstError.details === "object" ? firstError.details : void 0;
+  const candidates = [
+    data.error_code,
+    data.errorCode,
+    nested?.code,
+    details?.error_code,
+    details?.legacy_error_code,
+    firstError?.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-VKBUQTDS.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,20 +971,20 @@ 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,
     lastName: data.last_name,
-    confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
-    verificationStatus,
-    isVerified: verified,
-    isVerifiedForSending: !needsReverification && data.verified_for_sending === true,
+    confidence: failed ? 0 : data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
+    verificationStatus: failed ? "error" : verificationStatus,
+    isVerified: !failed && verified,
+    isVerifiedForSending: !failed && !needsReverification && data.verified_for_sending === true,
     isCatchAll: data.email_is_catch_all === true || data.is_catch_all === true,
     verificationFreshness,
     verificationAgeDays,
     verifiedAt: typeof data.verified_at === "string" ? data.verified_at : null,
-    needsReverification,
+    needsReverification: failed || needsReverification,
     providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
     creditsUsed: data.credits_used,
     estimatedExternalCostUsd: data.estimated_external_cost_usd,
@@ -992,28 +998,32 @@ 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));
+  const malformed = data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed";
   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,
-    isMalformed: data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed",
+    isValid: failed ? false : data.is_valid ?? data.valid ?? verified,
+    isDeliverable: failed ? false : data.is_deliverable ?? data.deliverable ?? verified,
+    isMalformed: 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,
-    verificationVerdict: data.verification_verdict ?? data.verification_status ?? "unknown",
-    confidenceScore: data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
+    verifiedForSending: !failed && data.verified_for_sending === true,
+    verificationVerdict: failed ? malformed ? "malformed" : "error" : data.verification_verdict ?? data.verification_status ?? "unknown",
+    confidenceScore: failed ? 0 : data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
     provider: data.provider,
     verificationSource: data.verification_source,
     billingReplayed: data.billing_replayed,
@@ -1056,9 +1066,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: {
@@ -1083,16 +1096,16 @@ function normalizeCompanySignalResult(params, data) {
         classification: signal.signal_classification ?? null
       };
     }),
-    signalCount: data.signal_count ?? data.total_signals ?? rawSignals.length,
-    signalSummary: data.signal_summary ?? null,
-    intelligence: data.intelligence ?? null,
-    copyFuel: data.copy_fuel ?? null,
-    evidenceValidation: data.evidence_validation,
-    evidenceSources: data.metadata?.evidence_sources ?? data.evidence_sources,
-    evidenceCount: data.evidence_count,
-    evidenceCountTotal: data.evidence_count_total,
-    evidenceSourcesOmitted: data.evidence_sources_omitted,
-    evidenceScope: data.evidence_scope,
+    signalCount: failed ? 0 : data.signal_count ?? data.total_signals ?? rawSignals.length,
+    signalSummary: failed ? null : data.signal_summary ?? null,
+    intelligence: failed ? null : data.intelligence ?? null,
+    copyFuel: failed ? null : data.copy_fuel ?? null,
+    evidenceValidation: failed ? void 0 : data.evidence_validation,
+    evidenceSources: failed ? [] : data.metadata?.evidence_sources ?? data.evidence_sources,
+    evidenceCount: failed ? 0 : data.evidence_count,
+    evidenceCountTotal: failed ? 0 : data.evidence_count_total,
+    evidenceSourcesOmitted: failed ? 0 : data.evidence_sources_omitted,
+    evidenceScope: failed ? void 0 : data.evidence_scope,
     billingMetadata: data.billing_metadata,
     resultReturnedFrom: data.result_returned_from,
     cacheHit: data.cache_hit,
@@ -1355,11 +1368,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,21 +1449,25 @@ 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,
-    researchMetadata: data.research_metadata,
+    researchMetadata: failed ? void 0 : data.research_metadata,
     billingMetadata: data.billing_metadata,
     resultReturnedFrom: data.result_returned_from,
     cacheHit: data.cache_hit,
@@ -1455,7 +1476,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 +1488,56 @@ 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 || data.ok === false) return true;
+  if (hasCoreProductFailureValue(data.error_code) || hasCoreProductFailureValue(data.errorCode)) return true;
+  if (hasCoreProductFailureValue(data.error) || hasCoreProductFailureValue(data.error_message) || hasCoreProductFailureValue(data.errorMessage)) return true;
+  if (Array.isArray(data.errors) && data.errors.length > 0) return true;
+  return ["failed", "error", "cancelled", "canceled", "crashed", "timed_out", "system_failure"].includes(String(data.status || "").toLowerCase());
+}
+function hasCoreProductFailureValue(value) {
+  if (typeof value === "string") return value.trim().length > 0;
+  if (Array.isArray(value)) return value.length > 0;
+  if (value && typeof value === "object") return Object.keys(value).length > 0;
+  return value === true || typeof value === "number" && value !== 0;
+}
+function coreProductErrorMessage(data) {
+  const nested = data.error && typeof data.error === "object" ? data.error : void 0;
+  const firstError = Array.isArray(data.errors) ? data.errors[0] : void 0;
+  const candidates = [
+    nested?.message,
+    firstError?.message,
+    data.error_message,
+    data.errorMessage,
+    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 firstError = Array.isArray(data.errors) ? data.errors[0] : void 0;
+  const details = firstError?.details && typeof firstError.details === "object" ? firstError.details : void 0;
+  const candidates = [
+    data.error_code,
+    data.errorCode,
+    nested?.code,
+    details?.error_code,
+    details?.legacy_error_code,
+    firstError?.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-VKBUQTDS.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.59",
   "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",