@signaliz/cli 1.0.57 → 1.0.60

package/README.md

@@ -55,8 +55,20 @@ signaliz find-email --input contacts.jsonl --concurrency 20 --json
 signaliz verify-email --input emails.json --concurrency 20 --json
 signaliz company-signals --input companies.jsonl --concurrency 5 --json
 signaliz signal-to-copy --input copy-requests.jsonl --concurrency 5 --json
+
+# Yield an agent turn immediately for a durable >25-row batch.
+# The response includes both job_id and the actual idempotency_key.
+signaliz company-signals --input companies.jsonl --no-wait --json
+signaliz company-signals --job-id job_... --idempotency-key key_... --json
+signaliz signal-to-copy --input copy-requests.jsonl --no-wait --json
+signaliz signal-to-copy --job-id job_... --idempotency-key key_... --json
 ```
 
+Retrieve completed Company/Copy result pages within seven days. If retention
+expires, the CLI returns non-retryable `BATCH_RESULTS_EXPIRED`; do not
+automatically rerun the submission because provider work may already have been
+performed.
+
 The CLI compacts exact duplicate successes by default: the first row contains
 the full result and repeats contain `duplicateOf` pointing to its zero-based
 input index. Use `--expand-duplicates` only when every repeated row must contain
@@ -97,30 +109,36 @@ they reduce the ceiling.
 
 Batch input is capped at 5,000 records, concurrency is bounded to `1-50`, input
 order is preserved, and a failed item does not abort successful items.
-Exact duplicate tasks are single-flighted across the full input before
-transport. The four row-oriented core products use one recoverable REST job for inputs larger
-than 25; the CLI waits for completion and retrieves every result page before it
-emits complete results or terminal per-row errors. Find Email, Verify Email, and
-Signal to Copy use 500-row pages, while Company Signal Enrichment uses 25-row
-pages. Durable Signal to Copy jobs use available company-signal data only. If a
-Company Signal row contains `signal_run_id`, the CLI preserves the recovery-read
-contract with direct batches of at most 25. If a
-copy row explicitly requests fresh or deep research, the CLI preserves that
-behavior with synchronous chunks of at most 25. Signal to Copy also shares
-company research across recipients.
+Synchronous exact duplicates are single-flighted. Durable Company/Copy
+submissions preserve every row and index so idempotency stays stable across
+REST, MCP, SDK, and CLI recovery. The four row-oriented core products use one
+recoverable REST job for inputs larger than 25; the CLI waits by default or
+returns `job_id`, `idempotency_key`, and an exact resume command with
+`--no-wait`. Find Email, Verify Email, and Company Signal Enrichment use 25-row
+pages; Signal to Copy uses 100-row pages. Large Find Email and Verify Email
+batches honor `--max-wait-ms` and `--poll-interval-ms`. Durable Signal to Copy jobs use
+persisted, eligible company-signal data only and never start live providers or
+deep research. Large Copy inputs with fresh, deep, skip-cache, per-row
+idempotency, or synchronous-only controls fail locally before HTTP; split those
+requests into batches of at most 25. Company Signal `signal_run_id` recovery
+rows likewise stay in direct batches of at most 25. Large Company Signal jobs
+persist bounded result pages and exclude rejected candidate-evidence
+diagnostics; use `--include-candidate-evidence` only with batches of at most 25.
 
 Every command uses the authenticated workspace. Find Email and Verify Email
 honor that workspace's configured cache window; eligible hits cost 0 credits,
-while fresh discovery or verification is charged on every plan. Team, Agency,
-and Pay-As-You-Go include fresh Company Signals and Signal to Copy. Those plans
-still check eligible workspace signal data first even when Company Signals is
-set to No cache. `--lookback-days` remains a hard evidence-age bound for both
+while fresh discovery or verification is charged on every plan. Builder, Team,
+Agency, and Pay-As-You-Go include fresh Company Signals. Team and Agency also
+include Unlimited Signal to Copy AI; Signal to Copy remains callable on other
+plans under the standard product contract. These plans still check eligible
+workspace signal data first even when Company Signals is set to No cache.
+`--lookback-days` remains a hard evidence-age bound for both
 cached and fresh Company Signals and Signal to Copy results.
 
 Signals Everything is a query-first company discovery command rather than a
 row batch. It returns only dated, source-linked signals that contain both a
 company name and company domain. The default request is 100 companies and the
-maximum is 1,000. It is included on Team and Agency plans, is resumable with
+maximum is 1,000. It is included on Builder, Team, and Agency plans, is resumable with
 `signal_search_run_id`, and reports a strict source-cost guardrail: results are
 only returned when source cost is below $0.01 per qualified company. A request
 is a ceiling, not a promise: it can return fewer results when public evidence

package/dist/bin.js

@@ -14,13 +14,19 @@ var HELP = `Signaliz CLI
 Five product commands:
   signaliz find-email --company-domain example.com --full-name "Jane Doe" [--skip-cache]
   signaliz find-email --run-id run_...  Resume an existing Find Email run without duplicate spend
+  signaliz find-email --job-id job_...  Resume an existing Find Email batch without redispatch
   signaliz verify-email [jane@example.com] [--verification-run-id run_...] [--no-wait] [--max-wait-ms 600000]
