@signaliz/sdk 1.0.23 → 1.0.24

package/README.md

@@ -34,12 +34,24 @@ const signals = await signaliz.enrichCompanySignals({
   researchPrompt: 'expansion priorities',
 });
 
+// Persist a no-wait run ID and resume it later without duplicate spend.
+const queuedSignals = await signaliz.enrichCompanySignals({
+  companyDomain: 'example.com',
+  waitForResult: false,
+});
+const resumedSignals = await signaliz.enrichCompanySignals({
+  signalRunId: queuedSignals.signalRunId,
+});
+
 const copy = await signaliz.signalToCopy({
   companyDomain: 'example.com',
   personName: 'Jane Doe',
   title: 'VP Sales',
   campaignOffer: 'pipeline intelligence',
   researchPrompt: 'expansion priorities',
+  // Cache-first and shallow by default; opt into either behavior explicitly.
+  skipCache: false,
+  enableDeepSearch: false,
 });
 ```
 
@@ -56,11 +68,16 @@ const copyBatch = await signaliz.createSignalCopyBatch(copyRequests, { concurren
 
 Each batch accepts up to 5,000 items. Company Signal Enrichment transparently
 resumes long-running research through the same `/company-signals` endpoint;
-callers never need an internal Trigger.dev status URL.
+callers never need an internal Trigger.dev status URL. The SDK follows the
+server's adaptive polling hints by default and still honors `pollIntervalMs`
+when a caller explicitly overrides the cadence.
 
 Company Signal Enrichment defaults `online` and `enableDeepSearch` to `true`
 unless the caller explicitly disables them. Signal to Copy AI returns three
 complete, evidence-backed email variations when supported signals are available.
+Signal to Copy is cache-first and defaults `enableDeepSearch` to `false` so it
+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.
 

package/dist/{chunk-EQ3WI2UU.mjs → chunk-GWTSOG6D.mjs}

@@ -402,6 +402,7 @@ var Signaliz = class {
   async enrichCompanySignals(params) {
     const online = params.online ?? true;
     const request = compact({
+      signal_run_id: params.signalRunId,
       company_domain: params.companyDomain,
       company_name: params.companyName,
       research_prompt: params.researchPrompt,
@@ -413,15 +414,17 @@ var Signaliz = class {
       enable_outreach_intelligence: params.enableOutreachIntelligence,
       enable_predictive_intelligence: params.enablePredictiveIntelligence,
       skip_cache: params.skipCache,
-      wait_for_result: params.waitForResult !== false,
+      // REST always returns a resumable run instead of holding the connection;
+      // waitForResult controls this SDK's polling loop below.
+      wait_for_result: false,
       max_wait_ms: params.maxWaitMs
     });
     let data = await this.client.post("api/v1/company-signals", request);
     if (params.waitForResult !== false && data.run_id && isPendingSignalResponse(data)) {
       const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
-      const pollIntervalMs = Math.max(250, params.pollIntervalMs ?? 2e3);
       const startedAt = Date.now();
       while (Date.now() - startedAt < maxWaitMs) {
+        if (!await waitForNextSignalPoll(data, params.pollIntervalMs, startedAt, maxWaitMs)) break;
         const status = await this.client.post("api/v1/company-signals", {
           ...request,
           signal_run_id: data.run_id
@@ -437,7 +440,7 @@ var Signaliz = class {
           data = status.output ?? status.result ?? status.data ?? status;
           break;
         }
-        await sleep2(pollIntervalMs);
+        data = status;
       }
       if (isPendingSignalResponse(data)) {
         throw new Error(`Company signal enrichment ${data.run_id} did not complete within ${maxWaitMs}ms`);
@@ -445,6 +448,8 @@ var Signaliz = class {
     }
     return {
       success: data.success ?? true,
+      status: data.status,
+      signalRunId: data.signal_run_id ?? data.run_id,
       company: {
         name: data.company?.name ?? params.companyName ?? null,
         domain: data.company?.domain ?? params.companyDomain ?? null
@@ -476,15 +481,16 @@ var Signaliz = class {
       title: params.title,
       campaign_offer: params.campaignOffer,
       research_prompt: params.researchPrompt,
-      signal_run_id: params.signalRunId
+      signal_run_id: params.signalRunId,
+      skip_cache: params.skipCache,
+      enable_deep_search: params.enableDeepSearch
     });
     let data = await this.client.post("api/v1/signal-to-copy", request);
     if (params.waitForResult !== false && data.run_id && isPendingSignalResponse(data)) {
       const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
-      const pollIntervalMs = Math.max(250, params.pollIntervalMs ?? 2e3);
       const startedAt = Date.now();
       while (Date.now() - startedAt < maxWaitMs) {
-        await sleep2(pollIntervalMs);
+        if (!await waitForNextSignalPoll(data, params.pollIntervalMs, startedAt, maxWaitMs)) break;
         data = await this.client.post("api/v1/signal-to-copy", {
           ...request,
           signal_run_id: data.run_id
@@ -544,6 +550,19 @@ function isCompletedSignalRun(data) {
 function isFailedSignalRun(data) {
   return ["failed", "error", "cancelled", "canceled", "crashed", "timed_out"].includes(String(data.status || "").toLowerCase());
 }
+function signalPollDelayMs(data, override) {
+  if (override !== void 0) return Math.max(250, override);
+  const retryAfterMs = Number(data.retry_after_ms);
+  const nextPollSeconds = Number(data.next_poll_after_seconds);
+  const hinted = Number.isFinite(retryAfterMs) && retryAfterMs > 0 ? retryAfterMs : Number.isFinite(nextPollSeconds) && nextPollSeconds > 0 ? nextPollSeconds * 1e3 : 2e3;
+  return Math.min(6e4, Math.max(250, hinted));
+}
+async function waitForNextSignalPoll(data, override, startedAt, maxWaitMs) {
+  const remainingMs = maxWaitMs - (Date.now() - startedAt);
+  if (remainingMs <= 0) return false;
+  await sleep2(Math.min(signalPollDelayMs(data, override), remainingMs));
+  return Date.now() - startedAt < maxWaitMs;
+}
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/dist/index.d.mts

@@ -65,6 +65,8 @@ interface VerifyEmailResult {
     raw: Record<string, unknown>;
 }
 interface CompanySignalEnrichmentParams {
+    /** Resume an existing enrichment without creating another provider run. */
+    signalRunId?: string;
     companyDomain?: string;
     companyName?: string;
     researchPrompt?: string;
@@ -95,6 +97,8 @@ interface CompanySignal {
 }
 interface CompanySignalEnrichmentResult {
     success: boolean;
+    status?: string;
+    signalRunId?: string;
     company: {
         name: string | null;
         domain: string | null;
@@ -113,6 +117,10 @@ interface SignalToCopyParams {
     campaignOffer: string;
     researchPrompt?: string;
     signalRunId?: string;
+    /** Bypass cached company signals and start fresh research. */
+    skipCache?: boolean;
+    /** Opt into slower deep research. Defaults to false. */
+    enableDeepSearch?: boolean;
     waitForResult?: boolean;
     maxWaitMs?: number;
     pollIntervalMs?: number;

package/dist/index.d.ts

@@ -65,6 +65,8 @@ interface VerifyEmailResult {
     raw: Record<string, unknown>;
 }
 interface CompanySignalEnrichmentParams {
+    /** Resume an existing enrichment without creating another provider run. */
+    signalRunId?: string;
     companyDomain?: string;
     companyName?: string;
     researchPrompt?: string;
@@ -95,6 +97,8 @@ interface CompanySignal {
 }
 interface CompanySignalEnrichmentResult {
     success: boolean;
+    status?: string;
+    signalRunId?: string;
     company: {
         name: string | null;
         domain: string | null;
@@ -113,6 +117,10 @@ interface SignalToCopyParams {
     campaignOffer: string;
     researchPrompt?: string;
     signalRunId?: string;
+    /** Bypass cached company signals and start fresh research. */
+    skipCache?: boolean;
+    /** Opt into slower deep research. Defaults to false. */
+    enableDeepSearch?: boolean;
     waitForResult?: boolean;
     maxWaitMs?: number;
     pollIntervalMs?: number;

package/dist/index.js

@@ -429,6 +429,7 @@ var Signaliz = class {
   async enrichCompanySignals(params) {
     const online = params.online ?? true;
     const request = compact({
+      signal_run_id: params.signalRunId,
       company_domain: params.companyDomain,
       company_name: params.companyName,
       research_prompt: params.researchPrompt,
@@ -440,15 +441,17 @@ var Signaliz = class {
       enable_outreach_intelligence: params.enableOutreachIntelligence,
       enable_predictive_intelligence: params.enablePredictiveIntelligence,
       skip_cache: params.skipCache,
-      wait_for_result: params.waitForResult !== false,
+      // REST always returns a resumable run instead of holding the connection;
+      // waitForResult controls this SDK's polling loop below.
+      wait_for_result: false,
       max_wait_ms: params.maxWaitMs
     });
     let data = await this.client.post("api/v1/company-signals", request);
     if (params.waitForResult !== false && data.run_id && isPendingSignalResponse(data)) {
       const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
-      const pollIntervalMs = Math.max(250, params.pollIntervalMs ?? 2e3);
       const startedAt = Date.now();
       while (Date.now() - startedAt < maxWaitMs) {
+        if (!await waitForNextSignalPoll(data, params.pollIntervalMs, startedAt, maxWaitMs)) break;
         const status = await this.client.post("api/v1/company-signals", {
           ...request,
           signal_run_id: data.run_id
@@ -464,7 +467,7 @@ var Signaliz = class {
           data = status.output ?? status.result ?? status.data ?? status;
           break;
         }
-        await sleep2(pollIntervalMs);
+        data = status;
       }
       if (isPendingSignalResponse(data)) {
         throw new Error(`Company signal enrichment ${data.run_id} did not complete within ${maxWaitMs}ms`);
@@ -472,6 +475,8 @@ var Signaliz = class {
     }
     return {
       success: data.success ?? true,
+      status: data.status,
+      signalRunId: data.signal_run_id ?? data.run_id,
       company: {
         name: data.company?.name ?? params.companyName ?? null,
         domain: data.company?.domain ?? params.companyDomain ?? null
@@ -503,15 +508,16 @@ var Signaliz = class {
       title: params.title,
       campaign_offer: params.campaignOffer,
       research_prompt: params.researchPrompt,
-      signal_run_id: params.signalRunId
+      signal_run_id: params.signalRunId,
+      skip_cache: params.skipCache,
+      enable_deep_search: params.enableDeepSearch
     });
     let data = await this.client.post("api/v1/signal-to-copy", request);
     if (params.waitForResult !== false && data.run_id && isPendingSignalResponse(data)) {
       const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
-      const pollIntervalMs = Math.max(250, params.pollIntervalMs ?? 2e3);
       const startedAt = Date.now();
       while (Date.now() - startedAt < maxWaitMs) {
-        await sleep2(pollIntervalMs);
+        if (!await waitForNextSignalPoll(data, params.pollIntervalMs, startedAt, maxWaitMs)) break;
         data = await this.client.post("api/v1/signal-to-copy", {
           ...request,
           signal_run_id: data.run_id
@@ -571,6 +577,19 @@ function isCompletedSignalRun(data) {
 function isFailedSignalRun(data) {
   return ["failed", "error", "cancelled", "canceled", "crashed", "timed_out"].includes(String(data.status || "").toLowerCase());
 }
+function signalPollDelayMs(data, override) {
+  if (override !== void 0) return Math.max(250, override);
+  const retryAfterMs = Number(data.retry_after_ms);
+  const nextPollSeconds = Number(data.next_poll_after_seconds);
+  const hinted = Number.isFinite(retryAfterMs) && retryAfterMs > 0 ? retryAfterMs : Number.isFinite(nextPollSeconds) && nextPollSeconds > 0 ? nextPollSeconds * 1e3 : 2e3;
+  return Math.min(6e4, Math.max(250, hinted));
+}
+async function waitForNextSignalPoll(data, override, startedAt, maxWaitMs) {
+  const remainingMs = maxWaitMs - (Date.now() - startedAt);
+  if (remainingMs <= 0) return false;
+  await sleep2(Math.min(signalPollDelayMs(data, override), remainingMs));
+  return Date.now() - startedAt < maxWaitMs;
+}
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -433,6 +433,7 @@ var Signaliz = class {
   async enrichCompanySignals(params) {
     const online = params.online ?? true;
     const request = compact({
+      signal_run_id: params.signalRunId,
       company_domain: params.companyDomain,
       company_name: params.companyName,
       research_prompt: params.researchPrompt,
@@ -444,15 +445,17 @@ var Signaliz = class {
       enable_outreach_intelligence: params.enableOutreachIntelligence,
       enable_predictive_intelligence: params.enablePredictiveIntelligence,
       skip_cache: params.skipCache,
-      wait_for_result: params.waitForResult !== false,
+      // REST always returns a resumable run instead of holding the connection;
+      // waitForResult controls this SDK's polling loop below.
+      wait_for_result: false,
       max_wait_ms: params.maxWaitMs
     });
     let data = await this.client.post("api/v1/company-signals", request);
     if (params.waitForResult !== false && data.run_id && isPendingSignalResponse(data)) {
       const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
-      const pollIntervalMs = Math.max(250, params.pollIntervalMs ?? 2e3);
       const startedAt = Date.now();
       while (Date.now() - startedAt < maxWaitMs) {
+        if (!await waitForNextSignalPoll(data, params.pollIntervalMs, startedAt, maxWaitMs)) break;
         const status = await this.client.post("api/v1/company-signals", {
           ...request,
           signal_run_id: data.run_id
@@ -468,7 +471,7 @@ var Signaliz = class {
           data = status.output ?? status.result ?? status.data ?? status;
           break;
         }
-        await sleep2(pollIntervalMs);
+        data = status;
       }
       if (isPendingSignalResponse(data)) {
         throw new Error(`Company signal enrichment ${data.run_id} did not complete within ${maxWaitMs}ms`);
@@ -476,6 +479,8 @@ var Signaliz = class {
     }
     return {
       success: data.success ?? true,
+      status: data.status,
+      signalRunId: data.signal_run_id ?? data.run_id,
       company: {
         name: data.company?.name ?? params.companyName ?? null,
         domain: data.company?.domain ?? params.companyDomain ?? null
@@ -507,15 +512,16 @@ var Signaliz = class {
       title: params.title,
       campaign_offer: params.campaignOffer,
       research_prompt: params.researchPrompt,
-      signal_run_id: params.signalRunId
+      signal_run_id: params.signalRunId,
+      skip_cache: params.skipCache,
+      enable_deep_search: params.enableDeepSearch
     });
     let data = await this.client.post("api/v1/signal-to-copy", request);
     if (params.waitForResult !== false && data.run_id && isPendingSignalResponse(data)) {
       const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
-      const pollIntervalMs = Math.max(250, params.pollIntervalMs ?? 2e3);
       const startedAt = Date.now();
       while (Date.now() - startedAt < maxWaitMs) {
-        await sleep2(pollIntervalMs);
+        if (!await waitForNextSignalPoll(data, params.pollIntervalMs, startedAt, maxWaitMs)) break;
         data = await this.client.post("api/v1/signal-to-copy", {
           ...request,
           signal_run_id: data.run_id
@@ -575,6 +581,19 @@ function isCompletedSignalRun(data) {
 function isFailedSignalRun(data) {
   return ["failed", "error", "cancelled", "canceled", "crashed", "timed_out"].includes(String(data.status || "").toLowerCase());
 }
+function signalPollDelayMs(data, override) {
+  if (override !== void 0) return Math.max(250, override);
+  const retryAfterMs = Number(data.retry_after_ms);
+  const nextPollSeconds = Number(data.next_poll_after_seconds);
+  const hinted = Number.isFinite(retryAfterMs) && retryAfterMs > 0 ? retryAfterMs : Number.isFinite(nextPollSeconds) && nextPollSeconds > 0 ? nextPollSeconds * 1e3 : 2e3;
+  return Math.min(6e4, Math.max(250, hinted));
+}
+async function waitForNextSignalPoll(data, override, startedAt, maxWaitMs) {
+  const remainingMs = maxWaitMs - (Date.now() - startedAt);
+  if (remainingMs <= 0) return false;
+  await sleep2(Math.min(signalPollDelayMs(data, override), remainingMs));
+  return Date.now() - startedAt < maxWaitMs;
+}
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/dist/mcp-config.mjs

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

package/package.json

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