@signaliz/sdk 1.0.39 → 1.0.42

package/README.md

@@ -69,6 +69,17 @@ const copy = await signaliz.signalToCopy({
   skipCache: false,
   enableDeepSearch: false,
 });
+
+// Persist a queued copy ID and resume with that ID alone. Signaliz restores
+// the recipient, title, offer, prompt, and underlying research run.
+const queuedCopy = await signaliz.signalToCopy({
+  companyDomain: 'example.com',
+  personName: 'Jane Doe',
+  title: 'VP Sales',
+  campaignOffer: 'pipeline intelligence',
+  waitForResult: false,
+});
+const resumedCopy = await signaliz.signalToCopy({ signalRunId: queuedCopy.runId });
 ```
 
 All four products support bounded batch execution over the same REST endpoints.

package/dist/{chunk-UVW5N4LW.mjs → chunk-B4OMGBD5.mjs}

@@ -32,7 +32,7 @@ function parseError(status, body) {
 }
 function mapErrorType(code, status) {
   if (code === "RATE_LIMITED" || status === 429) return "rate_limited";
-  if (code === "VALIDATION_ERROR" || status === 400) return "validation";
+  if (code === "VALIDATION_ERROR" || code === "SIGNAL_RUN_COMPANY_MISMATCH" || status === 400) return "validation";
   if (code === "NOT_FOUND" || status === 404) return "not_found";
   if (code === "NO_SUPPORTED_SIGNAL") return "not_found";
   if (code === "AUTH_EXPIRED" || status === 401) return "auth_expired";
@@ -60,6 +60,7 @@ var HttpClient = class {
   }
   async request(functionName, body, method = "POST") {
     let lastError;
+    const idempotencyKey = method === "POST" ? requestIdempotencyKey(body) : void 0;
     for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
       let timer;
       try {
@@ -77,7 +78,8 @@ var HttpClient = class {
           method,
           headers: {
             "Content-Type": "application/json",
-            Authorization: `Bearer ${token}`
+            Authorization: `Bearer ${token}`,
+            ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}
           },
           signal: controller.signal
         };
@@ -242,6 +244,11 @@ var HttpClient = class {
     return this.accessTokenPromise;
   }
 };
+function requestIdempotencyKey(body) {
+  const requested = typeof body.idempotency_key === "string" ? body.idempotency_key.trim() : "";
+  const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+  return requested || `sdk_${nonce}`;
+}
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
@@ -342,7 +349,7 @@ function mapMcpErrorType(error) {
 function mapErrorTypeFromCode(code) {
   if (!code) return "unknown";
   if (code === "RATE_LIMITED") return "rate_limited";
-  if (code === "INVALID_ARGUMENT" || code === "VALIDATION_ERROR" || code === "VALIDATION_001" || code === "APPROVAL_REQUIRED" || code === "WEBHOOK_APPROVAL_REQUIRED" || code === "TARGET_LIMIT_EXCEEDED") return "validation";
+  if (code === "INVALID_ARGUMENT" || code === "VALIDATION_ERROR" || code === "VALIDATION_001" || code === "SIGNAL_RUN_COMPANY_MISMATCH" || code === "APPROVAL_REQUIRED" || code === "WEBHOOK_APPROVAL_REQUIRED" || code === "TARGET_LIMIT_EXCEEDED") return "validation";
   if (code === "AUTH_REQUIRED" || code === "AUTH_001") return "auth_expired";
   if (code === "QUOTA_EXCEEDED") return "insufficient_credits";
   if (code === "BUILD_NOT_READY" || code === "ARTIFACT_NOT_READY") return "not_found";
@@ -521,17 +528,16 @@ var Signaliz = class {
     };
   }
   async signalToCopy(params) {
+    validateSignalToCopyParams(params);
     const request = signalToCopyRequestBody(params);
     let data = await this.client.post("api/v1/signal-to-copy", request);
-    if (params.waitForResult !== false && data.run_id && isPendingSignalResponse(data)) {
+    if (params.waitForResult !== false && (data.signal_run_id || data.run_id) && isPendingSignalResponse(data)) {
       const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
       const startedAt = Date.now();
       while (Date.now() - startedAt < maxWaitMs) {
         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
-        });
+        const signalRunId = data.signal_run_id || data.run_id;
+        data = await this.client.post("api/v1/signal-to-copy", data.resume_context_persisted === true ? { signal_run_id: signalRunId } : { ...request, signal_run_id: signalRunId });
         if (!isPendingSignalResponse(data)) break;
       }
       if (isPendingSignalResponse(data)) {
@@ -542,6 +548,7 @@ var Signaliz = class {
   }
   async createSignalCopyBatch(requests, options) {
     validateBatchSize(requests);
+    requests.forEach(validateSignalToCopyParams);
     const startedAt = Date.now();
     const deduplicated = dedupeExactBatchItems(requests, (params) => JSON.stringify({
       request: signalToCopyRequestBody(params),
@@ -551,7 +558,7 @@ var Signaliz = class {
     }));
     const uniqueRequests = deduplicated.uniqueItems;
     const canUseRecoverableAvailableDataJob = uniqueRequests.length > 25 && uniqueRequests.every(
-      (params) => params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
+      (params) => (!params.signalRunId || !params.signalRunId.startsWith("copy_") && [params.companyDomain, params.personName, params.title, params.campaignOffer].every((value) => typeof value === "string" && Boolean(value.trim()))) && params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
     );
     const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests, options) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
     const results = requests.map((_, index) => ({
@@ -738,7 +745,7 @@ var Signaliz = class {
         );
         nextPending.push({
           ...task,
-          request: { ...task.request, signal_run_id: signalRunId }
+          request: item.resume_context_persisted === true ? { signal_run_id: signalRunId } : { ...task.request, signal_run_id: signalRunId }
         });
       }
       pending = nextPending;
@@ -944,15 +951,16 @@ function companySignalRecoverableBatchOptions(companies, tasks) {
   return { label: "Company Signals", pageSize: 25, maxWaitMs };
 }
 function normalizeCompanySignalResult(params, data) {
+  const rawSignals = data.signals ?? data.signal_feed ?? [];
   return {
     success: data.success ?? true,
     status: data.status,
-    signalRunId: data.signal_run_id ?? data.run_id,
+    signalRunId: data.signal_run_id ?? data.run_id ?? params.signalRunId,
     company: {
       name: data.company?.name ?? params.companyName ?? null,
       domain: data.company?.domain ?? params.companyDomain ?? null
     },
-    signals: (data.signals ?? []).map((signal) => {
+    signals: rawSignals.map((signal) => {
       const metadata = signal.metadata && typeof signal.metadata === "object" && !Array.isArray(signal.metadata) ? signal.metadata : void 0;
       return {
         id: signal.id,
@@ -976,9 +984,20 @@ function normalizeCompanySignalResult(params, data) {
         metadata
       };
     }),
-    signalCount: data.signal_count ?? data.total_signals ?? data.signals?.length ?? 0,
+    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,
+    liveProviderCalled: data.live_provider_called,
     metadata: data.metadata,
     raw: data
   };
@@ -1076,11 +1095,24 @@ function signalToCopyRequestBody(params) {
     enable_deep_search: params.enableDeepSearch
   });
 }
+function validateSignalToCopyParams(params) {
+  if (typeof params.signalRunId === "string" && params.signalRunId.trim()) return;
+  const missing = [
+    ["companyDomain", params.companyDomain],
+    ["personName", params.personName],
+    ["title", params.title],
+    ["campaignOffer", params.campaignOffer]
+  ].filter(([, value]) => typeof value !== "string" || !value.trim()).map(([field]) => field);
+  if (missing.length > 0) {
+    throw new TypeError(`Signal to Copy requires signalRunId or: ${missing.join(", ")}`);
+  }
+}
 function normalizeSignalToCopyResult(data) {
   return {
     success: data.success ?? true,
     status: data.status,
     runId: data.signal_run_id ?? data.run_id,
+    resumeContextPersisted: data.resume_context_persisted,
     strongestSignal: data.strongest_signal ?? "",
     whyNow: data.why_now ?? "",
     subjectLine: data.subject_line ?? "",
@@ -1088,6 +1120,9 @@ function normalizeSignalToCopyResult(data) {
     confidence: data.confidence ?? 0,
     evidenceUrl: data.evidence_url ?? "",
     researchPrompt: data.research_prompt,
+    empty: data.empty,
+    emptyReason: data.empty_reason,
+    researchMetadata: data.research_metadata,
     variations: (data.variations ?? []).map((variation) => ({
       style: variation.style,
       subjectLine: variation.subject_line ?? "",

package/dist/index.d.mts

@@ -150,16 +150,27 @@ interface CompanySignalEnrichmentResult {
     };
     signals: CompanySignal[];
     signalCount: number;
+    signalSummary: string | null;
+    signalSummarySource?: string;
     intelligence?: Record<string, unknown> | null;
+    copyFuel?: Record<string, unknown> | null;
+    evidenceValidation?: Record<string, unknown>;
+    evidenceSources?: Record<string, unknown>[];
     credits?: Record<string, unknown>;
+    creditsUsed?: number;
+    costUsd?: number;
+    billingMetadata?: Record<string, unknown>;
+    resultReturnedFrom?: string;
+    cacheHit?: boolean;
+    liveProviderCalled?: boolean;
     metadata?: Record<string, unknown>;
     raw: Record<string, unknown>;
 }
 interface SignalToCopyParams {
-    companyDomain: string;
-    personName: string;
-    title: string;
-    campaignOffer: string;
+    companyDomain?: string;
+    personName?: string;
+    title?: string;
+    campaignOffer?: string;
     researchPrompt?: string;
     signalRunId?: string;
     /** Bypass cached company signals and start fresh research. */
@@ -182,6 +193,7 @@ interface SignalToCopyResult {
     success: boolean;
     status?: string;
     runId?: string;
+    resumeContextPersisted?: boolean;
     strongestSignal: string;
     whyNow: string;
     subjectLine: string;
@@ -189,6 +201,9 @@ interface SignalToCopyResult {
     confidence: number;
     evidenceUrl: string;
     researchPrompt?: string;
+    empty?: boolean;
+    emptyReason?: string;
+    researchMetadata?: Record<string, unknown>;
     variations: SignalToCopyVariation[];
     raw: Record<string, unknown>;
 }

package/dist/index.d.ts

@@ -150,16 +150,27 @@ interface CompanySignalEnrichmentResult {
     };
     signals: CompanySignal[];
     signalCount: number;
+    signalSummary: string | null;
+    signalSummarySource?: string;
     intelligence?: Record<string, unknown> | null;
+    copyFuel?: Record<string, unknown> | null;
+    evidenceValidation?: Record<string, unknown>;
+    evidenceSources?: Record<string, unknown>[];
     credits?: Record<string, unknown>;
+    creditsUsed?: number;
+    costUsd?: number;
+    billingMetadata?: Record<string, unknown>;
+    resultReturnedFrom?: string;
+    cacheHit?: boolean;
+    liveProviderCalled?: boolean;
     metadata?: Record<string, unknown>;
     raw: Record<string, unknown>;
 }
 interface SignalToCopyParams {
-    companyDomain: string;
-    personName: string;
-    title: string;
-    campaignOffer: string;
+    companyDomain?: string;
+    personName?: string;
+    title?: string;
+    campaignOffer?: string;
     researchPrompt?: string;
     signalRunId?: string;
     /** Bypass cached company signals and start fresh research. */
@@ -182,6 +193,7 @@ interface SignalToCopyResult {
     success: boolean;
     status?: string;
     runId?: string;
+    resumeContextPersisted?: boolean;
     strongestSignal: string;
     whyNow: string;
     subjectLine: string;
@@ -189,6 +201,9 @@ interface SignalToCopyResult {
     confidence: number;
     evidenceUrl: string;
     researchPrompt?: string;
+    empty?: boolean;
+    emptyReason?: string;
+    researchMetadata?: Record<string, unknown>;
     variations: SignalToCopyVariation[];
     raw: Record<string, unknown>;
 }

package/dist/index.js

@@ -59,7 +59,7 @@ function parseError(status, body) {
 }
 function mapErrorType(code, status) {
   if (code === "RATE_LIMITED" || status === 429) return "rate_limited";
-  if (code === "VALIDATION_ERROR" || status === 400) return "validation";
+  if (code === "VALIDATION_ERROR" || code === "SIGNAL_RUN_COMPANY_MISMATCH" || status === 400) return "validation";
   if (code === "NOT_FOUND" || status === 404) return "not_found";
   if (code === "NO_SUPPORTED_SIGNAL") return "not_found";
   if (code === "AUTH_EXPIRED" || status === 401) return "auth_expired";
@@ -87,6 +87,7 @@ var HttpClient = class {
   }
   async request(functionName, body, method = "POST") {
     let lastError;
+    const idempotencyKey = method === "POST" ? requestIdempotencyKey(body) : void 0;
     for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
       let timer;
       try {
@@ -104,7 +105,8 @@ var HttpClient = class {
           method,
           headers: {
             "Content-Type": "application/json",
-            Authorization: `Bearer ${token}`
+            Authorization: `Bearer ${token}`,
+            ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}
           },
           signal: controller.signal
         };
@@ -269,6 +271,11 @@ var HttpClient = class {
     return this.accessTokenPromise;
   }
 };
+function requestIdempotencyKey(body) {
+  const requested = typeof body.idempotency_key === "string" ? body.idempotency_key.trim() : "";
+  const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+  return requested || `sdk_${nonce}`;
+}
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
@@ -369,7 +376,7 @@ function mapMcpErrorType(error) {
 function mapErrorTypeFromCode(code) {
   if (!code) return "unknown";
   if (code === "RATE_LIMITED") return "rate_limited";
-  if (code === "INVALID_ARGUMENT" || code === "VALIDATION_ERROR" || code === "VALIDATION_001" || code === "APPROVAL_REQUIRED" || code === "WEBHOOK_APPROVAL_REQUIRED" || code === "TARGET_LIMIT_EXCEEDED") return "validation";
+  if (code === "INVALID_ARGUMENT" || code === "VALIDATION_ERROR" || code === "VALIDATION_001" || code === "SIGNAL_RUN_COMPANY_MISMATCH" || code === "APPROVAL_REQUIRED" || code === "WEBHOOK_APPROVAL_REQUIRED" || code === "TARGET_LIMIT_EXCEEDED") return "validation";
   if (code === "AUTH_REQUIRED" || code === "AUTH_001") return "auth_expired";
   if (code === "QUOTA_EXCEEDED") return "insufficient_credits";
   if (code === "BUILD_NOT_READY" || code === "ARTIFACT_NOT_READY") return "not_found";
@@ -548,17 +555,16 @@ var Signaliz = class {
     };
   }
   async signalToCopy(params) {
+    validateSignalToCopyParams(params);
     const request = signalToCopyRequestBody(params);
     let data = await this.client.post("api/v1/signal-to-copy", request);
-    if (params.waitForResult !== false && data.run_id && isPendingSignalResponse(data)) {
+    if (params.waitForResult !== false && (data.signal_run_id || data.run_id) && isPendingSignalResponse(data)) {
       const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
       const startedAt = Date.now();
       while (Date.now() - startedAt < maxWaitMs) {
         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
-        });
+        const signalRunId = data.signal_run_id || data.run_id;
+        data = await this.client.post("api/v1/signal-to-copy", data.resume_context_persisted === true ? { signal_run_id: signalRunId } : { ...request, signal_run_id: signalRunId });
         if (!isPendingSignalResponse(data)) break;
       }
       if (isPendingSignalResponse(data)) {
@@ -569,6 +575,7 @@ var Signaliz = class {
   }
   async createSignalCopyBatch(requests, options) {
     validateBatchSize(requests);
+    requests.forEach(validateSignalToCopyParams);
     const startedAt = Date.now();
     const deduplicated = dedupeExactBatchItems(requests, (params) => JSON.stringify({
       request: signalToCopyRequestBody(params),
@@ -578,7 +585,7 @@ var Signaliz = class {
     }));
     const uniqueRequests = deduplicated.uniqueItems;
     const canUseRecoverableAvailableDataJob = uniqueRequests.length > 25 && uniqueRequests.every(
-      (params) => params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
+      (params) => (!params.signalRunId || !params.signalRunId.startsWith("copy_") && [params.companyDomain, params.personName, params.title, params.campaignOffer].every((value) => typeof value === "string" && Boolean(value.trim()))) && params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
     );
     const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests, options) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
     const results = requests.map((_, index) => ({
@@ -765,7 +772,7 @@ var Signaliz = class {
         );
         nextPending.push({
           ...task,
-          request: { ...task.request, signal_run_id: signalRunId }
+          request: item.resume_context_persisted === true ? { signal_run_id: signalRunId } : { ...task.request, signal_run_id: signalRunId }
         });
       }
       pending = nextPending;
@@ -971,15 +978,16 @@ function companySignalRecoverableBatchOptions(companies, tasks) {
   return { label: "Company Signals", pageSize: 25, maxWaitMs };
 }
 function normalizeCompanySignalResult(params, data) {
+  const rawSignals = data.signals ?? data.signal_feed ?? [];
   return {
     success: data.success ?? true,
     status: data.status,
-    signalRunId: data.signal_run_id ?? data.run_id,
+    signalRunId: data.signal_run_id ?? data.run_id ?? params.signalRunId,
     company: {
       name: data.company?.name ?? params.companyName ?? null,
       domain: data.company?.domain ?? params.companyDomain ?? null
     },
-    signals: (data.signals ?? []).map((signal) => {
+    signals: rawSignals.map((signal) => {
       const metadata = signal.metadata && typeof signal.metadata === "object" && !Array.isArray(signal.metadata) ? signal.metadata : void 0;
       return {
         id: signal.id,
@@ -1003,9 +1011,20 @@ function normalizeCompanySignalResult(params, data) {
         metadata
       };
     }),
-    signalCount: data.signal_count ?? data.total_signals ?? data.signals?.length ?? 0,
+    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,
+    liveProviderCalled: data.live_provider_called,
     metadata: data.metadata,
     raw: data
   };
@@ -1103,11 +1122,24 @@ function signalToCopyRequestBody(params) {
     enable_deep_search: params.enableDeepSearch
   });
 }
+function validateSignalToCopyParams(params) {
+  if (typeof params.signalRunId === "string" && params.signalRunId.trim()) return;
+  const missing = [
+    ["companyDomain", params.companyDomain],
+    ["personName", params.personName],
+    ["title", params.title],
+    ["campaignOffer", params.campaignOffer]
+  ].filter(([, value]) => typeof value !== "string" || !value.trim()).map(([field]) => field);
+  if (missing.length > 0) {
+    throw new TypeError(`Signal to Copy requires signalRunId or: ${missing.join(", ")}`);
+  }
+}
 function normalizeSignalToCopyResult(data) {
   return {
     success: data.success ?? true,
     status: data.status,
     runId: data.signal_run_id ?? data.run_id,
+    resumeContextPersisted: data.resume_context_persisted,
     strongestSignal: data.strongest_signal ?? "",
     whyNow: data.why_now ?? "",
     subjectLine: data.subject_line ?? "",
@@ -1115,6 +1147,9 @@ function normalizeSignalToCopyResult(data) {
     confidence: data.confidence ?? 0,
     evidenceUrl: data.evidence_url ?? "",
     researchPrompt: data.research_prompt,
+    empty: data.empty,
+    emptyReason: data.empty_reason,
+    researchMetadata: data.research_metadata,
     variations: (data.variations ?? []).map((variation) => ({
       style: variation.style,
       subjectLine: variation.subject_line ?? "",

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -63,7 +63,7 @@ function parseError(status, body) {
 }
 function mapErrorType(code, status) {
   if (code === "RATE_LIMITED" || status === 429) return "rate_limited";
-  if (code === "VALIDATION_ERROR" || status === 400) return "validation";
+  if (code === "VALIDATION_ERROR" || code === "SIGNAL_RUN_COMPANY_MISMATCH" || status === 400) return "validation";
   if (code === "NOT_FOUND" || status === 404) return "not_found";
   if (code === "NO_SUPPORTED_SIGNAL") return "not_found";
   if (code === "AUTH_EXPIRED" || status === 401) return "auth_expired";
@@ -91,6 +91,7 @@ var HttpClient = class {
   }
   async request(functionName, body, method = "POST") {
     let lastError;
+    const idempotencyKey = method === "POST" ? requestIdempotencyKey(body) : void 0;
     for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
       let timer;
       try {
@@ -108,7 +109,8 @@ var HttpClient = class {
           method,
           headers: {
             "Content-Type": "application/json",
-            Authorization: `Bearer ${token}`
+            Authorization: `Bearer ${token}`,
+            ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}
           },
           signal: controller.signal
         };
@@ -273,6 +275,11 @@ var HttpClient = class {
     return this.accessTokenPromise;
   }
 };
+function requestIdempotencyKey(body) {
+  const requested = typeof body.idempotency_key === "string" ? body.idempotency_key.trim() : "";
+  const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+  return requested || `sdk_${nonce}`;
+}
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
@@ -373,7 +380,7 @@ function mapMcpErrorType(error) {
 function mapErrorTypeFromCode(code) {
   if (!code) return "unknown";
   if (code === "RATE_LIMITED") return "rate_limited";
-  if (code === "INVALID_ARGUMENT" || code === "VALIDATION_ERROR" || code === "VALIDATION_001" || code === "APPROVAL_REQUIRED" || code === "WEBHOOK_APPROVAL_REQUIRED" || code === "TARGET_LIMIT_EXCEEDED") return "validation";
+  if (code === "INVALID_ARGUMENT" || code === "VALIDATION_ERROR" || code === "VALIDATION_001" || code === "SIGNAL_RUN_COMPANY_MISMATCH" || code === "APPROVAL_REQUIRED" || code === "WEBHOOK_APPROVAL_REQUIRED" || code === "TARGET_LIMIT_EXCEEDED") return "validation";
   if (code === "AUTH_REQUIRED" || code === "AUTH_001") return "auth_expired";
   if (code === "QUOTA_EXCEEDED") return "insufficient_credits";
   if (code === "BUILD_NOT_READY" || code === "ARTIFACT_NOT_READY") return "not_found";
@@ -552,17 +559,16 @@ var Signaliz = class {
     };
   }
   async signalToCopy(params) {
+    validateSignalToCopyParams(params);
     const request = signalToCopyRequestBody(params);
     let data = await this.client.post("api/v1/signal-to-copy", request);
-    if (params.waitForResult !== false && data.run_id && isPendingSignalResponse(data)) {
+    if (params.waitForResult !== false && (data.signal_run_id || data.run_id) && isPendingSignalResponse(data)) {
       const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
       const startedAt = Date.now();
       while (Date.now() - startedAt < maxWaitMs) {
         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
-        });
+        const signalRunId = data.signal_run_id || data.run_id;
+        data = await this.client.post("api/v1/signal-to-copy", data.resume_context_persisted === true ? { signal_run_id: signalRunId } : { ...request, signal_run_id: signalRunId });
         if (!isPendingSignalResponse(data)) break;
       }
       if (isPendingSignalResponse(data)) {
@@ -573,6 +579,7 @@ var Signaliz = class {
   }
   async createSignalCopyBatch(requests, options) {
     validateBatchSize(requests);
+    requests.forEach(validateSignalToCopyParams);
     const startedAt = Date.now();
     const deduplicated = dedupeExactBatchItems(requests, (params) => JSON.stringify({
       request: signalToCopyRequestBody(params),
@@ -582,7 +589,7 @@ var Signaliz = class {
     }));
     const uniqueRequests = deduplicated.uniqueItems;
     const canUseRecoverableAvailableDataJob = uniqueRequests.length > 25 && uniqueRequests.every(
-      (params) => params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
+      (params) => (!params.signalRunId || !params.signalRunId.startsWith("copy_") && [params.companyDomain, params.personName, params.title, params.campaignOffer].every((value) => typeof value === "string" && Boolean(value.trim()))) && params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
     );
     const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests, options) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
     const results = requests.map((_, index) => ({
@@ -769,7 +776,7 @@ var Signaliz = class {
         );
         nextPending.push({
           ...task,
-          request: { ...task.request, signal_run_id: signalRunId }
+          request: item.resume_context_persisted === true ? { signal_run_id: signalRunId } : { ...task.request, signal_run_id: signalRunId }
         });
       }
       pending = nextPending;
@@ -975,15 +982,16 @@ function companySignalRecoverableBatchOptions(companies, tasks) {
   return { label: "Company Signals", pageSize: 25, maxWaitMs };
 }
 function normalizeCompanySignalResult(params, data) {
+  const rawSignals = data.signals ?? data.signal_feed ?? [];
   return {
     success: data.success ?? true,
     status: data.status,
-    signalRunId: data.signal_run_id ?? data.run_id,
+    signalRunId: data.signal_run_id ?? data.run_id ?? params.signalRunId,
     company: {
       name: data.company?.name ?? params.companyName ?? null,
       domain: data.company?.domain ?? params.companyDomain ?? null
     },
-    signals: (data.signals ?? []).map((signal) => {
+    signals: rawSignals.map((signal) => {
       const metadata = signal.metadata && typeof signal.metadata === "object" && !Array.isArray(signal.metadata) ? signal.metadata : void 0;
       return {
         id: signal.id,
@@ -1007,9 +1015,20 @@ function normalizeCompanySignalResult(params, data) {
         metadata
       };
     }),
-    signalCount: data.signal_count ?? data.total_signals ?? data.signals?.length ?? 0,
+    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,
+    liveProviderCalled: data.live_provider_called,
     metadata: data.metadata,
     raw: data
   };
@@ -1107,11 +1126,24 @@ function signalToCopyRequestBody(params) {
     enable_deep_search: params.enableDeepSearch
   });
 }
+function validateSignalToCopyParams(params) {
+  if (typeof params.signalRunId === "string" && params.signalRunId.trim()) return;
+  const missing = [
+    ["companyDomain", params.companyDomain],
+    ["personName", params.personName],
+    ["title", params.title],
+    ["campaignOffer", params.campaignOffer]
+  ].filter(([, value]) => typeof value !== "string" || !value.trim()).map(([field]) => field);
+  if (missing.length > 0) {
+    throw new TypeError(`Signal to Copy requires signalRunId or: ${missing.join(", ")}`);
+  }
+}
 function normalizeSignalToCopyResult(data) {
   return {
     success: data.success ?? true,
     status: data.status,
     runId: data.signal_run_id ?? data.run_id,
+    resumeContextPersisted: data.resume_context_persisted,
     strongestSignal: data.strongest_signal ?? "",
     whyNow: data.why_now ?? "",
     subjectLine: data.subject_line ?? "",
@@ -1119,6 +1151,9 @@ function normalizeSignalToCopyResult(data) {
     confidence: data.confidence ?? 0,
     evidenceUrl: data.evidence_url ?? "",
     researchPrompt: data.research_prompt,
+    empty: data.empty,
+    emptyReason: data.empty_reason,
+    researchMetadata: data.research_metadata,
     variations: (data.variations ?? []).map((variation) => ({
       style: variation.style,
       subjectLine: variation.subject_line ?? "",

package/dist/mcp-config.mjs

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

package/package.json

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