+  signaliz verify-email --job-id job_...  Resume an existing Verify Email batch without redispatch
   signaliz company-signals --domain example.com [--research-prompt "..."] [--search-mode fast|balanced|coverage] [--include-candidate-evidence] [--no-summary] [--max-wait-ms 120000]
+  signaliz company-signals --input companies.json --no-wait  Submit a durable >25-row batch and return its job
+  signaliz company-signals --job-id job_...  Resume an existing Company Signals batch without redispatch
   signaliz company-signals --signal-run-id run_...  Read a completed run without duplicate spend
   signaliz signal-to-copy --company-domain example.com --person-name "Jane Doe" \\
     --title "VP Sales" --campaign-offer "pipeline intelligence" [--signal-run-id run_...] \\
     [--lookback-days 90] [--skip-cache] [--deep-search] [--max-wait-ms 120000]
   signaliz signal-to-copy --signal-run-id copy_...  Reuse a completed signal run
+  signaliz signal-to-copy --input recipients.json --no-wait  Submit an available-data-only >25-row batch
+  signaliz signal-to-copy --job-id job_...  Resume an existing Signal to Copy batch without redispatch
   signaliz signals "companies that just got funded" [--icp-context "..."] [--limit 100] [--sources web,news] [--wait]
   signaliz signals --signal-search-run-id run_...  Resume an existing company-attributed signal search
 
@@ -44,10 +50,11 @@ Common flags:
   --concurrency <1-50>          Simultaneous API requests for batch input (default: 10)
   --idempotency-key <key>       Reuse after an ambiguous response to recover the same request or job
   --run-id <run_...>            Resume one existing Find Email run without dispatching new work
+  --job-id <job_...>            Resume an existing core-product batch without dispatching new work
   --icp-context <text>          Optional ICP, product, or pain context that returned signals must support
   --dry-run                     Return a no-spend plan without provider calls, jobs, or writes
 
