@signaliz/sdk 1.0.40 → 1.0.43

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-A7B63XMZ.mjs → chunk-HQS7N57T.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";
@@ -351,6 +358,7 @@ function mapErrorTypeFromCode(code) {
 }
 
 // src/index.ts
+var MAX_ROW_RATE_LIMIT_RETRIES = 2;
 var Signaliz = class {
   constructor(config) {
     this.client = new HttpClient(config);
@@ -521,17 +529,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 +549,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 +559,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 +746,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;
@@ -746,7 +754,7 @@ var Signaliz = class {
     }
     return results;
   }
-  async runCoreBatchRound(path, tasks, options, companyRecoverableBatch) {
+  async runCoreBatchRound(path, tasks, options, companyRecoverableBatch, rowRateLimitAttempt = 0) {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
@@ -811,6 +819,25 @@ var Signaliz = class {
         };
       }
     }
+    if (rowRateLimitAttempt < MAX_ROW_RATE_LIMIT_RETRIES) {
+      const retryTasks = uniqueTasks.filter((_, index) => isRetryableRowRateLimit(uniqueResults[index]));
+      if (retryTasks.length > 0) {
+        const retryItems = uniqueResults.filter(isRetryableRowRateLimit);
+        await sleep2(rowRateLimitDelayMs(retryItems));
+        const retried = await this.runCoreBatchRound(
+          path,
+          retryTasks,
+          options,
+          void 0,
+          rowRateLimitAttempt + 1
+        );
+        const retriedByIndex = new Map(retried.map((item) => [item.index, item]));
+        for (let index = 0; index < uniqueResults.length; index += 1) {
+          const replacement = retriedByIndex.get(uniqueResults[index].index);
+          if (replacement) uniqueResults[index] = replacement;
+        }
+      }
+    }
     return tasks.map((task, index) => ({
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index: task.index
@@ -828,6 +855,21 @@ var Signaliz = class {
     };
   }
 };
+function isRetryableRowRateLimit(item) {
+  if (!item || item.success || !item.raw || item.raw.retry_eligible === false) return false;
+  const code = String(item.raw.error_code || item.raw.code || "").trim().toUpperCase();
+  return code === "RATE_LIMITED" || /^RATE_\d+$/.test(code);
+}
+function rowRateLimitDelayMs(items) {
+  const delays = items.map((item) => {
+    const retryAfterMs = Number(item.raw?.retry_after_ms);
+    if (Number.isFinite(retryAfterMs) && retryAfterMs > 0) return retryAfterMs;
+    const retryAfterSeconds = Number(item.raw?.retry_after_seconds ?? item.raw?.retry_after);
+    if (Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0) return retryAfterSeconds * 1e3;
+    return 6e4;
+  });
+  return Math.max(1, Math.min(6e4, Math.max(...delays)));
+}
 function recoverableJobRowFailed(row) {
   return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
@@ -1088,11 +1130,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 ?? "",
@@ -1100,6 +1155,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

@@ -167,10 +167,10 @@ interface CompanySignalEnrichmentResult {
     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. */
@@ -193,6 +193,7 @@ interface SignalToCopyResult {
     success: boolean;
     status?: string;
     runId?: string;
+    resumeContextPersisted?: boolean;
     strongestSignal: string;
     whyNow: string;
     subjectLine: string;
@@ -200,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

@@ -167,10 +167,10 @@ interface CompanySignalEnrichmentResult {
     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. */
@@ -193,6 +193,7 @@ interface SignalToCopyResult {
     success: boolean;
     status?: string;
     runId?: string;
+    resumeContextPersisted?: boolean;
     strongestSignal: string;
     whyNow: string;
     subjectLine: string;
@@ -200,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";
@@ -378,6 +385,7 @@ function mapErrorTypeFromCode(code) {
 }
 
 // src/index.ts
+var MAX_ROW_RATE_LIMIT_RETRIES = 2;
 var Signaliz = class {
   constructor(config) {
     this.client = new HttpClient(config);
@@ -548,17 +556,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 +576,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 +586,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 +773,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;
@@ -773,7 +781,7 @@ var Signaliz = class {
     }
     return results;
   }
-  async runCoreBatchRound(path, tasks, options, companyRecoverableBatch) {
+  async runCoreBatchRound(path, tasks, options, companyRecoverableBatch, rowRateLimitAttempt = 0) {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
@@ -838,6 +846,25 @@ var Signaliz = class {
         };
       }
     }
+    if (rowRateLimitAttempt < MAX_ROW_RATE_LIMIT_RETRIES) {
+      const retryTasks = uniqueTasks.filter((_, index) => isRetryableRowRateLimit(uniqueResults[index]));
+      if (retryTasks.length > 0) {
+        const retryItems = uniqueResults.filter(isRetryableRowRateLimit);
+        await sleep2(rowRateLimitDelayMs(retryItems));
+        const retried = await this.runCoreBatchRound(
+          path,
+          retryTasks,
+          options,
+          void 0,
+          rowRateLimitAttempt + 1
+        );
+        const retriedByIndex = new Map(retried.map((item) => [item.index, item]));
+        for (let index = 0; index < uniqueResults.length; index += 1) {
+          const replacement = retriedByIndex.get(uniqueResults[index].index);
+          if (replacement) uniqueResults[index] = replacement;
+        }
+      }
+    }
     return tasks.map((task, index) => ({
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index: task.index
@@ -855,6 +882,21 @@ var Signaliz = class {
     };
   }
 };
+function isRetryableRowRateLimit(item) {
+  if (!item || item.success || !item.raw || item.raw.retry_eligible === false) return false;
+  const code = String(item.raw.error_code || item.raw.code || "").trim().toUpperCase();
+  return code === "RATE_LIMITED" || /^RATE_\d+$/.test(code);
+}
+function rowRateLimitDelayMs(items) {
+  const delays = items.map((item) => {
+    const retryAfterMs = Number(item.raw?.retry_after_ms);
+    if (Number.isFinite(retryAfterMs) && retryAfterMs > 0) return retryAfterMs;
+    const retryAfterSeconds = Number(item.raw?.retry_after_seconds ?? item.raw?.retry_after);
+    if (Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0) return retryAfterSeconds * 1e3;
+    return 6e4;
+  });
+  return Math.max(1, Math.min(6e4, Math.max(...delays)));
+}
 function recoverableJobRowFailed(row) {
   return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
@@ -1115,11 +1157,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 ?? "",
@@ -1127,6 +1182,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-A7B63XMZ.mjs";
+} from "./chunk-HQS7N57T.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";
@@ -382,6 +389,7 @@ function mapErrorTypeFromCode(code) {
 }
 
 // src/index.ts
+var MAX_ROW_RATE_LIMIT_RETRIES = 2;
 var Signaliz = class {
   constructor(config) {
     this.client = new HttpClient(config);
@@ -552,17 +560,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 +580,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 +590,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 +777,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;
@@ -777,7 +785,7 @@ var Signaliz = class {
     }
     return results;
   }
-  async runCoreBatchRound(path2, tasks, options, companyRecoverableBatch) {
+  async runCoreBatchRound(path2, tasks, options, companyRecoverableBatch, rowRateLimitAttempt = 0) {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
@@ -842,6 +850,25 @@ var Signaliz = class {
         };
       }
     }
+    if (rowRateLimitAttempt < MAX_ROW_RATE_LIMIT_RETRIES) {
+      const retryTasks = uniqueTasks.filter((_, index) => isRetryableRowRateLimit(uniqueResults[index]));
+      if (retryTasks.length > 0) {
+        const retryItems = uniqueResults.filter(isRetryableRowRateLimit);
+        await sleep2(rowRateLimitDelayMs(retryItems));
+        const retried = await this.runCoreBatchRound(
+          path2,
+          retryTasks,
+          options,
+          void 0,
+          rowRateLimitAttempt + 1
+        );
+        const retriedByIndex = new Map(retried.map((item) => [item.index, item]));
+        for (let index = 0; index < uniqueResults.length; index += 1) {
+          const replacement = retriedByIndex.get(uniqueResults[index].index);
+          if (replacement) uniqueResults[index] = replacement;
+        }
+      }
+    }
     return tasks.map((task, index) => ({
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index: task.index
@@ -859,6 +886,21 @@ var Signaliz = class {
     };
   }
 };
+function isRetryableRowRateLimit(item) {
+  if (!item || item.success || !item.raw || item.raw.retry_eligible === false) return false;
+  const code = String(item.raw.error_code || item.raw.code || "").trim().toUpperCase();
+  return code === "RATE_LIMITED" || /^RATE_\d+$/.test(code);
+}
+function rowRateLimitDelayMs(items) {
+  const delays = items.map((item) => {
+    const retryAfterMs = Number(item.raw?.retry_after_ms);
+    if (Number.isFinite(retryAfterMs) && retryAfterMs > 0) return retryAfterMs;
+    const retryAfterSeconds = Number(item.raw?.retry_after_seconds ?? item.raw?.retry_after);
+    if (Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0) return retryAfterSeconds * 1e3;
+    return 6e4;
+  });
+  return Math.max(1, Math.min(6e4, Math.max(...delays)));
+}
 function recoverableJobRowFailed(row) {
   return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
@@ -1119,11 +1161,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 ?? "",
@@ -1131,6 +1186,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-A7B63XMZ.mjs";
+} from "./chunk-HQS7N57T.mjs";
 
 // src/mcp-config.ts
 import * as fs from "fs";

package/package.json

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