@signaliz/cli 1.0.51 → 1.0.53

package/README.md

@@ -35,6 +35,8 @@ signaliz signal-to-copy \
 signaliz signal-to-copy --company-domain example.com --person-name "Jane Doe" \
   --title "VP Sales" --campaign-offer "pipeline intelligence" --skip-cache --deep-search
 
+# Omit --deep-search for bounded credit-free first-party and Bing grounding.
+
 # 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
@@ -74,10 +76,15 @@ Failed result lines preserve `errorCode`, `retryEligible`, and
 `retryAfterSeconds` when the API supplies recovery guidance.
 
 If a single request or batch submission response is lost, rerun the same
-command with `--idempotency-key <key>` to recover the original request or durable job
-without duplicate work. Add `--dry-run` to any product command, including one
+command with `--idempotency-key <key>` to recover the original request, durable
+job, or provider run without duplicate work or spend. The same key is portable
+across CLI, SDK, REST API, and MCP calls for the same workspace and logical
+input; chunked batches retain collision-free keys for each original row. Add
+`--dry-run` to any product command, including one
 using `--input`, to receive a conservative credit ceiling without provider
-calls, jobs, writes, or spend.
+calls, jobs, writes, or spend. JSON plans expose submitted, unique-fresh, and
+duplicate-suppression counts; human output calls out exact duplicates whenever
+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.

package/dist/bin.js

@@ -124,6 +124,62 @@ function readBatchInput() {
 function record(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
+function customerEmailResult(value) {
+  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,
+    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 } : {}
+  };
+}
+function customerEmailBatch(value) {
+  return {
+    ...value,
+    results: value.results.map((item) => {
+      const row = record(item);
+      return row.data ? { ...row, data: customerEmailResult(row.data) } : row;
+    })
+  };
+}
+function customerSignalResult(value) {
+  const result = record(value);
+  const raw = record(result.raw);
+  const billingMetadata = Object.keys(record(result.billingMetadata)).length > 0 ? record(result.billingMetadata) : record(raw.billing_metadata);
+  return {
+    ...result,
+    ...Object.keys(billingMetadata).length > 0 ? { billingMetadata } : {},
+    resultReturnedFrom: result.resultReturnedFrom ?? raw.result_returned_from,
+    cacheHit: result.cacheHit ?? raw.cache_hit,
+    freshEnrichmentUsed: result.freshEnrichmentUsed ?? raw.fresh_enrichment_used,
+    creditsUsed: result.creditsUsed ?? raw.credits_used,
+    liveProviderCalled: result.liveProviderCalled ?? raw.live_provider_called,
+    aiProviderCalled: result.aiProviderCalled ?? raw.ai_provider_called,
+    byoAiUsed: result.byoAiUsed ?? raw.byo_ai_used
+  };
+}
+function customerSignalBatch(value) {
+  return {
+    ...value,
+    results: value.results.map((item) => {
+      const row = record(item);
+      return row.data ? { ...row, data: customerSignalResult(row.data) } : row;
+    })
+  };
+}
 function batchOptions() {
   return {
     concurrency: numberFlag("concurrency"),
@@ -159,10 +215,22 @@ function batchOutput(value) {
   });
 }
 function dryRunOutput(value) {
-  output(value, () => {
-    process.stdout.write(`Planned ${value.inputCount} ${value.capability} request(s).
+  const raw = record(value.raw);
+  const normalized = {
+    ...value,
+    freshInputCount: Number(value.freshInputCount ?? raw.fresh_input_count ?? value.inputCount),
+    uniqueFreshInputCount: Number(value.uniqueFreshInputCount ?? raw.unique_fresh_input_count ?? value.inputCount),
+    inputDuplicatesSuppressed: Number(value.inputDuplicatesSuppressed ?? raw.input_duplicates_suppressed ?? 0),
+    uniqueRecoveryReadCount: Number(value.uniqueRecoveryReadCount ?? raw.unique_recovery_read_count ?? 0)
+  };
+  output(normalized, () => {
+    process.stdout.write(`Planned ${normalized.inputCount} ${normalized.capability} request(s).
+`);
+    if (normalized.inputDuplicatesSuppressed > 0) {
+      process.stdout.write(`Unique fresh tasks: ${normalized.uniqueFreshInputCount}; exact duplicates suppressed: ${normalized.inputDuplicatesSuppressed}.
 `);
-    process.stdout.write(`Maximum estimated credits: ${value.estimatedCredits.max}
+    }
+    process.stdout.write(`Maximum estimated credits: ${normalized.estimatedCredits.max}
 `);
     process.stdout.write("No provider calls, jobs, writes, or credits were used.\n");
   });
@@ -404,7 +472,7 @@ async function findEmail() {
       return;
     }
     const result2 = await createClient().findEmails(requests, batchOptions());
-    batchOutput(result2);
+    batchOutput(customerEmailBatch(result2));
     return;
   }
   const companyDomain = flag("company-domain") || flag("domain");
@@ -431,12 +499,19 @@ async function findEmail() {
     return;
   }
   const result = await createClient().findEmail(request);