-Company Signals and Signal to Copy always wait for complete results or terminal errors. Signals Everything is asynchronous by default; use --wait to poll until it completes.
+Company Signals and Signal to Copy wait by default. For a durable batch larger than 25 rows, use --no-wait to return job_id + idempotency_key immediately, then resume with --job-id. Large Company Signal batches exclude candidate-evidence diagnostics; split --include-candidate-evidence requests into batches of at most 25. Large Signal to Copy batches are available-data-only. Signals Everything is asynchronous by default; use --wait to poll until it completes.
 `;
 function loadConfig() {
   if (!(0, import_node_fs.existsSync)(CONFIG_FILE)) return {};
@@ -88,6 +95,12 @@ function numberFlag(name) {
   if (!Number.isFinite(parsed)) fail(`--${name} must be a number`);
   return parsed;
 }
+function requireIntegerInRange(value, name, minimum, maximum) {
+  if (value === void 0) return;
+  if (!Number.isInteger(value) || value < minimum || value > maximum) {
+    throw new RangeError(`${name} must be an integer between ${minimum} and ${maximum}`);
+  }
+}
 function csvFlag(name) {
   const value = flag(name);
   return value?.split(",").map((item) => item.trim()).filter(Boolean);
@@ -127,37 +140,191 @@ function readBatchInput() {
 function record(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
-function customerEmailResult(value) {
+function safeNonNegativeNumber(value) {
+  if (value === null || value === void 0 || value === "") return null;
+  const numeric = Number(value);
+  return Number.isFinite(numeric) && numeric >= 0 ? numeric : null;
+}
+function customerEmailBillingMetadata(value) {
+  const source = record(value);
+  const safe = {};
+  if (typeof source.result_returned_from === "string") safe.result_returned_from = source.result_returned_from;
+  for (const field of ["cache_hit", "fresh_enrichment_used", "live_provider_called", "openrouter_called", "byo_openrouter_used"]) {
+    if (typeof source[field] === "boolean") safe[field] = source[field];
+  }
+  for (const field of ["credits_used", "credits_charged", "estimated_external_cost_usd"]) {
+    const numeric = safeNonNegativeNumber(source[field]);
+    if (numeric !== null) safe[field] = numeric;
+  }
+  return safe;
+}
+function customerEmailResult(value, kind) {
   const result = record(value);
   const raw = record(result.raw);
   if (String(result.status || "").toLowerCase() === "processing") {
-    const verificationRunId = result.verificationRunId ?? raw.verification_run_id;
-    const runId = result.runId ?? raw.run_id ?? verificationRunId;
+    const verificationRunId2 = result.verificationRunId ?? raw.verification_run_id;
+    const runId2 = result.runId ?? raw.run_id ?? verificationRunId2;
     return {
       success: true,
       status: "processing",
       email: null,
-      run_id: runId,
-      ...verificationRunId ? { verification_run_id: verificationRunId } : {},
+      run_id: runId2,
+      ...verificationRunId2 ? { verification_run_id: verificationRunId2 } : {},
       next_poll_after_seconds: result.nextPollAfterSeconds ?? raw.next_poll_after_seconds,
-      suggested_action: result.suggestedAction ?? raw.suggested_action ?? (verificationRunId ? "retry_with_verification_run_id" : "retry_with_run_id")
+      suggested_action: result.suggestedAction ?? raw.suggested_action ?? (verificationRunId2 ? "retry_with_verification_run_id" : "retry_with_run_id")
     };
   }
   const creditsUsed = Number(result.creditsUsed ?? raw.credits_used ?? 0);
-  return {
+  const base = {
     email: typeof result.email === "string" && result.email.trim() ? result.email.trim() : null,
     status: "completed",
     success: result.success === true,
-    is_valid: typeof raw.is_valid === "boolean" ? raw.is_valid : result.isValid ?? result.isVerified ?? false,
+    is_valid: typeof result.isValid === "boolean" ? result.isValid : typeof raw.is_valid === "boolean" ? raw.is_valid : result.isVerified ?? false,
     credits_used: Number.isFinite(creditsUsed) && creditsUsed >= 0 ? creditsUsed : 0
   };
+  if (kind === "find") {
+    const verifiedForSending2 = typeof result.isVerifiedForSending === "boolean" ? result.isVerifiedForSending : raw.verified_for_sending === true;
+    const isCatchAll2 = typeof result.isCatchAll === "boolean" ? result.isCatchAll : raw.email_is_catch_all === true || raw.is_catch_all === true;
+    const verificationStatus2 = String(
+      result.verificationStatus ?? raw.verification_status ?? raw.deliverability_status ?? (verifiedForSending2 ? "valid" : "unknown")
+    ).toLowerCase();
+    const deliverabilityStatus2 = String(
+      result.deliverabilityStatus ?? raw.deliverability_status ?? verificationStatus2
+    ).toLowerCase();
+    const verificationVerdict2 = String(
+      result.verificationVerdict ?? raw.verification_verdict ?? verificationStatus2
+    ).toLowerCase();
+    const billingMetadata2 = customerEmailBillingMetadata(
+      Object.keys(record(result.billingMetadata)).length > 0 ? result.billingMetadata : raw.billing_metadata
+    );
+    const historicalBillingMetadata2 = customerEmailBillingMetadata(
+      Object.keys(record(result.historicalBillingMetadata)).length > 0 ? result.historicalBillingMetadata : raw.historical_billing_metadata
+    );
+    const cacheHit2 = typeof raw.cache_hit === "boolean" ? raw.cache_hit : result.cacheHit === true;
+    const negativeCacheHit2 = typeof raw.negative_cache_hit === "boolean" ? raw.negative_cache_hit : result.negativeCacheHit === true;
+    const resultReturnedFrom = result.resultReturnedFrom ?? raw.result_returned_from ?? null;
+    const freshEnrichmentUsed = typeof raw.fresh_enrichment_used === "boolean" ? raw.fresh_enrichment_used : result.freshEnrichmentUsed === true;
+    const liveProviderCalled = typeof raw.live_provider_called === "boolean" ? raw.live_provider_called : result.liveProviderCalled === true;
+    const normalizedBillingMetadata = {
+      ...billingMetadata2,
+      ...resultReturnedFrom ? { result_returned_from: resultReturnedFrom } : {},
+      cache_hit: cacheHit2,
+      fresh_enrichment_used: freshEnrichmentUsed,
+      credits_used: base.credits_used,
+      live_provider_called: liveProviderCalled
+    };
+    const estimatedExternalCostUsd2 = safeNonNegativeNumber(
+      result.estimatedExternalCostUsd ?? raw.estimated_external_cost_usd
+    );
+    return {
+      ...base,
+      is_valid: verifiedForSending2,
+      verification_status: verificationStatus2,
+      deliverability_status: deliverabilityStatus2,
+      verification_verdict: verificationVerdict2,
+      verified_for_sending: verifiedForSending2,
+      is_deliverable: typeof result.isDeliverable === "boolean" ? result.isDeliverable && verifiedForSending2 : verifiedForSending2,
+      email_is_catch_all: isCatchAll2,
+      is_catch_all: isCatchAll2,
+      verification_source: result.verificationSource ?? raw.verification_source ?? result.providerUsed ?? "email_finder",
+      ...result.verificationObservedAt ?? raw.verification_observed_at ? { verification_observed_at: result.verificationObservedAt ?? raw.verification_observed_at } : {},
+      failure_reason: result.failureReason ?? raw.failure_reason ?? (verifiedForSending2 ? "none" : "no_verified_email_found"),
+      cache_hit: cacheHit2,
+      negative_cache_hit: negativeCacheHit2,
+      negative_cache_ttl_seconds: safeNonNegativeNumber(
+        result.negativeCacheTtlSeconds ?? raw.negative_cache_ttl_seconds
+      ),
+      cache_tier: result.cacheTier ?? raw.cache_tier ?? null,
+      result_returned_from: resultReturnedFrom,
+      fresh_enrichment_used: freshEnrichmentUsed,
+      live_provider_called: liveProviderCalled,
+      billing_metadata: normalizedBillingMetadata,
+      ...Object.keys(historicalBillingMetadata2).length > 0 ? { historical_billing_metadata: historicalBillingMetadata2 } : {},
+      ...estimatedExternalCostUsd2 !== null ? { estimated_external_cost_usd: estimatedExternalCostUsd2 } : {},
+      ...result.runId ?? raw.run_id ? { run_id: result.runId ?? raw.run_id } : {},
+      ...raw.cache_publication_status ? {
+        cache_publication_status: raw.cache_publication_status,
+        cache_publication_retry_eligible: raw.cache_publication_retry_eligible === true,
+        ...raw.suggested_action ? { suggested_action: raw.suggested_action } : {}
+      } : {}
+    };
+  }
+  const verificationStatus = String(
+    result.verificationStatus ?? raw.verification_status ?? result.verificationVerdict ?? raw.verification_verdict ?? raw.deliverability_status ?? "unknown"
+  ).toLowerCase();
+  const deliverabilityStatus = String(
+    result.deliverabilityStatus ?? raw.deliverability_status ?? verificationStatus
+  ).toLowerCase();
+  const verificationVerdict = String(
+    result.verificationVerdict ?? raw.verification_verdict ?? verificationStatus
+  ).toLowerCase();
+  const verifiedForSending = typeof result.verifiedForSending === "boolean" ? result.verifiedForSending : raw.verified_for_sending === true;
+  const isDeliverable = typeof result.isDeliverable === "boolean" ? result.isDeliverable : raw.is_deliverable === true;
+  const isCatchAll = typeof result.isCatchAll === "boolean" ? result.isCatchAll : raw.email_is_catch_all === true || raw.is_catch_all === true;
+  const isRoleAccount = typeof result.isRoleAccount === "boolean" ? result.isRoleAccount : raw.is_role_account === true;
+  const isMalformed = typeof result.isMalformed === "boolean" ? result.isMalformed : raw.is_malformed === true;
+  const quality = typeof result.quality === "string" ? result.quality : typeof raw.quality === "string" ? raw.quality : null;
+  const recommendation = typeof result.recommendation === "string" ? result.recommendation : typeof raw.recommendation === "string" ? raw.recommendation : verifiedForSending ? "send" : ["unknown", "verifier_error"].includes(verificationStatus) ? "manual_review" : "do_not_send";
+  const cacheHit = typeof raw.cache_hit === "boolean" ? raw.cache_hit : result.cacheHit === true;
+  const negativeCacheHit = typeof raw.negative_cache_hit === "boolean" ? raw.negative_cache_hit : result.negativeCacheHit === true;
+  const negativeCacheTtlSeconds = safeNonNegativeNumber(
+    result.negativeCacheTtlSeconds ?? raw.negative_cache_ttl_seconds
+  );
+  const billingMetadata = customerEmailBillingMetadata(
+    Object.keys(record(result.billingMetadata)).length > 0 ? result.billingMetadata : raw.billing_metadata
+  );
+  const historicalBillingMetadata = customerEmailBillingMetadata(
+    Object.keys(record(result.historicalBillingMetadata)).length > 0 ? result.historicalBillingMetadata : raw.historical_billing_metadata
+  );
+  const verificationRunId = result.verificationRunId ?? raw.verification_run_id ?? raw.run_id;
+  const runId = result.runId ?? raw.run_id ?? verificationRunId;
+  const estimatedExternalCostUsd = safeNonNegativeNumber(
+    result.estimatedExternalCostUsd ?? raw.estimated_external_cost_usd
+  );
+  return {
+    ...base,
+    verification_status: verificationStatus,
+    deliverability_status: deliverabilityStatus,
+    verification_verdict: verificationVerdict,
+    verified_for_sending: verifiedForSending,
+    is_deliverable: isDeliverable,
+    email_is_catch_all: isCatchAll,
+    is_catch_all: isCatchAll,
+    is_role_account: isRoleAccount,
+    is_malformed: isMalformed,
+    quality,
+    recommendation,
+    smtp_status: result.smtpStatus ?? raw.smtp_status ?? (isCatchAll ? "accept_all" : verifiedForSending ? "accepted" : "not_checked"),
+    provider_status: result.providerStatus ?? raw.provider_status ?? verificationStatus,
+    verification_source: result.verificationSource ?? raw.verification_source ?? "email_verification",
+    ...result.verificationObservedAt ?? raw.verification_observed_at ? { verification_observed_at: result.verificationObservedAt ?? raw.verification_observed_at } : {},
+    failure_reason: result.failureReason ?? raw.failure_reason ?? (verifiedForSending ? "none" : isCatchAll ? "catch_all_domain_not_send_safe" : "verification_not_send_safe"),
+    cache_hit: cacheHit,
+    negative_cache_hit: negativeCacheHit,
+    negative_cache_ttl_seconds: negativeCacheTtlSeconds,
+    cache_tier: result.cacheTier ?? raw.cache_tier ?? null,
+    result_returned_from: result.resultReturnedFrom ?? raw.result_returned_from ?? null,
+    fresh_enrichment_used: typeof raw.fresh_enrichment_used === "boolean" ? raw.fresh_enrichment_used : result.freshEnrichmentUsed === true,
+    live_provider_called: typeof raw.live_provider_called === "boolean" ? raw.live_provider_called : result.liveProviderCalled === true,
+    billing_replayed: typeof raw.billing_replayed === "boolean" ? raw.billing_replayed : result.billingReplayed === true,
+    billing_metadata: billingMetadata,
+    ...Object.keys(historicalBillingMetadata).length > 0 ? { historical_billing_metadata: historicalBillingMetadata } : {},
+    ...estimatedExternalCostUsd !== null ? { estimated_external_cost_usd: estimatedExternalCostUsd } : {},
+    ...verificationRunId ? { verification_run_id: verificationRunId } : {},
+    ...runId ? { run_id: runId } : {},
+    ...raw.cache_publication_status ? {
+      cache_publication_status: raw.cache_publication_status,
+      cache_publication_retry_eligible: raw.cache_publication_retry_eligible === true,
+      ...raw.suggested_action ? { suggested_action: raw.suggested_action } : {}
+    } : {}
+  };
 }
-function customerEmailBatch(value) {
+function customerEmailBatch(value, kind) {
   return {
     ...value,
     results: value.results.map((item) => {
       const row = record(item);
-      return promoteBatchRecoveryMetadata(row.data ? { ...row, data: customerEmailResult(row.data) } : row);
+      return promoteBatchRecoveryMetadata(row.data ? { ...row, data: customerEmailResult(row.data, kind) } : row);
     })
   };
 }
@@ -199,14 +366,40 @@ function batchOptions() {
   return {
     concurrency: numberFlag("concurrency"),
     idempotencyKey: flag("idempotency-key"),
-    compactDuplicates: !hasFlag("expand-duplicates")
+    compactDuplicates: !hasFlag("expand-duplicates"),
+    maxWaitMs: numberFlag("max-wait-ms"),
+    pollIntervalMs: numberFlag("poll-interval-ms")
   };
 }
-function rejectAsyncSignalFlags() {
-  if (hasFlag("no-wait") || hasFlag("poll-interval-ms")) {
-    fail("Company Signals and Signal to Copy are always synchronous; --no-wait and --poll-interval-ms are not supported.");
+function rejectDurableNoWaitPollingFlags(label) {
+  if (!hasFlag("no-wait")) return;
+  const conflicts = ["max-wait-ms", "poll-interval-ms", "concurrency"].filter(hasFlag);
+  if (conflicts.length > 0) {
+    fail(`${label} --no-wait cannot be combined with ${conflicts.map((name) => `--${name}`).join(", ")}.`);
   }
 }
+function recoverableJobOutput(value, command) {
+  const resumeCommand = `signaliz ${command} --job-id ${value.jobId} --idempotency-key ${value.idempotencyKey}`;
+  const payload = {
+    success: true,
+    status: value.status,
+    capability: value.capability,
+    job_id: value.jobId,
+    idempotency_key: value.idempotencyKey,
+    total: value.total,
+    next_poll_after_seconds: value.nextPollAfterSeconds,
+    suggested_action: "check_job_status",
+    resume_command: resumeCommand
+  };
+  output(payload, () => {
+    process.stdout.write(`Durable ${command} batch submitted: ${value.jobId}
+`);
+    process.stdout.write(`Idempotency key: ${value.idempotencyKey}
+`);
+    process.stdout.write(`Resume with: ${resumeCommand}
+`);
+  });
+}
 function batchOutput(value) {
   if (hasFlag("jsonl")) {
     for (const result of value.results) {
@@ -493,12 +686,41 @@ async function auth(args) {
   fail("Usage: signaliz auth <login|set-key|workspace|status>");
 }
 async function findEmail() {
+  const jobId = flag("job-id");
+  if (jobId) {
+    const conflicts = [
+      "input",
+      "dry-run",
+      "company-domain",
+      "domain",
+      "full-name",
+      "first-name",
+      "last-name",
+      "linkedin-url",
+      "company-name",
+      "run-id",
+      "skip-cache"
+    ].filter(hasFlag);
+    if (conflicts.length > 0) {
+      fail(`Find Email --job-id cannot be combined with ${conflicts.map((name) => `--${name}`).join(", ")}.`);
+    }
+    const result2 = await createClient().resumeFindEmailBatch(jobId, {
+      pageSize: numberFlag("page-size"),
+      maxWaitMs: numberFlag("max-wait-ms"),
+      pollIntervalMs: numberFlag("poll-interval-ms"),
+      compactDuplicates: !hasFlag("expand-duplicates"),
+      idempotencyKey: flag("idempotency-key")
+    });
+    batchOutput(customerEmailBatch(result2, "find"));
+    return;
+  }
   const rows = readBatchInput();
   if (rows) {
     const requests = rows.map((value) => {
       const row = record(value);
       const runId2 = row.runId || row.run_id;
-      if (runId2) return { runId: runId2 };
+      const idempotencyKey = row.idempotencyKey || row.idempotency_key;
+      if (runId2) return { runId: runId2, idempotencyKey };
       return {
         companyDomain: row.companyDomain || row.company_domain || row.domain,
         fullName: row.fullName || row.full_name || row.name,
@@ -506,7 +728,8 @@ async function findEmail() {
         lastName: row.lastName || row.last_name,
         linkedinUrl: row.linkedinUrl || row.linkedin_url || row.linkedin,
         companyName: row.companyName || row.company_name,
-        skipCache: row.skipCache ?? row.skip_cache ?? hasFlag("skip-cache")
+        skipCache: row.skipCache ?? row.skip_cache ?? hasFlag("skip-cache"),
+        idempotencyKey
       };
     });
     if (hasFlag("dry-run")) {
@@ -515,7 +738,7 @@ async function findEmail() {
       return;
     }
     const result2 = await createClient().findEmails(requests, batchOptions());
-    batchOutput(customerEmailBatch(result2));
+    batchOutput(customerEmailBatch(result2, "find"));
     return;
   }
   const companyDomain = flag("company-domain") || flag("domain");
@@ -543,7 +766,7 @@ async function findEmail() {
     return;
   }
   const result = await createClient().findEmail(request);
-  const publicResult = customerEmailResult(result);
+  const publicResult = customerEmailResult(result, "find");
   if (outputFailedCoreProduct(publicResult, "No verified email found")) return;
   output(publicResult, () => {
     if (result.status === "processing" && result.runId) {
@@ -566,9 +789,45 @@ async function findEmail() {
   });
 }
 async function verifyEmail(args) {
+  const jobId = flag("job-id");
+  if (jobId) {
+    const positionalEmail = args[0] && !args[0].startsWith("--");
+    const conflicts = [
+      "input",
+      "dry-run",
+      "email",
+      "verification-run-id",
+      "skip-cache",
+      "no-wait"
+    ].filter(hasFlag);
+    if (positionalEmail || conflicts.length > 0) {
+      const conflictList = [
+        ...positionalEmail ? ["email argument"] : [],
+        ...conflicts.map((name) => `--${name}`)
+      ];
+      fail(`Verify Email --job-id cannot be combined with ${conflictList.join(", ")}.`);
+    }
+    const result2 = await createClient().resumeVerifyEmailBatch(jobId, {
+      pageSize: numberFlag("page-size"),
+      maxWaitMs: numberFlag("max-wait-ms"),
+      pollIntervalMs: numberFlag("poll-interval-ms"),
+      compactDuplicates: !hasFlag("expand-duplicates"),
+      idempotencyKey: flag("idempotency-key")
+    });
+    batchOutput(customerEmailBatch(result2, "verify"));
+    return;
+  }
   const rows = readBatchInput();
   if (rows) {
-    const emails = rows.map((value) => typeof value === "string" ? value : String(record(value).email || ""));
+    const emails = rows.map((value) => {
+      if (typeof value === "string") return value;
+      const row = record(value);
+      return {
+        email: String(row.email || ""),
+        skipCache: row.skipCache ?? row.skip_cache ?? hasFlag("skip-cache"),
+        idempotencyKey: row.idempotencyKey || row.idempotency_key
+      };
+    });
     if (hasFlag("dry-run")) {
       const result3 = await createClient().verifyEmails(emails, {
         ...batchOptions(),
@@ -582,7 +841,7 @@ async function verifyEmail(args) {
       ...batchOptions(),
       skipCache: hasFlag("skip-cache")
     });
-    batchOutput(customerEmailBatch(result2));
+    batchOutput(customerEmailBatch(result2, "verify"));
     return;
   }
   const email = args[0] && !args[0].startsWith("--") ? args[0] : flag("email");
@@ -602,7 +861,7 @@ async function verifyEmail(args) {
     return;
   }
   const result = await createClient().verifyEmail(email, options);
-  const publicResult = customerEmailResult(result);
+  const publicResult = customerEmailResult(result, "verify");
   if (outputFailedCoreProduct(publicResult, "Email verification failed")) return;
   output(publicResult, () => {
     if (result.status === "processing") {
@@ -619,15 +878,62 @@ async function verifyEmail(args) {
     process.stdout.write(`Success: ${publicResult.success}
 `);
     process.stdout.write(`Valid: ${publicResult.is_valid}
