@signaliz/sdk 1.0.52 → 1.0.54

package/dist/mcp-config.js

@@ -70,7 +70,11 @@ function publicRetryDetails(body) {
   const details = {
     ...body?.retry_eligible !== void 0 ? { retry_eligible: body.retry_eligible } : {},
     ...body?.retry_after !== void 0 ? { retry_after: body.retry_after } : {},
-    ...body?.retry_after_seconds !== void 0 ? { retry_after_seconds: body.retry_after_seconds } : {}
+    ...body?.retry_after_seconds !== void 0 ? { retry_after_seconds: body.retry_after_seconds } : {},
+    ...body?.run_id !== void 0 ? { run_id: body.run_id } : {},
+    ...body?.signal_run_id !== void 0 ? { signal_run_id: body.signal_run_id } : {},
+    ...body?.company_signal_run_id !== void 0 ? { company_signal_run_id: body.company_signal_run_id } : {},
+    ...body?.resume_context_persisted !== void 0 ? { resume_context_persisted: body.resume_context_persisted } : {}
   };
   return Object.keys(details).length > 0 ? details : void 0;
 }
@@ -495,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));
@@ -555,10 +567,7 @@ var Signaliz = class {
       request: signalToCopyRequestBody(params)
     }));
     const uniqueRequests = deduplicated.uniqueItems;