-  output(result, () => {
+  const publicResult = customerEmailResult(result);
+  output(publicResult, () => {
     process.stdout.write(`${result.email || "No email found"} (${result.verificationStatus})
+`);
+    process.stdout.write(`Verified for sending: ${result.isVerifiedForSending}
+`);
+    process.stdout.write(`Catch-all: ${result.isCatchAll}
 `);
     process.stdout.write(`Confidence: ${result.confidence}
 `);
     process.stdout.write(`Provider: ${result.providerUsed}
+`);
+    process.stdout.write(`Credits used: ${result.creditsUsed || 0}
 `);
     if (result.needsReverification) {
       process.stdout.write("Send safety: stale verification; rerun with --skip-cache before sending\n");
@@ -460,7 +535,7 @@ async function verifyEmail(args) {
       ...batchOptions(),
       skipCache: hasFlag("skip-cache")
     });
-    batchOutput(result2);
+    batchOutput(customerEmailBatch(result2));
     return;
   }
   const email = args[0] && !args[0].startsWith("--") ? args[0] : flag("email");
@@ -480,7 +555,8 @@ async function verifyEmail(args) {
     return;
   }
   const result = await createClient().verifyEmail(email, options);
-  output(result, () => {
+  const publicResult = customerEmailResult(result);
+  output(publicResult, () => {
     if (result.status === "processing") {
       process.stdout.write(`Verification processing: ${result.verificationRunId}
 `);
@@ -494,6 +570,9 @@ async function verifyEmail(args) {
 Deliverable: ${result.isDeliverable}
 Catch-all: ${result.isCatchAll}
 Verdict: ${result.verificationVerdict}
+`);
+    if (result.isMalformed) process.stdout.write("Malformed: true (rejected before provider call)\n");
+    process.stdout.write(`Credits used: ${result.creditsUsed || 0}
 `);
   });
 }
@@ -529,7 +608,7 @@ async function companySignals() {
       return;
     }
     const result2 = await createClient().enrichCompanies(requests, batchOptions());
-    batchOutput(result2);
+    batchOutput(customerSignalBatch(result2));
     return;
   }
   const companyDomain = flag("domain") || flag("company-domain");
@@ -560,10 +639,13 @@ async function companySignals() {
     dryRunOutput(result2);
     return;
   }
-  const result = await createClient().enrichCompanySignals(request);
+  const result = customerSignalResult(await createClient().enrichCompanySignals(request));
   output(result, () => {
     process.stdout.write(`Company: ${result.company.name || result.company.domain}
 Signals: ${result.signalCount}
+`);
+    process.stdout.write(`Result source: ${result.resultReturnedFrom || "unknown"}
+Credits used: ${result.creditsUsed || 0}
 `);
     for (const signal of result.signals.slice(0, 5)) {
       process.stdout.write(`- ${signal.title} [${signal.type}]
@@ -702,7 +784,7 @@ async function signalToCopy() {
       return;
     }
     const result2 = await createClient().createSignalCopyBatch(requests, batchOptions());
-    batchOutput(result2);
+    batchOutput(customerSignalBatch(result2));
     return;
   }
   const companyDomain = flag("company-domain") || flag("domain");
@@ -710,9 +792,6 @@ async function signalToCopy() {
   const title = flag("title");
   const campaignOffer = flag("campaign-offer") || flag("offer");
   const signalRunId = flag("signal-run-id");
-  if (!signalRunId && (!companyDomain || !personName || !title || !campaignOffer)) {
-    fail('Usage: signaliz signal-to-copy --company-domain example.com --person-name "Jane Doe" --title "VP Sales" --campaign-offer "pipeline intelligence" OR signaliz signal-to-copy --signal-run-id copy_...');
-  }
   const request = {
     companyDomain,
     personName,
@@ -730,7 +809,7 @@ async function signalToCopy() {
     dryRunOutput(result2);
     return;
   }
-  const result = await createClient().signalToCopy(request);
+  const result = customerSignalResult(await createClient().signalToCopy(request));
   output(result, () => {
     if (result.variations.length === 0) {
       process.stdout.write(`${String(result.raw.message || "Signal research completed without supported evidence.")}
@@ -740,6 +819,9 @@ async function signalToCopy() {
     process.stdout.write(`Strongest signal: ${result.strongestSignal}
 Confidence: ${result.confidence}
 Evidence: ${result.evidenceUrl}
+`);
+    process.stdout.write(`Result source: ${result.resultReturnedFrom || "unknown"}
+Credits used: ${result.creditsUsed || 0}
 `);
     for (const variation of result.variations) {
       process.stdout.write(`
@@ -827,7 +909,7 @@ main().catch((error) => {
     process.stdout.write(`${stringifyMachineJson({
       success: false,
       error: "product_request_failed",
-      error_code: signalizError?.code || (error instanceof RangeError ? "INPUT_001" : "CLI_ERROR"),
+      error_code: signalizError?.code || (error instanceof RangeError || error instanceof TypeError ? "INPUT_001" : "CLI_ERROR"),
       message,
       retry_eligible: signalizError?.isRetryable ?? false,
       ...signalizError?.retryAfter !== void 0 ? {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.51",
+  "version": "1.0.53",
   "description": "Signaliz CLI for Signals Everything, Find Email, Verify Email, Company Signal Enrichment, and Signal to Copy AI.",
   "bin": {
     "signaliz": "dist/bin.js"