+`);
+    process.stdout.write(`Verdict: ${publicResult.verification_status}
+`);
+    process.stdout.write(`Recommendation: ${publicResult.recommendation}
+`);
+    process.stdout.write(`Source: ${publicResult.verification_source}${publicResult.cache_hit === true ? " (cache)" : ""}
+`);
+    if (publicResult.run_id) process.stdout.write(`Run ID: ${publicResult.run_id}
 `);
     process.stdout.write(`Credits used: ${publicResult.credits_used}
 `);
   });
 }
 async function companySignals() {
-  rejectAsyncSignalFlags();
+  const jobId = flag("job-id");
+  if (jobId) {
+    const conflicts = [
+      "input",
+      "dry-run",
+      "domain",
+      "company-domain",
+      "company-name",
+      "signal-run-id",
+      "research-prompt",
+      "prompt",
+      "signal-types",
+      "target-signal-count",
+      "lookback-days",
+      "offline",
+      "shallow",
+      "search-mode",
+      "no-summary",
+      "outreach-intelligence",
+      "predictive-intelligence",
+      "skip-cache",
+      "include-candidate-evidence",
+      "no-wait",
+      "concurrency"
+    ].filter(hasFlag);
+    if (conflicts.length > 0) {
+      fail(`Company Signals --job-id cannot be combined with ${conflicts.map((name) => `--${name}`).join(", ")}.`);
+    }
+    const result2 = await createClient().resumeCompanySignalBatch(jobId, {
+      pageSize: numberFlag("page-size"),
+      maxWaitMs: numberFlag("max-wait-ms"),
+      pollIntervalMs: numberFlag("poll-interval-ms"),
+      idempotencyKey: flag("idempotency-key"),
+      compactDuplicates: !hasFlag("expand-duplicates")
+    });
+    batchOutput(customerSignalBatch(result2));
+    return;
+  }
+  rejectDurableNoWaitPollingFlags("Company Signals");
   const rows = readBatchInput();
   if (rows) {
+    const durableBatch = rows.length > 25;
     const requests = rows.map((value) => {
       const row = record(value);
       const online = row.online ?? !hasFlag("offline");
@@ -637,8 +943,8 @@ async function companySignals() {
         companyName: row.companyName || row.company_name || row.name,
         researchPrompt: row.researchPrompt || row.research_prompt || flag("research-prompt") || flag("prompt"),
         signalTypes: row.signalTypes || row.signal_types || csvFlag("signal-types"),
-        targetSignalCount: row.targetSignalCount || row.target_signal_count || numberFlag("target-signal-count"),
-        lookbackDays: row.lookbackDays || row.lookback_days || numberFlag("lookback-days"),
+        targetSignalCount: row.targetSignalCount ?? row.target_signal_count ?? numberFlag("target-signal-count"),
+        lookbackDays: row.lookbackDays ?? row.lookback_days ?? numberFlag("lookback-days"),
         online,
         enableDeepSearch: row.enableDeepSearch ?? row.enable_deep_search ?? (online && !hasFlag("shallow")),
         searchMode: companySignalSearchMode(row.searchMode ?? row.search_mode ?? flag("search-mode")),
@@ -647,18 +953,34 @@ async function companySignals() {
         enablePredictiveIntelligence: row.enablePredictiveIntelligence ?? row.enable_predictive_intelligence,
         skipCache: row.skipCache ?? row.skip_cache ?? hasFlag("skip-cache"),
         includeCandidateEvidence: row.includeCandidateEvidence ?? row.include_candidate_evidence ?? hasFlag("include-candidate-evidence"),
-        maxWaitMs: row.maxWaitMs || row.max_wait_ms || numberFlag("max-wait-ms")
+        maxWaitMs: row.maxWaitMs ?? row.max_wait_ms ?? (durableBatch ? void 0 : numberFlag("max-wait-ms")),
+        idempotencyKey: row.idempotencyKey || row.idempotency_key
       };
     });
+    for (const request2 of requests) {
+      requireIntegerInRange(request2.targetSignalCount, "targetSignalCount", 1, 15);
+      requireIntegerInRange(request2.lookbackDays, "lookbackDays", 1, 365);
+    }
     if (hasFlag("dry-run")) {
+      if (hasFlag("no-wait")) fail("Company Signals --no-wait cannot be combined with --dry-run.");
       const result3 = await createClient().enrichCompanies(requests, { ...batchOptions(), dryRun: true });
       dryRunOutput(result3);
       return;
     }
+    if (hasFlag("no-wait")) {
+      const job = await createClient().enrichCompanies(requests, {
+        ...batchOptions(),
+        waitForResult: false
+      });
+      recoverableJobOutput(job, "company-signals");
+      return;
+    }
     const result2 = await createClient().enrichCompanies(requests, batchOptions());
     batchOutput(customerSignalBatch(result2));
     return;
   }
+  if (hasFlag("no-wait")) fail("Company Signals --no-wait requires --input with more than 25 homogeneous rows.");
+  if (hasFlag("poll-interval-ms")) fail("Company Signals --poll-interval-ms requires --input or --job-id.");
   const companyDomain = flag("domain") || flag("company-domain");
   const companyName = flag("company-name");
   const signalRunId = flag("signal-run-id");
@@ -807,7 +1129,7 @@ async function signals(args) {
         const identityCost = guardrail.identityResolutionCostUsd === null ? "unavailable" : `$${guardrail.identityResolutionCostUsd}`;
         const identityRequests = guardrail.identityProviderRequests;
         process.stdout.write(
-          `Identity resolution cost: ${identityCost}${identityRequests === void 0 ? "" : ` across ${identityRequests} fallback provider request${identityRequests === 1 ? "" : "s"}`}${guardrail.identityCostSource ? ` (${guardrail.identityCostSource})` : ""}.
+          `Identity resolution cost: ${identityCost}${identityRequests === void 0 ? "" : ` across ${identityRequests} identity lookup request${identityRequests === 1 ? "" : "s"}`}${guardrail.identityCostSource ? ` (${guardrail.identityCostSource})` : ""}.
 `
         );
       }
