@signaliz/sdk 1.0.66 → 1.0.68

package/dist/index.js

@@ -74,8 +74,6 @@ function publicRetryDetails(body) {
     ...body?.retry_strategy !== void 0 ? { retry_strategy: body.retry_strategy } : {},
     ...body?.credits_used !== void 0 ? { credits_used: body.credits_used } : {},
     ...body?.credits_charged !== void 0 ? { credits_charged: body.credits_charged } : {},
-    ...body?.live_provider_called !== void 0 ? { live_provider_called: body.live_provider_called } : {},
-    ...body?.estimated_external_cost_usd !== void 0 ? { estimated_external_cost_usd: body.estimated_external_cost_usd } : {},
     ...body?.job_id !== void 0 ? { job_id: body.job_id } : {},
     ...body?.idempotency_key !== void 0 ? { idempotency_key: body.idempotency_key } : {},
     ...body?.verification_run_id !== void 0 ? { verification_run_id: body.verification_run_id } : {},
@@ -228,10 +226,10 @@ var HttpClient = class {
           }),
           signal: controller.signal
         });
-        const text = await res.text();
-        const data = safeJson(text);
+        const text2 = await res.text();
+        const data = safeJson(text2);
         if (!res.ok) {
-          const err = parseError(res.status, data ?? { message: text });
+          const err = parseError(res.status, data ?? { message: text2 });
           if (err.isRetryable && attempt < this.maxRetries) {
             if (err.details?.retry_strategy === "same_run_recovery") throw err;
             lastError = err;
@@ -245,7 +243,7 @@ var HttpClient = class {
             code: "INVALID_JSON",
             message: "MCP response was not valid JSON",
             errorType: "provider_error",
-            details: { responseText: text.slice(0, 500) }
+            details: { responseText: text2.slice(0, 500) }
           });
         }
         const responseError = isRecord(data) && isRecord(data.error) ? data.error : null;
