@signaliz/sdk 1.0.53 → 1.0.55

package/README.md

@@ -1,6 +1,6 @@
 # @signaliz/sdk
 
-Typed JavaScript/TypeScript access to the four Signaliz products.
+Typed JavaScript/TypeScript access to all five core products in Signaliz.
 
 ```bash
 npm install @signaliz/sdk
@@ -12,6 +12,7 @@ Production REST endpoints:
 - `https://api.signaliz.com/functions/v1/api/v1/verify-email`
 - `https://api.signaliz.com/functions/v1/api/v1/company-signals`
 - `https://api.signaliz.com/functions/v1/api/v1/signal-to-copy`
+- `https://api.signaliz.com/functions/v1/api/v1/signals`
 
 ```ts
 import { Signaliz } from '@signaliz/sdk';
@@ -59,6 +60,19 @@ const signals = await signaliz.enrichCompanySignals({
 console.log(signals.signals[0].evidencePublishedDate);
 console.log(signals.signals[0].signalFeedSource, signals.signals[0].derived);
 
+// Query-first discovery returns distinct companies with dated source evidence.
+// The first response is usually queued; resume only the returned run ID.
+const signalDiscovery = await signaliz.discoverSignals({
+  query: 'companies that just got funded',
+  limit: 100,
+  sources: ['web', 'news'],
+});
+const completedDiscovery = signalDiscovery.signalSearchRunId
+  ? await signaliz.discoverSignals({ signalSearchRunId: signalDiscovery.signalSearchRunId })
+  : signalDiscovery;
+console.log(completedDiscovery.signals[0]?.company.domain);
+console.log(completedDiscovery.costGuardrail?.costPerQualifiedSignalUsd);
+
 const copy = await signaliz.signalToCopy({
   companyDomain: 'example.com',
   personName: 'Jane Doe',
@@ -74,7 +88,7 @@ const copy = await signaliz.signalToCopy({
 // methods return complete data or throw a terminal error in this same call.
 ```
 
-All four products support bounded batch execution over the same REST endpoints.
+The four row-oriented products support bounded batch execution over the same REST endpoints.
 Results stay in input order, failures are isolated per item, and concurrency is
 limited to `1-50` (default `10`):
 
@@ -100,7 +114,7 @@ For an ambiguous single request or batch submission failure, retry with the
 same `idempotencyKey` to recover the original request or durable job without duplicate
 work.
 
-Each batch accepts up to 5,000 items. For all four core products, batches larger
+Each batch accepts up to 5,000 items. For the four row-oriented core products, batches larger
 than 25 use one recoverable REST job; the SDK waits for completion and retrieves
 every result page before returning, so callers never receive queued work or
 polling instructions. Find Email, Verify Email, and Signal to Copy use 500-row
@@ -117,6 +131,16 @@ explicitly requests `skipCache` or `enableDeepSearch`, the SDK preserves that
 fresh-research behavior by using synchronous client-side chunks of at most 25.
 Signal to Copy also shares company research across copy recipients.
 
+Signals Everything is query-first rather than a row batch. It defaults to 100
+distinct companies and supports up to 1,000. Every returned signal contains a
+company name, company domain, dated evidence, and a source URL. The typed
+`costGuardrail` reports both projected and observed source acquisition cost;
+Signaliz returns signals only when cost stays strictly below $0.01 per qualified
+company. A request is a ceiling, not a promise: it can return fewer results
+when public evidence cannot verify both a date and company identity. It is
+included on Team and Agency plans and can be resumed with
+`signalSearchRunId` without duplicate source acquisition.
+
 Company Signal Enrichment defaults `online` and `enableDeepSearch` to `true`
 unless the caller explicitly disables them. Its `searchMode` defaults to
 `balanced`; use `fast` for the primary low-latency search lane only or

package/dist/{chunk-MC7EZ3BP.mjs → chunk-QXMVHZIQ.mjs}

@@ -468,6 +468,14 @@ var Signaliz = class {
     assertTerminalSignalResponse(data, "Company Signals");
     return normalizeCompanySignalResult(params, data);
   }
+  async discoverSignals(params) {
+    validateSignalDiscoveryParams(params);
+    const data = await this.client.post(
+      "api/v1/signals",
+      signalDiscoveryRequestBody(params)
+    );
+    return normalizeSignalDiscoveryResult(params, data);
+  }
   async enrichCompanies(companies, options) {
     validateBatchSize(companies);
     companies.forEach((params) => validateCoreProductMaxWaitMs(params.maxWaitMs));
@@ -1020,6 +1028,145 @@ function normalizeCompanySignalResult(params, data) {
     raw: data
   };
 }