-    const requiresFreshResearch = uniqueRequests.some(
-      (request) => request.skipCache === true || request.enableDeepSearch === true
-    );
-    const uniqueResults = uniqueRequests.length > 25 && !requiresFreshResearch ? await this.runRecoverableSignalCopyBatch(uniqueRequests, options) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
+    const uniqueResults = await this.runSignalCopyBatchChunks(uniqueRequests, options);
     const results = requests.map((_, index) => ({
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index
@@ -589,7 +598,7 @@ var Signaliz = class {
     for (let offset = 0; offset < uniqueRequests.length; offset += 25) {
       chunks.push({ offset, requests: uniqueRequests.slice(offset, offset + 25) });
     }
-    const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
+    const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options, 25, 25);
     const chunkBatch = await runBatch(
       chunks,
       (chunk) => this.runSignalCopyBatchChunk(chunk.requests, serverConcurrency),
@@ -684,35 +693,6 @@ var Signaliz = class {
     if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
     return rows;
   }
-  async runRecoverableSignalCopyBatch(requests, options) {
-    const rows = await this.runRecoverableCoreBatchJob(
-      "api/v1/signal-to-copy",
-      requests.map(signalToCopyRequestBody),
-      "Signal to Copy",
-      100,
-      20 * 6e4,
-      options?.idempotencyKey
-    );
-    const results = new Array(requests.length);
-    for (const row of rows) {
-      const index = Number(row.index);
-      if (recoverableJobRowFailed(row)) {
-        results[index] = batchItemFailure(
-          index,
-          row.error || row._error || row.message || row.failure_reason || "Signal to Copy item failed",
-          row
-        );
-        continue;
-      }
-      try {
-        assertTerminalSignalResponse(row, "Signal to Copy");
-        results[index] = { index, success: true, data: normalizeSignalToCopyResult(row) };
-      } catch (error) {
-        results[index] = batchItemFailure(index, error instanceof Error ? error.message : String(error), row);
-      }
-    }
-    return results;
-  }
   async runSignalCopyBatchChunk(requests, concurrency, rowRateLimitAttempt = 0) {
     const results = new Array(requests.length);
     const rateLimited = [];
@@ -762,12 +742,11 @@ var Signaliz = class {
     return results;
   }
   async runCoreBatchRound(path2, tasks, options, rowRateLimitAttempt = 0) {
-    const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
+    const { serverConcurrency, chunkConcurrency } = path2 === "api/v1/company-signals" ? batchConcurrencyPlan(options, 25, 25) : batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
-    const recoverableBatch = path2 === "api/v1/find-email" ? { label: "Find Email", pageSize: 500, maxWaitMs: 20 * 6e4 } : path2 === "api/v1/verify-email" ? { label: "Verify Email", pageSize: 500, maxWaitMs: 20 * 6e4 } : path2 === "api/v1/company-signals" ? { label: "Company Signals", pageSize: 25, maxWaitMs: 20 * 6e4 } : void 0;
-    const containsSignalRunRecovery = path2 === "api/v1/company-signals" && uniqueTasks.some((task) => Boolean(task.request.signal_run_id));
-    if (recoverableBatch && uniqueTasks.length > 25 && !containsSignalRunRecovery) {
+    const recoverableBatch = path2 === "api/v1/find-email" ? { label: "Find Email", pageSize: 500, maxWaitMs: 20 * 6e4 } : path2 === "api/v1/verify-email" ? { label: "Verify Email", pageSize: 500, maxWaitMs: 20 * 6e4 } : void 0;
+    if (path2 !== "api/v1/company-signals" && recoverableBatch && uniqueTasks.length > 25) {
       const rows = await this.runRecoverableCoreBatchJob(
         path2,
         uniqueTasks.map((task) => task.request),
@@ -1032,6 +1011,7 @@ function companySignalRequestBody(params) {
     enable_outreach_intelligence: params.enableOutreachIntelligence,
     enable_predictive_intelligence: params.enablePredictiveIntelligence,
     skip_cache: params.skipCache,
+    include_candidate_evidence: params.includeCandidateEvidence,
     wait_for_result: true,
     max_wait_ms: params.maxWaitMs,
     dry_run: params.dryRun,
@@ -1049,7 +1029,6 @@ function normalizeCompanySignalResult(params, data) {
       domain: data.company?.domain ?? params.companyDomain ?? null
     },
     signals: rawSignals.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 ?? "",
@@ -1058,43 +1037,160 @@ function normalizeCompanySignalResult(params, data) {
         date: signal.date ?? null,
         detectedAt: signal.detected_at ?? null,
         datePrecision: signal.date_precision,
-        hasSpecificDate: signal.has_specific_date ?? metadata?.has_specific_date,
         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
+        classification: signal.signal_classification ?? null
       };
     }),
     signalCount: data.signal_count ?? data.total_signals ?? rawSignals.length,
     signalSummary: data.signal_summary ?? null,
-    signalSummarySource: data.signal_summary_source,
     intelligence: data.intelligence ?? null,
     copyFuel: data.copy_fuel ?? null,
     evidenceValidation: data.evidence_validation,
-    evidenceSources: data.evidence_sources,
-    credits: data.credits,
-    creditsUsed: data.credits_used,
-    costUsd: data.cost_usd,
-    billingMetadata: data.billing_metadata,
-    resultReturnedFrom: data.result_returned_from,
-    cacheHit: data.cache_hit,
-    freshEnrichmentUsed: data.fresh_enrichment_used,
-    liveProviderCalled: data.live_provider_called,
-    aiProviderCalled: data.ai_provider_called,
-    byoAiUsed: data.byo_ai_used,
-    metadata: data.metadata,
+    evidenceSources: data.metadata?.evidence_sources ?? data.evidence_sources,
+    evidenceCount: data.evidence_count,
+    evidenceCountTotal: data.evidence_count_total,
+    evidenceSourcesOmitted: data.evidence_sources_omitted,
+    evidenceScope: data.evidence_scope,
     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,
+      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,
+    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),
+    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");
@@ -1110,9 +1206,9 @@ function validatedBatchConcurrency(options) {
   }
   return concurrency;
 }
-function batchConcurrencyPlan(options) {
-  const concurrency = validatedBatchConcurrency(options);
-  const serverConcurrency = Math.min(10, concurrency);
+function batchConcurrencyPlan(options, defaultConcurrency = 10, maximumServerConcurrency = 10) {
+  const concurrency = options?.concurrency === void 0 ? defaultConcurrency : validatedBatchConcurrency(options);
+  const serverConcurrency = Math.min(maximumServerConcurrency, concurrency);
   return {
     serverConcurrency,
     chunkConcurrency: Math.max(1, Math.floor(concurrency / serverConcurrency))

package/dist/mcp-config.mjs

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@signaliz/sdk",
-  "version": "1.0.52",
-  "description": "Signaliz SDK for Find Email, Verify Email, Company Signal Enrichment, and Signal to Copy AI.",
+  "version": "1.0.54",
+  "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": {