@signaliz/cli 1.0.56 → 1.0.58

package/README.md

@@ -40,6 +40,9 @@ signaliz signal-to-copy --company-domain example.com --person-name "Jane Doe" \
 # Signals Everything returns distinct companies with a source-backed signal.
 # It is asynchronous by default; add --wait or resume the returned run ID.
 signaliz signals "companies that just got funded" --limit 100 --sources web,news
+signaliz signals "companies showing signals they need account-signal automation" \
+  --icp-context "B2B SaaS with outbound teams and manual account research" \
+  --limit 100 --sources web,news
 signaliz signals --signal-search-run-id run_... --wait --json
 ```
 
@@ -52,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
@@ -94,26 +109,38 @@ 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. 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. Builder, 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
+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
-cannot verify both a date and company identity.
+cannot verify both a date and company identity. Use `--icp-context` to qualify
+an open-ended signal request against a target market.
 
 Connection commands are limited to access infrastructure:
 

package/dist/bin.js

@@ -13,14 +13,21 @@ 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_...] \\
-    [--skip-cache] [--deep-search] [--max-wait-ms 120000]
+    [--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 signals "companies that just got funded" [--limit 100] [--sources web,news] [--wait]
+  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
 
 Access and connection:
@@ -42,9 +49,12 @@ Common flags:
   --input -                     Read a JSON array or JSONL batch from stdin
   --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 {};
@@ -124,37 +134,203 @@ 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);
-  if (String(result.status || "").toLowerCase() === "processing") return result;
   const raw = record(result.raw);
-  const verifiedForSending = typeof raw.verified_for_sending === "boolean" ? raw.verified_for_sending : typeof raw._verified_for_sending === "boolean" ? raw._verified_for_sending : result.raw === void 0 && typeof result.verifiedForSending === "boolean" ? result.verifiedForSending : result.raw === void 0 && typeof result.isVerifiedForSending === "boolean" ? result.isVerifiedForSending : void 0;
-  const isCatchAll = typeof result.isCatchAll === "boolean" ? result.isCatchAll : void 0;
-  const isMalformed = result.isMalformed === true || raw.is_malformed === true;
-  const verificationStatus = result.verificationStatus || result.verificationVerdict;
-  return {
-    ...result,
+  if (String(result.status || "").toLowerCase() === "processing") {
+    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: runId2,
+      ...verificationRunId2 ? { verification_run_id: verificationRunId2 } : {},
+      next_poll_after_seconds: result.nextPollAfterSeconds ?? raw.next_poll_after_seconds,
+      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);
+  const base = {
     email: typeof result.email === "string" && result.email.trim() ? result.email.trim() : null,
     status: "completed",
     success: result.success === true,
-    is_valid: verifiedForSending ?? result.isValid ?? result.isVerified ?? false,
-    credits_used: Number(result.creditsUsed || 0),
-    ...verifiedForSending !== void 0 ? { verified_for_sending: verifiedForSending } : {},
-    ...isCatchAll !== void 0 ? { email_is_catch_all: isCatchAll, is_catch_all: isCatchAll } : {},
-    ...typeof result.isMalformed === "boolean" || typeof raw.is_malformed === "boolean" ? { is_malformed: isMalformed } : {},
-    ...verificationStatus ? { verification_status: verificationStatus, verification_verdict: verificationStatus } : {},
-    ...result.billingMetadata ? { billing_metadata: result.billingMetadata } : {}
+    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 row.data ? { ...row, data: customerEmailResult(row.data) } : row;
+      return promoteBatchRecoveryMetadata(row.data ? { ...row, data: customerEmailResult(row.data, kind) } : row);
     })
   };
 }
+function promoteBatchRecoveryMetadata(row) {
+  return {
+    ...row,
+    ...typeof row.runId === "string" ? { run_id: row.runId } : {},
+    ...typeof row.verificationRunId === "string" ? { verification_run_id: row.verificationRunId } : {},
+    ...typeof row.jobId === "string" ? { job_id: row.jobId } : {},
+    ...typeof row.suggestedAction === "string" ? { suggested_action: row.suggestedAction } : {}
+  };
+}
 function customerSignalResult(value) {
   const result = record(value);
   const raw = record(result.raw);
@@ -176,7 +352,7 @@ function customerSignalBatch(value) {
     ...value,
     results: value.results.map((item) => {
       const row = record(item);
-      return row.data ? { ...row, data: customerSignalResult(row.data) } : row;
+      return promoteBatchRecoveryMetadata(row.data ? { ...row, data: customerSignalResult(row.data) } : row);
     })
   };
 }
@@ -184,14 +360,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) {
@@ -256,6 +458,9 @@ function numberValue(value) {
   const number = Number(value);
   return Number.isFinite(number) ? number : void 0;
 }
+function nullableNumberValue(value) {
+  return value === null ? null : numberValue(value);
+}
 function stringValue(value) {
   return typeof value === "string" ? value.trim() : "";
 }
@@ -311,6 +516,7 @@ function normalizeSignalsEverythingResult(request, value) {
   const status = statuses.has(statusValue) ? statusValue : signals2.length > 0 ? "completed" : "failed";
   const guardrail = record(value.cost_guardrail);
   const maxCost = numberValue(guardrail.max_cost_per_qualified_signal_usd);
+  const identityCostSource = stringValue(guardrail.identity_cost_source);
   const warnings = Array.isArray(value.warnings) ? value.warnings.filter((warning) => typeof warning === "string") : void 0;
   return {
     success: value.success !== false,
@@ -327,7 +533,15 @@ function normalizeSignalsEverythingResult(request, value) {
     ...maxCost === void 0 ? {} : {
       costGuardrail: {
         maxCostPerQualifiedSignalUsd: maxCost,
-        costPerQualifiedSignalUsd: value.cost_guardrail && typeof value.cost_guardrail === "object" ? numberValue(guardrail.cost_per_qualified_signal_usd) ?? (guardrail.cost_per_qualified_signal_usd === null ? null : void 0) : void 0
+        costPerQualifiedSignalUsd: nullableNumberValue(guardrail.cost_per_qualified_signal_usd),
+        identityResolutionCostUsd: nullableNumberValue(guardrail.identity_resolution_cost_usd),
+        identityCostSource: [
+          "observed_zero_credit_receipts",
+          "contractual_zero_cost",
+          "not_used",
+          "unavailable"
+        ].includes(identityCostSource) ? identityCostSource : void 0,
+        identityProviderRequests: numberValue(guardrail.identity_provider_requests)
       }
     },
     ...warnings?.length ? { warnings } : {},
@@ -342,6 +556,7 @@ async function discoverSignalsEverything(request) {
     ...request.idempotencyKey ? { idempotency_key: request.idempotencyKey } : {}
   } : {
     query: request.query,
+    ...request.icpContext ? { icp_context: request.icpContext } : {},
     limit: request.limit ?? 100,
     ...request.sources ? { sources: request.sources } : {},
     ...request.lookbackDays === void 0 ? {} : { lookback_days: request.lookbackDays },
@@ -465,10 +680,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",
+      "idempotency-key"
+    ].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")
+    });
+    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;
+      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,
@@ -476,7 +722,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")) {
@@ -485,18 +732,19 @@ 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");
+  const runId = flag("run-id");
   const fullName = flag("full-name");
   const firstName = flag("first-name");
   const lastName = flag("last-name");
   const linkedinUrl = flag("linkedin-url");
-  if (!companyDomain || !fullName && !(firstName && lastName)) {
-    fail('Usage: signaliz find-email --company-domain example.com --full-name "Jane Doe"');
+  if (!runId && (!companyDomain || !fullName && !(firstName && lastName))) {
+    fail('Usage: signaliz find-email --company-domain example.com --full-name "Jane Doe", or signaliz find-email --run-id run_...');
   }
-  const request = {
+  const request = runId ? { runId } : {
     companyDomain,
     fullName,
     firstName,
@@ -512,30 +760,68 @@ 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, () => {
-    process.stdout.write(`${result.email || "No email found"} (${result.verificationStatus})
+    if (result.status === "processing" && result.runId) {
+      process.stdout.write(`Find Email processing: ${result.runId}
 `);
-    process.stdout.write(`Verified for sending: ${result.isVerifiedForSending}
+      process.stdout.write(`Retry after ${result.nextPollAfterSeconds || 3} seconds with --run-id ${result.runId}
 `);
-    process.stdout.write(`Catch-all: ${result.isCatchAll}
+      return;
+    }
+    process.stdout.write(`Email: ${publicResult.email ?? "Not found"}
 `);
-    process.stdout.write(`Confidence: ${result.confidence}
+    process.stdout.write(`Status: ${publicResult.status}
 `);
-    process.stdout.write(`Provider: ${result.providerUsed}
+    process.stdout.write(`Success: ${publicResult.success}
 `);
-    process.stdout.write(`Credits used: ${result.creditsUsed || 0}
+    process.stdout.write(`Valid: ${publicResult.is_valid}
+`);
+    process.stdout.write(`Credits used: ${publicResult.credits_used}
 `);
-    if (result.needsReverification) {
-      process.stdout.write("Send safety: stale verification; rerun with --skip-cache before sending\n");
-    }
   });
 }
 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",
+      "idempotency-key",
+      "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")
+    });
+    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(),
@@ -549,7 +835,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");
@@ -569,7 +855,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") {
@@ -579,22 +865,69 @@ async function verifyEmail(args) {
 `);
       return;
     }
-    process.stdout.write(`${result.email}: ${result.verifiedForSending ? "verified for sending" : "not verified for sending"}
+    process.stdout.write(`Email: ${publicResult.email ?? "Not found"}
+`);
+    process.stdout.write(`Status: ${publicResult.status}
+`);
+    process.stdout.write(`Success: ${publicResult.success}
+`);
+    process.stdout.write(`Valid: ${publicResult.is_valid}
 `);
-    process.stdout.write(`Valid: ${result.isValid}
-Deliverable: ${result.isDeliverable}
-Catch-all: ${result.isCatchAll}
-Verdict: ${result.verificationVerdict}
+    process.stdout.write(`Verdict: ${publicResult.verification_status}
 `);
-    if (result.isMalformed) process.stdout.write("Malformed: true (rejected before provider call)\n");
-    process.stdout.write(`Credits used: ${result.creditsUsed || 0}
+    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");
@@ -614,18 +947,30 @@ 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
       };
     });
     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");
@@ -676,6 +1021,7 @@ function signalQueryFromArgs(args) {
     "--limit",
     "--sources",
     "--lookback-days",
+    "--icp-context",
     "--signal-search-run-id",
     "--idempotency-key",
     "--max-wait-ms",
@@ -709,8 +1055,13 @@ async function signals(args) {
   if (sourceValues?.some((source) => !["web", "news"].includes(source))) {
     fail("--sources must contain only web or news");
   }
+  const icpContext = flag("icp-context");
+  if (hasFlag("icp-context") && (typeof icpContext !== "string" || icpContext.trim().length < 2 || icpContext.trim().length > 4e3)) {
+    fail("--icp-context must contain between 2 and 4000 characters");
+  }
   const request = {
     query,
+    icpContext: icpContext?.trim(),
     signalSearchRunId,
     limit: numberFlag("limit"),
     sources: sourceValues,
@@ -764,6 +1115,14 @@ async function signals(args) {
         `Source cost per qualified company: ${guardrail.costPerQualifiedSignalUsd ?? "n/a"} (must be < $${guardrail.maxCostPerQualifiedSignalUsd})
 `
       );
+      if (guardrail.identityResolutionCostUsd !== void 0) {
+        const identityCost = guardrail.identityResolutionCostUsd === null ? "unavailable" : `$${guardrail.identityResolutionCostUsd}`;
+        const identityRequests = guardrail.identityProviderRequests;
+        process.stdout.write(
+          `Identity resolution cost: ${identityCost}${identityRequests === void 0 ? "" : ` across ${identityRequests} identity lookup request${identityRequests === 1 ? "" : "s"}`}${guardrail.identityCostSource ? ` (${guardrail.identityCostSource})` : ""}.
+`
+        );
+      }
     }
     for (const signal of result.signals.slice(0, 20)) {
       process.stdout.write(`- ${signal.company.name} (${signal.company.domain}) \u2014 ${signal.eventDate} \u2014 ${signal.title}
@@ -777,9 +1136,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 {
@@ -788,21 +1181,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"),
         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");
@@ -814,6 +1220,7 @@ async function signalToCopy() {
     title,
     campaignOffer,
     researchPrompt: flag("research-prompt") || flag("prompt"),
+    lookbackDays: numberFlag("lookback-days"),
     signalRunId,
     skipCache: hasFlag("skip-cache"),
     enableDeepSearch: hasFlag("deep-search"),
@@ -933,6 +1340,14 @@ main().catch((error) => {
         retry_after: signalizError.retryAfter,
         retry_after_seconds: signalizError.retryAfter
       } : {},
+      ...signalizError?.details?.retry_strategy === "new_idempotency_key" ? { retry_strategy: "new_idempotency_key" } : {},
+      ...signalizError?.details?.credits_used === 0 ? { credits_used: 0 } : {},
+      ...signalizError?.details?.credits_charged === 0 ? { credits_charged: 0 } : {},
+      ...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 } : {}
     }, hasFlag("json") ? 2 : void 0)}
@@ -946,6 +1361,46 @@ main().catch((error) => {
     fail(`${message}
 Recoverable signal run: ${signalRunId}
 Retry the same signaliz ${command} command with --signal-run-id ${signalRunId}, or use --json for structured recovery metadata.`);
+  }
+  if (error instanceof import_sdk.SignalizError && typeof error.details?.verification_run_id === "string") {
+    const verificationRunId = error.details.verification_run_id;
+    if (error.details.suggested_action === "retry_with_verification_run_id") {
+      fail(`${message}
+Recoverable verification run: ${verificationRunId}
+Retry with: signaliz verify-email --verification-run-id ${verificationRunId}`);
+    }
+    fail(`${message}
+Terminal verification run: ${verificationRunId}
+No automatic retry is recommended; review the provider outcome or contact support.`);
+  }
+  if (error instanceof import_sdk.SignalizError && typeof error.details?.run_id === "string" && process.argv[2] === "find-email") {
+    const runId = error.details.run_id;
+    if (error.details.suggested_action === "retry_with_run_id") {
+      fail(`${message}
+Recoverable Find Email run: ${runId}
+Retry with: signaliz find-email --run-id ${runId}`);
+    }
+    fail(`${message}
+Terminal Find Email run: ${runId}
+No automatic retry is recommended; review the provider outcome or contact support.`);
+  }
+  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.`);
+    }
+    fail(`${message}
+Terminal job: ${jobId}
+No automatic retry is recommended; review the provider outcome or contact support.`);
   }
   fail(message);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.56",
+  "version": "1.0.58",
   "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.60"
+    "@signaliz/sdk": "^1.0.62"
   },
   "devDependencies": {
     "tsup": "^8.0.0",