+var SIGNAL_DISCOVERY_SOURCES = /* @__PURE__ */ new Set(["web", "news"]);
+var SIGNAL_DISCOVERY_STATUSES = /* @__PURE__ */ new Set([
+  "planned",
+  "queued",
+  "processing",
+  "completed",
+  "completed_with_warnings",
+  "failed"
+]);
+function validateSignalDiscoveryParams(params) {
+  const runId = typeof params.signalSearchRunId === "string" ? params.signalSearchRunId.trim() : "";
+  const query = typeof params.query === "string" ? params.query.trim() : "";
+  if (!runId && !query) {
+    throw new TypeError("Signals Everything requires query or signalSearchRunId");
+  }
+  if (query && (query.length < 2 || query.length > 2e3)) {
+    throw new RangeError("query must contain between 2 and 2000 characters");
+  }
+  if (params.limit !== void 0 && (!Number.isInteger(params.limit) || params.limit < 1 || params.limit > 1e3)) {
+    throw new RangeError("limit must be an integer between 1 and 1000");
+  }
+  if (params.lookbackDays !== void 0 && (!Number.isInteger(params.lookbackDays) || params.lookbackDays < 1 || params.lookbackDays > 365)) {
+    throw new RangeError("lookbackDays must be an integer between 1 and 365");
+  }
+  if (params.sources !== void 0 && (!Array.isArray(params.sources) || params.sources.length < 1 || params.sources.length > 2 || params.sources.some((source) => !SIGNAL_DISCOVERY_SOURCES.has(source)))) {
+    throw new TypeError("sources must contain only web or news");
+  }
+}
+function signalDiscoveryRequestBody(params) {
+  const runId = typeof params.signalSearchRunId === "string" ? params.signalSearchRunId.trim() : "";
+  if (runId) {
+    return compact({
+      signal_search_run_id: runId,
+      // An explicit limit expands or narrows the retained qualified cohort;
+      // omitting it preserves the original preview size.
+      limit: params.limit,
+      dry_run: params.dryRun,
+      idempotency_key: params.idempotencyKey
+    });
+  }
+  return compact({
+    query: params.query?.trim(),
+    limit: params.limit ?? 100,
+    sources: params.sources,
+    lookback_days: params.lookbackDays,
+    dry_run: params.dryRun,
+    idempotency_key: params.idempotencyKey
+  });
+}
+function normalizeSignalDiscoveryResult(params, data) {
+  const rawSignals = Array.isArray(data.signals) ? data.signals : [];
+  const rawStatus = String(data.status || "").toLowerCase();
+  const status = SIGNAL_DISCOVERY_STATUSES.has(rawStatus) ? rawStatus : rawSignals.length > 0 ? "completed" : "failed";
+  const signals = rawSignals.map(normalizeSignalDiscoverySignal);
+  return {
+    success: data.success !== false,
+    status,
+    capability: "signals_everything",
+    signalSearchRunId: String(data.signal_search_run_id ?? params.signalSearchRunId ?? ""),
+    query: String(data.query ?? params.query ?? ""),
+    requestedCount: Number(data.requested_count ?? params.limit ?? 100),
+    nextPollAfterSeconds: typeof data.next_poll_after_seconds === "number" ? data.next_poll_after_seconds : void 0,
+    signals,
+    signalCount: signals.length,
+    availableCompanySignalCount: Number.isFinite(Number(data.available_company_signal_count)) ? Number(data.available_company_signal_count) : void 0,
+    sourceLanes: Array.isArray(data.source_lanes) ? data.source_lanes.filter((lane) => typeof lane === "string") : void 0,
+    evidenceValidation: data.evidence_validation && typeof data.evidence_validation === "object" ? data.evidence_validation : void 0,
+    costGuardrail: normalizeSignalDiscoveryCostGuardrail(data.cost_guardrail),
+    warnings: Array.isArray(data.warnings) ? data.warnings.filter((warning) => typeof warning === "string") : void 0,
+    raw: data
+  };
+}
+function normalizeSignalDiscoveryCostGuardrail(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const guardrail = value;
+  const maxCost = Number(guardrail.max_cost_per_qualified_signal_usd);
+  const withinLimit = guardrail.within_limit === true;
+  if (!Number.isFinite(maxCost)) return void 0;
+  const numberOrNullable = (candidate) => {
+    if (candidate === null) return null;
+    const numeric = Number(candidate);
+    return Number.isFinite(numeric) ? numeric : void 0;
+  };
+  const numberOrUndefined = (candidate) => {
+    const numeric = Number(candidate);
+    return Number.isFinite(numeric) ? numeric : void 0;
+  };
+  return {
+    maxCostPerQualifiedSignalUsd: maxCost,
+    projectedSourceCostUsd: numberOrNullable(guardrail.projected_source_cost_usd),
+    maxSourceCostUsd: numberOrNullable(guardrail.max_source_cost_usd),
+    projectedCostPerRequestedCompanySignalUsd: numberOrNullable(
+      guardrail.projected_cost_per_requested_company_signal_usd
+    ),
+    sourceCostUsd: numberOrNullable(guardrail.source_cost_usd),
+    costSource: ["observed", "catalog_bounded", "mixed", "unavailable"].includes(String(guardrail.cost_source)) ? String(guardrail.cost_source) : void 0,
+    qualifiedCompanySignalCount: numberOrUndefined(guardrail.qualified_company_signal_count),
+    returnedCompanySignalCount: numberOrUndefined(guardrail.returned_company_signal_count),
+    availableCompanySignalCount: numberOrUndefined(guardrail.available_company_signal_count),
+    acquisitionCandidateLimit: numberOrUndefined(guardrail.acquisition_candidate_limit),
+    minimumQualifiedCompanySignals: numberOrUndefined(guardrail.minimum_qualified_company_signals),
+    costPerQualifiedSignalUsd: numberOrNullable(guardrail.cost_per_qualified_signal_usd),
+    withinLimit
+  };
+}
+function normalizeSignalDiscoverySignal(value) {
+  const signal = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  const company = signal.company && typeof signal.company === "object" && !Array.isArray(signal.company) ? signal.company : {};
+  const companyName = String(company.name ?? signal.company_name ?? "").trim();
+  const companyDomain = String(company.domain ?? signal.company_domain ?? "").trim();
+  if (!companyName || !companyDomain) {
+    throw new Error("Signals Everything response violated the company attribution contract.");
+  }
+  return {
+    id: signal.id,
+    company: {
+      name: companyName,
+      domain: companyDomain,
+      linkedinUrl: company.linkedin_url ?? signal.company_linkedin_url ?? void 0
+    },
+    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)) : [],
+    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,
+    sourceType: signal.source_type ?? null,
+    confidence: signal.confidence ?? signal.confidence_score ?? null,
+    classification: signal.signal_classification ?? signal.classification ?? null,
+    raw: signal
+  };
+}
 function validateBatchSize(items) {
   if (!Array.isArray(items) || items.length === 0) {
     throw new Error("Signaliz batch requests require at least one item");

package/dist/index.d.mts

@@ -219,6 +219,89 @@ interface CompanySignalEnrichmentResult {
     evidenceScope?: 'selected_signals' | 'all_candidates';
     raw: Record<string, unknown>;
 }
+type SignalDiscoverySource = 'web' | 'news';
+type SignalDiscoveryStatus = 'planned' | 'queued' | 'processing' | 'completed' | 'completed_with_warnings' | 'failed';
+interface SignalDiscoveryParams {
+    /** Natural-language description of the signals to find. Required for a new search. */
+    query?: string;
+    /** Number of qualified company signals requested. Defaults to 100; allowed range is 1-1,000. */
+    limit?: number;
+    /** Restrict discovery to selected source families. */
+    sources?: SignalDiscoverySource[];
+    /** Maximum signal age in days. Allowed range is 1-365. */
+    lookbackDays?: number;
+    /** Resume an existing asynchronous discovery run without starting another search. */
+    signalSearchRunId?: string;
+    /** Stable retry key for recovering the same search after an ambiguous response. */
+    idempotencyKey?: string;
+    /** Return a no-dispatch plan without provider calls or jobs. */
+    dryRun?: boolean;
+}
+interface SignalDiscoverySignal {
+    id?: string;
+    company: {
+        /** Every returned discovery signal is attributed to a distinct company. */
+        name: string;
+        domain: string;
+        linkedinUrl?: string | null;
+    };
+    title: string;
+    type: string;
+    summary: string;
+    eventDate?: string | null;
+    evidence: Array<{
+        url: string;
+        publishedAt: string;
+        source: string;
+    }>;
+    /** Compatibility alias for summary. */
+    content: string;
+    /** Compatibility alias for eventDate. */
+    date?: string | null;
+    detectedAt?: string | null;
+    sourceUrl?: string | null;
+    sourceType?: string | null;
+    confidence?: number | null;
+    classification?: Record<string, unknown> | string | null;
+    raw: Record<string, unknown>;
+}
+interface SignalDiscoveryCostGuardrail {
+    /** Strict ceiling: a qualified company signal must cost less than this amount to return. */
+    maxCostPerQualifiedSignalUsd: number;
+    projectedSourceCostUsd?: number | null;
+    maxSourceCostUsd?: number | null;
+    projectedCostPerRequestedCompanySignalUsd?: number | null;
+    sourceCostUsd?: number | null;
+    costSource?: 'observed' | 'catalog_bounded' | 'mixed' | 'unavailable';
+    qualifiedCompanySignalCount?: number;
+    returnedCompanySignalCount?: number;
+    /** Qualified signals retained on the same search run for later expansion. */
+    availableCompanySignalCount?: number;
+    /** Raw source candidate ceiling per selected source lane used to form the cohort. */
+    acquisitionCandidateLimit?: number;
+    /** Minimum qualified companies needed for the source receipt to stay below one cent each. */
+    minimumQualifiedCompanySignals?: number;
+    costPerQualifiedSignalUsd?: number | null;
+    withinLimit: boolean;
+}
+interface SignalDiscoveryResult {
+    success: boolean;
+    status: SignalDiscoveryStatus;
+    capability: 'signals_everything';
+    signalSearchRunId: string;
+    query: string;
+    requestedCount: number;
+    nextPollAfterSeconds?: number;
+    signals: SignalDiscoverySignal[];
+    signalCount: number;
+    /** Number of qualified company signals retained on signalSearchRunId. */
+    availableCompanySignalCount?: number;
+    sourceLanes?: string[];
+    evidenceValidation?: Record<string, unknown>;
+    costGuardrail?: SignalDiscoveryCostGuardrail;
+    warnings?: string[];
+    raw: Record<string, unknown>;
+}
 interface SignalToCopyParams {
     companyDomain?: string;
     personName?: string;
@@ -310,6 +393,7 @@ declare class Signaliz {
         dryRun: true;
     }): Promise<CoreProductDryRunResult>;
     enrichCompanySignals(params: CompanySignalEnrichmentParams): Promise<CompanySignalEnrichmentResult>;
+    discoverSignals(params: SignalDiscoveryParams): Promise<SignalDiscoveryResult>;
     enrichCompanies(companies: CompanySignalEnrichmentParams[], options: BatchOptions & {
         dryRun: true;
     }): Promise<CoreProductDryRunResult>;
@@ -331,4 +415,4 @@ declare class Signaliz {
     health(): Promise<PlatformHealth>;
 }
 
-export { type BatchItemResult, type BatchOptions, type BatchResult, type CompanySignal, type CompanySignalEnrichmentParams, type CompanySignalEnrichmentResult, type ErrorType, type FindEmailParams, type FindEmailResult, type MCPToolInfo, type PlatformHealth, type SignalToCopyParams, type SignalToCopyResult, type SignalToCopyVariation, Signaliz, type SignalizConfig, SignalizError, type SignalizErrorData, type VerifyEmailBatchOptions, type VerifyEmailOptions, type VerifyEmailResult };
+export { type BatchItemResult, type BatchOptions, type BatchResult, type CompanySignal, type CompanySignalEnrichmentParams, type CompanySignalEnrichmentResult, type ErrorType, type FindEmailParams, type FindEmailResult, type MCPToolInfo, type PlatformHealth, type SignalDiscoveryParams, type SignalDiscoveryResult, type SignalDiscoverySignal, type SignalDiscoverySource, type SignalDiscoveryStatus, type SignalToCopyParams, type SignalToCopyResult, type SignalToCopyVariation, Signaliz, type SignalizConfig, SignalizError, type SignalizErrorData, type VerifyEmailBatchOptions, type VerifyEmailOptions, type VerifyEmailResult };

package/dist/index.d.ts

@@ -219,6 +219,89 @@ interface CompanySignalEnrichmentResult {
     evidenceScope?: 'selected_signals' | 'all_candidates';
     raw: Record<string, unknown>;
 }
+type SignalDiscoverySource = 'web' | 'news';
+type SignalDiscoveryStatus = 'planned' | 'queued' | 'processing' | 'completed' | 'completed_with_warnings' | 'failed';
+interface SignalDiscoveryParams {
+    /** Natural-language description of the signals to find. Required for a new search. */
+    query?: string;
+    /** Number of qualified company signals requested. Defaults to 100; allowed range is 1-1,000. */
+    limit?: number;
+    /** Restrict discovery to selected source families. */
+    sources?: SignalDiscoverySource[];
+    /** Maximum signal age in days. Allowed range is 1-365. */
+    lookbackDays?: number;
+    /** Resume an existing asynchronous discovery run without starting another search. */
+    signalSearchRunId?: string;
+    /** Stable retry key for recovering the same search after an ambiguous response. */
+    idempotencyKey?: string;
+    /** Return a no-dispatch plan without provider calls or jobs. */
+    dryRun?: boolean;
+}
+interface SignalDiscoverySignal {
+    id?: string;
+    company: {
+        /** Every returned discovery signal is attributed to a distinct company. */
+        name: string;
+        domain: string;
+        linkedinUrl?: string | null;
+    };
+    title: string;
+    type: string;
+    summary: string;
+    eventDate?: string | null;
+    evidence: Array<{
+        url: string;
+        publishedAt: string;
+        source: string;
+    }>;
+    /** Compatibility alias for summary. */
+    content: string;
+    /** Compatibility alias for eventDate. */
+    date?: string | null;
+    detectedAt?: string | null;
+    sourceUrl?: string | null;
+    sourceType?: string | null;
+    confidence?: number | null;
+    classification?: Record<string, unknown> | string | null;
+    raw: Record<string, unknown>;
+}
+interface SignalDiscoveryCostGuardrail {
+    /** Strict ceiling: a qualified company signal must cost less than this amount to return. */
+    maxCostPerQualifiedSignalUsd: number;
+    projectedSourceCostUsd?: number | null;
+    maxSourceCostUsd?: number | null;
+    projectedCostPerRequestedCompanySignalUsd?: number | null;
+    sourceCostUsd?: number | null;
+    costSource?: 'observed' | 'catalog_bounded' | 'mixed' | 'unavailable';
+    qualifiedCompanySignalCount?: number;
+    returnedCompanySignalCount?: number;
+    /** Qualified signals retained on the same search run for later expansion. */
+    availableCompanySignalCount?: number;
+    /** Raw source candidate ceiling per selected source lane used to form the cohort. */
+    acquisitionCandidateLimit?: number;
+    /** Minimum qualified companies needed for the source receipt to stay below one cent each. */
+    minimumQualifiedCompanySignals?: number;
+    costPerQualifiedSignalUsd?: number | null;
+    withinLimit: boolean;
+}
+interface SignalDiscoveryResult {
+    success: boolean;
+    status: SignalDiscoveryStatus;
+    capability: 'signals_everything';
+    signalSearchRunId: string;
+    query: string;
+    requestedCount: number;
+    nextPollAfterSeconds?: number;
+    signals: SignalDiscoverySignal[];
+    signalCount: number;
+    /** Number of qualified company signals retained on signalSearchRunId. */
+    availableCompanySignalCount?: number;
+    sourceLanes?: string[];
+    evidenceValidation?: Record<string, unknown>;
+    costGuardrail?: SignalDiscoveryCostGuardrail;
+    warnings?: string[];
+    raw: Record<string, unknown>;
+}
 interface SignalToCopyParams {
     companyDomain?: string;
     personName?: string;
@@ -310,6 +393,7 @@ declare class Signaliz {
         dryRun: true;
     }): Promise<CoreProductDryRunResult>;
     enrichCompanySignals(params: CompanySignalEnrichmentParams): Promise<CompanySignalEnrichmentResult>;
+    discoverSignals(params: SignalDiscoveryParams): Promise<SignalDiscoveryResult>;
     enrichCompanies(companies: CompanySignalEnrichmentParams[], options: BatchOptions & {
         dryRun: true;
     }): Promise<CoreProductDryRunResult>;
@@ -331,4 +415,4 @@ declare class Signaliz {
     health(): Promise<PlatformHealth>;
 }
 
-export { type BatchItemResult, type BatchOptions, type BatchResult, type CompanySignal, type CompanySignalEnrichmentParams, type CompanySignalEnrichmentResult, type ErrorType, type FindEmailParams, type FindEmailResult, type MCPToolInfo, type PlatformHealth, type SignalToCopyParams, type SignalToCopyResult, type SignalToCopyVariation, Signaliz, type SignalizConfig, SignalizError, type SignalizErrorData, type VerifyEmailBatchOptions, type VerifyEmailOptions, type VerifyEmailResult };
+export { type BatchItemResult, type BatchOptions, type BatchResult, type CompanySignal, type CompanySignalEnrichmentParams, type CompanySignalEnrichmentResult, type ErrorType, type FindEmailParams, type FindEmailResult, type MCPToolInfo, type PlatformHealth, type SignalDiscoveryParams, type SignalDiscoveryResult, type SignalDiscoverySignal, type SignalDiscoverySource, type SignalDiscoveryStatus, type SignalToCopyParams, type SignalToCopyResult, type SignalToCopyVariation, Signaliz, type SignalizConfig, SignalizError, type SignalizErrorData, type VerifyEmailBatchOptions, type VerifyEmailOptions, type VerifyEmailResult };

package/dist/index.js

@@ -495,6 +495,14 @@ var Signaliz = class {
     assertTerminalSignalResponse(data, "Company Signals");
     return normalizeCompanySignalResult(params, data);
   }
+  async discoverSignals(params) {
+    validateSignalDiscoveryParams(params);
+    const data = await this.client.post(
+      "api/v1/signals",
+      signalDiscoveryRequestBody(params)
+    );
+    return normalizeSignalDiscoveryResult(params, data);
+  }
   async enrichCompanies(companies, options) {
     validateBatchSize(companies);
     companies.forEach((params) => validateCoreProductMaxWaitMs(params.maxWaitMs));
@@ -1047,6 +1055,145 @@ function normalizeCompanySignalResult(params, data) {
     raw: data
   };
 }
+var SIGNAL_DISCOVERY_SOURCES = /* @__PURE__ */ new Set(["web", "news"]);
+var SIGNAL_DISCOVERY_STATUSES = /* @__PURE__ */ new Set([
+  "planned",
+  "queued",
+  "processing",
+  "completed",
+  "completed_with_warnings",
+  "failed"
+]);
+function validateSignalDiscoveryParams(params) {
+  const runId = typeof params.signalSearchRunId === "string" ? params.signalSearchRunId.trim() : "";
+  const query = typeof params.query === "string" ? params.query.trim() : "";
+  if (!runId && !query) {
+    throw new TypeError("Signals Everything requires query or signalSearchRunId");
+  }
+  if (query && (query.length < 2 || query.length > 2e3)) {
+    throw new RangeError("query must contain between 2 and 2000 characters");
+  }
+  if (params.limit !== void 0 && (!Number.isInteger(params.limit) || params.limit < 1 || params.limit > 1e3)) {
+    throw new RangeError("limit must be an integer between 1 and 1000");
+  }
+  if (params.lookbackDays !== void 0 && (!Number.isInteger(params.lookbackDays) || params.lookbackDays < 1 || params.lookbackDays > 365)) {
+    throw new RangeError("lookbackDays must be an integer between 1 and 365");
+  }
+  if (params.sources !== void 0 && (!Array.isArray(params.sources) || params.sources.length < 1 || params.sources.length > 2 || params.sources.some((source) => !SIGNAL_DISCOVERY_SOURCES.has(source)))) {
+    throw new TypeError("sources must contain only web or news");
+  }
+}
+function signalDiscoveryRequestBody(params) {
+  const runId = typeof params.signalSearchRunId === "string" ? params.signalSearchRunId.trim() : "";
+  if (runId) {
+    return compact({
+      signal_search_run_id: runId,
+      // An explicit limit expands or narrows the retained qualified cohort;
+      // omitting it preserves the original preview size.
+      limit: params.limit,
+      dry_run: params.dryRun,
+      idempotency_key: params.idempotencyKey
+    });
+  }
+  return compact({
+    query: params.query?.trim(),
+    limit: params.limit ?? 100,
+    sources: params.sources,
+    lookback_days: params.lookbackDays,
+    dry_run: params.dryRun,
+    idempotency_key: params.idempotencyKey
+  });
+}
+function normalizeSignalDiscoveryResult(params, data) {
+  const rawSignals = Array.isArray(data.signals) ? data.signals : [];
+  const rawStatus = String(data.status || "").toLowerCase();
+  const status = SIGNAL_DISCOVERY_STATUSES.has(rawStatus) ? rawStatus : rawSignals.length > 0 ? "completed" : "failed";
+  const signals = rawSignals.map(normalizeSignalDiscoverySignal);
+  return {
+    success: data.success !== false,
+    status,
+    capability: "signals_everything",
+    signalSearchRunId: String(data.signal_search_run_id ?? params.signalSearchRunId ?? ""),
+    query: String(data.query ?? params.query ?? ""),
+    requestedCount: Number(data.requested_count ?? params.limit ?? 100),
+    nextPollAfterSeconds: typeof data.next_poll_after_seconds === "number" ? data.next_poll_after_seconds : void 0,
+    signals,
+    signalCount: signals.length,
+    availableCompanySignalCount: Number.isFinite(Number(data.available_company_signal_count)) ? Number(data.available_company_signal_count) : void 0,
+    sourceLanes: Array.isArray(data.source_lanes) ? data.source_lanes.filter((lane) => typeof lane === "string") : void 0,
+    evidenceValidation: data.evidence_validation && typeof data.evidence_validation === "object" ? data.evidence_validation : void 0,
+    costGuardrail: normalizeSignalDiscoveryCostGuardrail(data.cost_guardrail),
+    warnings: Array.isArray(data.warnings) ? data.warnings.filter((warning) => typeof warning === "string") : void 0,
+    raw: data
+  };
+}
+function normalizeSignalDiscoveryCostGuardrail(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const guardrail = value;
+  const maxCost = Number(guardrail.max_cost_per_qualified_signal_usd);
+  const withinLimit = guardrail.within_limit === true;
+  if (!Number.isFinite(maxCost)) return void 0;
+  const numberOrNullable = (candidate) => {
+    if (candidate === null) return null;
+    const numeric = Number(candidate);
+    return Number.isFinite(numeric) ? numeric : void 0;
+  };
+  const numberOrUndefined = (candidate) => {
+    const numeric = Number(candidate);
+    return Number.isFinite(numeric) ? numeric : void 0;
+  };
+  return {
+    maxCostPerQualifiedSignalUsd: maxCost,
+    projectedSourceCostUsd: numberOrNullable(guardrail.projected_source_cost_usd),
+    maxSourceCostUsd: numberOrNullable(guardrail.max_source_cost_usd),
+    projectedCostPerRequestedCompanySignalUsd: numberOrNullable(
+      guardrail.projected_cost_per_requested_company_signal_usd
+    ),
+    sourceCostUsd: numberOrNullable(guardrail.source_cost_usd),
+    costSource: ["observed", "catalog_bounded", "mixed", "unavailable"].includes(String(guardrail.cost_source)) ? String(guardrail.cost_source) : void 0,
+    qualifiedCompanySignalCount: numberOrUndefined(guardrail.qualified_company_signal_count),
+    returnedCompanySignalCount: numberOrUndefined(guardrail.returned_company_signal_count),
+    availableCompanySignalCount: numberOrUndefined(guardrail.available_company_signal_count),
+    acquisitionCandidateLimit: numberOrUndefined(guardrail.acquisition_candidate_limit),
+    minimumQualifiedCompanySignals: numberOrUndefined(guardrail.minimum_qualified_company_signals),
+    costPerQualifiedSignalUsd: numberOrNullable(guardrail.cost_per_qualified_signal_usd),
+    withinLimit
+  };
+}
+function normalizeSignalDiscoverySignal(value) {
+  const signal = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  const company = signal.company && typeof signal.company === "object" && !Array.isArray(signal.company) ? signal.company : {};
+  const companyName = String(company.name ?? signal.company_name ?? "").trim();
+  const companyDomain = String(company.domain ?? signal.company_domain ?? "").trim();
+  if (!companyName || !companyDomain) {
+    throw new Error("Signals Everything response violated the company attribution contract.");
+  }
+  return {
+    id: signal.id,
+    company: {
+      name: companyName,
+      domain: companyDomain,
+      linkedinUrl: company.linkedin_url ?? signal.company_linkedin_url ?? void 0
+    },
+    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)) : [],
+    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,
+    sourceType: signal.source_type ?? null,
+    confidence: signal.confidence ?? signal.confidence_score ?? null,
+    classification: signal.signal_classification ?? signal.classification ?? null,
+    raw: signal
+  };
+}
 function validateBatchSize(items) {
   if (!Array.isArray(items) || items.length === 0) {
     throw new Error("Signaliz batch requests require at least one item");

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -499,6 +499,14 @@ var Signaliz = class {
     assertTerminalSignalResponse(data, "Company Signals");
     return normalizeCompanySignalResult(params, data);
   }
+  async discoverSignals(params) {
+    validateSignalDiscoveryParams(params);
+    const data = await this.client.post(
+      "api/v1/signals",
+      signalDiscoveryRequestBody(params)
+    );
+    return normalizeSignalDiscoveryResult(params, data);
+  }
   async enrichCompanies(companies, options) {
     validateBatchSize(companies);
     companies.forEach((params) => validateCoreProductMaxWaitMs(params.maxWaitMs));
@@ -1051,6 +1059,145 @@ function normalizeCompanySignalResult(params, data) {
     raw: data
   };
 }
+var SIGNAL_DISCOVERY_SOURCES = /* @__PURE__ */ new Set(["web", "news"]);
+var SIGNAL_DISCOVERY_STATUSES = /* @__PURE__ */ new Set([
+  "planned",
+  "queued",
+  "processing",
+  "completed",
+  "completed_with_warnings",
+  "failed"
+]);
+function validateSignalDiscoveryParams(params) {
+  const runId = typeof params.signalSearchRunId === "string" ? params.signalSearchRunId.trim() : "";
+  const query = typeof params.query === "string" ? params.query.trim() : "";
+  if (!runId && !query) {
+    throw new TypeError("Signals Everything requires query or signalSearchRunId");
+  }
+  if (query && (query.length < 2 || query.length > 2e3)) {
+    throw new RangeError("query must contain between 2 and 2000 characters");
+  }
+  if (params.limit !== void 0 && (!Number.isInteger(params.limit) || params.limit < 1 || params.limit > 1e3)) {
+    throw new RangeError("limit must be an integer between 1 and 1000");
+  }
+  if (params.lookbackDays !== void 0 && (!Number.isInteger(params.lookbackDays) || params.lookbackDays < 1 || params.lookbackDays > 365)) {
+    throw new RangeError("lookbackDays must be an integer between 1 and 365");
+  }
+  if (params.sources !== void 0 && (!Array.isArray(params.sources) || params.sources.length < 1 || params.sources.length > 2 || params.sources.some((source) => !SIGNAL_DISCOVERY_SOURCES.has(source)))) {
+    throw new TypeError("sources must contain only web or news");
+  }
+}
+function signalDiscoveryRequestBody(params) {
+  const runId = typeof params.signalSearchRunId === "string" ? params.signalSearchRunId.trim() : "";
+  if (runId) {
+    return compact({
+      signal_search_run_id: runId,
+      // An explicit limit expands or narrows the retained qualified cohort;
+      // omitting it preserves the original preview size.
+      limit: params.limit,
+      dry_run: params.dryRun,
+      idempotency_key: params.idempotencyKey
+    });
+  }
+  return compact({
+    query: params.query?.trim(),
+    limit: params.limit ?? 100,
+    sources: params.sources,
+    lookback_days: params.lookbackDays,
+    dry_run: params.dryRun,
+    idempotency_key: params.idempotencyKey
+  });
+}
+function normalizeSignalDiscoveryResult(params, data) {
+  const rawSignals = Array.isArray(data.signals) ? data.signals : [];
+  const rawStatus = String(data.status || "").toLowerCase();
+  const status = SIGNAL_DISCOVERY_STATUSES.has(rawStatus) ? rawStatus : rawSignals.length > 0 ? "completed" : "failed";
+  const signals = rawSignals.map(normalizeSignalDiscoverySignal);
+  return {
+    success: data.success !== false,
+    status,
+    capability: "signals_everything",
+    signalSearchRunId: String(data.signal_search_run_id ?? params.signalSearchRunId ?? ""),
+    query: String(data.query ?? params.query ?? ""),
+    requestedCount: Number(data.requested_count ?? params.limit ?? 100),
+    nextPollAfterSeconds: typeof data.next_poll_after_seconds === "number" ? data.next_poll_after_seconds : void 0,
+    signals,
+    signalCount: signals.length,
+    availableCompanySignalCount: Number.isFinite(Number(data.available_company_signal_count)) ? Number(data.available_company_signal_count) : void 0,
+    sourceLanes: Array.isArray(data.source_lanes) ? data.source_lanes.filter((lane) => typeof lane === "string") : void 0,
+    evidenceValidation: data.evidence_validation && typeof data.evidence_validation === "object" ? data.evidence_validation : void 0,
+    costGuardrail: normalizeSignalDiscoveryCostGuardrail(data.cost_guardrail),
+    warnings: Array.isArray(data.warnings) ? data.warnings.filter((warning) => typeof warning === "string") : void 0,
+    raw: data
+  };
+}
+function normalizeSignalDiscoveryCostGuardrail(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const guardrail = value;
+  const maxCost = Number(guardrail.max_cost_per_qualified_signal_usd);
+  const withinLimit = guardrail.within_limit === true;
+  if (!Number.isFinite(maxCost)) return void 0;
+  const numberOrNullable = (candidate) => {
+    if (candidate === null) return null;
+    const numeric = Number(candidate);
+    return Number.isFinite(numeric) ? numeric : void 0;
+  };
+  const numberOrUndefined = (candidate) => {
+    const numeric = Number(candidate);
+    return Number.isFinite(numeric) ? numeric : void 0;
+  };
+  return {
+    maxCostPerQualifiedSignalUsd: maxCost,
+    projectedSourceCostUsd: numberOrNullable(guardrail.projected_source_cost_usd),
+    maxSourceCostUsd: numberOrNullable(guardrail.max_source_cost_usd),
+    projectedCostPerRequestedCompanySignalUsd: numberOrNullable(
+      guardrail.projected_cost_per_requested_company_signal_usd
+    ),
+    sourceCostUsd: numberOrNullable(guardrail.source_cost_usd),
+    costSource: ["observed", "catalog_bounded", "mixed", "unavailable"].includes(String(guardrail.cost_source)) ? String(guardrail.cost_source) : void 0,
+    qualifiedCompanySignalCount: numberOrUndefined(guardrail.qualified_company_signal_count),
+    returnedCompanySignalCount: numberOrUndefined(guardrail.returned_company_signal_count),
+    availableCompanySignalCount: numberOrUndefined(guardrail.available_company_signal_count),
+    acquisitionCandidateLimit: numberOrUndefined(guardrail.acquisition_candidate_limit),
+    minimumQualifiedCompanySignals: numberOrUndefined(guardrail.minimum_qualified_company_signals),
+    costPerQualifiedSignalUsd: numberOrNullable(guardrail.cost_per_qualified_signal_usd),
+    withinLimit
+  };
+}
+function normalizeSignalDiscoverySignal(value) {
+  const signal = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  const company = signal.company && typeof signal.company === "object" && !Array.isArray(signal.company) ? signal.company : {};
+  const companyName = String(company.name ?? signal.company_name ?? "").trim();
+  const companyDomain = String(company.domain ?? signal.company_domain ?? "").trim();
+  if (!companyName || !companyDomain) {
+    throw new Error("Signals Everything response violated the company attribution contract.");
+  }
+  return {
+    id: signal.id,
+    company: {
+      name: companyName,
+      domain: companyDomain,
+      linkedinUrl: company.linkedin_url ?? signal.company_linkedin_url ?? void 0
+    },
+    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)) : [],
+    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,
+    sourceType: signal.source_type ?? null,
+    confidence: signal.confidence ?? signal.confidence_score ?? null,
+    classification: signal.signal_classification ?? signal.classification ?? null,
+    raw: signal
+  };
+}
 function validateBatchSize(items) {
   if (!Array.isArray(items) || items.length === 0) {
     throw new Error("Signaliz batch requests require at least one item");

package/dist/mcp-config.mjs

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@signaliz/sdk",
-  "version": "1.0.53",
-  "description": "Signaliz SDK for Find Email, Verify Email, Company Signal Enrichment, and Signal to Copy AI.",
+  "version": "1.0.55",
+  "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",
   "types": "dist/index.d.ts",
@@ -24,7 +24,8 @@
     "email-finder",
     "email-verification",
     "company-signals",
-    "signal-to-copy"
+    "signal-to-copy",
+    "signals-everything"
   ],
   "license": "MIT",
   "repository": {