@signaliz/cli 1.0.63 → 1.0.64

package/dist/bin.js

@@ -17,25 +17,35 @@ var CONFIG_DIR = (0, import_node_path.join)((0, import_node_os.homedir)(), ".sig
 var CONFIG_FILE = (0, import_node_path.join)(CONFIG_DIR, "config.json");
 var HELP = `Signaliz CLI
 
-Five product commands:
-  signaliz find-email --linkedin-url https://www.linkedin.com/in/jane-doe [--skip-cache]
-  signaliz find-email --company-domain example.com --full-name "Jane Doe" [--skip-cache]
+Six product commands:
+  signaliz find-email --linkedin-url https://www.linkedin.com/in/jane-doe [--no-wait]
+  signaliz find-email --company-domain example.com --full-name "Jane Doe" [--no-wait]
   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 --domain example.com
   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]
+    [--signal-search-run-id run_... | --fact-id <sha256> | --event-id <sha256>] \\
+    [--copy-evidence-mode signal_led|firmographic] [--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 --fact-id <sha256> --company-domain example.com --person-name "Jane Doe" --title "VP Sales" --campaign-offer "pipeline intelligence"  Reuse one canonical signal without rediscovery
+  signaliz signal-to-copy --input recipients.json --no-wait  Submit a durable >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 "companies that just got funded" [--icp-context "..."] [--limit 100] [--sources web,news] [--after-date YYYY-MM-DD --before-date YYYY-MM-DD] [--wait]
+  signaliz signals-first "companies that just got funded" [--limit 100] [--lookback-days 30] [--wait]
   signaliz signals --signal-search-run-id run_...  Resume an existing company-attributed signal search
+  signaliz awareness create --company-name "Acme" --domain acme.com [--schedule daily] [--monthly-credit-cap 100]
+  signaliz awareness list [--limit 100] [--offset 0]
+  signaliz awareness run --monitor-id <uuid> --idempotency-key <key>
+  signaliz awareness signals [--monitor-id <uuid>]
+  signaliz awareness pause|resume|delete --monitor-id <uuid>
+  signaliz flow --signal-query "companies with recent hiring" --campaign-offer "..." [--limit 5] [--lookback-days 90] [--people-titles "CEO,VP Sales"]
+  signaliz flow --run-id run_...  Read a durable Flow checkpoint without dispatching new work
 
 Access and connection:
   signaliz auth login
@@ -56,12 +66,17 @@ 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
+  --no-wait                     Return the durable Find Email run ID immediately; resume with --run-id
+  --copy-evidence-mode <mode>  Use signals, or draft from offer and research context without signal claims
   --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
+  --signal-search-run-id <id>   Resume Signals First, or pin its immutable snapshot in Signal to Copy
+  --fact-id <sha256>            Pin one active canonical signal fact in Signal to Copy
+  --event-id <sha256>           Pin one canonical signal event in Signal to Copy
   --dry-run                     Return a no-spend plan without provider calls, jobs, or writes
 
-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.
+Company Signals accepts only --domain. Signaliz checks its cache, runs one type-agnostic Parallel Advanced search plus at most one first-party hub Extract, and returns the newest distinct events that pass its deterministic date, source, company, evidence, and duplicate gates. For a durable batch larger than 25 rows, provide domain-only rows with --no-wait and resume with --job-id. Signal to Copy canonical references remain separate. Signals Everything is asynchronous by default; use --wait to poll until it completes.
 `;
 function loadConfig() {
   if (!(0, import_node_fs.existsSync)(CONFIG_FILE)) return {};
@@ -108,6 +123,25 @@ function requireIntegerInRange(value, name, minimum, maximum) {
     throw new CliInputError(`${name} must be an integer between ${minimum} and ${maximum}`);
   }
 }
+function validateSignalDateWindow(afterDate, beforeDate, lookbackDays, flagPrefix = "--") {
+  if ((afterDate || beforeDate) && lookbackDays !== void 0) {
+    throw new CliInputError(`${flagPrefix}after-date/--before-date cannot be combined with --lookback-days`);
+  }
+  const parseDate = (value, name) => {
+    if (value === void 0) return void 0;
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) throw new CliInputError(`${name} must use YYYY-MM-DD format`);
+    const timestamp = Date.parse(`${value}T00:00:00Z`);
+    if (!Number.isFinite(timestamp) || new Date(timestamp).toISOString().slice(0, 10) !== value) {
+      throw new CliInputError(`${name} must be a valid calendar date`);
+    }
+    return timestamp;
+  };
+  const afterTimestamp = parseDate(afterDate, `${flagPrefix}after-date`);
+  const beforeTimestamp = parseDate(beforeDate, `${flagPrefix}before-date`);
+  if (afterTimestamp !== void 0 && beforeTimestamp !== void 0 && beforeTimestamp < afterTimestamp) {
+    throw new CliInputError(`${flagPrefix}before-date must be on or after ${flagPrefix}after-date`);
+  }
+}
 function requireSignalToCopyIdentity(request) {
   if (stringValue(request.signalRunId)) return;
   const missing = [
@@ -124,11 +158,6 @@ function csvFlag(name) {
   const value = flag(name);
   return value?.split(",").map((item) => item.trim()).filter(Boolean);
 }
-function companySignalSearchMode(value) {
-  if (value === void 0 || value === null || value === "") return void 0;
-  if (value === "fast" || value === "balanced" || value === "coverage") return value;
-  throw new CliInputError("--search-mode must be fast, balanced, or coverage");
-}
 function readBatchInput() {
   const path = flag("input");
   if (!path) return null;
@@ -164,6 +193,221 @@ function readBatchInput() {
 function record(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
+function signalText(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function signalDate(value) {
+  const match = signalText(value).match(/^\d{4}-\d{2}-\d{2}/);
+  if (!match) return "";
+  const parsed = /* @__PURE__ */ new Date(`${match[0]}T00:00:00.000Z`);
+  return Number.isFinite(parsed.getTime()) && parsed.toISOString().slice(0, 10) === match[0] ? match[0] : "";
+}
+function signalClassification(value) {
+  const direct = signalText(value);
+  if (direct) return direct;
+  const classification = record(value);
+  return signalText(classification.slug || classification.type || classification.name);
+}
+function publicSignalType(signal) {
+  const raw = record(signal.raw_data);
+  const generic = /* @__PURE__ */ new Set(["unclassified", "unknown", "other", "news", "signal"]);
+  for (const value of [
+    signal.signal_type,
+    signal.signalType,
+    signalClassification(signal.signal_classification || signal.signalClassification),
+    signalClassification(signal.classification),
+    raw.signal_type,
+    raw.signalType,
+    signalClassification(raw.signal_classification || raw.signalClassification),
+    signalClassification(raw.classification),
+    signal.type,
+    signal.category,
+    signal.event_type,
+    raw.type,
+    raw.category,
+    raw.event_type
+  ]) {
+    const candidate = signalText(value);
+    if (candidate && !generic.has(candidate.toLowerCase())) return candidate;
+  }
+  return "";
+}
+function verifiedHttpsSource(value) {
+  const source = signalText(value);
+  if (!source || /\s/.test(source)) return "";
+  try {
+    const url = new URL(source);
+    return url.protocol === "https:" && Boolean(url.hostname) && !url.username && !url.password ? source : "";
+  } catch {
+    return "";
+  }
+}
+function normalizedSignalDomain(value) {
+  const normalized = signalText(value).toLowerCase().replace(/^https?:\/\//, "").replace(/^www\./, "").split(/[/?#]/)[0].replace(/\.$/, "");
+  return /^(?=.{3,253}$)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$/i.test(normalized) ? normalized : "";
+}
+function firstValidSignalValue(values, normalize) {
+  for (const value of values) {
+    const normalized = normalize(value);
+    if (normalized) return normalized;
+  }
+  return "";
+}
+function publicSignalRow(value, fallbackCompany) {
+  const signal = record(value);
+  const raw = record(signal.raw_data);
+  const company = record(signal.company);
+  const rawCompany = record(raw.company);
+  const fallback = record(fallbackCompany);
+  const row = {
+    signal_type: publicSignalType(signal),
+    signal_title: firstValidSignalValue([
+      signal.signal_title,
+      signal.signalTitle,
+      raw.signal_title,
+      raw.signalTitle,
+      signal.title,
+      raw.title,
+      signal.headline,
+      raw.headline,
+      signal.name,
+      raw.name
+    ], signalText),
+    signal_summary: firstValidSignalValue([
+      signal.signal_summary,
+      signal.signalSummary,
+      raw.signal_summary,
+      raw.signalSummary,
+      signal.summary,
+      raw.summary,
+      signal.signal_content,
+      signal.signalContent,
+      raw.signal_content,
+      raw.signalContent,
+      signal.content,
+      raw.content,
+      signal.description,
+      raw.description
+    ], signalText),
+    source: firstValidSignalValue([
+      signal.canonical_source_url,
+      signal.canonicalSourceUrl,
+      signal.source_url,
+      signal.sourceUrl,
+      signal.verified_source_url,
+      signal.verifiedSourceUrl,
+      signal.signal_source,
+      signal.signalSource,
+      signal.source,
+      signal.url,
+      raw.canonical_source_url,
+      raw.canonicalSourceUrl,
+      raw.source_url,
+      raw.sourceUrl,
+      raw.verified_source_url,
+      raw.verifiedSourceUrl,
+      raw.signal_source,
+      raw.signalSource,
+      raw.source,
+      raw.url
+    ], verifiedHttpsSource),
+    date: firstValidSignalValue([
+      signal.date,
+      signal.event_date,
+      signal.eventDate,
+      signal.signal_date,
+      signal.signalDate,
+      signal.published_date,
+      signal.publishedDate,
+      signal.published_at,
+      signal.publishedAt,
+      signal.detected_at,
+      signal.detectedAt,
+      signal.observed_at,
+      signal.observedAt,
+      raw.date,
+      raw.event_date,
+      raw.eventDate,
+      raw.signal_date,
+      raw.signalDate,
+      raw.published_date,
+      raw.publishedDate,
+      raw.published_at,
+      raw.publishedAt,
+      raw.detected_at,
+      raw.detectedAt,
+      raw.observed_at,
+      raw.observedAt
+    ], signalDate),
+    company_name: signalText(
+      signal.company_name || signal.companyName || company.name || company.company_name || raw.company_name || raw.companyName || rawCompany.name || rawCompany.company_name || fallback.company_name || fallback.companyName || fallback.name
+    ),
+    domain: firstValidSignalValue([
+      signal.company_domain,
+      signal.companyDomain,
+      signal.domain,
+      company.domain,
+      company.company_domain,
+      raw.company_domain,
+      raw.companyDomain,
+      raw.domain,
+      rawCompany.domain,
+      rawCompany.company_domain,
+      fallback.company_domain,
+      fallback.companyDomain,
+      fallback.domain
+    ], normalizedSignalDomain)
+  };
+  return row.signal_type && row.source && row.date && row.company_name && row.domain ? row : null;
+}
+function publicSignalRows(value, fallbackCompany) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((item) => {
+    const row = publicSignalRow(item, fallbackCompany);
+    return row ? [row] : [];
+  });
+}
+function oneSignalPerCompany(rows) {
+  const seen = /* @__PURE__ */ new Set();
+  return rows.filter((row) => {
+    if (seen.has(row.domain)) return false;
+    seen.add(row.domain);
+    return true;
+  });
+}
+var PUBLIC_COMPANY_SIGNAL_MAX_COVERAGE_COUNT = 10;
+function publicCompanySignalRows(value, fallbackCompany) {
+  const candidates = Array.isArray(value) ? value : [];
+  const seenEvents = /* @__PURE__ */ new Set();
+  const rows = [];
+  for (const candidate of candidates) {
+    const row = publicSignalRow(candidate, fallbackCompany);
+    if (!row) continue;
+    const signal = record(candidate);
+    const raw = record(signal.raw_data);
+    const eventId = signalText(
+      signal.event_id || signal.eventId || signal.fact_id || signal.factId || raw.event_id || raw.eventId || raw.fact_id || raw.factId
+    ).toLowerCase();
+    const identities = [
+      ...eventId ? [`event:${eventId}`] : [],
+      `source:${row.source.toLowerCase()}`
+    ];
+    if (identities.some((identity) => seenEvents.has(identity))) continue;
+    identities.forEach((identity) => seenEvents.add(identity));
+    rows.push(row);
+    if (rows.length >= PUBLIC_COMPANY_SIGNAL_MAX_COVERAGE_COUNT) break;
+  }
+  return rows;
+}
+function companySignalOutputRow(signal) {
+  return {
+    date: signal.date,
+    signal_type: signal.signal_type,
+    signal_title: signal.signal_title,
+    signal_summary: signal.signal_summary,
+    source: signal.source
+  };
+}
 function safeNonNegativeNumber(value) {
   if (value === null || value === void 0 || value === "") return null;
   const numeric = Number(value);
@@ -173,7 +417,7 @@ 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"]) {
+  for (const field of ["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"]) {
@@ -241,19 +485,10 @@ function customerEmailResult(value, kind) {
     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,
-      credits_charged: base.credits_charged,
-      live_provider_called: liveProviderCalled
+      credits_charged: base.credits_charged
     };
     const estimatedExternalCostUsd2 = safeNonNegativeNumber(
       result.estimatedExternalCostUsd ?? raw.estimated_external_cost_usd
@@ -288,15 +523,6 @@ function customerEmailResult(value, kind) {
       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_replayed: typeof raw.billing_replayed === "boolean" ? raw.billing_replayed : result.billingReplayed === true,
       ...typeof raw.idempotency_replayed === "boolean" || typeof result.idempotencyReplayed === "boolean" ? {
         idempotency_replayed: typeof raw.idempotency_replayed === "boolean" ? raw.idempotency_replayed : result.idempotencyReplayed === true
@@ -309,11 +535,6 @@ function customerEmailResult(value, kind) {
         recovery_mode: raw.recovery_mode,
         recovery_status: raw.recovery_status ?? "completed"
       } : {},
-      ...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 } : {}
-      } : {},
       ...terminalErrorCode ? {
         email: null,
         success: false,
@@ -348,11 +569,6 @@ function customerEmailResult(value, kind) {
   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
   );
@@ -382,13 +598,6 @@ function customerEmailResult(value, kind) {
     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,
     ...typeof raw.idempotency_replayed === "boolean" || typeof result.idempotencyReplayed === "boolean" ? {
       idempotency_replayed: typeof raw.idempotency_replayed === "boolean" ? raw.idempotency_replayed : result.idempotencyReplayed === true
@@ -397,12 +606,7 @@ function customerEmailResult(value, kind) {
     ...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 } : {}
-    } : {}
+    ...runId ? { run_id: runId } : {}
   };
 }
 function customerEmailBatch(value, kind) {
@@ -430,15 +634,39 @@ function customerSignalResult(value) {
   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 customerCompanySignalResult(value) {
+  const result = record(value);
+  const raw = record(result.raw);
+  const company = record(result.company);
+  const rawCompany = record(raw.company);
+  const normalizedCompany = {
+    name: signalText(result.companyName || result.company_name || company.name || raw.company_name || rawCompany.name) || null,
+    domain: normalizedSignalDomain(
+      result.companyDomain || result.company_domain || result.domain || company.domain || raw.company_domain || raw.domain || rawCompany.domain
+    ) || null
+  };
+  const rawSignals = Array.isArray(raw.signals) ? raw.signals : Array.isArray(raw.signal_feed) ? raw.signal_feed : result.signals;
+  const signals2 = publicCompanySignalRows(rawSignals, normalizedCompany).map(companySignalOutputRow);
+  const {
+    raw: _raw,
+    signals: _signals,
+    signalCount: _signalCount,
+    company: _company,
+    ...publicResult
+  } = result;
+  return {
+    ...publicResult,
+    company: normalizedCompany,
+    signals: signals2,
+    signalCount: signals2.length,
+    creditsUsed: result.creditsUsed ?? raw.credits_used
+  };
+}
 function customerSignalBatch(value) {
   return {
     ...value,
@@ -448,6 +676,31 @@ function customerSignalBatch(value) {
     })
   };
 }
+function customerCompanySignalBatch(value) {
+  const batch = record(value);
+  const { raw: _raw, results: _results, ...publicBatch } = batch;
+  const results = Array.isArray(batch.results) ? batch.results.map((item) => {
+    const row = record(item);
+    const { raw: _rowRaw, ...publicRow } = row;
+    if (row.data) {
+      return promoteBatchRecoveryMetadata({ ...publicRow, data: customerCompanySignalResult(row.data) });
+    }
+    if (Array.isArray(row.signals) || row.company) {
+      return promoteBatchRecoveryMetadata(customerCompanySignalResult(publicRow));
+    }
+    return promoteBatchRecoveryMetadata(publicRow);
+  }) : [];
+  return { ...publicBatch, results };
+}
+function customerSignalAwarenessResult(value) {
+  const result = record(value);
+  const { raw: _raw, signals: _signals, ...publicResult } = result;
+  const signals2 = Array.isArray(result.signals) ? oneSignalPerCompany(publicSignalRows(result.signals)) : void 0;
+  return {
+    ...publicResult,
+    ...signals2 ? { signals: signals2 } : {}
+  };
+}
 function batchOptions() {
   return {
     concurrency: numberFlag("concurrency"),
@@ -553,12 +806,40 @@ 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() : "";
 }
+function publicSignalDiscoveryFailure(value) {
+  const requestedCode = stringValue(value).toUpperCase();
+  if (requestedCode === "NO_QUALIFIED_SIGNALS") {
+    return {
+      errorCode: requestedCode,
+      error: "No company signal met the dated-evidence, company-identity, and query requirements."
+    };
+  }
+  if (requestedCode === "SOURCE_EMPTY") {
+    return {
+      errorCode: requestedCode,
+      error: "The selected source lanes returned no candidates for this query and time window."
+    };
+  }
+  if (requestedCode === "IDEMPOTENCY_CONFLICT") {
+    return {
+      errorCode: requestedCode,
+      error: "This recovery key belongs to a different Signals Everything request."
+    };
+  }
+  if (requestedCode === "PERSISTENCE_UNAVAILABLE") {
+    return {
+      errorCode: requestedCode,
+      error: "The result is still being finalized. Retry with the same signal search run ID."
+    };
+  }
+  return {
+    errorCode: "SOURCE_UNAVAILABLE",
+    error: "Signals Everything could not complete this search."
+  };
+}
 function hasFindEmailLinkedInIdentity(value) {
   const linkedinUrl = stringValue(value);
   if (!linkedinUrl) return false;
@@ -582,35 +863,11 @@ function signalsEverythingErrorType(status) {
 }
 function normalizeSignalsEverythingResult(request, value) {
   const rawSignals = Array.isArray(value.signals) ? value.signals : [];
-  const signals2 = rawSignals.map((rawSignal) => {
-    const signal = record(rawSignal);
-    const company = record(signal.company);
-    const name = stringValue(company.name || signal.company_name);
-    const domain = stringValue(company.domain || signal.company_domain);
-    if (!name || !domain) {
-      throw new Error("Signals Everything response violated the company attribution contract.");
-    }
-    const evidence = Array.isArray(signal.evidence) ? signal.evidence.map((rawEvidence) => {
-      const item = record(rawEvidence);
-      return {
-        url: stringValue(item.url),
-        publishedAt: stringValue(item.published_at || item.publishedAt),
-        source: stringValue(item.source)
-      };
-    }).filter((item) => Boolean(item.url)) : [];
-    const eventDate = stringValue(signal.event_date || signal.date);
-    const sourceUrl = stringValue(signal.source_url || signal.url);
-    if (!eventDate || !sourceUrl || !evidence.some((item) => item.url === sourceUrl && item.publishedAt === eventDate)) {
-      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),
-      eventDate,
-      sourceUrl,
-      evidence
-    };
-  });
+  const requestedCount = numberValue(value.requested_count) ?? request.limit;
+  const signals2 = oneSignalPerCompany(publicSignalRows(rawSignals)).slice(
+    0,
+    requestedCount !== void 0 && requestedCount > 0 ? requestedCount : void 0
+  );
   const statusValue = stringValue(value.status).toLowerCase();
   const statuses = /* @__PURE__ */ new Set([
     "planned",
@@ -621,52 +878,24 @@ function normalizeSignalsEverythingResult(request, value) {
     "failed"
   ]);
   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 costSource = stringValue(guardrail.cost_source);
-  const identityCostSource = stringValue(guardrail.identity_cost_source);
-  const warnings = Array.isArray(value.warnings) ? value.warnings.filter((warning) => typeof warning === "string") : void 0;
+  const error = record(value.error);
+  const hasFailure = value.success === false || Boolean(stringValue(value.error_code || error.code));
+  const publicFailure = hasFailure ? publicSignalDiscoveryFailure(value.error_code || error.code) : void 0;
   return {
     success: value.success !== false,
     status,
     signalSearchRunId: stringValue(value.signal_search_run_id || request.signalSearchRunId),
     query: stringValue(value.query || request.query),
-    requestedCount: numberValue(value.requested_count) ?? request.limit ?? 100,
+    ...requestedCount === void 0 ? {} : { requestedCount },
     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,
-        projectedSourceCostUsd: nullableNumberValue(guardrail.projected_source_cost_usd),
-        maxSourceCostUsd: nullableNumberValue(guardrail.max_source_cost_usd),
-        projectedCostPerRequestedCompanySignalUsd: nullableNumberValue(
-          guardrail.projected_cost_per_requested_company_signal_usd
-        ),
-        sourceCostUsd: nullableNumberValue(guardrail.source_cost_usd),
-        costSource: ["observed", "catalog_preflight", "catalog_bounded", "mixed", "unavailable"].includes(costSource) ? costSource : 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),
-        qualifiedCompanySignalCount: numberValue(guardrail.qualified_company_signal_count),
-        returnedCompanySignalCount: numberValue(guardrail.returned_company_signal_count),
-        availableCompanySignalCount: numberValue(guardrail.available_company_signal_count),
-        acquisitionCandidateLimit: numberValue(guardrail.acquisition_candidate_limit),
-        minimumQualifiedCompanySignals: numberValue(guardrail.minimum_qualified_company_signals),
-        withinLimit: guardrail.within_limit === true
-      }
-    },
-    ...warnings?.length ? { warnings } : {},
-    raw: value
+    creditsUsed: numberValue(value.credits_used) ?? 0,
+    creditsCharged: numberValue(value.credits_charged) ?? 0,
+    ...value.billing_status === "included" ? { billingStatus: "included" } : {},
+    ...typeof value.idempotency_replayed === "boolean" ? { idempotencyReplayed: value.idempotency_replayed } : {},
+    ...publicFailure ? publicFailure : {},
+    ...typeof value.retry_eligible === "boolean" ? { retryEligible: value.retry_eligible } : {}
   };
 }
 async function discoverSignalsEverything(request) {
@@ -681,6 +910,8 @@ async function discoverSignalsEverything(request) {
     limit: request.limit ?? 100,
     ...request.sources ? { sources: request.sources } : {},
     ...request.lookbackDays === void 0 ? {} : { lookback_days: request.lookbackDays },
+    ...request.afterDate ? { after_date: request.afterDate } : {},
+    ...request.beforeDate ? { before_date: request.beforeDate } : {},
     ...request.dryRun === void 0 ? {} : { dry_run: request.dryRun },
     ...request.idempotencyKey ? { idempotency_key: request.idempotencyKey } : {}
   };
@@ -697,14 +928,19 @@ async function discoverSignalsEverything(request) {
   const responseBody = record(responseValue);
   if (!response.ok) {
     const error = record(responseBody.error);
-    const code = stringValue(error.code || responseBody.error_code) || `HTTP_${response.status}`;
-    const message = stringValue(error.message || responseBody.message || responseBody.error) || `Signals Everything request failed with status ${response.status}`;
+    const publicFailure = publicSignalDiscoveryFailure(
+      error.code || responseBody.error_code || `HTTP_${response.status}`
+    );
     throw new import_sdk.SignalizError({
-      code,
-      message,
+      code: publicFailure.errorCode,
+      message: publicFailure.error,
       errorType: signalsEverythingErrorType(response.status),
       retryAfter: numberValue(responseBody.retry_after_seconds || responseBody.retry_after),
-      details: responseBody
+      details: normalizeSignalsEverythingResult(request, {
+        ...responseBody,
+        success: false,
+        error_code: publicFailure.errorCode
+      })
     });
   }
   return normalizeSignalsEverythingResult(request, responseBody);
@@ -716,10 +952,39 @@ function output(value, human) {
   } else if (human) {
     human();
   } else {
-    process.stdout.write(`${JSON.stringify(value, null, 2)}
+    process.stdout.write(`${JSON.stringify(publicCliValue(value), null, 2)}
 `);
   }
 }
+var INTERNAL_PRODUCT_OUTPUT_KEYS = /* @__PURE__ */ new Set([
+  "billingmetadata",
+  "historicalbillingmetadata",
+  "resultreturnedfrom",
+  "freshenrichmentused",
+  "liveprovidercalled",
+  "openroutercalled",
+  "byoopenrouterused",
+  "aiprovidercalled",
+  "byoaiused",
+  "estimatedexternalcostusd"
+]);
+function publicCliValue(value) {
+  if (Array.isArray(value)) return value.map(publicCliValue);
+  if (!value || typeof value !== "object") return value;
+  const output2 = {};
+  for (const [key, raw] of Object.entries(value)) {
+    const normalizedKey = key.toLowerCase().replace(/_/g, "");
+    if (normalizedKey.includes("cache") || INTERNAL_PRODUCT_OUTPUT_KEYS.has(normalizedKey)) continue;
+    if (typeof raw === "string" && (raw.toLowerCase().includes("cache") || raw === "available_data")) {
+      if (["source", "emailsource", "emailsourcelabel", "verificationsource", "providerstatus"].includes(normalizedKey)) {
+        output2[key] = normalizedKey === "verificationsource" ? "email_verification" : "email_finder";
+      }
+      continue;
+    }
+    output2[key] = publicCliValue(raw);
+  }
+  return output2;
+}
 function outputFailedCoreProduct(value, fallbackMessage) {
   const result = record(value);
   if (result.success !== false) return false;
@@ -733,7 +998,7 @@ function outputFailedCoreProduct(value, fallbackMessage) {
 }
 function stringifyMachineJson(value, space) {
   const omitRaw = hasFlag("omit-raw");
-  return JSON.stringify(value, omitRaw ? (key, item) => key === "raw" ? void 0 : item : void 0, space);
+  return JSON.stringify(publicCliValue(value), omitRaw ? (key, item) => key === "raw" ? void 0 : item : void 0, space);
 }
 function fail(message) {
   process.stderr.write(`${message}
@@ -814,7 +1079,7 @@ async function findEmail() {
       "linkedin-url",
       "company-name",
       "run-id",
-      "skip-cache"
+      "no-wait"
     ].filter(hasFlag);
     if (conflicts.length > 0) {
       throw new CliInputError(
@@ -833,6 +1098,9 @@ async function findEmail() {
   }
   const rows = readBatchInput();
   if (rows) {
+    if (hasFlag("no-wait")) {
+      throw new CliInputError("Find Email --no-wait supports one contact. Batch submissions are already durable and return a recoverable job.");
+    }
     const requests = rows.map((value) => {
       const row = record(value);
       const runId2 = row.runId || row.run_id;
@@ -845,7 +1113,6 @@ 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"),
         idempotencyKey
       };
     });
@@ -884,7 +1151,7 @@ async function findEmail() {
     lastName,
     linkedinUrl,
     companyName: flag("company-name"),
-    skipCache: hasFlag("skip-cache"),
+    waitForResult: hasFlag("no-wait") ? false : void 0,
     idempotencyKey: flag("idempotency-key")
   };
   if (hasFlag("dry-run")) {
@@ -924,7 +1191,6 @@ async function verifyEmail(args) {
       "dry-run",
       "email",
       "verification-run-id",
-      "skip-cache",
       "no-wait"
     ].filter(hasFlag);
     if (positionalEmail || conflicts.length > 0) {
@@ -951,22 +1217,19 @@ async function verifyEmail(args) {
       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(),
-        skipCache: hasFlag("skip-cache"),
         dryRun: true
       });
       dryRunOutput(result3);
       return;
     }
     const result2 = await createClient().verifyEmails(emails, {
-      ...batchOptions(),
-      skipCache: hasFlag("skip-cache")
+      ...batchOptions()
     });
     batchOutput(customerEmailBatch(result2, "verify"));
     return;
@@ -977,7 +1240,6 @@ async function verifyEmail(args) {
     throw new CliInputError("Usage: signaliz verify-email [jane@example.com] [--verification-run-id run_...]");
   }
   const options = {
-    skipCache: hasFlag("skip-cache"),
     verificationRunId,
     waitForResult: !hasFlag("no-wait"),
     maxWaitMs: numberFlag("max-wait-ms"),
@@ -1012,7 +1274,7 @@ async function verifyEmail(args) {
 `);
     process.stdout.write(`Recommendation: ${publicResult.recommendation}
 `);
-    process.stdout.write(`Source: ${publicResult.verification_source}${publicResult.cache_hit === true ? " (cache)" : ""}
+    process.stdout.write(`Source: ${String(publicResult.verification_source || "email_verification").toLowerCase().includes("cache") ? "email_verification" : publicResult.verification_source}
 `);
     if (publicResult.run_id) process.stdout.write(`Run ID: ${publicResult.run_id}
 `);
@@ -1022,6 +1284,39 @@ async function verifyEmail(args) {
 }
 async function companySignals() {
   const jobId = flag("job-id");
+  const removedControlFlags = [
+    "prompt",
+    "signal-types",
+    "after-date",
+    "before-date",
+    "include-candidate-evidence",
+    "search-mode",
+    "model",
+    "online",
+    "offline",
+    "shallow",
+    "deep-search",
+    "enable-deep-search",
+    "no-summary",
+    "outreach-intelligence",
+    "predictive-intelligence",
+    "credit-free-grounding-only",
+    "skip-cache",
+    "bypass-cache",
+    "fresh-only",
+    "cache-ttl-hours",
+    "cache-ttl-seconds",
+    "cache-enabled",
+    "cache-policy",
+    "target-signal-count",
+    "provider-target-signal-count",
+    ...jobId ? [] : ["max-wait-ms"]
+  ].filter(hasFlag);
+  if (removedControlFlags.length > 0) {
+    throw new CliInputError(
+      `Company Signals manages provider routing, coverage, and classifications internally; ${removedControlFlags.map((name) => `--${name}`).join(", ")} is no longer supported. Use --domain only.`
+    );
+  }
   if (jobId) {
     const conflicts = [
       "input",
@@ -1031,18 +1326,7 @@ async function companySignals() {
       "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);
@@ -1058,7 +1342,7 @@ async function companySignals() {
       idempotencyKey: flag("idempotency-key"),
       compactDuplicates: !hasFlag("expand-duplicates")
     });
-    batchOutput(customerSignalBatch(result2));
+    batchOutput(customerCompanySignalBatch(result2));
     return;
   }
   rejectDurableNoWaitPollingFlags("Company Signals");
@@ -1067,59 +1351,20 @@ async function companySignals() {
     const durableBatch = rows.length > 25;
     const requests = rows.map((value) => {
       const row = record(value);
-      const online = row.online ?? !hasFlag("offline");
       return {
         signalRunId: row.signalRunId || row.signal_run_id,
         companyDomain: row.companyDomain || row.company_domain || row.domain,
-        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"),
-        online,
-        enableDeepSearch: row.enableDeepSearch ?? row.enable_deep_search ?? (online && !hasFlag("shallow")),
-        searchMode: companySignalSearchMode(row.searchMode ?? row.search_mode ?? flag("search-mode")),
-        includeSummary: row.includeSummary ?? row.include_summary ?? !hasFlag("no-summary"),
-        enableOutreachIntelligence: row.enableOutreachIntelligence ?? row.enable_outreach_intelligence,
-        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 ?? (durableBatch ? void 0 : numberFlag("max-wait-ms")),
+        domain: row.domain || row.companyDomain || row.company_domain,
         idempotencyKey: row.idempotencyKey || row.idempotency_key
       };
     });
-    for (const request2 of requests) {
-      requireIntegerInRange(request2.targetSignalCount, "targetSignalCount", 1, 15);
-      requireIntegerInRange(request2.lookbackDays, "lookbackDays", 1, 365);
-      requireIntegerInRange(request2.maxWaitMs, "maxWaitMs", 1e4, 12e4);
-    }
-    if (durableBatch && requests.some((request2) => request2.includeCandidateEvidence === true)) {
-      throw new CliInputError(
-        "includeCandidateEvidence is not supported in Company Signals batches larger than 25 because rejected evidence diagnostics are intentionally excluded from durable scale storage; split diagnostic requests into batches of at most 25."
-      );
-    }
     if (durableBatch) {
-      const controlKey = (request2) => JSON.stringify({
-        researchPrompt: request2.researchPrompt,
-        signalTypes: request2.signalTypes,
-        targetSignalCount: request2.targetSignalCount,
-        lookbackDays: request2.lookbackDays,
-        online: request2.online,
-        enableDeepSearch: request2.enableDeepSearch,
-        searchMode: request2.searchMode ?? "balanced",
-        includeSummary: request2.includeSummary,
-        enableOutreachIntelligence: request2.enableOutreachIntelligence,
-        enablePredictiveIntelligence: request2.enablePredictiveIntelligence,
-        skipCache: request2.skipCache,
-        includeCandidateEvidence: request2.includeCandidateEvidence
-      });
-      const firstControlKey = controlKey(requests[0]);
       const incompatible = requests.some(
-        (request2) => Boolean(stringValue(request2.signalRunId)) || Boolean(stringValue(request2.idempotencyKey)) || !stringValue(request2.companyDomain) && !stringValue(request2.companyName) || controlKey(request2) !== firstControlKey
+        (request2) => Boolean(stringValue(request2.signalRunId)) || Boolean(stringValue(request2.idempotencyKey)) || !stringValue(request2.domain)
       );
       if (incompatible) {
         throw new CliInputError(
-          "Company Signals batches larger than 25 require homogeneous new-enrichment rows with company identity only and uniform controls; split recovery or mixed-control rows into batches of at most 25."
+          "Company Signals batches larger than 25 require domain-only rows without per-row controls or recovery IDs."
         );
       }
     } else if (hasFlag("no-wait") && !hasFlag("dry-run")) {
@@ -1144,7 +1389,7 @@ async function companySignals() {
       return;
     }
     const result2 = await createClient().enrichCompanies(requests, batchOptions());
-    batchOutput(customerSignalBatch(result2));
+    batchOutput(customerCompanySignalBatch(result2));
     return;
   }
   if (hasFlag("no-wait")) {
@@ -1154,49 +1399,30 @@ async function companySignals() {
     throw new CliInputError("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");
-  if (!companyDomain && !companyName && !signalRunId) {
+  if (!companyDomain && !signalRunId) {
     throw new CliInputError("Usage: signaliz company-signals --domain example.com");
   }
   const request = {
     signalRunId,
-    companyDomain,
-    companyName,
-    researchPrompt: flag("research-prompt") || flag("prompt"),
-    signalTypes: csvFlag("signal-types"),
-    targetSignalCount: numberFlag("target-signal-count"),
-    lookbackDays: numberFlag("lookback-days"),
-    online: !hasFlag("offline"),
-    enableDeepSearch: !hasFlag("offline") && !hasFlag("shallow"),
-    searchMode: companySignalSearchMode(flag("search-mode")),
-    includeSummary: !hasFlag("no-summary"),
-    enableOutreachIntelligence: hasFlag("outreach-intelligence") || void 0,
-    enablePredictiveIntelligence: hasFlag("predictive-intelligence") || void 0,
-    skipCache: hasFlag("skip-cache"),
-    includeCandidateEvidence: hasFlag("include-candidate-evidence"),
-    maxWaitMs: numberFlag("max-wait-ms"),
+    domain: companyDomain,
     idempotencyKey: flag("idempotency-key")
   };
-  requireIntegerInRange(request.targetSignalCount, "targetSignalCount", 1, 15);
-  requireIntegerInRange(request.lookbackDays, "lookbackDays", 1, 365);
-  requireIntegerInRange(request.maxWaitMs, "maxWaitMs", 1e4, 12e4);
   if (hasFlag("dry-run")) {
     const result2 = await createClient().enrichCompanySignals({ ...request, dryRun: true });
     dryRunOutput(result2);
     return;
   }
-  const result = customerSignalResult(await createClient().enrichCompanySignals(request));
+  const result = customerCompanySignalResult(await createClient().enrichCompanySignals(request));
   if (outputFailedCoreProduct(result, "Company Signal enrichment failed")) return;
   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}
+    process.stdout.write(`Credits used: ${result.creditsUsed || 0}
 `);
-    for (const signal of result.signals.slice(0, 5)) {
-      process.stdout.write(`- ${signal.title} [${signal.type}]
+    for (const signal of result.signals.slice(0, PUBLIC_COMPANY_SIGNAL_MAX_COVERAGE_COUNT)) {
+      process.stdout.write(`${signal.date}	${signal.signal_type}	${signal.signal_title}	${signal.signal_summary}	${signal.source}
 `);
     }
   });
@@ -1208,6 +1434,8 @@ function signalQueryFromArgs(args) {
     "--limit",
     "--sources",
     "--lookback-days",
+    "--after-date",
+    "--before-date",
     "--icp-context",
     "--signal-search-run-id",
     "--idempotency-key",
@@ -1253,9 +1481,12 @@ async function signals(args) {
     limit: numberFlag("limit"),
     sources: sourceValues,
     lookbackDays: numberFlag("lookback-days"),
+    afterDate: flag("after-date"),
+    beforeDate: flag("before-date"),
     idempotencyKey: flag("idempotency-key"),
     dryRun: hasFlag("dry-run")
   };
+  validateSignalDateWindow(request.afterDate, request.beforeDate, request.lookbackDays);
   let result = await discoverSignalsEverything(request);
   if (hasFlag("wait") && !request.dryRun) {
     const maxWaitMs = numberFlag("max-wait-ms") ?? 15 * 6e4;
@@ -1271,57 +1502,135 @@ async function signals(args) {
   }
   output(result, () => {
     if (result.status === "planned") {
-      process.stdout.write(`Signals Everything plan: ${result.requestedCount} distinct companies. No source acquisition was launched.
+      process.stdout.write(`Signals Everything plan: ${result.requestedCount} distinct companies. No source acquisition was launched. Included on plan; 0 Signaliz credits charged.
 `);
       return;
     }
     if (signalDiscoveryIsPending(result.status)) {
       process.stdout.write(`Signals Everything ${result.status}: ${result.signalSearchRunId}
+`);
+      process.stdout.write(`Billing: included on plan \xB7 ${result.creditsCharged} Signaliz credits charged.
 `);
       process.stdout.write(`Resume with --signal-search-run-id ${result.signalSearchRunId}${hasFlag("wait") ? " after the current wait window" : ""}.
 `);
       return;
     }
     if (!result.success || result.status === "failed") {
-      process.stdout.write(`${String(result.raw.error || result.raw.message || "Signals Everything failed.")}
+      process.stdout.write(`${result.error || "Signals Everything failed."}
 `);
       return;
     }
-    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(
-        `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})` : ""}.
-`
-        );
-      }
-    }
+    process.stdout.write(`Billing: ${result.billingStatus === "included" ? "included on plan" : "receipt unavailable"} \xB7 ${result.creditsCharged} Signaliz credits charged.
+`);
+    if (result.idempotencyReplayed) process.stdout.write("Retained result reused; no new source acquisition.\n");
     for (const signal of result.signals.slice(0, 20)) {
-      process.stdout.write(`- ${signal.company.name} (${signal.company.domain}) \u2014 ${signal.eventDate} \u2014 ${signal.title}
-  ${signal.sourceUrl}
+      process.stdout.write(`- ${signal.company_name} (${signal.domain}) \u2014 ${signal.date} \u2014 ${signal.signal_type}
+  ${signal.source}
 `);
     }
     if (result.signalCount > 20) process.stdout.write(`Showing 20 of ${result.signalCount}; use --json for the full result.
-`);
-    for (const warning of result.warnings || []) process.stdout.write(`Warning: ${warning}
 `);
   });
 }
+async function flow() {
+  const runId = flag("run-id");
+  if (runId) {
+    const conflicts = [
+      "signal-query",
+      "query",
+      "campaign-offer",
+      "offer",
+      "limit",
+      "lookback-days",
+      "after-date",
+      "before-date",
+      "people-titles",
+      "people-per-company",
+      "copy-research-prompt",
+      "icp-context",
+      "dry-run",
+      "idempotency-key",
+      "deep-search"
+    ].filter(hasFlag);
+    if (conflicts.length > 0) {
+      throw new CliInputError(`Flow --run-id cannot be combined with ${conflicts.map((name) => `--${name}`).join(", ")}.`);
+    }
+    const result2 = await createClient().getFlow(runId);
+    output(result2, () => {
+      const outcome = record(result2.result);
+      process.stdout.write(`Signaliz Flow ${result2.status}: ${result2.runId}
+`);
+      process.stdout.write(`Verified leads: ${Number(outcome.emails_verified || 0)} \xB7 Copy drafts: ${Number(outcome.copies_ready || 0)}
+`);
+      const billing = record(outcome.billing);
+      if (billing.creditsCharged !== void 0) process.stdout.write(`Credits charged: ${Number(billing.creditsCharged || 0)}
+`);
+    });
+    return;
+  }
+  const signalQuery = flag("signal-query") || flag("query");
+  const campaignOffer = flag("campaign-offer") || flag("offer");
+  if (!signalQuery || !campaignOffer) {
+    fail('Usage: signaliz flow --signal-query "companies with recent hiring" --campaign-offer "your offer" [--limit 5]');
+  }
+  const removedFlowControls = [
+    "after-date",
+    "before-date",
+    "deep-search",
+    "enable-deep-search",
+    "signal-types",
+    "search-mode",
+    "model",
+    "online",
+    "offline",
+    "shallow",
+    "skip-cache",
+    "bypass-cache",
+    "fresh-only",
+    "cache-ttl-hours",
+    "cache-ttl-seconds",
+    "cache-enabled",
+    "cache-policy",
+    "target-signal-count",
+    "provider-target-signal-count"
+  ].filter(hasFlag);
+  if (removedFlowControls.length > 0) {
+    throw new CliInputError(
+      `Flow selects signal acquisition internally; ${removedFlowControls.map((name) => `--${name}`).join(", ")} is no longer supported. Use --lookback-days to set the maximum evidence age.`
+    );
+  }
+  const request = {
+    signalQuery,
+    campaignOffer,
+    signalLimit: numberFlag("limit"),
+    lookbackDays: numberFlag("lookback-days"),
+    icpContext: flag("icp-context"),
+    peopleTitles: csvFlag("people-titles"),
+    peoplePerCompany: numberFlag("people-per-company"),
+    copyResearchPrompt: flag("copy-research-prompt") || flag("research-prompt"),
+    approvalRequired: true,
+    idempotencyKey: flag("idempotency-key")
+  };
+  requireIntegerInRange(request.signalLimit, "limit", 1, 25);
+  requireIntegerInRange(request.lookbackDays, "lookbackDays", 1, 365);
+  requireIntegerInRange(request.peoplePerCompany, "peoplePerCompany", 1, 5);
+  if (hasFlag("dry-run")) {
+    const result2 = await createClient().startFlow({ ...request, dryRun: true });
+    output(result2, () => {
+      process.stdout.write(`Signaliz Flow plan: up to ${result2.plan.maximumReviewCandidates} review candidates. No work was dispatched.
+`);
+      for (const safeguard of result2.plan.safeguards) process.stdout.write(`- ${safeguard}
+`);
+    });
+    return;
+  }
+  const result = await createClient().startFlow(request);
+  output(result, () => process.stdout.write(`Signaliz Flow started: ${result.runId}
+Check status: signaliz flow --run-id ${result.runId}
+`));
+}
 async function signalToCopy() {
   const jobId = flag("job-id");
   if (jobId) {
@@ -1337,8 +1646,12 @@ async function signalToCopy() {
       "research-prompt",
       "prompt",
       "lookback-days",
+      "copy-evidence-mode",
+      "without-signals",
       "signal-run-id",
-      "skip-cache",
+      "signal-search-run-id",
+      "fact-id",
+      "event-id",
       "deep-search",
       "no-wait",
       "concurrency"
@@ -1369,27 +1682,28 @@ async function signalToCopy() {
         personName: row.personName || row.person_name,
         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"),
+        copyEvidenceMode: row.copyEvidenceMode || row.copy_evidence_mode || flag("copy-evidence-mode") || (hasFlag("without-signals") ? "firmographic" : void 0),
+        lookbackDays: 365,
         signalRunId: row.signalRunId || row.signal_run_id,
-        skipCache: row.skipCache ?? row.skip_cache ?? hasFlag("skip-cache"),
+        signalSearchRunId: row.signalSearchRunId || row.signal_search_run_id,
+        factId: row.factId || row.fact_id,
+        eventId: row.eventId || row.event_id,
         enableDeepSearch: row.enableDeepSearch ?? row.enable_deep_search ?? hasFlag("deep-search"),
         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.lookbackDays, "lookbackDays", 1, 365);
       requireIntegerInRange(request2.maxWaitMs, "maxWaitMs", 1e4, 12e4);
       requireSignalToCopyIdentity(request2);
     }
     if (durableBatch) {
       const invalidIndex = requests.findIndex(
-        (request2) => request2.skipCache === true || request2.enableDeepSearch === true || Boolean(stringValue(request2.idempotencyKey)) || request2.maxWaitMs !== void 0 || !stringValue(request2.companyDomain) || !stringValue(request2.personName) || !stringValue(request2.title) || !stringValue(request2.campaignOffer)
+        (request2) => Boolean(stringValue(request2.idempotencyKey)) || request2.maxWaitMs !== void 0 || Boolean(stringValue(request2.signalSearchRunId)) || Boolean(stringValue(request2.factId)) || Boolean(stringValue(request2.eventId)) || !stringValue(request2.companyDomain) || !stringValue(request2.personName) || !stringValue(request2.title) || !stringValue(request2.campaignOffer)
       );
       if (invalidIndex >= 0) {
         throw new CliInputError(
-          `Signal to Copy batches larger than 25 are available-data-only; row ${invalidIndex} requests fresh/deep/synchronous controls or lacks required recipient fields. Split fresh requests into batches of at most 25.`
+          `Signal to Copy batch row ${invalidIndex} uses canonical references (supported only in batches of 25 or fewer), uses unsupported row-level execution controls, or lacks required recipient fields. Put wait and idempotency controls on the batch command.`
         );
       }
     } else if (hasFlag("no-wait") && !hasFlag("dry-run")) {
@@ -1416,7 +1730,7 @@ async function signalToCopy() {
     return;
   }
   if (hasFlag("no-wait")) {
-    throw new CliInputError("Signal to Copy --no-wait requires --input with more than 25 available-data-only rows.");
+    throw new CliInputError("Signal to Copy --no-wait requires --input with more than 25 rows.");
   }
   if (hasFlag("poll-interval-ms")) {
     throw new CliInputError("Signal to Copy --poll-interval-ms requires --input or --job-id.");
@@ -1431,15 +1745,16 @@ async function signalToCopy() {
     personName,
     title,
     campaignOffer,
-    researchPrompt: flag("research-prompt") || flag("prompt"),
-    lookbackDays: numberFlag("lookback-days"),
+    copyEvidenceMode: flag("copy-evidence-mode") || (hasFlag("without-signals") ? "firmographic" : void 0),
+    lookbackDays: 365,
     signalRunId,
-    skipCache: hasFlag("skip-cache"),
+    signalSearchRunId: flag("signal-search-run-id"),
+    factId: flag("fact-id"),
+    eventId: flag("event-id"),
     enableDeepSearch: hasFlag("deep-search"),
     maxWaitMs: numberFlag("max-wait-ms"),
     idempotencyKey: flag("idempotency-key")
   };
-  requireIntegerInRange(request.lookbackDays, "lookbackDays", 1, 365);
   requireIntegerInRange(request.maxWaitMs, "maxWaitMs", 1e4, 12e4);
   requireSignalToCopyIdentity(request);
   if (hasFlag("dry-run")) {
@@ -1459,8 +1774,16 @@ async function signalToCopy() {
 Confidence: ${result.confidence}
 Evidence: ${result.evidenceUrl}
 `);
-    process.stdout.write(`Result source: ${result.resultReturnedFrom || "unknown"}
-Credits used: ${result.creditsUsed || 0}
+    const canonicalPointers = [
+      result.signalSearchRunId ? `snapshot=${result.signalSearchRunId}` : "",
+      result.factId ? `fact=${result.factId}` : "",
+      result.eventId ? `event=${result.eventId}` : ""
+    ].filter(Boolean);
+    if (canonicalPointers.length > 0) {
+      process.stdout.write(`Canonical evidence: ${canonicalPointers.join(" ")}
+`);
+    }
+    process.stdout.write(`Credits used: ${result.creditsUsed || 0}
 `);
     for (const variation of result.variations) {
       process.stdout.write(`
@@ -1510,6 +1833,108 @@ Import this file into your MCP client.
 `);
   });
 }
+function awarenessSchedule() {
+  const direct = flag("schedule-cron");
+  if (direct) return direct;
+  const schedule = flag("schedule");
+  if (!schedule) return void 0;
+  const schedules = {
+    every_6_hours: "0 */6 * * *",
+    daily: "0 8 * * *",
+    every_2_days: "0 8 */2 * *",
+    weekly: "0 8 * * 1"
+  };
+  if (!schedules[schedule]) {
+    throw new CliInputError("--schedule must be every_6_hours, daily, every_2_days, or weekly");
+  }
+  return schedules[schedule];
+}
+async function awareness(args) {
+  const action = args[0];
+  const monitorId = flag("monitor-id");
+  if (!action || !["create", "list", "run", "signals", "pause", "resume", "delete"].includes(action)) {
+    throw new CliInputError("Usage: signaliz awareness <create|list|run|signals|pause|resume|delete>");
+  }
+  const client = createClient();
+  if (action === "create") {
+    const companyName = flag("company-name");
+    const domain = flag("domain");
+    if (!companyName || !domain) {
+      throw new CliInputError('Usage: signaliz awareness create --company-name "Acme" --domain acme.com');
+    }
+    const monthlyCreditCap = numberFlag("monthly-credit-cap");
+    if (monthlyCreditCap !== void 0) requireIntegerInRange(monthlyCreditCap, "--monthly-credit-cap", 1, 1e4);
+    const lookbackDays = numberFlag("lookback-days");
+    if (lookbackDays !== void 0) requireIntegerInRange(lookbackDays, "--lookback-days", 1, 365);
+    const signalTypes = csvFlag("signal-types");
+    const result2 = await client.createSignalMonitor({
+      companyName,
+      domain,
+      template: flag("template") === "basic" ? "basic" : "full_intelligence",
+      scheduleCron: awarenessSchedule(),
+      monthlyCreditCap,
+      webhookUrl: flag("webhook-url"),
+      signalConfig: {
+        ...lookbackDays !== void 0 ? { lookback_days: lookbackDays } : {},
+        ...signalTypes ? { signal_types: signalTypes } : {},
+        ...flag("research-prompt") ? { research_prompt: flag("research-prompt") } : {}
+      }
+    });
+    output(result2, () => process.stdout.write(`Monitor created: ${String(result2.monitor?.id || "pending")}
+`));
+    return;
+  }
+  if (action === "list") {
+    const offset = numberFlag("offset");
+    if (offset !== void 0) requireIntegerInRange(offset, "--offset", 0, 1e4);
+    const result2 = await client.listSignalMonitors(numberFlag("limit"), offset);
+    output(result2, () => {
+      for (const monitor of result2.monitors || []) {
+        process.stdout.write(`${String(monitor.company_name)}	${String(monitor.status)}	${String(monitor.next_run_at || "not scheduled")}	${String(monitor.id)}
+`);
+      }
+    });
+    return;
+  }
+  if (action === "signals") {
+    const offset = numberFlag("offset");
+    if (offset !== void 0) requireIntegerInRange(offset, "--offset", 0, 1e4);
+    const result2 = customerSignalAwarenessResult(await client.signalAwareness({
+      action: "list_signals",
+      monitorId,
+      limit: numberFlag("limit"),
+      offset
+    }));
+    output(result2, () => {
+      for (const signal of result2.signals || []) {
+        process.stdout.write(`${signal.signal_type}	${signal.signal_title}	${signal.signal_summary}	${signal.source}	${signal.date}	${signal.company_name}	${signal.domain}
+`);
+      }
+    });
+    return;
+  }
+  if (!monitorId) throw new CliInputError(`signaliz awareness ${action} requires --monitor-id <uuid>`);
+  if (action === "run") {
+    if (hasFlag("dry-run")) {
+      const result3 = await client.signalAwareness({ action: "manual_run", monitorId, idempotencyKey: flag("idempotency-key"), dryRun: true });
+      output(result3);
+      return;
+    }
+    const result2 = await client.runSignalMonitor(monitorId, flag("idempotency-key"));
+    output(result2, () => {
+      process.stdout.write(`Run: ${String(result2.run?.id || result2.runId || "pending")}
+Signals: ${String(result2.run?.signals_found || 0)}
+Credits used: ${result2.creditsUsed || 0}
+`);
+    });
+    return;
+  }
+  const result = await client.signalAwareness(
+    action === "delete" ? { action: "delete", monitorId } : { action: "update", monitorId, updates: { status: action === "resume" ? "active" : "paused", ...action === "resume" ? { auto_paused: false, auto_pause_reason: null } : {} } }
+  );
+  output(result, () => process.stdout.write(`Monitor ${action === "delete" ? "deleted" : action === "resume" ? "resumed" : "paused"}: ${monitorId}
+`));
+}
 async function main() {
   const [, , command, ...args] = process.argv;
   if (!command || ["help", "--help", "-h"].includes(command)) {
@@ -1527,6 +1952,12 @@ async function main() {
       return companySignals();
     case "signals":
       return signals(args);
+    case "signals-first":
+      return signals(args);
+    case "awareness":
+      return awareness(args);
+    case "flow":
+      return flow();
     case "signal-to-copy":
       return signalToCopy();
     case "health":