@signaliz/cli 1.0.50 → 1.0.52

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).
 `);
-    process.stdout.write(`Maximum estimated credits: ${value.estimatedCredits.max}
+    if (normalized.inputDuplicatesSuppressed > 0) {
+      process.stdout.write(`Unique fresh tasks: ${normalized.uniqueFreshInputCount}; exact duplicates suppressed: ${normalized.inputDuplicatesSuppressed}.
+`);
+    }
+    process.stdout.write(`Maximum estimated credits: ${normalized.estimatedCredits.max}
 `);
     process.stdout.write("No provider calls, jobs, writes, or credits were used.\n");
   });
@@ -216,10 +284,16 @@ function normalizeSignalsEverythingResult(request, value) {
         source: stringValue(item.source)
       };
     }).filter((item) => Boolean(item.url)) : [];
+    const eventDate = stringValue(signal.event_date || signal.date) || evidence[0]?.publishedAt || "";
+    const sourceUrl = stringValue(signal.source_url || signal.url) || evidence[0]?.url || null;
+    if (!eventDate || !sourceUrl || !evidence.some((item) => Boolean(item.publishedAt))) {
+      throw new Error("Signals Everything response violated the dated-evidence and source-URL contract.");
+    }
     return {
       company: { name, domain },
       title: stringValue(signal.title || signal.summary || signal.content),
-      sourceUrl: stringValue(signal.source_url || signal.url) || null,
+      eventDate,
+      sourceUrl,
       evidence
     };
   });
@@ -245,6 +319,9 @@ function normalizeSignalsEverythingResult(request, value) {
     nextPollAfterSeconds: numberValue(value.next_poll_after_seconds),
     signals: signals2,
     signalCount: signals2.length,
+    ...numberValue(value.available_company_signal_count) === void 0 ? {} : {
+      availableCompanySignalCount: numberValue(value.available_company_signal_count)
+    },
     ...maxCost === void 0 ? {} : {
       costGuardrail: {
         maxCostPerQualifiedSignalUsd: maxCost,
@@ -258,6 +335,7 @@ function normalizeSignalsEverythingResult(request, value) {
 async function discoverSignalsEverything(request) {
   const body = request.signalSearchRunId ? {
     signal_search_run_id: request.signalSearchRunId,
+    ...request.limit === void 0 ? {} : { limit: request.limit },
     ...request.dryRun === void 0 ? {} : { dry_run: request.dryRun },
     ...request.idempotencyKey ? { idempotency_key: request.idempotencyKey } : {}
   } : {
@@ -394,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");
@@ -421,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");
@@ -450,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");
@@ -470,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}
 `);
@@ -484,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}
 `);
   });
 }
@@ -519,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");
@@ -550,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}]
@@ -617,7 +709,10 @@ async function signals(args) {
     const startedAt = Date.now();
     while (signalDiscoveryIsPending(result.status) && result.signalSearchRunId && Date.now() - startedAt < maxWaitMs) {
       await sleep(Math.max(250, pollIntervalMs ?? (result.nextPollAfterSeconds || 5) * 1e3));
-      result = await discoverSignalsEverything({ signalSearchRunId: result.signalSearchRunId });
+      result = await discoverSignalsEverything({
+        signalSearchRunId: result.signalSearchRunId,
+        limit: request.limit
+      });
     }
   }
   output(result, () => {
@@ -638,8 +733,15 @@ async function signals(args) {
 `);
       return;
     }
-    process.stdout.write(`Qualified companies: ${result.signalCount}
+    const available = result.availableCompanySignalCount ?? result.signalCount;
+    process.stdout.write(`Qualified companies returned: ${result.signalCount}
 `);
+    if (available > result.signalCount) {
+      process.stdout.write(
+        `Retained cohort: ${available}. Expand without new acquisition: signaliz signals --signal-search-run-id ${result.signalSearchRunId} --limit ${available}
+`
+      );
+    }
     const guardrail = result.costGuardrail;
     if (guardrail) {
       process.stdout.write(
@@ -648,8 +750,8 @@ async function signals(args) {
       );
     }
     for (const signal of result.signals.slice(0, 20)) {
-      process.stdout.write(`- ${signal.company.name} (${signal.company.domain}) \u2014 ${signal.title}
-  ${signal.sourceUrl || signal.evidence[0]?.url || ""}
+      process.stdout.write(`- ${signal.company.name} (${signal.company.domain}) \u2014 ${signal.eventDate} \u2014 ${signal.title}
+  ${signal.sourceUrl}
 `);
     }
     if (result.signalCount > 20) process.stdout.write(`Showing 20 of ${result.signalCount}; use --json for the full result.
@@ -682,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,7 +812,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.")}
@@ -720,6 +822,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(`

package/package.json

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