@@ -824,9 +1146,43 @@ async function signals(args) {
   });
 }
 async function signalToCopy() {
-  rejectAsyncSignalFlags();
+  const jobId = flag("job-id");
+  if (jobId) {
+    const conflicts = [
+      "input",
+      "dry-run",
+      "company-domain",
+      "domain",
+      "person-name",
+      "title",
+      "campaign-offer",
+      "offer",
+      "research-prompt",
+      "prompt",
+      "lookback-days",
+      "signal-run-id",
+      "skip-cache",
+      "deep-search",
+      "no-wait",
+      "concurrency"
+    ].filter(hasFlag);
+    if (conflicts.length > 0) {
+      fail(`Signal to Copy --job-id cannot be combined with ${conflicts.map((name) => `--${name}`).join(", ")}.`);
+    }
+    const result2 = await createClient().resumeSignalCopyBatch(jobId, {
+      pageSize: numberFlag("page-size"),
+      maxWaitMs: numberFlag("max-wait-ms"),
+      pollIntervalMs: numberFlag("poll-interval-ms"),
+      idempotencyKey: flag("idempotency-key"),
+      compactDuplicates: !hasFlag("expand-duplicates")
+    });
+    batchOutput(customerSignalBatch(result2));
+    return;
+  }
+  rejectDurableNoWaitPollingFlags("Signal to Copy");
   const rows = readBatchInput();
   if (rows) {
+    const durableBatch = rows.length > 25;
     const requests = rows.map((value) => {
       const row = record(value);
       return {
@@ -835,22 +1191,34 @@ async function signalToCopy() {
         title: row.title,
         campaignOffer: row.campaignOffer || row.campaign_offer || row.offer,
         researchPrompt: row.researchPrompt || row.research_prompt || flag("research-prompt") || flag("prompt"),
-        lookbackDays: row.lookbackDays || row.lookback_days || numberFlag("lookback-days"),
+        lookbackDays: row.lookbackDays ?? row.lookback_days ?? numberFlag("lookback-days"),
         signalRunId: row.signalRunId || row.signal_run_id,
         skipCache: row.skipCache ?? row.skip_cache ?? hasFlag("skip-cache"),
         enableDeepSearch: row.enableDeepSearch ?? row.enable_deep_search ?? hasFlag("deep-search"),
-        maxWaitMs: row.maxWaitMs || row.max_wait_ms || numberFlag("max-wait-ms")
+        maxWaitMs: row.maxWaitMs ?? row.max_wait_ms ?? (durableBatch ? void 0 : numberFlag("max-wait-ms")),
+        idempotencyKey: row.idempotencyKey || row.idempotency_key
       };
     });
     if (hasFlag("dry-run")) {
+      if (hasFlag("no-wait")) fail("Signal to Copy --no-wait cannot be combined with --dry-run.");
       const result3 = await createClient().createSignalCopyBatch(requests, { ...batchOptions(), dryRun: true });
       dryRunOutput(result3);
       return;
     }
+    if (hasFlag("no-wait")) {
+      const job = await createClient().createSignalCopyBatch(requests, {
+        ...batchOptions(),
+        waitForResult: false
+      });
+      recoverableJobOutput(job, "signal-to-copy");
+      return;
+    }
     const result2 = await createClient().createSignalCopyBatch(requests, batchOptions());
     batchOutput(customerSignalBatch(result2));
     return;
   }
+  if (hasFlag("no-wait")) fail("Signal to Copy --no-wait requires --input with more than 25 available-data-only rows.");
+  if (hasFlag("poll-interval-ms")) fail("Signal to Copy --poll-interval-ms requires --input or --job-id.");
   const companyDomain = flag("company-domain") || flag("domain");
   const personName = flag("person-name");
   const title = flag("title");
@@ -988,6 +1356,7 @@ main().catch((error) => {
       ...typeof signalizError?.details?.run_id === "string" ? { run_id: signalizError.details.run_id } : {},
       ...typeof signalizError?.details?.verification_run_id === "string" ? { verification_run_id: signalizError.details.verification_run_id } : {},
       ...typeof signalizError?.details?.job_id === "string" ? { job_id: signalizError.details.job_id } : {},
+      ...typeof signalizError?.details?.idempotency_key === "string" ? { idempotency_key: signalizError.details.idempotency_key } : {},
       ...typeof signalizError?.details?.suggested_action === "string" ? { suggested_action: signalizError.details.suggested_action } : {},
       ...signalizError?.errorType ? { error_type: signalizError.errorType } : {},
       ...signalizError?.details ? { details: signalizError.details } : {}
@@ -1028,6 +1397,13 @@ No automatic retry is recommended; review the provider outcome or contact suppor
   if (error instanceof import_sdk.SignalizError && typeof error.details?.job_id === "string") {
     const jobId = error.details.job_id;
     if (error.details.suggested_action === "check_job_status") {
+      if (["find-email", "verify-email", "company-signals", "signal-to-copy"].includes(process.argv[2])) {
+        const idempotencyKey = typeof error.details.idempotency_key === "string" ? error.details.idempotency_key : "";
+        const keyFlag = idempotencyKey ? ` --idempotency-key ${idempotencyKey}` : "";
+        fail(`${message}
+Recoverable job: ${jobId}
+Retry with: signaliz ${process.argv[2]} --job-id ${jobId}${keyFlag}`);
+      }
       fail(`${message}
 Recoverable job: ${jobId}
 Resume this job through the REST API or SDK using job_id ${jobId}, or use --json for structured recovery metadata.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.57",
+  "version": "1.0.60",
   "description": "Signaliz CLI for Signals Everything, Find Email, Verify Email, Company Signal Enrichment, and Signal to Copy AI.",
   "bin": {
     "signaliz": "dist/bin.js"
@@ -29,7 +29,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@signaliz/sdk": "^1.0.61"
+    "@signaliz/sdk": "^1.0.63"
   },
   "devDependencies": {
     "tsup": "^8.0.0",