@@ -330,9 +328,9 @@ function requestIdempotencyKey(body, automaticIdempotency) {
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
-function safeJson(text) {
+function safeJson(text2) {
   try {
-    return JSON.parse(text);
+    return JSON.parse(text2);
   } catch {
     return null;
   }
@@ -368,10 +366,10 @@ function unwrapMcpResponse(data) {
   }
   const content = isRecord(result) ? result.content : void 0;
   const firstContent = Array.isArray(content) ? content[0] : void 0;
-  const text = isRecord(firstContent) ? firstContent.text : void 0;
-  if (typeof text === "string") {
-    const parsed = safeJson(text);
-    return unwrapMcpPayload(parsed ?? text);
+  const text2 = isRecord(firstContent) ? firstContent.text : void 0;
+  if (typeof text2 === "string") {
+    const parsed = safeJson(text2);
+    return unwrapMcpPayload(parsed ?? text2);
   }
   return unwrapMcpPayload(result);
 }
@@ -518,8 +516,8 @@ function assertCompanySignalRows(body) {
   );
   if (Array.isArray(body.signal_types)) {
     body.signal_types.forEach(
-      (signalType, index) => assertStringBytes(
-        signalType,
+      (signalType2, index) => assertStringBytes(
+        signalType2,
         `signal_types[${index}]`,
         SIGNAL_TYPE_MAX_UTF8_BYTES,
         index
@@ -529,9 +527,11 @@ function assertCompanySignalRows(body) {
   requests.forEach((value, index) => {
     if (!value || typeof value !== "object" || Array.isArray(value)) return;
     const request = value;
+    const domain = request.domain ?? request.company_domain;
+    const domainField = request.domain !== void 0 ? "domain" : "company_domain";
     assertStringBytes(
-      request.company_domain,
-      `requests[${index}].company_domain`,
+      domain,
+      `requests[${index}].${domainField}`,
       DOMAIN_MAX_UTF8_BYTES,
       index
     );
@@ -611,6 +611,190 @@ function assertLargeCoreProductInputBounds(path, body) {
   );
 }
 
+// src/public-signal-row.ts
+var PUBLIC_COMPANY_SIGNAL_MAX_COVERAGE_COUNT = 10;
+function recordValue(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function text(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function dateOnly(value) {
+  const raw = text(value);
+  const match = raw.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 classificationSlug(value) {
+  const direct = text(value);
+  if (direct) return direct;
+  const classification = recordValue(value);
+  return text(classification.slug || classification.type || classification.name);
+}
+function signalType(signal) {
+  const raw = recordValue(signal.raw_data);
+  const generic = /* @__PURE__ */ new Set(["unclassified", "unknown", "other", "news", "signal"]);
+  for (const value of [
+    signal.signal_type,
+    classificationSlug(signal.signal_classification),
+    classificationSlug(signal.classification),
+    raw.signal_type,
+    classificationSlug(raw.signal_classification),
+    classificationSlug(raw.classification),
+    signal.type,
+    signal.category,
+    signal.event_type,
+    raw.type,
+    raw.category,
+    raw.event_type
+  ]) {
+    const candidate = text(value);
+    if (candidate && !generic.has(candidate.toLowerCase())) return candidate;
+  }
+  return "";
+}
+function verifiedHttpsUrl(value) {
+  const candidate = text(value);
+  if (!candidate || /\s/.test(candidate)) return "";
+  try {
+    const parsed = new URL(candidate);
+    return parsed.protocol === "https:" && Boolean(parsed.hostname) && !parsed.username && !parsed.password ? candidate : "";
+  } catch {
+    return "";
+  }
+}
+function normalizedDomain(value) {
+  const normalized = text(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 firstValid(values, normalize) {
+  for (const value of values) {
+    const normalized = normalize(value);
+    if (normalized) return normalized;
+  }
+  return "";
+}
+function publicSignalRow(value, fallbackCompany) {
+  const signal = recordValue(value);
+  const raw = recordValue(signal.raw_data);
+  const company = recordValue(signal.company);
+  const rawCompany = recordValue(raw.company);
+  const fallback = recordValue(fallbackCompany);
+  const row = {
+    signal_type: signalType(signal),
+    signal_title: firstValid([
+      signal.signal_title,
+      raw.signal_title,
+      signal.title,
+      raw.title,
+      signal.headline,
+      raw.headline,
+      signal.name,
+      raw.name
+    ], text),
+    signal_summary: firstValid([
+      signal.signal_summary,
+      raw.signal_summary,
+      signal.summary,
+      raw.summary,
+      signal.signal_content,
+      raw.signal_content,
+      signal.content,
+      raw.content,
+      signal.description,
+      raw.description
+    ], text),
+    source: firstValid([
+      signal.canonical_source_url,
+      signal.source_url,
+      signal.verified_source_url,
+      signal.signal_source,
+      signal.source,
+      signal.url,
+      raw.canonical_source_url,
+      raw.source_url,
+      raw.verified_source_url,
+      raw.signal_source,
+      raw.source,
+      raw.url
+    ], verifiedHttpsUrl),
+    date: firstValid([
+      signal.date,
+      signal.event_date,
+      signal.signal_date,
+      signal.published_date,
+      signal.published_at,
+      signal.detected_at,
+      signal.observed_at,
+      raw.date,
+      raw.event_date,
+      raw.signal_date,
+      raw.published_date,
+      raw.published_at,
+      raw.detected_at,
+      raw.observed_at
+    ], dateOnly),
+    company_name: text(
+      signal.company_name || company.name || company.company_name || raw.company_name || rawCompany.name || rawCompany.company_name || fallback.company_name || fallback.name
+    ),
+    domain: firstValid([
+      signal.company_domain,
+      signal.domain,
+      company.domain,
+      company.company_domain,
+      raw.company_domain,
+      raw.domain,
+      rawCompany.domain,
+      rawCompany.company_domain,
+      fallback.company_domain,
+      fallback.domain
+    ], normalizedDomain)
+  };
+  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 companySignalEventIdentities(value, row) {
+  const signal = recordValue(value);
+  const raw = recordValue(signal.raw_data);
+  const eventId = text(
+    signal.event_id || signal.eventId || signal.fact_id || signal.factId || raw.event_id || raw.eventId || raw.fact_id || raw.factId
+  ).toLowerCase();
+  return [
+    ...eventId ? [`event:${eventId}`] : [],
+    `source:${row.source.toLowerCase()}`
+  ];
+}
+function publicCompanySignalRows(value, fallbackCompany) {
+  if (!Array.isArray(value)) return [];
+  const seenEvents = /* @__PURE__ */ new Set();
+  const rows = [];
+  for (const item of value) {
+    const row = publicSignalRow(item, fallbackCompany);
+    if (!row) continue;
+    const identities = companySignalEventIdentities(item, row);
+    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 oneSignalPerCompany(rows) {
+  const seen = /* @__PURE__ */ new Set();
+  return rows.filter((row) => {
+    if (seen.has(row.domain)) return false;
+    seen.add(row.domain);
+    return true;
+  });
+}
+
 // ../../supabase/functions/_shared/find-email-identity.ts
 var LINKEDIN_PERSON_PROFILE_URL_PATTERN = "^[hH][tT][tT][pP][sS]://(?:[A-Za-z0-9-]+\\.)*[lL][iI][nN][kK][eE][dD][iI][nN]\\.[cC][oO][mM]/[iI][nN]/[^/?#]+/?(?:[?#].*)?$";
 var LINKEDIN_PERSON_PROFILE_URL_REGEX = new RegExp(LINKEDIN_PERSON_PROFILE_URL_PATTERN);
@@ -642,6 +826,27 @@ var Signaliz = class {
   constructor(config) {
     this.client = new HttpClient(config);
   }
+  /**
+   * The canonical Signal Awareness control plane used by the CLI and MCP.
+   * Manual runs accept a stable retry key and return an explicit billing
+   * receipt, including zero-credit available-data reuse.
+   */
+  async signalAwareness(request) {
+    const data = await this.client.post(
+      "api/v1/signal-awareness",
+      signalAwarenessRequestBody(request)
+    );
+    return normalizeSignalAwarenessResponse(data);
+  }
+  async createSignalMonitor(monitor) {
+    return this.signalAwareness({ action: "create", monitor });
+  }
+  async listSignalMonitors(limit, offset) {
+    return this.signalAwareness({ action: "list", limit, offset });
+  }
+  async runSignalMonitor(monitorId, idempotencyKey) {
+    return this.signalAwareness({ action: "manual_run", monitorId, idempotencyKey });
+  }
   async findEmail(params) {
     const request = findEmailRequestBody(params);
     assertFindEmailRequestIdentity(request);
@@ -711,14 +916,12 @@ var Signaliz = class {
         error,
         error_code: "INPUT_001",
         retry_eligible: false,
-        credits_used: 0,
-        live_provider_called: false
+        credits_used: 0
       });
     }
     const request = compact({
       email: email || void 0,
       verification_run_id: options?.verificationRunId,
-      skip_cache: options?.skipCache,
       dry_run: options?.dryRun,
       idempotency_key: options?.idempotencyKey
     });
@@ -803,19 +1006,38 @@ var Signaliz = class {
     );
     return normalizeSignalDiscoveryResult(params, data);
   }
+  /** Signals First is the customer-facing name for open-ended discovery. */
+  async discoverSignalsFirst(params) {
+    return this.discoverSignals(params);
+  }
+  async startFlow(params) {
+    validateSignalizFlowParams(params);
+    const data = await this.client.post(
+      "api/v1/flow",
+      signalizFlowRequestBody(params)
+    );
+    return data.dry_run === true ? normalizeSignalizFlowPlanResult(data) : normalizeSignalizFlowStartResult(data);
+  }
+  async getFlow(runId) {
+    const normalizedRunId = runId.trim();
+    if (!normalizedRunId || normalizedRunId.length > 200) {
+      throw new RangeError("runId must contain between 1 and 200 characters");
+    }
+    const data = await this.client.post(
+      "api/v1/flow",
+      { run_id: normalizedRunId },
+      { automaticIdempotency: false }
+    );
+    return normalizeSignalizFlowStatus(data);
+  }
   async enrichCompanies(companies, options) {
     validateBatchSize(companies);
     companies.forEach(validateCompanySignalParams);
     const requests = companies.map(companySignalRequestBody);
-    if (companies.length > 25 && requests.some((request) => request.include_candidate_evidence === true)) {
-      throw new RangeError(
-        "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."
-      );
-    }
     const largeBatch = companySignalLargeBatchSubmission(requests);
     if (companies.length > 25 && !largeBatch) {
       throw new RangeError(
-        "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 homogeneous new-enrichment rows with a domain only; split recovery or mixed-context rows into batches of at most 25."
       );
     }
     if (options?.dryRun === true) {
@@ -866,14 +1088,14 @@ var Signaliz = class {
       if (total !== companies.length) {
         throw new Error(`Company Signals batch returned ${total} results for ${companies.length} requests`);
       }
-      const batch = finalizeCoreBatch(
+      const batch2 = finalizeCoreBatch(
         companies.length,
         startedAt,
         recoverableRowsToRound(rows, "Company Signals"),
         (item) => normalizeCompanySignalResult(companies[item.index], item.raw)
       );
       return compactKnownDuplicateBatch(
-        batch,
+        batch2,
         dedupeExactBatchItems(
           requests,
           (request) => coreProductBatchRequestKey("api/v1/company-signals", request)
@@ -894,15 +1116,21 @@ var Signaliz = class {
         return batchItemFailure(item.index, error instanceof Error ? error.message : String(error), item.raw);
       }
     });
-    const compactedResults = compactExactDuplicateResults(results, options?.compactDuplicates === true);
-    const succeeded = compactedResults.filter((item) => item.success).length;
-    return {
+    const batch = {
       total: companies.length,
-      succeeded,
-      failed: companies.length - succeeded,
+      succeeded: results.filter((item) => item.success).length,
+      failed: companies.length - results.filter((item) => item.success).length,
       durationMs: Date.now() - startedAt,
-      results: compactedResults
+      results
     };
+    return compactKnownDuplicateBatch(
+      batch,
+      dedupeExactBatchItems(
+        requests,
+        (request) => coreProductBatchRequestKey("api/v1/company-signals", request)
+      ).sourceIndexByInput,
+      options?.compactDuplicates === true
+    );
   }
   async resumeCompanySignalBatch(jobId, options) {
     const startedAt = Date.now();
@@ -931,7 +1159,7 @@ var Signaliz = class {
   async createSignalCopyBatch(requests, options) {
     validateBatchSize(requests);
     requests.forEach(validateSignalToCopyParams);
-    validateLargeAvailableDataSignalCopyBatch(requests);
+    validateLargeSignalCopyBatch(requests);
     if (options?.dryRun === true) {
       return this.runCoreProductDryRun(
         "api/v1/signal-to-copy",
@@ -944,7 +1172,7 @@ var Signaliz = class {
       if (options?.waitForResult === false) {
         return this.submitRecoverableCoreBatchJob(
           "api/v1/signal-to-copy",
-          requests.map(availableDataSignalCopyRequestBody),
+          requests.map(durableSignalCopyRequestBody),
           "Signal to Copy",
           options.idempotencyKey,
           requests.map((_, index) => index)
@@ -952,7 +1180,7 @@ var Signaliz = class {
       }
       const job = await this.submitRecoverableCoreBatchJob(
         "api/v1/signal-to-copy",
-        requests.map(availableDataSignalCopyRequestBody),
+        requests.map(durableSignalCopyRequestBody),
         "Signal to Copy",
         options?.idempotencyKey,
         requests.map((_, index) => index)
@@ -1490,8 +1718,6 @@ function batchItemFailure(index, error, raw) {
   const retryStrategy = raw?.retry_strategy ?? raw?.retryStrategy;
   const creditsUsed = raw?.credits_used ?? raw?.creditsUsed;
   const creditsCharged = raw?.credits_charged ?? raw?.creditsCharged;
-  const liveProviderCalled = raw?.live_provider_called ?? raw?.liveProviderCalled;
-  const estimatedExternalCostUsd = raw?.estimated_external_cost_usd ?? raw?.estimatedExternalCostUsd;
   const runId = [raw?.run_id, raw?.runId, raw?.signal_run_id, raw?.signalRunId].find((value) => typeof value === "string" && value.trim());
   const verificationRunId = raw?.verification_run_id ?? raw?.verificationRunId;
   const jobId = raw?.job_id ?? raw?.jobId;
@@ -1506,8 +1732,6 @@ function batchItemFailure(index, error, raw) {
     ...["new_idempotency_key", "same_run_recovery"].includes(String(retryStrategy)) ? { retryStrategy } : {},
     ...creditsUsed === 0 ? { creditsUsed: 0 } : {},
     ...creditsCharged === 0 ? { creditsCharged: 0 } : {},
-    ...liveProviderCalled === false ? { liveProviderCalled: false } : {},
-    ...estimatedExternalCostUsd === 0 ? { estimatedExternalCostUsd: 0 } : {},
     ...typeof runId === "string" && runId.trim() ? { runId: runId.trim() } : {},
     ...typeof verificationRunId === "string" && verificationRunId.trim() ? { verificationRunId: verificationRunId.trim() } : {},
     ...typeof jobId === "string" && jobId.trim() ? { jobId: jobId.trim() } : {},
@@ -1563,6 +1787,51 @@ function newBatchIdempotencyKey(label) {
 function compact(input) {
   return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
 }
+var INTERNAL_PRODUCT_RESULT_KEYS = /* @__PURE__ */ new Set([
+  "billing_metadata",
+  "historical_billing_metadata",
+  "result_returned_from",
+  "fresh_enrichment_used",
+  "live_provider_called",
+  "openrouter_called",
+  "byo_openrouter_used",
+  "ai_provider_called",
+  "byo_ai_used",
+  "estimated_external_cost_usd",
+  "included_provider_cost_usd",
+  "would_have_charged_credits",
+  "available_data_only",
+  "available_data_input_count",
+  "unique_available_data_input_count"
+]);
+var PUBLIC_PRODUCT_DATA_MEMO = /* @__PURE__ */ new WeakMap();
+function publicProductData(value, capability = "") {
+  if (Array.isArray(value)) return value.map((item) => publicProductData(item, capability));
+  if (!value || typeof value !== "object") return value;
+  const source = value;
+  const inferredCapability = String(source.capability || capability).toLowerCase();
+  const cachedByCapability = PUBLIC_PRODUCT_DATA_MEMO.get(source);
+  if (cachedByCapability?.has(inferredCapability)) return cachedByCapability.get(inferredCapability);
+  const result = Object.fromEntries(Object.entries(source).flatMap(([key, raw]) => {
+    const normalizedKey = key.toLowerCase();
+    if (INTERNAL_PRODUCT_RESULT_KEYS.has(normalizedKey) || normalizedKey.includes("cache")) return [];
+    if (typeof raw === "string" && (raw.toLowerCase().includes("cache") || raw === "available_data")) {
+      if (["error", "message", "suggested_action", "failure_reason"].includes(normalizedKey)) {
+        return [[key, "The result could not be finalized. Retry safely using the existing run or job ID."]];
+      }
+      if (["source", "email_source", "email_source_label", "verification_source", "provider_status"].includes(normalizedKey)) {
+        const sourceLabel = inferredCapability.includes("verify") ? "email_verification" : inferredCapability.includes("find") ? "email_finder" : inferredCapability.includes("signal_to_copy") ? "signal_to_copy" : "company_signal_enrichment";
+        return [[key, sourceLabel]];
+      }
+      return [];
+    }
+    return [[key, publicProductData(raw, inferredCapability)]];
+  }));
+  const memo = cachedByCapability || /* @__PURE__ */ new Map();
+  memo.set(inferredCapability, result);
+  if (!cachedByCapability) PUBLIC_PRODUCT_DATA_MEMO.set(source, memo);
+  return result;
+}
 function findEmailRequestBody(params) {
   return compact({
     run_id: params.runId,
@@ -1572,7 +1841,7 @@ function findEmailRequestBody(params) {
     last_name: params.lastName,
     linkedin_url: params.linkedinUrl,
     company_name: params.companyName,
-    skip_cache: params.skipCache,
+    wait_for_result: params.waitForResult,
     dry_run: params.dryRun,
     idempotency_key: params.idempotencyKey
   });
@@ -1587,11 +1856,10 @@ function assertFindEmailRequestIdentity(request) {
 }
 function verifyEmailBatchRequestBody(input, options) {
   if (typeof input === "string") {
-    return compact({ email: input, skip_cache: options?.skipCache });
+    return compact({ email: input });
   }
   return compact({
     email: input.email,
-    skip_cache: input.skipCache ?? options?.skipCache,
     idempotency_key: input.idempotencyKey
   });
 }
@@ -1623,6 +1891,7 @@ function normalizeCoreProductDryRunResult(data) {
   };
 }
 function normalizeFindEmailResult(data) {
+  data = publicProductData(data, "find_email");
   const processing = String(data.status || "").toLowerCase() === "processing";
   const failed = coreProductResponseFailed(data);
   const rawEmail = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
@@ -1639,7 +1908,6 @@ function normalizeFindEmailResult(data) {
   const verificationAgeDays = typeof data.verification_age_days === "number" && Number.isFinite(data.verification_age_days) ? data.verification_age_days : null;
   const providerUsed = data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown";
   const verificationSource = data.verification_source ?? providerUsed;
-  const billingMetadata = data.billing_metadata && typeof data.billing_metadata === "object" && !Array.isArray(data.billing_metadata) ? data.billing_metadata : void 0;
   return {
     success: processing || !failed && found,
     found,
@@ -1662,20 +1930,10 @@ function normalizeFindEmailResult(data) {
     verificationSource,
     verificationObservedAt: typeof data.verification_observed_at === "string" ? data.verification_observed_at : void 0,
     failureReason: data.failure_reason ?? (failed || !found ? "no_verified_email_found" : "none"),
-    creditsUsed: data.credits_used ?? billingMetadata?.credits_used,
-    creditsCharged: data.credits_charged ?? billingMetadata?.credits_charged,
-    estimatedExternalCostUsd: data.estimated_external_cost_usd ?? billingMetadata?.estimated_external_cost_usd,
-    billingMetadata,
-    historicalBillingMetadata: data.historical_billing_metadata,
-    resultReturnedFrom: data.result_returned_from ?? billingMetadata?.result_returned_from,
-    cacheHit: typeof data.cache_hit === "boolean" ? data.cache_hit : billingMetadata?.cache_hit,
-    negativeCacheHit: data.negative_cache_hit,
-    negativeCacheTtlSeconds: data.negative_cache_ttl_seconds,
-    cacheTier: data.cache_tier,
-    freshEnrichmentUsed: typeof data.fresh_enrichment_used === "boolean" ? data.fresh_enrichment_used : billingMetadata?.fresh_enrichment_used,
-    liveProviderCalled: typeof data.live_provider_called === "boolean" ? data.live_provider_called : billingMetadata?.live_provider_called,
-    openrouterCalled: typeof data.openrouter_called === "boolean" ? data.openrouter_called : billingMetadata?.openrouter_called,
-    byoOpenrouterUsed: typeof data.byo_openrouter_used === "boolean" ? data.byo_openrouter_used : billingMetadata?.byo_openrouter_used,
+    creditsUsed: data.credits_used,
+    creditsCharged: data.credits_charged,
+    billingReplayed: data.billing_replayed,
+    idempotencyReplayed: data.idempotency_replayed,
     error: processing || found ? void 0 : coreProductErrorMessage(data) ?? "No verified email found",
     errorCode: processing || found ? void 0 : coreProductErrorCode(data) ?? "EMAIL_NOT_FOUND",
     status: processing ? "processing" : "completed",
@@ -1687,18 +1945,17 @@ function normalizeFindEmailResult(data) {
     doNotAutoResubmit: data.do_not_auto_resubmit === true,
     recoveryMode: data.recovery_mode === "same_run" ? "same_run" : void 0,
     recoveryStatus: ["pending", "completed"].includes(String(data.recovery_status)) ? data.recovery_status : void 0,
-    cachePublicationStatus: data.cache_publication_status,
-    cachePublicationRetryEligible: data.cache_publication_retry_eligible,
     raw: data
   };
 }
 function normalizeVerifyEmailResult(email, data) {
+  data = publicProductData(data, "verify_email");
   const failed = coreProductResponseFailed(data);
   const malformed = data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed";
-  const verificationStatus = String(
+  const verificationStatus = normalizeVerifyEmailStatus(
     failed ? malformed ? "malformed" : "error" : data.verification_status ?? data.verification_verdict ?? data.deliverability_status ?? "unknown"
-  ).toLowerCase();
-  const deliverabilityStatus = String(data.deliverability_status ?? verificationStatus).toLowerCase();
+  );
+  const deliverabilityStatus = normalizeVerifyEmailStatus(data.deliverability_status ?? verificationStatus);
   const verified = !failed && (data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus));
   const isCatchAll = data.email_is_catch_all ?? data.is_catch_all ?? data.catch_all ?? data.diagnostics?.is_catch_all ?? false;
   const verifiedForSending = !failed && data.verified_for_sending === true;
@@ -1719,10 +1976,12 @@ function normalizeVerifyEmailResult(email, data) {
     verifiedForSending,
     verificationStatus,
     deliverabilityStatus,
-    verificationVerdict: failed ? malformed ? "malformed" : "error" : data.verification_verdict ?? data.verification_status ?? "unknown",
+    verificationVerdict: normalizeVerifyEmailStatus(
+      failed ? malformed ? "malformed" : "error" : data.verification_verdict ?? verificationStatus
+    ),
     isRoleAccount: data.is_role_account === true || data.email_is_role_account === true || data.role === true,
     quality: typeof data.quality === "string" ? data.quality : null,
-    recommendation: typeof data.recommendation === "string" ? data.recommendation : verifiedForSending ? "send" : ["unknown", "verifier_error"].includes(verificationStatus) ? "manual_review" : "do_not_send",
+    recommendation: normalizeVerifyEmailRecommendation(data.recommendation, verificationStatus, verifiedForSending),
     smtpStatus: data.smtp_status ?? (isCatchAll ? "accept_all" : verifiedForSending ? "accepted" : "not_checked"),
     providerStatus: data.provider_status ?? verificationStatus,
     failureReason: data.failure_reason ?? (verifiedForSending ? "none" : isCatchAll ? "catch_all_domain_not_send_safe" : "verification_not_send_safe"),
@@ -1731,54 +1990,49 @@ function normalizeVerifyEmailResult(email, data) {
     verificationSource: data.verification_source,
     verificationObservedAt: typeof data.verification_observed_at === "string" ? data.verification_observed_at : void 0,
     billingReplayed: data.billing_replayed,
+    idempotencyReplayed: data.idempotency_replayed,
     creditsUsed: data.credits_used,
-    billingMetadata: data.billing_metadata,
-    historicalBillingMetadata: data.historical_billing_metadata,
-    resultReturnedFrom: data.result_returned_from,
-    cacheHit: data.cache_hit,
-    negativeCacheHit: data.negative_cache_hit,
-    negativeCacheTtlSeconds: data.negative_cache_ttl_seconds,
-    cacheTier: data.cache_tier,
-    freshEnrichmentUsed: data.fresh_enrichment_used,
-    liveProviderCalled: data.live_provider_called,
-    openrouterCalled: data.openrouter_called,
-    byoOpenrouterUsed: data.byo_openrouter_used,
-    estimatedExternalCostUsd: data.estimated_external_cost_usd,
     runId: data.run_id ?? verificationRunId,
-    cachePublicationStatus: data.cache_publication_status,
-    cachePublicationRetryEligible: data.cache_publication_retry_eligible,
     suggestedAction: data.suggested_action,
     raw: data
   };
 }
+function normalizeVerifyEmailStatus(value) {
+  const status = String(value ?? "").trim().toLowerCase();
+  if (status === "deliverable" || status === "accepted" || status === "verified") return "valid";
+  if (status === "undeliverable" || status === "rejected") return "invalid";
+  if ([
+    "valid",
+    "invalid",
+    "catch_all",
+    "role",
+    "disposable",
+    "unknown",
+    "verifier_error",
+    "malformed",
+    "error"
+  ].includes(status)) return status;
+  return "unknown";
+}
+function normalizeVerifyEmailRecommendation(value, verificationStatus, verifiedForSending) {
+  const recommendation = String(value ?? "").trim().toLowerCase();
+  if (recommendation === "send" || recommendation === "do_not_send" || recommendation === "manual_review") {
+    return recommendation;
+  }
+  if (verifiedForSending) return "send";
+  return verificationStatus === "unknown" || verificationStatus === "verifier_error" ? "manual_review" : "do_not_send";
+}
 function companySignalRequestBody(params) {
-  const online = params.online ?? true;
   return compact({
     signal_run_id: params.signalRunId,
-    company_domain: params.companyDomain,
-    company_name: params.companyName,
-    research_prompt: params.researchPrompt,
-    signal_types: params.signalTypes,
-    target_signal_count: params.targetSignalCount,
-    lookback_days: params.lookbackDays,
-    online,
-    enable_deep_search: params.enableDeepSearch ?? online,
-    search_mode: params.searchMode ?? "balanced",
-    include_summary: params.includeSummary,
-    enable_outreach_intelligence: params.enableOutreachIntelligence,
-    enable_predictive_intelligence: params.enablePredictiveIntelligence,
-    skip_cache: params.skipCache,
-    include_candidate_evidence: params.includeCandidateEvidence,
-    wait_for_result: true,
-    max_wait_ms: params.maxWaitMs,
+    domain: params.domain ?? params.companyDomain,
     dry_run: params.dryRun,
     idempotency_key: params.idempotencyKey
   });
 }
 function validateCompanySignalParams(params) {
-  validateCoreProductMaxWaitMs(params.maxWaitMs);
-  if (params.targetSignalCount !== void 0 && (!Number.isInteger(params.targetSignalCount) || params.targetSignalCount < 1 || params.targetSignalCount > 15)) {
-    throw new RangeError("targetSignalCount must be an integer between 1 and 15");
+  if (!params.signalRunId && !(params.domain ?? params.companyDomain)?.trim()) {
+    throw new TypeError("Company Signals requires domain");
   }
   if (params.lookbackDays !== void 0 && (!Number.isInteger(params.lookbackDays) || params.lookbackDays < 1 || params.lookbackDays > 365)) {
     throw new RangeError("lookbackDays must be an integer between 1 and 365");
@@ -1786,25 +2040,11 @@ function validateCompanySignalParams(params) {
 }
 function companySignalParamsFromRecoveredRow(row) {
   return {
-    companyDomain: row.company?.domain ?? row.company_domain,
-    companyName: row.company?.name ?? row.company_name,
+    domain: row.company?.domain ?? row.company_domain,
     signalRunId: row.signal_run_id ?? row.run_id
   };
 }
-var COMPANY_SIGNAL_LARGE_BATCH_CONTROL_FIELDS = [
-  "research_prompt",
-  "signal_types",
-  "target_signal_count",
-  "lookback_days",
-  "online",
-  "enable_deep_search",
-  "search_mode",
-  "include_summary",
-  "enable_outreach_intelligence",
-  "enable_predictive_intelligence",
-  "skip_cache",
-  "include_candidate_evidence"
-];
+var COMPANY_SIGNAL_LARGE_BATCH_CONTROL_FIELDS = [];
 function companySignalLargeBatchSubmission(requests) {
   if (requests.length <= 25) return null;
   if (requests.some(
@@ -1821,67 +2061,158 @@ function companySignalLargeBatchSubmission(requests) {
       COMPANY_SIGNAL_LARGE_BATCH_CONTROL_FIELDS.filter((field) => request[field] !== void 0).map((field) => [field, request[field]])
     );
     if (JSON.stringify(requestControls) !== controlKey) return null;
-    const hasIdentity = typeof request.company_domain === "string" && request.company_domain.trim() || typeof request.company_name === "string" && request.company_name.trim();
+    const hasIdentity = typeof request.domain === "string" && request.domain.trim();
     if (!hasIdentity) return null;
   }
   return {
-    requests: requests.map((request) => compact({
-      company_domain: request.company_domain,
-      company_name: request.company_name
-    })),
+    requests: requests.map((request) => compact({ domain: request.domain })),
     submissionFields
   };
 }
 function normalizeCompanySignalResult(params, data) {
+  data = publicProductData(data, "company_signals");
   const failed = coreProductResponseFailed(data);
   const rawSignals = failed ? [] : data.signals ?? data.signal_feed ?? [];
+  const fallbackCompany = {
+    name: data.company_name ?? data.company?.name ?? params.domain ?? params.companyDomain ?? null,
+    domain: data.company_domain ?? data.domain ?? data.company?.domain ?? params.domain ?? params.companyDomain ?? null
+  };
+  const signalRows = publicCompanySignalRows(rawSignals, fallbackCompany);
+  const company = {
+    name: fallbackCompany.name ?? signalRows[0]?.company_name ?? null,
+    domain: fallbackCompany.domain ?? signalRows[0]?.domain ?? null
+  };
+  const signals = signalRows.map(companySignalOutputRow);
   return {
     success: !failed,
     error: failed ? coreProductErrorMessage(data) : void 0,
     errorCode: failed ? coreProductErrorCode(data) : void 0,
     status: data.status,
     signalRunId: data.signal_run_id ?? data.run_id ?? params.signalRunId,
-    company: {
-      name: data.company?.name ?? params.companyName ?? null,
-      domain: data.company?.domain ?? params.companyDomain ?? null
-    },
-    signals: rawSignals.map((signal) => {
-      return {
-        id: signal.id,
-        title: signal.title ?? "",
-        type: signal.type ?? signal.signal_type ?? "unknown",
-        content: signal.content ?? signal.description ?? "",
-        date: signal.date ?? null,
-        detectedAt: signal.detected_at ?? null,
-        datePrecision: signal.date_precision,
-        sourceUrl: signal.source_url ?? signal.url ?? null,
-        sourceType: signal.source_type,
-        confidence: signal.confidence ?? signal.confidence_score ?? null,
-        signalFamily: signal.signal_family,
-        eventType: signal.signal_event_type,
-        eventLabel: signal.signal_event_label,
-        classification: signal.signal_classification ?? null
-      };
-    }),
-    signalCount: failed ? 0 : data.signal_count ?? data.total_signals ?? rawSignals.length,
-    signalSummary: failed ? null : data.signal_summary ?? null,
-    intelligence: failed ? null : data.intelligence ?? null,
-    copyFuel: failed ? null : data.copy_fuel ?? null,
-    evidenceValidation: failed ? void 0 : data.evidence_validation,
-    evidenceSources: failed ? [] : data.metadata?.evidence_sources ?? data.evidence_sources,
-    evidenceCount: failed ? 0 : data.evidence_count,
-    evidenceCountTotal: failed ? 0 : data.evidence_count_total,
-    evidenceSourcesOmitted: failed ? 0 : data.evidence_sources_omitted,
-    evidenceScope: failed ? void 0 : data.evidence_scope,
-    billingMetadata: data.billing_metadata,
-    resultReturnedFrom: data.result_returned_from,
-    cacheHit: data.cache_hit,
-    freshEnrichmentUsed: data.fresh_enrichment_used,
-    creditsUsed: data.credits_used,
-    liveProviderCalled: data.live_provider_called,
-    aiProviderCalled: data.ai_provider_called,
-    byoAiUsed: data.byo_ai_used,
-    raw: data
+    company,
+    signals,
+    signalCount: signals.length,
+    creditsUsed: data.credits_used
+  };
+}
+function companySignalOutputRow(row) {
+  return {
+    date: row.date,
+    signal_type: row.signal_type,
+    signal_title: row.signal_title,
+    signal_summary: row.signal_summary,
+    source: row.source
+  };
+}
+function validateSignalizFlowParams(params) {
+  const query = typeof params.signalQuery === "string" ? params.signalQuery.trim() : "";
+  const offer = typeof params.campaignOffer === "string" ? params.campaignOffer.trim() : "";
+  if (query.length < 2 || query.length > 2e3) throw new RangeError("signalQuery must contain between 2 and 2000 characters");
+  if (!offer || offer.length > 4e3) throw new RangeError("campaignOffer must contain between 1 and 4000 characters");
+  if (params.signalLimit !== void 0 && (!Number.isInteger(params.signalLimit) || params.signalLimit < 1 || params.signalLimit > 25)) {
+    throw new RangeError("signalLimit must be an integer between 1 and 25");
+  }
+  if (params.peoplePerCompany !== void 0 && (!Number.isInteger(params.peoplePerCompany) || params.peoplePerCompany < 1 || params.peoplePerCompany > 5)) {
+    throw new RangeError("peoplePerCompany must be an integer between 1 and 5");
+  }
+  if (params.lookbackDays !== void 0 && (!Number.isInteger(params.lookbackDays) || params.lookbackDays < 1 || params.lookbackDays > 365)) {
+    throw new RangeError("lookbackDays must be an integer between 1 and 365");
+  }
+  if (params.peopleTitles !== void 0 && (!Array.isArray(params.peopleTitles) || params.peopleTitles.length > 20 || params.peopleTitles.some((title) => typeof title !== "string" || !title.trim()))) {
+    throw new TypeError("peopleTitles must contain at most 20 non-empty titles");
+  }
+}
+function signalizFlowRequestBody(params) {
+  const requestedFlowId = typeof params.flowId === "string" ? params.flowId.trim() : "";
+  const requestedIdempotencyKey = typeof params.idempotencyKey === "string" ? params.idempotencyKey.trim() : "";
+  const flowId = requestedFlowId || requestedIdempotencyKey || `sdk-flow-${globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`}`;
+  const idempotencyKey = requestedIdempotencyKey || `signaliz-flow:${flowId}`;
+  return compact({
+    signal_query: params.signalQuery.trim(),
+    campaign_offer: params.campaignOffer.trim(),
+    signal_limit: params.signalLimit,
+    lookback_days: params.lookbackDays,
+    icp_context: params.icpContext?.trim(),
+    people_titles: params.peopleTitles?.map((title) => title.trim()),
+    people_per_company: params.peoplePerCompany,
+    copy_research_prompt: params.copyResearchPrompt?.trim(),
+    approval_required: params.approvalRequired,
+    flow_id: flowId,
+    idempotency_key: idempotencyKey,
+    dry_run: params.dryRun
+  });
+}
+function normalizeSignalizFlowPlan(data) {
+  const plan = data.plan && typeof data.plan === "object" ? data.plan : {};
+  const billing = plan.billing && typeof plan.billing === "object" ? plan.billing : {};
+  return {
+    plannedCompanyCount: Number(plan.planned_company_count ?? 0),
+    plannedPeoplePerCompany: Number(plan.planned_people_per_company ?? 0),
+    maximumReviewCandidates: Number(plan.maximum_review_candidates ?? 0),
+    safeguards: Array.isArray(plan.safeguards) ? plan.safeguards.filter((value) => typeof value === "string") : [],
+    billing: { additionalFlowFeeCredits: Number(billing.additional_flow_fee_credits ?? 0), chargeBasis: String(billing.charge_basis ?? "") }
+  };
+}
+function normalizeSignalizFlowPlanResult(data) {
+  if (data.success !== true) throw new Error(String(data.error || "Signaliz Flow plan is unavailable."));
+  return { success: true, dryRun: true, status: "PLANNED", flowId: String(data.flow_id ?? ""), plan: normalizeSignalizFlowPlan(data), creditsCharged: 0 };
+}
+function normalizeSignalizFlowStartResult(data) {
+  if (data.success !== true || typeof data.run_id !== "string" || !data.run_id.trim()) {
+    throw new Error(String(data.error || "Signaliz Flow could not be started."));
+  }
+  return { success: true, flowId: String(data.flow_id ?? ""), runId: data.run_id, status: "TRIGGERED", statusEndpoint: "api/v1/flow", message: String(data.message ?? "") };
+}
+var FLOW_SIGNAL_LIST_KEYS = /* @__PURE__ */ new Set(["signals", "signal_feed", "company_signals", "signal_results"]);
+var FLOW_SINGLE_SIGNAL_KEYS = /* @__PURE__ */ new Set(["signal", "source_signal"]);
+function publicSignalizFlowResult(value) {
+  if (Array.isArray(value)) return value.map(publicSignalizFlowResult);
+  if (!value || typeof value !== "object") return value;
+  const source = value;
+  return Object.fromEntries(Object.entries(source).flatMap(([key, raw]) => {
+    const normalizedKey = key.toLowerCase();
+    if (normalizedKey === "raw" || normalizedKey === "raw_data") return [];
+    if (FLOW_SIGNAL_LIST_KEYS.has(normalizedKey)) {
+      return [[key, oneSignalPerCompany(publicSignalRows(raw))]];
+    }
+    if (FLOW_SINGLE_SIGNAL_KEYS.has(normalizedKey)) {
+      const row = publicSignalRow(raw);
+      return row ? [[key, row]] : [];
+    }
+    return [[key, publicSignalizFlowResult(raw)]];
+  }));
+}
+function normalizeSignalizFlowBilling(value) {
+  if (!value || typeof value !== "object") return void 0;
+  const billing = value;
+  return {
+    creditsCharged: Number(billing.credits_charged ?? 0),
+    billingStatus: billing.billing_status === "charged" ? "charged" : "included_or_waived",
+    chargeBasis: String(billing.charge_basis ?? ""),
+    receipt: Array.isArray(billing.receipt) ? billing.receipt.map((line) => ({
+      capability: line.capability,
+      successfulResults: Number(line.successful_results ?? 0),
+      creditsCharged: Number(line.credits_charged ?? 0)
+    })).filter((line) => ["company_signals", "find_email", "signal_to_copy"].includes(line.capability)) : []
+  };
+}
+function normalizeSignalizFlowStatus(data) {
+  if (data.success !== true || typeof data.run_id !== "string" || !data.run_id.trim()) {
+    throw new Error(String(data.error || "Signaliz Flow status is unavailable."));
+  }
+  const publicData = publicProductData(data, "signaliz_flow");
+  const result = publicData.result && typeof publicData.result === "object" ? publicSignalizFlowResult(publicData.result) : {};
+  const billing = normalizeSignalizFlowBilling(result.billing);
+  if (billing) result.billing = billing;
+  const status = String(publicData.status || "").toLowerCase();
+  return {
+    success: true,
+    runId: String(publicData.run_id),
+    status: status === "completed" || status === "failed" ? status : "running",
+    result,
+    createdAt: typeof publicData.created_at === "string" ? publicData.created_at : void 0,
+    updatedAt: typeof publicData.updated_at === "string" ? publicData.updated_at : void 0,
+    completedAt: typeof publicData.completed_at === "string" ? publicData.completed_at : void 0
   };
 }
 var SIGNAL_DISCOVERY_SOURCES = /* @__PURE__ */ new Set(["web", "news"]);
@@ -1914,10 +2245,32 @@ function validateSignalDiscoveryParams(params) {
   if (params.lookbackDays !== void 0 && (!Number.isInteger(params.lookbackDays) || params.lookbackDays < 1 || params.lookbackDays > 365)) {
     throw new RangeError("lookbackDays must be an integer between 1 and 365");
   }
+  validateSignalDateWindow(params);
   if (params.sources !== void 0 && (!Array.isArray(params.sources) || params.sources.length < 1 || params.sources.length > 2 || params.sources.some((source) => !SIGNAL_DISCOVERY_SOURCES.has(source)))) {
     throw new TypeError("sources must contain only web or news");
   }
 }
+function validateSignalDateWindow(params) {
+  const afterDate = params.afterDate?.trim();
+  const beforeDate = params.beforeDate?.trim();
+  if ((afterDate || beforeDate) && params.lookbackDays !== void 0) {
+    throw new RangeError("afterDate/beforeDate cannot be combined with lookbackDays");
+  }
+  const parseDate = (value, field) => {
+    if (value === void 0) return void 0;
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) throw new RangeError(`${field} 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 RangeError(`${field} must be a valid calendar date`);
+    }
+    return timestamp;
+  };
+  const afterTimestamp = parseDate(afterDate, "afterDate");
+  const beforeTimestamp = parseDate(beforeDate, "beforeDate");
+  if (afterTimestamp !== void 0 && beforeTimestamp !== void 0 && beforeTimestamp < afterTimestamp) {
+    throw new RangeError("beforeDate must be on or after afterDate");
+  }
+}
 function signalDiscoveryRequestBody(params) {
   const runId = typeof params.signalSearchRunId === "string" ? params.signalSearchRunId.trim() : "";
   if (runId) {
@@ -1926,6 +2279,8 @@ function signalDiscoveryRequestBody(params) {
       // An explicit limit expands or narrows the retained qualified cohort;
       // omitting it preserves the original preview size.
       limit: params.limit,
+      after_date: params.afterDate?.trim(),
+      before_date: params.beforeDate?.trim(),
       dry_run: params.dryRun,
       idempotency_key: params.idempotencyKey
     });
@@ -1936,6 +2291,8 @@ function signalDiscoveryRequestBody(params) {
     limit: params.limit ?? 100,
     sources: params.sources,
     lookback_days: params.lookbackDays,
+    after_date: params.afterDate?.trim(),
+    before_date: params.beforeDate?.trim(),
     dry_run: params.dryRun,
     idempotency_key: params.idempotencyKey
   });
@@ -1944,106 +2301,25 @@ function normalizeSignalDiscoveryResult(params, data) {
   const rawSignals = Array.isArray(data.signals) ? data.signals : [];
   const rawStatus = String(data.status || "").toLowerCase();
   const status = SIGNAL_DISCOVERY_STATUSES.has(rawStatus) ? rawStatus : rawSignals.length > 0 ? "completed" : "failed";
-  const signals = rawSignals.map(normalizeSignalDiscoverySignal);
+  const requestedCount = Number(data.requested_count ?? params.limit);
+  const signals = oneSignalPerCompany(publicSignalRows(rawSignals)).slice(
+    0,
+    Number.isFinite(requestedCount) && requestedCount > 0 ? requestedCount : void 0
+  );
   return {
     success: data.success !== false,
     status,
     capability: "signals_everything",
     signalSearchRunId: String(data.signal_search_run_id ?? params.signalSearchRunId ?? ""),
     query: String(data.query ?? params.query ?? ""),
-    requestedCount: Number(data.requested_count ?? params.limit ?? 100),
+    ...Number.isFinite(requestedCount) && requestedCount > 0 ? { requestedCount } : {},
     nextPollAfterSeconds: typeof data.next_poll_after_seconds === "number" ? data.next_poll_after_seconds : void 0,
     signals,
     signalCount: signals.length,
-    availableCompanySignalCount: Number.isFinite(Number(data.available_company_signal_count)) ? Number(data.available_company_signal_count) : void 0,
-    sourceLanes: Array.isArray(data.source_lanes) ? data.source_lanes.filter((lane) => typeof lane === "string") : void 0,
-    evidenceValidation: data.evidence_validation && typeof data.evidence_validation === "object" ? data.evidence_validation : void 0,
-    discoveryDiagnostics: data.discovery_diagnostics && typeof data.discovery_diagnostics === "object" ? data.discovery_diagnostics : void 0,
-    identityResolution: data.identity_resolution && typeof data.identity_resolution === "object" ? data.identity_resolution : void 0,
-    costGuardrail: normalizeSignalDiscoveryCostGuardrail(data.cost_guardrail),
-    warnings: Array.isArray(data.warnings) ? data.warnings.filter((warning) => typeof warning === "string") : void 0,
-    raw: data
-  };
-}
-function normalizeSignalDiscoveryCostGuardrail(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
-  const guardrail = value;
-  const maxCost = Number(guardrail.max_cost_per_qualified_signal_usd);
-  const withinLimit = guardrail.within_limit === true;
-  if (!Number.isFinite(maxCost)) return void 0;
-  const numberOrNullable = (candidate) => {
-    if (candidate === null) return null;
-    const numeric = Number(candidate);
-    return Number.isFinite(numeric) ? numeric : void 0;
-  };
-  const numberOrUndefined = (candidate) => {
-    const numeric = Number(candidate);
-    return Number.isFinite(numeric) ? numeric : void 0;
-  };
-  return {
-    maxCostPerQualifiedSignalUsd: maxCost,
-    projectedSourceCostUsd: numberOrNullable(guardrail.projected_source_cost_usd),
-    maxSourceCostUsd: numberOrNullable(guardrail.max_source_cost_usd),
-    projectedCostPerRequestedCompanySignalUsd: numberOrNullable(
-      guardrail.projected_cost_per_requested_company_signal_usd
-    ),
-    sourceCostUsd: numberOrNullable(guardrail.source_cost_usd),
-    costSource: ["observed", "catalog_preflight", "catalog_bounded", "mixed", "unavailable"].includes(String(guardrail.cost_source)) ? String(guardrail.cost_source) : void 0,
-    identityResolutionCostUsd: numberOrNullable(guardrail.identity_resolution_cost_usd),
-    identityCostSource: [
-      "observed_zero_credit_receipts",
-      "contractual_zero_cost",
-      "not_used",
-      "unavailable"
-    ].includes(String(guardrail.identity_cost_source)) ? String(guardrail.identity_cost_source) : void 0,
-    identityProviderRequests: numberOrUndefined(guardrail.identity_provider_requests),
-    qualifiedCompanySignalCount: numberOrUndefined(guardrail.qualified_company_signal_count),
-    returnedCompanySignalCount: numberOrUndefined(guardrail.returned_company_signal_count),
-    availableCompanySignalCount: numberOrUndefined(guardrail.available_company_signal_count),
-    acquisitionCandidateLimit: numberOrUndefined(guardrail.acquisition_candidate_limit),
-    minimumQualifiedCompanySignals: numberOrUndefined(guardrail.minimum_qualified_company_signals),
-    costPerQualifiedSignalUsd: numberOrNullable(guardrail.cost_per_qualified_signal_usd),
-    withinLimit
-  };
-}
-function normalizeSignalDiscoverySignal(value) {
-  const signal = value && typeof value === "object" && !Array.isArray(value) ? value : {};
-  const company = signal.company && typeof signal.company === "object" && !Array.isArray(signal.company) ? signal.company : {};
-  const companyName = String(company.name ?? signal.company_name ?? "").trim();
-  const companyDomain = String(company.domain ?? signal.company_domain ?? "").trim();
-  if (!companyName || !companyDomain) {
-    throw new Error("Signals Everything response violated the company attribution contract.");
-  }
-  const eventDate = String(signal.event_date ?? signal.date ?? signal.signal_date ?? "").trim();
-  const sourceUrl = String(signal.source_url ?? signal.url ?? "").trim();
-  const evidence = Array.isArray(signal.evidence) ? signal.evidence.map((item) => ({
-    url: String(item?.url ?? "").trim(),
-    publishedAt: String(item?.published_at ?? item?.publishedAt ?? "").trim(),
-    source: String(item?.source ?? "").trim()
-  })).filter((item) => Boolean(item.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 {
-    id: signal.id,
-    company: {
-      name: companyName,
-      domain: companyDomain,
-      linkedinUrl: company.linkedin_url ?? signal.company_linkedin_url ?? void 0
-    },
-    title: signal.title ?? "",
-    type: signal.type ?? signal.signal_type ?? "unknown",
-    summary: signal.summary ?? signal.content ?? signal.description ?? "",
-    eventDate,
-    evidence,
-    content: signal.summary ?? signal.content ?? signal.description ?? "",
-    date: signal.event_date ?? signal.date ?? signal.signal_date ?? null,
-    detectedAt: signal.event_date ?? signal.detected_at ?? null,
-    sourceUrl,
-    sourceType: signal.source_type ?? null,
-    confidence: signal.confidence ?? signal.confidence_score ?? null,
-    classification: signal.signal_classification ?? signal.classification ?? null,
-    raw: signal
+    creditsUsed: Number.isFinite(Number(data.credits_used)) ? Number(data.credits_used) : 0,
+    creditsCharged: Number.isFinite(Number(data.credits_charged)) ? Number(data.credits_charged) : 0,
+    billingStatus: data.billing_status === "included" ? "included" : void 0,
+    idempotencyReplayed: typeof data.idempotency_replayed === "boolean" ? data.idempotency_replayed : void 0
   };
 }
 function validateBatchSize(items) {
@@ -2097,9 +2373,6 @@ function normalizedBatchDomain(value) {
 function normalizedBatchLinkedIn(value) {
   return normalizedBatchText(value).replace(/\/+$/, "");
 }
-function normalizedBatchList(value) {
-  return Array.isArray(value) ? value.map(normalizedBatchText).filter(Boolean).sort() : [];
-}
 function normalizedFindEmailBatchName(request) {
   const fullName = normalizedBatchText(request.full_name);
   const componentName = [normalizedBatchText(request.first_name), normalizedBatchText(request.last_name)].filter(Boolean).join(" ");
@@ -2114,39 +2387,24 @@ function coreProductBatchRequestKey(path, request) {
       normalizedBatchDomain(request.company_domain),
       normalizedBatchLinkedIn(request.linkedin_url),
       normalizedBatchText(request.company_name),
-      request.skip_cache === true || request.bypass_cache === true,
       normalizedBatchIdempotencyKey(request.idempotency_key)
     ]);
   }
   if (path === "api/v1/verify-email") {
     return JSON.stringify([
       normalizedBatchText(request.email),
-      request.skip_cache === true || request.bypass_cache === true,
       request.skip_catch_all_verification === true,
       request.skip_esp_check === true,
       normalizedBatchIdempotencyKey(request.idempotency_key)
     ]);
   }
   if (path === "api/v1/company-signals") {
-    const online = request.online !== false;
-    const deepSearch = request.enable_deep_search === void 0 ? online : request.enable_deep_search !== false;
     return JSON.stringify([
       normalizedBatchText(request.signal_run_id),
       normalizedBatchDomain(request.company_domain || request.domain),
       normalizedBatchText(request.company_name),
-      normalizedBatchText(request.company_id),
-      normalizedBatchLinkedIn(request.linkedin_url),
-      normalizedBatchText(request.industry),
       typeof request.research_prompt === "string" ? request.research_prompt.trim() : "",
-      normalizedBatchList(request.signal_types),
-      Number(request.target_signal_count) || null,
       Number(request.lookback_days) || null,
-      online,
-      deepSearch,
-      normalizedBatchText(request.search_mode || "balanced"),
-      request.enable_outreach_intelligence === true,
-      request.enable_predictive_intelligence === true,
-      request.skip_cache === true || request.bypass_cache === true,
       normalizedBatchIdempotencyKey(request.idempotency_key)
     ]);
   }
@@ -2156,9 +2414,12 @@ function coreProductBatchRequestKey(path, request) {
     typeof request.title === "string" ? request.title.trim() : "",
     typeof request.campaign_offer === "string" ? request.campaign_offer.trim() : "",
     typeof request.research_prompt === "string" ? request.research_prompt.trim() : "",
+    normalizedBatchText(request.copy_evidence_mode),
     Number(request.lookback_days) || null,
     typeof request.signal_run_id === "string" ? request.signal_run_id.trim() : "",
-    request.skip_cache === true,
+    typeof request.signal_search_run_id === "string" ? request.signal_search_run_id.trim() : "",
+    typeof request.fact_id === "string" ? request.fact_id.trim() : "",
+    typeof request.event_id === "string" ? request.event_id.trim() : "",
     request.enable_deep_search === true,
     normalizedBatchIdempotencyKey(request.idempotency_key)
   ]);
@@ -2263,43 +2524,60 @@ function signalToCopyRequestBody(params) {
     person_name: params.personName,
     title: params.title,
     campaign_offer: params.campaignOffer,
-    research_prompt: params.researchPrompt,
-    lookback_days: params.lookbackDays,
+    copy_evidence_mode: params.copyEvidenceMode,
+    lookback_days: 365,
     signal_run_id: params.signalRunId,
-    skip_cache: params.skipCache,
+    signal_search_run_id: params.signalSearchRunId,
+    fact_id: params.factId,
+    event_id: params.eventId,
     enable_deep_search: params.enableDeepSearch,
     max_wait_ms: params.maxWaitMs,
     dry_run: params.dryRun,
     idempotency_key: params.idempotencyKey
   });
 }
-function validateLargeAvailableDataSignalCopyBatch(requests) {
+function validateLargeSignalCopyBatch(requests) {
   if (requests.length <= 25) return;
   const invalidIndex = requests.findIndex(
-    (request) => request.skipCache === true || request.enableDeepSearch === true || Boolean(request.idempotencyKey?.trim()) || request.maxWaitMs !== void 0 || request.pollIntervalMs !== void 0 || request.waitForResult === false || !request.companyDomain?.trim() || !request.personName?.trim() || !request.title?.trim() || !request.campaignOffer?.trim()
+    (request) => Boolean(request.idempotencyKey?.trim()) || request.maxWaitMs !== void 0 || request.pollIntervalMs !== void 0 || request.waitForResult === false || Boolean(request.signalSearchRunId?.trim()) || Boolean(request.factId?.trim()) || Boolean(request.eventId?.trim()) || !request.companyDomain?.trim() || !request.personName?.trim() || !request.title?.trim() || !request.campaignOffer?.trim()
   );
   if (invalidIndex >= 0) {
     throw new RangeError(
-      `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 synchronous batches of 25 or fewer), uses unsupported row-level execution controls, or lacks required recipient fields. Put wait and idempotency controls in the batch options.`
     );
   }
 }
-function availableDataSignalCopyRequestBody(params) {
+function durableSignalCopyRequestBody(params) {
   return compact({
     company_domain: params.companyDomain,
     person_name: params.personName,
     title: params.title,
     campaign_offer: params.campaignOffer,
-    research_prompt: params.researchPrompt,
-    lookback_days: params.lookbackDays,
-    signal_run_id: params.signalRunId
+    copy_evidence_mode: params.copyEvidenceMode,
+    lookback_days: 365,
+    signal_run_id: params.signalRunId,
+    signal_search_run_id: params.signalSearchRunId,
+    fact_id: params.factId,
+    event_id: params.eventId,
+    enable_deep_search: params.enableDeepSearch
   });
 }
 function validateSignalToCopyParams(params) {
   validateCoreProductMaxWaitMs(params.maxWaitMs);
+  if (params.copyEvidenceMode !== void 0 && !["signal_led", "firmographic"].includes(params.copyEvidenceMode)) {
+    throw new RangeError("copyEvidenceMode must be signal_led or firmographic");
+  }
   if (params.lookbackDays !== void 0 && (!Number.isInteger(params.lookbackDays) || params.lookbackDays < 1 || params.lookbackDays > 365)) {
     throw new RangeError("lookbackDays must be an integer between 1 and 365");
   }
+  if (params.signalSearchRunId !== void 0 && !params.signalSearchRunId.trim()) {
+    throw new TypeError("signalSearchRunId must be a non-empty string");
+  }
+  for (const [field, value] of [["factId", params.factId], ["eventId", params.eventId]]) {
+    if (value !== void 0 && !/^[0-9a-f]{64}$/.test(value.trim())) {
+      throw new TypeError(`${field} must be a lowercase 64-character SHA-256 identifier`);
+    }
+  }
   if (typeof params.signalRunId === "string" && params.signalRunId.trim()) return;
   const missing = [
     ["companyDomain", params.companyDomain],
@@ -2318,6 +2596,7 @@ function validateCoreProductMaxWaitMs(value) {
   }
 }
 function normalizeSignalToCopyResult(data) {
+  data = publicProductData(data, "signal_to_copy");
   const failed = coreProductResponseFailed(data);
   return {
     success: !failed,
@@ -2326,6 +2605,11 @@ function normalizeSignalToCopyResult(data) {
     status: data.status,
     runId: data.run_id ?? data.signal_run_id,
     companySignalRunId: data.company_signal_run_id,
+    signalSearchRunId: data.signal_search_run_id,
+    factId: data.fact_id,
+    eventId: data.event_id,
+    canonicalSourceUrl: data.canonical_source_url,
+    evidenceReuse: data.evidence_reuse,
     resumeContextPersisted: data.resume_context_persisted,
     strongestSignal: failed ? "" : data.strongest_signal ?? "",
     whyNow: failed ? "" : data.why_now ?? "",
@@ -2334,17 +2618,11 @@ function normalizeSignalToCopyResult(data) {
     confidence: failed ? 0 : data.confidence ?? 0,
     evidenceUrl: failed ? "" : data.evidence_url ?? "",
     researchPrompt: data.research_prompt,
+    copyEvidenceMode: data.copy_evidence_mode,
     empty: data.empty,
     emptyReason: data.empty_reason,
     researchMetadata: failed ? void 0 : data.research_metadata,
-    billingMetadata: data.billing_metadata,
-    resultReturnedFrom: data.result_returned_from,
-    cacheHit: data.cache_hit,
-    freshEnrichmentUsed: data.fresh_enrichment_used,
     creditsUsed: data.credits_used,
-    liveProviderCalled: data.live_provider_called,
-    aiProviderCalled: data.ai_provider_called,
-    byoAiUsed: data.byo_ai_used,
     unlimitedSignalToCopy: data.unlimited_signal_to_copy,
     signalToCopyEntitlement: data.signal_to_copy_entitlement,
     variations: (failed ? [] : data.variations ?? []).map((variation) => ({
@@ -2358,6 +2636,117 @@ function normalizeSignalToCopyResult(data) {
     raw: data
   };
 }
+function signalAwarenessMonitorRequest(monitor) {
+  return compact({
+    company_name: monitor.companyName,
+    domain: monitor.domain,
+    template: monitor.template,
+    signal_config: monitor.signalConfig,
+    schedule_cron: monitor.scheduleCron,
+    webhook_url: monitor.webhookUrl
+  });
+}
+function signalAwarenessRequestBody(request) {
+  return compact({
+    action: request.action,
+    monitor_id: request.monitorId,
+    monitor: request.monitor ? signalAwarenessMonitorRequest(request.monitor) : void 0,
+    monitors: request.monitors?.map(signalAwarenessMonitorRequest),
+    defaults: request.defaults,
+    updates: request.updates,
+    limit: request.limit,
+    offset: request.offset,
+    idempotency_key: request.idempotencyKey,
+    dry_run: request.dryRun
+  });
+}
+function normalizeSignalAwarenessResponse(data) {
+  const payload = data.data && typeof data.data === "object" ? data.data : data;
+  const signals = Array.isArray(payload.signals) ? oneSignalPerCompany(payload.signals.flatMap(normalizeSignalAwarenessSignal)) : void 0;
+  const monitors = Array.isArray(payload.monitors) ? payload.monitors.map(normalizeSignalAwarenessMonitor).filter((value) => value !== void 0) : void 0;
+  const monitor = normalizeSignalAwarenessMonitor(payload.monitor);
+  const run = normalizeSignalAwarenessRun(payload.run);
+  const billing = payload.billing && typeof payload.billing === "object" ? payload.billing : {};
+  const creditsUsed = Number(payload.credits_used ?? billing.credits_used);
+  return {
+    success: data.success !== false,
+    ...monitors ? { monitors } : {},
+    ...monitor ? { monitor } : {},
+    ...signals ? { signals } : {},
+    ...signals ? { signalCount: signals.length } : {},
+    ...typeof payload.monitor_id === "string" ? { monitorId: payload.monitor_id } : {},
+    ...typeof payload.run_id === "string" ? { runId: payload.run_id } : {},
+    ...run ? { run } : {},
+    ...Number.isInteger(creditsUsed) && creditsUsed >= 0 ? { creditsUsed } : {},
+    ...Number.isFinite(Number(payload.created)) ? { created: Number(payload.created) } : {},
+    ...Number.isFinite(Number(payload.skipped)) ? { skipped: Number(payload.skipped) } : {},
+    ...Number.isFinite(Number(payload.total)) ? { total: Number(payload.total) } : {},
+    ...Number.isFinite(Number(payload.limit)) ? { limit: Number(payload.limit) } : {},
+    ...Number.isFinite(Number(payload.offset)) ? { offset: Number(payload.offset) } : {},
+    ...typeof payload.has_more === "boolean" ? { hasMore: payload.has_more } : {},
+    ...payload.idempotent_replay === true ? { idempotentReplay: true } : {}
+  };
+}
+function signalAwarenessRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function signalAwarenessText(value, maximum = 500) {
+  return typeof value === "string" && value.trim() && value.trim().length <= maximum ? value.trim() : void 0;
+}
+function signalAwarenessCount(value) {
+  const numeric = Number(value);
+  return Number.isInteger(numeric) && numeric >= 0 ? numeric : void 0;
+}
+function normalizeSignalAwarenessMonitor(value) {
+  const monitor = signalAwarenessRecord(value);
+  const result = {};
+  const id = signalAwarenessText(monitor.id, 200);
+  const companyName = signalAwarenessText(monitor.company_name, 300);
+  const domain = signalAwarenessText(monitor.domain, 253);
+  const status = signalAwarenessText(monitor.status, 80);
+  const schedule = signalAwarenessText(monitor.schedule, 120);
+  if (id) result.id = id;
+  if (companyName) result.company_name = companyName;
+  if (domain) result.domain = domain;
+  if (status) result.status = status;
+  if (schedule) result.schedule = schedule;
+  for (const key of ["last_run_at", "next_run_at", "created_at", "updated_at"]) {
+    const timestamp = signalAwarenessText(monitor[key], 64);
+    if (timestamp && Number.isFinite(Date.parse(timestamp))) result[key] = timestamp;
+  }
+  return Object.keys(result).length > 0 ? result : void 0;
+}
+function normalizeSignalAwarenessRun(value) {
+  const run = signalAwarenessRecord(value);
+  const result = {};
+  const id = signalAwarenessText(run.id, 200);
+  const monitorId = signalAwarenessText(run.monitor_id, 200);
+  const status = signalAwarenessText(run.status, 80);
+  const signalsFound = signalAwarenessCount(run.signals_found);
+  if (id) result.id = id;
+  if (monitorId) result.monitor_id = monitorId;
+  if (status) result.status = status;
+  if (signalsFound !== void 0) result.signals_found = signalsFound;
+  for (const key of ["started_at", "completed_at", "created_at"]) {
+    const timestamp = signalAwarenessText(run[key], 64);
+    if (timestamp && Number.isFinite(Date.parse(timestamp))) result[key] = timestamp;
+  }
+  return Object.keys(result).length > 0 ? result : void 0;
+}
+function normalizeSignalAwarenessSignal(value) {
+  const signal = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  const rawData = signal.raw_data && typeof signal.raw_data === "object" && !Array.isArray(signal.raw_data) ? signal.raw_data : {};
+  const row = publicSignalRow({
+    ...rawData,
+    ...signal,
+    signal_type: signal.signal_type ?? rawData.signal_type,
+    source_url: signal.canonical_source_url ?? rawData.canonical_source_url ?? signal.source_url ?? rawData.source_url ?? rawData.url,
+    date: signal.date ?? signal.event_date ?? signal.detected_at ?? rawData.date ?? rawData.event_date ?? rawData.detected_at ?? rawData.observed_at,
+    company_name: signal.company_name ?? rawData.company_name,
+    company_domain: signal.domain ?? signal.company_domain ?? rawData.company_domain ?? rawData.domain
+  });
+  return row ? [row] : [];
+}
 function isPendingSignalResponse(data) {
   if (coreProductResponseFailed(data)) return false;
   return ["triggered", "queued", "processing", "pending", "pending_version", "waiting_for_deploy"].includes(String(data.status || "").toLowerCase());