@signaliz/sdk 1.0.64 → 1.0.66

package/README.md

@@ -39,6 +39,11 @@ const found = await signaliz.findEmail({
   skipCache: true,
 });
 
+// An HTTPS LinkedIn person profile URL (/in/<slug>) is also sufficient on its own.
+const foundFromLinkedIn = await signaliz.findEmail({
+  linkedinUrl: 'https://www.linkedin.com/in/jane-doe',
+});
+
 const verified = await signaliz.verifyEmail(found.email!, {
   // Optional: bypass cached verification proof for a fresh-provider check.
   skipCache: true,

package/dist/{chunk-PDOG4IUP.mjs → chunk-ZXSNNBID.mjs}

@@ -47,6 +47,8 @@ function publicRetryDetails(body) {
     ...body?.retry_strategy !== void 0 ? { retry_strategy: body.retry_strategy } : {},
     ...body?.credits_used !== void 0 ? { credits_used: body.credits_used } : {},
     ...body?.credits_charged !== void 0 ? { credits_charged: body.credits_charged } : {},
+    ...body?.live_provider_called !== void 0 ? { live_provider_called: body.live_provider_called } : {},
+    ...body?.estimated_external_cost_usd !== void 0 ? { estimated_external_cost_usd: body.estimated_external_cost_usd } : {},
     ...body?.job_id !== void 0 ? { job_id: body.job_id } : {},
     ...body?.idempotency_key !== void 0 ? { idempotency_key: body.idempotency_key } : {},
     ...body?.verification_run_id !== void 0 ? { verification_run_id: body.verification_run_id } : {},
@@ -131,7 +133,8 @@ var HttpClient = class {
           const err = parseError(res.status, errBody);
           if (err.isRetryable && attempt < this.maxRetries) {
             const retryWithNewKey = err.details?.retry_strategy === "new_idempotency_key" && err.details?.credits_used === 0 && err.details?.credits_charged === 0;
-            if (retryWithNewKey) throw err;
+            const recoverSameRun = err.details?.retry_strategy === "same_run_recovery";
+            if (retryWithNewKey || recoverSameRun) throw err;
             const wait = err.retryAfter !== void 0 ? err.retryAfter * 1e3 : Math.min(1e3 * Math.pow(2, attempt), 1e4);
             await sleep(wait);
             lastError = err;
@@ -203,6 +206,7 @@ var HttpClient = class {
         if (!res.ok) {
           const err = parseError(res.status, data ?? { message: text });
           if (err.isRetryable && attempt < this.maxRetries) {
+            if (err.details?.retry_strategy === "same_run_recovery") throw err;
             lastError = err;
             await sleep(err.retryAfter ? err.retryAfter * 1e3 : Math.min(1e3 * Math.pow(2, attempt), 1e4));
             continue;
@@ -227,6 +231,7 @@ var HttpClient = class {
             details: isRecord(responseError.data) ? responseError.data : void 0
           });
           if (err.isRetryable && attempt < this.maxRetries) {
+            if (err.details?.retry_strategy === "same_run_recovery") throw err;
             lastError = err;
             await sleep(err.retryAfter ? err.retryAfter * 1e3 : Math.min(1e3 * Math.pow(2, attempt), 1e4));
             continue;
@@ -235,7 +240,10 @@ var HttpClient = class {
         }
         return unwrapMcpResponse(data);
       } catch (e) {
-        if (e instanceof SignalizError && !e.isRetryable) throw e;
+        if (e instanceof SignalizError) {
+          if (e.details?.retry_strategy === "same_run_recovery") throw e;
+          if (!e.isRetryable) throw e;
+        }
         if (e.name === "AbortError") {
           lastError = new SignalizError({
             code: "TIMEOUT",
@@ -346,15 +354,25 @@ function unwrapMcpPayload(payload) {
       return unwrapMcpPayload(payload.result);
     }
     if (payload.ok === false) {
+      if (isRecord(payload.result) && (payload.result.success === false || payload.result.ok === false)) {
+        return unwrapMcpPayload(payload.result);
+      }
       const first = firstPayloadError(payload);
-      const code = firstString(first.code, payload.error_code, payload.code) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
+      const firstDetails = isRecord(first.details) ? first.details : {};
+      const code = firstString(
+        firstDetails.error_code,
+        firstDetails.legacy_error_code,
+        first.code,
+        payload.error_code,
+        payload.code
+      ) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
       throw new SignalizError({
         code,
         message: firstString(first.message, payload.message, payload.summary, payload.error) || "MCP request failed",
         errorType: mapErrorTypeFromCode(code),
         details: {
           ...payload,
-          ...isRecord(first.details) ? first.details : {}
+          ...firstDetails
         }
       });
     }
@@ -363,14 +381,20 @@ function unwrapMcpPayload(payload) {
     }
     if (payload.success === false) {
       const first = firstPayloadError(payload);
-      const code = firstString(first.code, payload.error_code) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
+      const firstDetails = isRecord(first.details) ? first.details : {};
+      const code = firstString(
+        firstDetails.error_code,
+        firstDetails.legacy_error_code,
+        first.code,
+        payload.error_code
+      ) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
       throw new SignalizError({
         code,
         message: firstString(first.message, payload.message, payload.summary) || "MCP request failed",
         errorType: mapErrorTypeFromCode(code),
         details: {
           ...payload,
-          ...isRecord(first.details) ? first.details : {}
+          ...firstDetails
         }
       });
     }
@@ -560,6 +584,31 @@ function assertLargeCoreProductInputBounds(path, body) {
   );
 }
 
+// ../../supabase/functions/_shared/find-email-identity.ts
+var LINKEDIN_PERSON_PROFILE_URL_PATTERN = "^[hH][tT][tT][pP][sS]://(?:[A-Za-z0-9-]+\\.)*[lL][iI][nN][kK][eE][dD][iI][nN]\\.[cC][oO][mM]/[iI][nN]/[^/?#]+/?(?:[?#].*)?$";
+var LINKEDIN_PERSON_PROFILE_URL_REGEX = new RegExp(LINKEDIN_PERSON_PROFILE_URL_PATTERN);
+function nonEmptyText(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function isLinkedInPersonProfileUrl(value) {
+  if (!nonEmptyText(value)) return false;
+  const normalized = String(value).trim();
+  if (!LINKEDIN_PERSON_PROFILE_URL_REGEX.test(normalized)) return false;
+  try {
+    const url = new URL(normalized);
+    const hostname = url.hostname.toLowerCase();
+    return url.protocol === "https:" && !url.username && !url.password && !url.port && (hostname === "linkedin.com" || hostname.endsWith(".linkedin.com")) && /^\/in\/[^/]+\/?$/i.test(url.pathname);
+  } catch {
+    return false;
+  }
+}
+function hasFindEmailIdentity(input) {
+  if (isLinkedInPersonProfileUrl(input.linkedin_url)) return true;
+  const hasName = nonEmptyText(input.full_name) || nonEmptyText(input.first_name) && nonEmptyText(input.last_name);
+  return hasName && nonEmptyText(input.company_domain);
+}
+var FIND_EMAIL_IDENTITY_REQUIREMENT = "Provide an HTTPS LinkedIn person profile URL (/in/<slug>), or provide company_domain with full_name or first_name and last_name.";
+
 // src/index.ts
 var MAX_ROW_RATE_LIMIT_RETRIES = 2;
 var Signaliz = class {
@@ -567,22 +616,28 @@ var Signaliz = class {
     this.client = new HttpClient(config);
   }
   async findEmail(params) {
-    const data = await this.client.post("api/v1/find-email", findEmailRequestBody(params));
+    const request = findEmailRequestBody(params);
+    assertFindEmailRequestIdentity(request);
+    const data = await this.client.post("api/v1/find-email", request);
     return isCoreProductDryRun(data) ? normalizeCoreProductDryRunResult(data) : normalizeFindEmailResult(data);
   }
   async findEmails(params, options) {
     validateBatchSize(params);
+    const requests = params.map(findEmailRequestBody);
+    if (!requests.some(hasFindEmailRequestIdentity)) {
+      throw new TypeError(`Find Email batch must include at least one valid identity. ${FIND_EMAIL_IDENTITY_REQUIREMENT}`);
+    }
     if (options?.dryRun === true) {
       return this.runCoreProductDryRun(
         "api/v1/find-email",
-        params.map(findEmailRequestBody),
+        requests,
         options.idempotencyKey
       );
     }
     const startedAt = Date.now();
     const round = await this.runCoreBatchRound(
       "api/v1/find-email",
-      params.map((item, index) => ({ index, request: findEmailRequestBody(item) })),
+      requests.map((request, index) => ({ index, request })),
       options
     );
     return finalizeCoreBatch(
@@ -1408,6 +1463,8 @@ function batchItemFailure(index, error, raw) {
   const retryStrategy = raw?.retry_strategy ?? raw?.retryStrategy;
   const creditsUsed = raw?.credits_used ?? raw?.creditsUsed;
   const creditsCharged = raw?.credits_charged ?? raw?.creditsCharged;
+  const liveProviderCalled = raw?.live_provider_called ?? raw?.liveProviderCalled;
+  const estimatedExternalCostUsd = raw?.estimated_external_cost_usd ?? raw?.estimatedExternalCostUsd;
   const runId = [raw?.run_id, raw?.runId, raw?.signal_run_id, raw?.signalRunId].find((value) => typeof value === "string" && value.trim());
   const verificationRunId = raw?.verification_run_id ?? raw?.verificationRunId;
   const jobId = raw?.job_id ?? raw?.jobId;
@@ -1419,13 +1476,18 @@ function batchItemFailure(index, error, raw) {
     ...errorCode ? { errorCode } : {},
     ...typeof retryEligible === "boolean" ? { retryEligible } : {},
     ...Number.isFinite(retryAfterSeconds2) && retryAfterSeconds2 >= 0 ? { retryAfterSeconds: retryAfterSeconds2 } : {},
-    ...retryStrategy === "new_idempotency_key" ? { retryStrategy } : {},
+    ...["new_idempotency_key", "same_run_recovery"].includes(String(retryStrategy)) ? { retryStrategy } : {},
     ...creditsUsed === 0 ? { creditsUsed: 0 } : {},
     ...creditsCharged === 0 ? { creditsCharged: 0 } : {},
+    ...liveProviderCalled === false ? { liveProviderCalled: false } : {},
+    ...estimatedExternalCostUsd === 0 ? { estimatedExternalCostUsd: 0 } : {},
     ...typeof runId === "string" && runId.trim() ? { runId: runId.trim() } : {},
     ...typeof verificationRunId === "string" && verificationRunId.trim() ? { verificationRunId: verificationRunId.trim() } : {},
     ...typeof jobId === "string" && jobId.trim() ? { jobId: jobId.trim() } : {},
-    ...typeof suggestedAction === "string" && suggestedAction.trim() ? { suggestedAction: suggestedAction.trim() } : {}
+    ...typeof suggestedAction === "string" && suggestedAction.trim() ? { suggestedAction: suggestedAction.trim() } : {},
+    ...raw?.do_not_auto_resubmit === true ? { doNotAutoResubmit: true } : {},
+    ...raw?.recovery_mode === "same_run" ? { recoveryMode: "same_run" } : {},
+    ...["pending", "completed"].includes(String(raw?.recovery_status)) ? { recoveryStatus: raw?.recovery_status } : {}
   };
 }
 function recoverableJobRowFailed(row) {
@@ -1488,6 +1550,14 @@ function findEmailRequestBody(params) {
     idempotency_key: params.idempotencyKey
   });
 }
+function hasFindEmailRequestIdentity(request) {
+  return typeof request.run_id === "string" && request.run_id.trim().length > 0 || hasFindEmailIdentity(request);
+}
+function assertFindEmailRequestIdentity(request) {
+  if (!hasFindEmailRequestIdentity(request)) {
+    throw new TypeError(`Find Email requires a valid identity. ${FIND_EMAIL_IDENTITY_REQUIREMENT}`);
+  }
+}
 function verifyEmailBatchRequestBody(input, options) {
   if (typeof input === "string") {
     return compact({ email: input, skip_cache: options?.skipCache });
@@ -1566,6 +1636,7 @@ function normalizeFindEmailResult(data) {
     verificationObservedAt: typeof data.verification_observed_at === "string" ? data.verification_observed_at : void 0,
     failureReason: data.failure_reason ?? (failed || !found ? "no_verified_email_found" : "none"),
     creditsUsed: data.credits_used ?? billingMetadata?.credits_used,
+    creditsCharged: data.credits_charged ?? billingMetadata?.credits_charged,
     estimatedExternalCostUsd: data.estimated_external_cost_usd ?? billingMetadata?.estimated_external_cost_usd,
     billingMetadata,
     historicalBillingMetadata: data.historical_billing_metadata,
@@ -1584,6 +1655,11 @@ function normalizeFindEmailResult(data) {
     runId: data.run_id,
     nextPollAfterSeconds: data.next_poll_after_seconds,
     suggestedAction: data.suggested_action,
+    retryEligible: data.retry_eligible,
+    retryStrategy: ["new_idempotency_key", "same_run_recovery"].includes(data.retry_strategy) ? data.retry_strategy : void 0,
+    doNotAutoResubmit: data.do_not_auto_resubmit === true,
+    recoveryMode: data.recovery_mode === "same_run" ? "same_run" : void 0,
+    recoveryStatus: ["pending", "completed"].includes(String(data.recovery_status)) ? data.recovery_status : void 0,
     cachePublicationStatus: data.cache_publication_status,
     cachePublicationRetryEligible: data.cache_publication_retry_eligible,
     raw: data
@@ -1911,6 +1987,16 @@ function normalizeSignalDiscoverySignal(value) {
   if (!companyName || !companyDomain) {
     throw new Error("Signals Everything response violated the company attribution contract.");
   }
+  const eventDate = String(signal.event_date ?? signal.date ?? signal.signal_date ?? "").trim();
+  const sourceUrl = String(signal.source_url ?? signal.url ?? "").trim();
+  const evidence = Array.isArray(signal.evidence) ? signal.evidence.map((item) => ({
+    url: String(item?.url ?? "").trim(),
+    publishedAt: String(item?.published_at ?? item?.publishedAt ?? "").trim(),
+    source: String(item?.source ?? "").trim()
+  })).filter((item) => Boolean(item.url)) : [];
+  if (!eventDate || !sourceUrl || !evidence.some((item) => item.url === sourceUrl && item.publishedAt === eventDate)) {
+    throw new Error("Signals Everything response violated the dated-evidence and source-URL contract.");
+  }
   return {
     id: signal.id,
     company: {
@@ -1921,16 +2007,12 @@ function normalizeSignalDiscoverySignal(value) {
     title: signal.title ?? "",
     type: signal.type ?? signal.signal_type ?? "unknown",
     summary: signal.summary ?? signal.content ?? signal.description ?? "",
-    eventDate: signal.event_date ?? signal.date ?? signal.signal_date ?? null,
-    evidence: Array.isArray(signal.evidence) ? signal.evidence.map((item) => ({
-      url: String(item?.url ?? ""),
-      publishedAt: String(item?.published_at ?? item?.publishedAt ?? ""),
-      source: String(item?.source ?? "")
-    })).filter((item) => Boolean(item.url)) : [],
+    eventDate,
+    evidence,
     content: signal.summary ?? signal.content ?? signal.description ?? "",
     date: signal.event_date ?? signal.date ?? signal.signal_date ?? null,
     detectedAt: signal.event_date ?? signal.detected_at ?? null,
-    sourceUrl: signal.source_url ?? signal.url ?? null,
+    sourceUrl,
     sourceType: signal.source_type ?? null,
     confidence: signal.confidence ?? signal.confidence_score ?? null,
     classification: signal.signal_classification ?? signal.classification ?? null,

package/dist/index.d.mts

@@ -56,11 +56,15 @@ interface BatchItemResult<T> {
     /** Server-provided delay before retrying the failed row. */
     retryAfterSeconds?: number;
     /** Explicit recovery strategy. A fresh key can repeat provider work and is never automatic. */
-    retryStrategy?: 'new_idempotency_key';
+    retryStrategy?: 'new_idempotency_key' | 'same_run_recovery';
     /** Present only when the server proves the failed row consumed zero Signaliz credits. */
     creditsUsed?: 0;
     /** Present only when the server proves the failed row charged zero Signaliz credits. */
     creditsCharged?: 0;
+    /** Present only when the server proves no live provider was called for the failed row. */
+    liveProviderCalled?: false;
+    /** Present only when the server proves the failed row had no external provider cost. */
+    estimatedExternalCostUsd?: 0;
     /** Existing provider run that can be resumed without dispatching new work. */
     runId?: string;
     /** Existing Verify Email run that can be resumed without dispatching new work. */
@@ -69,6 +73,9 @@ interface BatchItemResult<T> {
     jobId?: string;
     /** Machine-readable recovery action returned by Signaliz. */
     suggestedAction?: string;
+    doNotAutoResubmit?: boolean;
+    recoveryMode?: 'same_run';
+    recoveryStatus?: 'pending' | 'completed';
     cachePublicationStatus?: 'completed' | 'pending' | 'pending_safe_retry' | 'superseded_by_newer_verdict';
     cachePublicationRetryEligible?: boolean;
     /** Zero-based input index containing the full result for this exact duplicate. */
@@ -111,10 +118,6 @@ interface CoreProductDryRunResult {
     raw: Record<string, unknown>;
 }
 interface FindEmailCommonParams {
-    fullName?: string;
-    firstName?: string;
-    lastName?: string;
-    linkedinUrl?: string;
     companyName?: string;
     /** Bypass cached email and verification data for a fresh-provider run. */
     skipCache?: boolean;
@@ -124,13 +127,35 @@ interface FindEmailCommonParams {
     idempotencyKey?: string;
 }
 type FindEmailParams = FindEmailCommonParams & ({
+    /** Start a new lookup using only the contact's LinkedIn profile. */
+    linkedinUrl: string;
+    companyDomain?: string;
+    fullName?: string;
+    firstName?: string;
+    lastName?: string;
+    /** Omit for a new lookup. */
+    runId?: undefined;
+} | ({
     companyDomain: string;
+    linkedinUrl?: string;
     /** Omit for a new lookup. */
     runId?: undefined;
+} & ({
+    fullName: string;
+    firstName?: string;
+    lastName?: string;
 } | {
+    fullName?: string;
+    firstName: string;
+    lastName: string;
+})) | {
     /** Resume one existing Find Email run without dispatching a new finder. */
     runId: string;
     companyDomain?: string;
+    linkedinUrl?: string;
+    fullName?: string;
+    firstName?: string;
+    lastName?: string;
 });
 interface FindEmailResult {
     success: boolean;
@@ -156,6 +181,7 @@ interface FindEmailResult {
     verificationObservedAt?: string;
     failureReason: string;
     creditsUsed?: number;
+    creditsCharged?: number;
     estimatedExternalCostUsd?: number;
     billingMetadata?: Record<string, unknown>;
     /** Original provider-work billing receipt when this request only recovered a completed run. */
@@ -179,6 +205,12 @@ interface FindEmailResult {
     runId?: string;
     nextPollAfterSeconds?: number;
     suggestedAction?: string;
+    /** True only for same-run recovery, or a fresh idempotency key with explicit zero-spend proof; never retry automatically. */
+    retryEligible?: boolean;
+    retryStrategy?: 'new_idempotency_key' | 'same_run_recovery';
+    doNotAutoResubmit?: boolean;
+    recoveryMode?: 'same_run';
+    recoveryStatus?: 'pending' | 'completed';
     cachePublicationStatus?: 'completed' | 'pending' | 'pending_safe_retry' | 'superseded_by_newer_verdict';
     cachePublicationRetryEligible?: boolean;
     raw: Record<string, unknown>;
@@ -373,7 +405,7 @@ interface SignalDiscoverySignal {
     title: string;
     type: string;
     summary: string;
-    eventDate?: string | null;
+    eventDate: string;
     evidence: Array<{
         url: string;
         publishedAt: string;
@@ -384,7 +416,7 @@ interface SignalDiscoverySignal {
     /** Compatibility alias for eventDate. */
     date?: string | null;
     detectedAt?: string | null;
-    sourceUrl?: string | null;
+    sourceUrl: string;
     sourceType?: string | null;
     confidence?: number | null;
     classification?: Record<string, unknown> | string | null;

package/dist/index.d.ts

@@ -56,11 +56,15 @@ interface BatchItemResult<T> {
     /** Server-provided delay before retrying the failed row. */
     retryAfterSeconds?: number;
     /** Explicit recovery strategy. A fresh key can repeat provider work and is never automatic. */
-    retryStrategy?: 'new_idempotency_key';
+    retryStrategy?: 'new_idempotency_key' | 'same_run_recovery';
     /** Present only when the server proves the failed row consumed zero Signaliz credits. */
     creditsUsed?: 0;
     /** Present only when the server proves the failed row charged zero Signaliz credits. */
     creditsCharged?: 0;
+    /** Present only when the server proves no live provider was called for the failed row. */
+    liveProviderCalled?: false;
+    /** Present only when the server proves the failed row had no external provider cost. */
+    estimatedExternalCostUsd?: 0;
     /** Existing provider run that can be resumed without dispatching new work. */
     runId?: string;
     /** Existing Verify Email run that can be resumed without dispatching new work. */
@@ -69,6 +73,9 @@ interface BatchItemResult<T> {
     jobId?: string;
     /** Machine-readable recovery action returned by Signaliz. */
     suggestedAction?: string;
+    doNotAutoResubmit?: boolean;
+    recoveryMode?: 'same_run';
+    recoveryStatus?: 'pending' | 'completed';
     cachePublicationStatus?: 'completed' | 'pending' | 'pending_safe_retry' | 'superseded_by_newer_verdict';
     cachePublicationRetryEligible?: boolean;
     /** Zero-based input index containing the full result for this exact duplicate. */
@@ -111,10 +118,6 @@ interface CoreProductDryRunResult {
     raw: Record<string, unknown>;
 }
 interface FindEmailCommonParams {
-    fullName?: string;
-    firstName?: string;
-    lastName?: string;
-    linkedinUrl?: string;
     companyName?: string;
     /** Bypass cached email and verification data for a fresh-provider run. */
     skipCache?: boolean;
@@ -124,13 +127,35 @@ interface FindEmailCommonParams {
     idempotencyKey?: string;
 }
 type FindEmailParams = FindEmailCommonParams & ({
+    /** Start a new lookup using only the contact's LinkedIn profile. */
+    linkedinUrl: string;
+    companyDomain?: string;
+    fullName?: string;
+    firstName?: string;
+    lastName?: string;
+    /** Omit for a new lookup. */
+    runId?: undefined;
+} | ({
     companyDomain: string;
+    linkedinUrl?: string;
     /** Omit for a new lookup. */
     runId?: undefined;
+} & ({
+    fullName: string;
+    firstName?: string;
+    lastName?: string;
 } | {
+    fullName?: string;
+    firstName: string;
+    lastName: string;
+})) | {
     /** Resume one existing Find Email run without dispatching a new finder. */
     runId: string;
     companyDomain?: string;
+    linkedinUrl?: string;
+    fullName?: string;
+    firstName?: string;
+    lastName?: string;
 });
 interface FindEmailResult {
     success: boolean;
@@ -156,6 +181,7 @@ interface FindEmailResult {
     verificationObservedAt?: string;
     failureReason: string;
     creditsUsed?: number;
+    creditsCharged?: number;
     estimatedExternalCostUsd?: number;
     billingMetadata?: Record<string, unknown>;
     /** Original provider-work billing receipt when this request only recovered a completed run. */
@@ -179,6 +205,12 @@ interface FindEmailResult {
     runId?: string;
     nextPollAfterSeconds?: number;
     suggestedAction?: string;
+    /** True only for same-run recovery, or a fresh idempotency key with explicit zero-spend proof; never retry automatically. */
+    retryEligible?: boolean;
+    retryStrategy?: 'new_idempotency_key' | 'same_run_recovery';
+    doNotAutoResubmit?: boolean;
+    recoveryMode?: 'same_run';
+    recoveryStatus?: 'pending' | 'completed';
     cachePublicationStatus?: 'completed' | 'pending' | 'pending_safe_retry' | 'superseded_by_newer_verdict';
     cachePublicationRetryEligible?: boolean;
     raw: Record<string, unknown>;
@@ -373,7 +405,7 @@ interface SignalDiscoverySignal {
     title: string;
     type: string;
     summary: string;
-    eventDate?: string | null;
+    eventDate: string;
     evidence: Array<{
         url: string;
         publishedAt: string;
@@ -384,7 +416,7 @@ interface SignalDiscoverySignal {
     /** Compatibility alias for eventDate. */
     date?: string | null;
     detectedAt?: string | null;
-    sourceUrl?: string | null;
+    sourceUrl: string;
     sourceType?: string | null;
     confidence?: number | null;
     classification?: Record<string, unknown> | string | null;

package/dist/index.js

@@ -74,6 +74,8 @@ function publicRetryDetails(body) {
     ...body?.retry_strategy !== void 0 ? { retry_strategy: body.retry_strategy } : {},
     ...body?.credits_used !== void 0 ? { credits_used: body.credits_used } : {},
     ...body?.credits_charged !== void 0 ? { credits_charged: body.credits_charged } : {},
+    ...body?.live_provider_called !== void 0 ? { live_provider_called: body.live_provider_called } : {},
+    ...body?.estimated_external_cost_usd !== void 0 ? { estimated_external_cost_usd: body.estimated_external_cost_usd } : {},
     ...body?.job_id !== void 0 ? { job_id: body.job_id } : {},
     ...body?.idempotency_key !== void 0 ? { idempotency_key: body.idempotency_key } : {},
     ...body?.verification_run_id !== void 0 ? { verification_run_id: body.verification_run_id } : {},
@@ -158,7 +160,8 @@ var HttpClient = class {
           const err = parseError(res.status, errBody);
           if (err.isRetryable && attempt < this.maxRetries) {
             const retryWithNewKey = err.details?.retry_strategy === "new_idempotency_key" && err.details?.credits_used === 0 && err.details?.credits_charged === 0;
-            if (retryWithNewKey) throw err;
+            const recoverSameRun = err.details?.retry_strategy === "same_run_recovery";
+            if (retryWithNewKey || recoverSameRun) throw err;
             const wait = err.retryAfter !== void 0 ? err.retryAfter * 1e3 : Math.min(1e3 * Math.pow(2, attempt), 1e4);
             await sleep(wait);
             lastError = err;
@@ -230,6 +233,7 @@ var HttpClient = class {
         if (!res.ok) {
           const err = parseError(res.status, data ?? { message: text });
           if (err.isRetryable && attempt < this.maxRetries) {
+            if (err.details?.retry_strategy === "same_run_recovery") throw err;
             lastError = err;
             await sleep(err.retryAfter ? err.retryAfter * 1e3 : Math.min(1e3 * Math.pow(2, attempt), 1e4));
             continue;
@@ -254,6 +258,7 @@ var HttpClient = class {
             details: isRecord(responseError.data) ? responseError.data : void 0
           });
           if (err.isRetryable && attempt < this.maxRetries) {
+            if (err.details?.retry_strategy === "same_run_recovery") throw err;
             lastError = err;
             await sleep(err.retryAfter ? err.retryAfter * 1e3 : Math.min(1e3 * Math.pow(2, attempt), 1e4));
             continue;
@@ -262,7 +267,10 @@ var HttpClient = class {
         }
         return unwrapMcpResponse(data);
       } catch (e) {
-        if (e instanceof SignalizError && !e.isRetryable) throw e;
+        if (e instanceof SignalizError) {
+          if (e.details?.retry_strategy === "same_run_recovery") throw e;
+          if (!e.isRetryable) throw e;
+        }
         if (e.name === "AbortError") {
           lastError = new SignalizError({
             code: "TIMEOUT",
@@ -373,15 +381,25 @@ function unwrapMcpPayload(payload) {
       return unwrapMcpPayload(payload.result);
     }
     if (payload.ok === false) {
+      if (isRecord(payload.result) && (payload.result.success === false || payload.result.ok === false)) {
+        return unwrapMcpPayload(payload.result);
+      }
       const first = firstPayloadError(payload);
-      const code = firstString(first.code, payload.error_code, payload.code) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
+      const firstDetails = isRecord(first.details) ? first.details : {};
+      const code = firstString(
+        firstDetails.error_code,
+        firstDetails.legacy_error_code,
+        first.code,
+        payload.error_code,
+        payload.code
+      ) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
       throw new SignalizError({
         code,
         message: firstString(first.message, payload.message, payload.summary, payload.error) || "MCP request failed",
         errorType: mapErrorTypeFromCode(code),
         details: {
           ...payload,
-          ...isRecord(first.details) ? first.details : {}
+          ...firstDetails
         }
       });
     }
@@ -390,14 +408,20 @@ function unwrapMcpPayload(payload) {
     }
     if (payload.success === false) {
       const first = firstPayloadError(payload);
-      const code = firstString(first.code, payload.error_code) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
+      const firstDetails = isRecord(first.details) ? first.details : {};
+      const code = firstString(
+        firstDetails.error_code,
+        firstDetails.legacy_error_code,
+        first.code,
+        payload.error_code
+      ) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
       throw new SignalizError({
         code,
         message: firstString(first.message, payload.message, payload.summary) || "MCP request failed",
         errorType: mapErrorTypeFromCode(code),
         details: {
           ...payload,
-          ...isRecord(first.details) ? first.details : {}
+          ...firstDetails
         }
       });
     }
@@ -587,6 +611,31 @@ function assertLargeCoreProductInputBounds(path, body) {
   );
 }
 
+// ../../supabase/functions/_shared/find-email-identity.ts
+var LINKEDIN_PERSON_PROFILE_URL_PATTERN = "^[hH][tT][tT][pP][sS]://(?:[A-Za-z0-9-]+\\.)*[lL][iI][nN][kK][eE][dD][iI][nN]\\.[cC][oO][mM]/[iI][nN]/[^/?#]+/?(?:[?#].*)?$";
+var LINKEDIN_PERSON_PROFILE_URL_REGEX = new RegExp(LINKEDIN_PERSON_PROFILE_URL_PATTERN);
+function nonEmptyText(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function isLinkedInPersonProfileUrl(value) {
+  if (!nonEmptyText(value)) return false;
+  const normalized = String(value).trim();
+  if (!LINKEDIN_PERSON_PROFILE_URL_REGEX.test(normalized)) return false;
+  try {
+    const url = new URL(normalized);
+    const hostname = url.hostname.toLowerCase();
+    return url.protocol === "https:" && !url.username && !url.password && !url.port && (hostname === "linkedin.com" || hostname.endsWith(".linkedin.com")) && /^\/in\/[^/]+\/?$/i.test(url.pathname);
+  } catch {
+    return false;
+  }
+}
+function hasFindEmailIdentity(input) {
+  if (isLinkedInPersonProfileUrl(input.linkedin_url)) return true;
+  const hasName = nonEmptyText(input.full_name) || nonEmptyText(input.first_name) && nonEmptyText(input.last_name);
+  return hasName && nonEmptyText(input.company_domain);
+}
+var FIND_EMAIL_IDENTITY_REQUIREMENT = "Provide an HTTPS LinkedIn person profile URL (/in/<slug>), or provide company_domain with full_name or first_name and last_name.";
+
 // src/index.ts
 var MAX_ROW_RATE_LIMIT_RETRIES = 2;
 var Signaliz = class {
@@ -594,22 +643,28 @@ var Signaliz = class {
     this.client = new HttpClient(config);
   }
   async findEmail(params) {
-    const data = await this.client.post("api/v1/find-email", findEmailRequestBody(params));
+    const request = findEmailRequestBody(params);
+    assertFindEmailRequestIdentity(request);
+    const data = await this.client.post("api/v1/find-email", request);
     return isCoreProductDryRun(data) ? normalizeCoreProductDryRunResult(data) : normalizeFindEmailResult(data);
   }
   async findEmails(params, options) {
     validateBatchSize(params);
+    const requests = params.map(findEmailRequestBody);
+    if (!requests.some(hasFindEmailRequestIdentity)) {
+      throw new TypeError(`Find Email batch must include at least one valid identity. ${FIND_EMAIL_IDENTITY_REQUIREMENT}`);
+    }
     if (options?.dryRun === true) {
       return this.runCoreProductDryRun(
         "api/v1/find-email",
-        params.map(findEmailRequestBody),
+        requests,
         options.idempotencyKey
       );
     }
     const startedAt = Date.now();
     const round = await this.runCoreBatchRound(
       "api/v1/find-email",
-      params.map((item, index) => ({ index, request: findEmailRequestBody(item) })),
+      requests.map((request, index) => ({ index, request })),
       options
     );
     return finalizeCoreBatch(
@@ -1435,6 +1490,8 @@ function batchItemFailure(index, error, raw) {
   const retryStrategy = raw?.retry_strategy ?? raw?.retryStrategy;
   const creditsUsed = raw?.credits_used ?? raw?.creditsUsed;
   const creditsCharged = raw?.credits_charged ?? raw?.creditsCharged;
+  const liveProviderCalled = raw?.live_provider_called ?? raw?.liveProviderCalled;
+  const estimatedExternalCostUsd = raw?.estimated_external_cost_usd ?? raw?.estimatedExternalCostUsd;
   const runId = [raw?.run_id, raw?.runId, raw?.signal_run_id, raw?.signalRunId].find((value) => typeof value === "string" && value.trim());
   const verificationRunId = raw?.verification_run_id ?? raw?.verificationRunId;
   const jobId = raw?.job_id ?? raw?.jobId;
@@ -1446,13 +1503,18 @@ function batchItemFailure(index, error, raw) {
     ...errorCode ? { errorCode } : {},
     ...typeof retryEligible === "boolean" ? { retryEligible } : {},
     ...Number.isFinite(retryAfterSeconds2) && retryAfterSeconds2 >= 0 ? { retryAfterSeconds: retryAfterSeconds2 } : {},
-    ...retryStrategy === "new_idempotency_key" ? { retryStrategy } : {},
+    ...["new_idempotency_key", "same_run_recovery"].includes(String(retryStrategy)) ? { retryStrategy } : {},
     ...creditsUsed === 0 ? { creditsUsed: 0 } : {},
     ...creditsCharged === 0 ? { creditsCharged: 0 } : {},
+    ...liveProviderCalled === false ? { liveProviderCalled: false } : {},
+    ...estimatedExternalCostUsd === 0 ? { estimatedExternalCostUsd: 0 } : {},
     ...typeof runId === "string" && runId.trim() ? { runId: runId.trim() } : {},
     ...typeof verificationRunId === "string" && verificationRunId.trim() ? { verificationRunId: verificationRunId.trim() } : {},
     ...typeof jobId === "string" && jobId.trim() ? { jobId: jobId.trim() } : {},
-    ...typeof suggestedAction === "string" && suggestedAction.trim() ? { suggestedAction: suggestedAction.trim() } : {}
+    ...typeof suggestedAction === "string" && suggestedAction.trim() ? { suggestedAction: suggestedAction.trim() } : {},
+    ...raw?.do_not_auto_resubmit === true ? { doNotAutoResubmit: true } : {},
+    ...raw?.recovery_mode === "same_run" ? { recoveryMode: "same_run" } : {},
+    ...["pending", "completed"].includes(String(raw?.recovery_status)) ? { recoveryStatus: raw?.recovery_status } : {}
   };
 }
 function recoverableJobRowFailed(row) {
@@ -1515,6 +1577,14 @@ function findEmailRequestBody(params) {
     idempotency_key: params.idempotencyKey
   });
 }
+function hasFindEmailRequestIdentity(request) {
+  return typeof request.run_id === "string" && request.run_id.trim().length > 0 || hasFindEmailIdentity(request);
+}
+function assertFindEmailRequestIdentity(request) {
+  if (!hasFindEmailRequestIdentity(request)) {
+    throw new TypeError(`Find Email requires a valid identity. ${FIND_EMAIL_IDENTITY_REQUIREMENT}`);
+  }
+}
 function verifyEmailBatchRequestBody(input, options) {
   if (typeof input === "string") {
     return compact({ email: input, skip_cache: options?.skipCache });
@@ -1593,6 +1663,7 @@ function normalizeFindEmailResult(data) {
     verificationObservedAt: typeof data.verification_observed_at === "string" ? data.verification_observed_at : void 0,
     failureReason: data.failure_reason ?? (failed || !found ? "no_verified_email_found" : "none"),
     creditsUsed: data.credits_used ?? billingMetadata?.credits_used,
+    creditsCharged: data.credits_charged ?? billingMetadata?.credits_charged,
     estimatedExternalCostUsd: data.estimated_external_cost_usd ?? billingMetadata?.estimated_external_cost_usd,
     billingMetadata,
     historicalBillingMetadata: data.historical_billing_metadata,
@@ -1611,6 +1682,11 @@ function normalizeFindEmailResult(data) {
     runId: data.run_id,
     nextPollAfterSeconds: data.next_poll_after_seconds,
     suggestedAction: data.suggested_action,
+    retryEligible: data.retry_eligible,
+    retryStrategy: ["new_idempotency_key", "same_run_recovery"].includes(data.retry_strategy) ? data.retry_strategy : void 0,
+    doNotAutoResubmit: data.do_not_auto_resubmit === true,
+    recoveryMode: data.recovery_mode === "same_run" ? "same_run" : void 0,
+    recoveryStatus: ["pending", "completed"].includes(String(data.recovery_status)) ? data.recovery_status : void 0,
     cachePublicationStatus: data.cache_publication_status,
     cachePublicationRetryEligible: data.cache_publication_retry_eligible,
     raw: data
@@ -1938,6 +2014,16 @@ function normalizeSignalDiscoverySignal(value) {
   if (!companyName || !companyDomain) {
     throw new Error("Signals Everything response violated the company attribution contract.");
   }
+  const eventDate = String(signal.event_date ?? signal.date ?? signal.signal_date ?? "").trim();
+  const sourceUrl = String(signal.source_url ?? signal.url ?? "").trim();
+  const evidence = Array.isArray(signal.evidence) ? signal.evidence.map((item) => ({
+    url: String(item?.url ?? "").trim(),
+    publishedAt: String(item?.published_at ?? item?.publishedAt ?? "").trim(),
+    source: String(item?.source ?? "").trim()
+  })).filter((item) => Boolean(item.url)) : [];
+  if (!eventDate || !sourceUrl || !evidence.some((item) => item.url === sourceUrl && item.publishedAt === eventDate)) {
+    throw new Error("Signals Everything response violated the dated-evidence and source-URL contract.");
+  }
   return {
     id: signal.id,
     company: {
@@ -1948,16 +2034,12 @@ function normalizeSignalDiscoverySignal(value) {
     title: signal.title ?? "",
     type: signal.type ?? signal.signal_type ?? "unknown",
     summary: signal.summary ?? signal.content ?? signal.description ?? "",
-    eventDate: signal.event_date ?? signal.date ?? signal.signal_date ?? null,
-    evidence: Array.isArray(signal.evidence) ? signal.evidence.map((item) => ({
-      url: String(item?.url ?? ""),
-      publishedAt: String(item?.published_at ?? item?.publishedAt ?? ""),
-      source: String(item?.source ?? "")
-    })).filter((item) => Boolean(item.url)) : [],
+    eventDate,
+    evidence,
     content: signal.summary ?? signal.content ?? signal.description ?? "",
     date: signal.event_date ?? signal.date ?? signal.signal_date ?? null,
     detectedAt: signal.event_date ?? signal.detected_at ?? null,
-    sourceUrl: signal.source_url ?? signal.url ?? null,
+    sourceUrl,
     sourceType: signal.source_type ?? null,
     confidence: signal.confidence ?? signal.confidence_score ?? null,
     classification: signal.signal_classification ?? signal.classification ?? null,

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -78,6 +78,8 @@ function publicRetryDetails(body) {
     ...body?.retry_strategy !== void 0 ? { retry_strategy: body.retry_strategy } : {},
     ...body?.credits_used !== void 0 ? { credits_used: body.credits_used } : {},
     ...body?.credits_charged !== void 0 ? { credits_charged: body.credits_charged } : {},
+    ...body?.live_provider_called !== void 0 ? { live_provider_called: body.live_provider_called } : {},
+    ...body?.estimated_external_cost_usd !== void 0 ? { estimated_external_cost_usd: body.estimated_external_cost_usd } : {},
     ...body?.job_id !== void 0 ? { job_id: body.job_id } : {},
     ...body?.idempotency_key !== void 0 ? { idempotency_key: body.idempotency_key } : {},
     ...body?.verification_run_id !== void 0 ? { verification_run_id: body.verification_run_id } : {},
@@ -162,7 +164,8 @@ var HttpClient = class {
           const err = parseError(res.status, errBody);
           if (err.isRetryable && attempt < this.maxRetries) {
             const retryWithNewKey = err.details?.retry_strategy === "new_idempotency_key" && err.details?.credits_used === 0 && err.details?.credits_charged === 0;
-            if (retryWithNewKey) throw err;
+            const recoverSameRun = err.details?.retry_strategy === "same_run_recovery";
+            if (retryWithNewKey || recoverSameRun) throw err;
             const wait = err.retryAfter !== void 0 ? err.retryAfter * 1e3 : Math.min(1e3 * Math.pow(2, attempt), 1e4);
             await sleep(wait);
             lastError = err;
@@ -234,6 +237,7 @@ var HttpClient = class {
         if (!res.ok) {
           const err = parseError(res.status, data ?? { message: text });
           if (err.isRetryable && attempt < this.maxRetries) {
+            if (err.details?.retry_strategy === "same_run_recovery") throw err;
             lastError = err;
             await sleep(err.retryAfter ? err.retryAfter * 1e3 : Math.min(1e3 * Math.pow(2, attempt), 1e4));
             continue;
@@ -258,6 +262,7 @@ var HttpClient = class {
             details: isRecord(responseError.data) ? responseError.data : void 0
           });
           if (err.isRetryable && attempt < this.maxRetries) {
+            if (err.details?.retry_strategy === "same_run_recovery") throw err;
             lastError = err;
             await sleep(err.retryAfter ? err.retryAfter * 1e3 : Math.min(1e3 * Math.pow(2, attempt), 1e4));
             continue;
@@ -266,7 +271,10 @@ var HttpClient = class {
         }
         return unwrapMcpResponse(data);
       } catch (e) {
-        if (e instanceof SignalizError && !e.isRetryable) throw e;
+        if (e instanceof SignalizError) {
+          if (e.details?.retry_strategy === "same_run_recovery") throw e;
+          if (!e.isRetryable) throw e;
+        }
         if (e.name === "AbortError") {
           lastError = new SignalizError({
             code: "TIMEOUT",
@@ -377,15 +385,25 @@ function unwrapMcpPayload(payload) {
       return unwrapMcpPayload(payload.result);
     }
     if (payload.ok === false) {
+      if (isRecord(payload.result) && (payload.result.success === false || payload.result.ok === false)) {
+        return unwrapMcpPayload(payload.result);
+      }
       const first = firstPayloadError(payload);
-      const code = firstString(first.code, payload.error_code, payload.code) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
+      const firstDetails = isRecord(first.details) ? first.details : {};
+      const code = firstString(
+        firstDetails.error_code,
+        firstDetails.legacy_error_code,
+        first.code,
+        payload.error_code,
+        payload.code
+      ) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
       throw new SignalizError({
         code,
         message: firstString(first.message, payload.message, payload.summary, payload.error) || "MCP request failed",
         errorType: mapErrorTypeFromCode(code),
         details: {
           ...payload,
-          ...isRecord(first.details) ? first.details : {}
+          ...firstDetails
         }
       });
     }
@@ -394,14 +412,20 @@ function unwrapMcpPayload(payload) {
     }
     if (payload.success === false) {
       const first = firstPayloadError(payload);
-      const code = firstString(first.code, payload.error_code) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
+      const firstDetails = isRecord(first.details) ? first.details : {};
+      const code = firstString(
+        firstDetails.error_code,
+        firstDetails.legacy_error_code,
+        first.code,
+        payload.error_code
+      ) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
       throw new SignalizError({
         code,
         message: firstString(first.message, payload.message, payload.summary) || "MCP request failed",
         errorType: mapErrorTypeFromCode(code),
         details: {
           ...payload,
-          ...isRecord(first.details) ? first.details : {}
+          ...firstDetails
         }
       });
     }
@@ -591,6 +615,31 @@ function assertLargeCoreProductInputBounds(path2, body) {
   );
 }
 
+// ../../supabase/functions/_shared/find-email-identity.ts
+var LINKEDIN_PERSON_PROFILE_URL_PATTERN = "^[hH][tT][tT][pP][sS]://(?:[A-Za-z0-9-]+\\.)*[lL][iI][nN][kK][eE][dD][iI][nN]\\.[cC][oO][mM]/[iI][nN]/[^/?#]+/?(?:[?#].*)?$";
+var LINKEDIN_PERSON_PROFILE_URL_REGEX = new RegExp(LINKEDIN_PERSON_PROFILE_URL_PATTERN);
+function nonEmptyText(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function isLinkedInPersonProfileUrl(value) {
+  if (!nonEmptyText(value)) return false;
+  const normalized = String(value).trim();
+  if (!LINKEDIN_PERSON_PROFILE_URL_REGEX.test(normalized)) return false;
+  try {
+    const url = new URL(normalized);
+    const hostname = url.hostname.toLowerCase();
+    return url.protocol === "https:" && !url.username && !url.password && !url.port && (hostname === "linkedin.com" || hostname.endsWith(".linkedin.com")) && /^\/in\/[^/]+\/?$/i.test(url.pathname);
+  } catch {
+    return false;
+  }
+}
+function hasFindEmailIdentity(input) {
+  if (isLinkedInPersonProfileUrl(input.linkedin_url)) return true;
+  const hasName = nonEmptyText(input.full_name) || nonEmptyText(input.first_name) && nonEmptyText(input.last_name);
+  return hasName && nonEmptyText(input.company_domain);
+}
+var FIND_EMAIL_IDENTITY_REQUIREMENT = "Provide an HTTPS LinkedIn person profile URL (/in/<slug>), or provide company_domain with full_name or first_name and last_name.";
+
 // src/index.ts
 var MAX_ROW_RATE_LIMIT_RETRIES = 2;
 var Signaliz = class {
@@ -598,22 +647,28 @@ var Signaliz = class {
     this.client = new HttpClient(config);
   }
   async findEmail(params) {
-    const data = await this.client.post("api/v1/find-email", findEmailRequestBody(params));
+    const request = findEmailRequestBody(params);
+    assertFindEmailRequestIdentity(request);
+    const data = await this.client.post("api/v1/find-email", request);
     return isCoreProductDryRun(data) ? normalizeCoreProductDryRunResult(data) : normalizeFindEmailResult(data);
   }
   async findEmails(params, options) {
     validateBatchSize(params);
+    const requests = params.map(findEmailRequestBody);
+    if (!requests.some(hasFindEmailRequestIdentity)) {
+      throw new TypeError(`Find Email batch must include at least one valid identity. ${FIND_EMAIL_IDENTITY_REQUIREMENT}`);
+    }
     if (options?.dryRun === true) {
       return this.runCoreProductDryRun(
         "api/v1/find-email",
-        params.map(findEmailRequestBody),
+        requests,
         options.idempotencyKey
       );
     }
     const startedAt = Date.now();
     const round = await this.runCoreBatchRound(
       "api/v1/find-email",
-      params.map((item, index) => ({ index, request: findEmailRequestBody(item) })),
+      requests.map((request, index) => ({ index, request })),
       options
     );
     return finalizeCoreBatch(
@@ -1439,6 +1494,8 @@ function batchItemFailure(index, error, raw) {
   const retryStrategy = raw?.retry_strategy ?? raw?.retryStrategy;
   const creditsUsed = raw?.credits_used ?? raw?.creditsUsed;
   const creditsCharged = raw?.credits_charged ?? raw?.creditsCharged;
+  const liveProviderCalled = raw?.live_provider_called ?? raw?.liveProviderCalled;
+  const estimatedExternalCostUsd = raw?.estimated_external_cost_usd ?? raw?.estimatedExternalCostUsd;
   const runId = [raw?.run_id, raw?.runId, raw?.signal_run_id, raw?.signalRunId].find((value) => typeof value === "string" && value.trim());
   const verificationRunId = raw?.verification_run_id ?? raw?.verificationRunId;
   const jobId = raw?.job_id ?? raw?.jobId;
@@ -1450,13 +1507,18 @@ function batchItemFailure(index, error, raw) {
     ...errorCode ? { errorCode } : {},
     ...typeof retryEligible === "boolean" ? { retryEligible } : {},
     ...Number.isFinite(retryAfterSeconds2) && retryAfterSeconds2 >= 0 ? { retryAfterSeconds: retryAfterSeconds2 } : {},
-    ...retryStrategy === "new_idempotency_key" ? { retryStrategy } : {},
+    ...["new_idempotency_key", "same_run_recovery"].includes(String(retryStrategy)) ? { retryStrategy } : {},
     ...creditsUsed === 0 ? { creditsUsed: 0 } : {},
     ...creditsCharged === 0 ? { creditsCharged: 0 } : {},
+    ...liveProviderCalled === false ? { liveProviderCalled: false } : {},
+    ...estimatedExternalCostUsd === 0 ? { estimatedExternalCostUsd: 0 } : {},
     ...typeof runId === "string" && runId.trim() ? { runId: runId.trim() } : {},
     ...typeof verificationRunId === "string" && verificationRunId.trim() ? { verificationRunId: verificationRunId.trim() } : {},
     ...typeof jobId === "string" && jobId.trim() ? { jobId: jobId.trim() } : {},
-    ...typeof suggestedAction === "string" && suggestedAction.trim() ? { suggestedAction: suggestedAction.trim() } : {}
+    ...typeof suggestedAction === "string" && suggestedAction.trim() ? { suggestedAction: suggestedAction.trim() } : {},
+    ...raw?.do_not_auto_resubmit === true ? { doNotAutoResubmit: true } : {},
+    ...raw?.recovery_mode === "same_run" ? { recoveryMode: "same_run" } : {},
+    ...["pending", "completed"].includes(String(raw?.recovery_status)) ? { recoveryStatus: raw?.recovery_status } : {}
   };
 }
 function recoverableJobRowFailed(row) {
@@ -1519,6 +1581,14 @@ function findEmailRequestBody(params) {
     idempotency_key: params.idempotencyKey
   });
 }
+function hasFindEmailRequestIdentity(request) {
+  return typeof request.run_id === "string" && request.run_id.trim().length > 0 || hasFindEmailIdentity(request);
+}
+function assertFindEmailRequestIdentity(request) {
+  if (!hasFindEmailRequestIdentity(request)) {
+    throw new TypeError(`Find Email requires a valid identity. ${FIND_EMAIL_IDENTITY_REQUIREMENT}`);
+  }
+}
 function verifyEmailBatchRequestBody(input, options) {
   if (typeof input === "string") {
     return compact({ email: input, skip_cache: options?.skipCache });
@@ -1597,6 +1667,7 @@ function normalizeFindEmailResult(data) {
     verificationObservedAt: typeof data.verification_observed_at === "string" ? data.verification_observed_at : void 0,
     failureReason: data.failure_reason ?? (failed || !found ? "no_verified_email_found" : "none"),
     creditsUsed: data.credits_used ?? billingMetadata?.credits_used,
+    creditsCharged: data.credits_charged ?? billingMetadata?.credits_charged,
     estimatedExternalCostUsd: data.estimated_external_cost_usd ?? billingMetadata?.estimated_external_cost_usd,
     billingMetadata,
     historicalBillingMetadata: data.historical_billing_metadata,
@@ -1615,6 +1686,11 @@ function normalizeFindEmailResult(data) {
     runId: data.run_id,
     nextPollAfterSeconds: data.next_poll_after_seconds,
     suggestedAction: data.suggested_action,
+    retryEligible: data.retry_eligible,
+    retryStrategy: ["new_idempotency_key", "same_run_recovery"].includes(data.retry_strategy) ? data.retry_strategy : void 0,
+    doNotAutoResubmit: data.do_not_auto_resubmit === true,
+    recoveryMode: data.recovery_mode === "same_run" ? "same_run" : void 0,
+    recoveryStatus: ["pending", "completed"].includes(String(data.recovery_status)) ? data.recovery_status : void 0,
     cachePublicationStatus: data.cache_publication_status,
     cachePublicationRetryEligible: data.cache_publication_retry_eligible,
     raw: data
@@ -1942,6 +2018,16 @@ function normalizeSignalDiscoverySignal(value) {
   if (!companyName || !companyDomain) {
     throw new Error("Signals Everything response violated the company attribution contract.");
   }
+  const eventDate = String(signal.event_date ?? signal.date ?? signal.signal_date ?? "").trim();
+  const sourceUrl = String(signal.source_url ?? signal.url ?? "").trim();
+  const evidence = Array.isArray(signal.evidence) ? signal.evidence.map((item) => ({
+    url: String(item?.url ?? "").trim(),
+    publishedAt: String(item?.published_at ?? item?.publishedAt ?? "").trim(),
+    source: String(item?.source ?? "").trim()
+  })).filter((item) => Boolean(item.url)) : [];
+  if (!eventDate || !sourceUrl || !evidence.some((item) => item.url === sourceUrl && item.publishedAt === eventDate)) {
+    throw new Error("Signals Everything response violated the dated-evidence and source-URL contract.");
+  }
   return {
     id: signal.id,
     company: {
@@ -1952,16 +2038,12 @@ function normalizeSignalDiscoverySignal(value) {
     title: signal.title ?? "",
     type: signal.type ?? signal.signal_type ?? "unknown",
     summary: signal.summary ?? signal.content ?? signal.description ?? "",
-    eventDate: signal.event_date ?? signal.date ?? signal.signal_date ?? null,
-    evidence: Array.isArray(signal.evidence) ? signal.evidence.map((item) => ({
-      url: String(item?.url ?? ""),
-      publishedAt: String(item?.published_at ?? item?.publishedAt ?? ""),
-      source: String(item?.source ?? "")
-    })).filter((item) => Boolean(item.url)) : [],
+    eventDate,
+    evidence,
     content: signal.summary ?? signal.content ?? signal.description ?? "",
     date: signal.event_date ?? signal.date ?? signal.signal_date ?? null,
     detectedAt: signal.event_date ?? signal.detected_at ?? null,
-    sourceUrl: signal.source_url ?? signal.url ?? null,
+    sourceUrl,
     sourceType: signal.source_type ?? null,
     confidence: signal.confidence ?? signal.confidence_score ?? null,
     classification: signal.signal_classification ?? signal.classification ?? null,

package/dist/mcp-config.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/sdk",
-  "version": "1.0.64",
+  "version": "1.0.66",
   "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",
@@ -15,7 +15,7 @@
   "scripts": {
     "generate-types": "tsx scripts/generate-types.ts",
     "build": "npm run generate-types && tsup src/index.ts src/mcp-config.ts --format cjs,esm --dts --clean",
-    "test": "tsx tests/core-products.test.ts",
+    "test": "tsx tests/core-products.test.ts && tsc --noEmit --strict --skipLibCheck --moduleResolution node --module esnext --target es2020 tests/find-email-types.test.ts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [