@signaliz/sdk 1.0.25 → 1.0.27

package/README.md

@@ -36,6 +36,9 @@ const signals = await signaliz.enrichCompanySignals({
   companyDomain: 'example.com',
   researchPrompt: 'expansion priorities',
 });
+// Audit normalized evidence provenance without reaching into `raw`.
+console.log(signals.signals[0].evidencePublishedDate);
+console.log(signals.signals[0].signalFeedSource, signals.signals[0].derived);
 
 // Persist a no-wait run ID and resume it later without duplicate spend.
 const queuedSignals = await signaliz.enrichCompanySignals({
@@ -83,5 +86,8 @@ normally finishes within an agent turn; set `skipCache` or `enableDeepSearch`
 only when fresh or deeper research is required.
 Unclassified evidence is returned by signal enrichment but is not used to
 generate outreach copy.
+Each normalized signal also exposes `datePrecision`, `sourceProvenance`,
+`entityConfidence`, `classification`, `derived`, `evidencePublishedDate`,
+`signalFeedSource`, and the provider `metadata` needed for integrity audits.
 
 `listTools()` and `health()` are connection helpers, not additional products.

package/dist/{chunk-EHNGI3N2.mjs → chunk-TQZFKFPI.mjs}

@@ -364,15 +364,17 @@ var Signaliz = class {
     }));
     const email = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
     const found = Boolean(email) && data.found !== false;
+    const verificationStatus = data.verification_status ?? data.status ?? "unknown";
+    const verified = data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase());
     return {
       success: data.success !== false && found,
       found,
       email,
       firstName: data.first_name,
       lastName: data.last_name,
-      confidence: data.confidence ?? data.confidence_score ?? 0,
-      verificationStatus: data.verification_status ?? data.status ?? "unknown",
-      providerUsed: data.provider_used ?? data.provider ?? data.source ?? "unknown",
+      confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
+      verificationStatus,
+      providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
       error: found ? void 0 : data.error ?? "No verified email found",
       errorCode: found ? void 0 : data.error_code ?? "EMAIL_NOT_FOUND",
       raw: data
@@ -457,16 +459,30 @@ var Signaliz = class {
         name: data.company?.name ?? params.companyName ?? null,
         domain: data.company?.domain ?? params.companyDomain ?? null
       },
-      signals: (data.signals ?? []).map((signal) => ({
-        id: signal.id,
-        title: signal.title ?? "",
-        type: signal.type ?? signal.signal_type ?? "unknown",
-        content: signal.content ?? signal.description ?? "",
-        date: signal.date ?? signal.detected_at ?? null,
-        sourceUrl: signal.source_url ?? signal.url ?? null,
-        sourceType: signal.source_type,
-        confidence: signal.confidence ?? signal.confidence_score ?? null
-      })),
+      signals: (data.signals ?? []).map((signal) => {
+        const metadata = signal.metadata && typeof signal.metadata === "object" && !Array.isArray(signal.metadata) ? signal.metadata : void 0;
+        return {
+          id: signal.id,
+          title: signal.title ?? "",
+          type: signal.type ?? signal.signal_type ?? "unknown",
+          content: signal.content ?? signal.description ?? "",
+          date: signal.date ?? signal.detected_at ?? null,
+          datePrecision: signal.date_precision,
+          sourceUrl: signal.source_url ?? signal.url ?? null,
+          sourceType: signal.source_type,
+          sourceProvenance: signal.source_provenance,
+          confidence: signal.confidence ?? signal.confidence_score ?? null,
+          entityConfidence: signal.entity_confidence ?? metadata?.entity_confidence ?? null,
+          signalFamily: signal.signal_family,
+          eventType: signal.signal_event_type,
+          eventLabel: signal.signal_event_label,
+          classification: signal.signal_classification ?? null,
+          derived: signal.derived === true,
+          evidencePublishedDate: signal.evidence_published_date ?? metadata?.evidence_published_date ?? null,
+          signalFeedSource: signal.signal_feed_source ?? metadata?.signal_feed_source,
+          metadata
+        };
+      }),
       signalCount: data.signal_count ?? data.total_signals ?? data.signals?.length ?? 0,
       intelligence: data.intelligence ?? null,
       credits: data.credits,

package/dist/index.d.mts

@@ -97,9 +97,20 @@ interface CompanySignal {
     type: string;
     content: string;
     date?: string | null;
+    datePrecision?: string;
     sourceUrl?: string | null;
     sourceType?: string;
+    sourceProvenance?: string;
     confidence?: number | null;
+    entityConfidence?: number | null;
+    signalFamily?: string;
+    eventType?: string;
+    eventLabel?: string;
+    classification?: Record<string, unknown> | string | null;
+    derived?: boolean;
+    evidencePublishedDate?: string | null;
+    signalFeedSource?: string;
+    metadata?: Record<string, unknown>;
 }
 interface CompanySignalEnrichmentResult {
     success: boolean;

package/dist/index.d.ts

@@ -97,9 +97,20 @@ interface CompanySignal {
     type: string;
     content: string;
     date?: string | null;
+    datePrecision?: string;
     sourceUrl?: string | null;
     sourceType?: string;
+    sourceProvenance?: string;
     confidence?: number | null;
+    entityConfidence?: number | null;
+    signalFamily?: string;
+    eventType?: string;
+    eventLabel?: string;
+    classification?: Record<string, unknown> | string | null;
+    derived?: boolean;
+    evidencePublishedDate?: string | null;
+    signalFeedSource?: string;
+    metadata?: Record<string, unknown>;
 }
 interface CompanySignalEnrichmentResult {
     success: boolean;

package/dist/index.js

@@ -391,15 +391,17 @@ var Signaliz = class {
     }));
     const email = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
     const found = Boolean(email) && data.found !== false;
+    const verificationStatus = data.verification_status ?? data.status ?? "unknown";
+    const verified = data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase());
     return {
       success: data.success !== false && found,
       found,
       email,
       firstName: data.first_name,
       lastName: data.last_name,
-      confidence: data.confidence ?? data.confidence_score ?? 0,
-      verificationStatus: data.verification_status ?? data.status ?? "unknown",
-      providerUsed: data.provider_used ?? data.provider ?? data.source ?? "unknown",
+      confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
+      verificationStatus,
+      providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
       error: found ? void 0 : data.error ?? "No verified email found",
       errorCode: found ? void 0 : data.error_code ?? "EMAIL_NOT_FOUND",
       raw: data
@@ -484,16 +486,30 @@ var Signaliz = class {
         name: data.company?.name ?? params.companyName ?? null,
         domain: data.company?.domain ?? params.companyDomain ?? null
       },
-      signals: (data.signals ?? []).map((signal) => ({
-        id: signal.id,
-        title: signal.title ?? "",
-        type: signal.type ?? signal.signal_type ?? "unknown",
-        content: signal.content ?? signal.description ?? "",
-        date: signal.date ?? signal.detected_at ?? null,
-        sourceUrl: signal.source_url ?? signal.url ?? null,
-        sourceType: signal.source_type,
-        confidence: signal.confidence ?? signal.confidence_score ?? null
-      })),
+      signals: (data.signals ?? []).map((signal) => {
+        const metadata = signal.metadata && typeof signal.metadata === "object" && !Array.isArray(signal.metadata) ? signal.metadata : void 0;
+        return {
+          id: signal.id,
+          title: signal.title ?? "",
+          type: signal.type ?? signal.signal_type ?? "unknown",
+          content: signal.content ?? signal.description ?? "",
+          date: signal.date ?? signal.detected_at ?? null,
+          datePrecision: signal.date_precision,
+          sourceUrl: signal.source_url ?? signal.url ?? null,
+          sourceType: signal.source_type,
+          sourceProvenance: signal.source_provenance,
+          confidence: signal.confidence ?? signal.confidence_score ?? null,
+          entityConfidence: signal.entity_confidence ?? metadata?.entity_confidence ?? null,
+          signalFamily: signal.signal_family,
+          eventType: signal.signal_event_type,
+          eventLabel: signal.signal_event_label,
+          classification: signal.signal_classification ?? null,
+          derived: signal.derived === true,
+          evidencePublishedDate: signal.evidence_published_date ?? metadata?.evidence_published_date ?? null,
+          signalFeedSource: signal.signal_feed_source ?? metadata?.signal_feed_source,
+          metadata
+        };
+      }),
       signalCount: data.signal_count ?? data.total_signals ?? data.signals?.length ?? 0,
       intelligence: data.intelligence ?? null,
       credits: data.credits,

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -395,15 +395,17 @@ var Signaliz = class {
     }));
     const email = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
     const found = Boolean(email) && data.found !== false;
+    const verificationStatus = data.verification_status ?? data.status ?? "unknown";
+    const verified = data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase());
     return {
       success: data.success !== false && found,
       found,
       email,
       firstName: data.first_name,
       lastName: data.last_name,
-      confidence: data.confidence ?? data.confidence_score ?? 0,
-      verificationStatus: data.verification_status ?? data.status ?? "unknown",
-      providerUsed: data.provider_used ?? data.provider ?? data.source ?? "unknown",
+      confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
+      verificationStatus,
+      providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
       error: found ? void 0 : data.error ?? "No verified email found",
       errorCode: found ? void 0 : data.error_code ?? "EMAIL_NOT_FOUND",
       raw: data
@@ -488,16 +490,30 @@ var Signaliz = class {
         name: data.company?.name ?? params.companyName ?? null,
         domain: data.company?.domain ?? params.companyDomain ?? null
       },
-      signals: (data.signals ?? []).map((signal) => ({
-        id: signal.id,
-        title: signal.title ?? "",
-        type: signal.type ?? signal.signal_type ?? "unknown",
-        content: signal.content ?? signal.description ?? "",
-        date: signal.date ?? signal.detected_at ?? null,
-        sourceUrl: signal.source_url ?? signal.url ?? null,
-        sourceType: signal.source_type,
-        confidence: signal.confidence ?? signal.confidence_score ?? null
-      })),
+      signals: (data.signals ?? []).map((signal) => {
+        const metadata = signal.metadata && typeof signal.metadata === "object" && !Array.isArray(signal.metadata) ? signal.metadata : void 0;
+        return {
+          id: signal.id,
+          title: signal.title ?? "",
+          type: signal.type ?? signal.signal_type ?? "unknown",
+          content: signal.content ?? signal.description ?? "",
+          date: signal.date ?? signal.detected_at ?? null,
+          datePrecision: signal.date_precision,
+          sourceUrl: signal.source_url ?? signal.url ?? null,
+          sourceType: signal.source_type,
+          sourceProvenance: signal.source_provenance,
+          confidence: signal.confidence ?? signal.confidence_score ?? null,
+          entityConfidence: signal.entity_confidence ?? metadata?.entity_confidence ?? null,
+          signalFamily: signal.signal_family,
+          eventType: signal.signal_event_type,
+          eventLabel: signal.signal_event_label,
+          classification: signal.signal_classification ?? null,
+          derived: signal.derived === true,
+          evidencePublishedDate: signal.evidence_published_date ?? metadata?.evidence_published_date ?? null,
+          signalFeedSource: signal.signal_feed_source ?? metadata?.signal_feed_source,
+          metadata
+        };
+      }),
       signalCount: data.signal_count ?? data.total_signals ?? data.signals?.length ?? 0,
       intelligence: data.intelligence ?? null,
       credits: data.credits,

package/dist/mcp-config.mjs

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

package/package.json

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