@signaliz/cli 1.0.66 → 1.0.68

package/README.md

@@ -45,7 +45,7 @@ signaliz signal-to-copy --company-domain example.com --person-name "Jane Doe" \
 
 # Omit --deep-search for bounded credit-free first-party and Bing grounding.
 
-# Signals Everything returns distinct companies with a source-backed signal.
+# Signals First returns distinct companies with a source-backed signal.
 # It is asynchronous by default; add --wait or resume the returned run ID.
 signaliz signals "companies that just got funded" --limit 100 --sources web,news
 signaliz signals "companies showing signals they need account-signal automation" \
@@ -53,10 +53,14 @@ signaliz signals "companies showing signals they need account-signal automation"
   --limit 100 --sources web,news
 signaliz signals --signal-search-run-id run_... --wait --json
 
-# Monitor companies and retrieve seven-field verified signal rows
-# reason and replacement pointers forward.
+# Monitor companies with the fixed Company Signal evidence engine.
+signaliz awareness create --company-name "Acme" --domain acme.com --schedule daily
+signaliz awareness schedule --monitor-id <uuid> --schedule monthly
+signaliz awareness import --input companies.json --schedule weekly
 signaliz awareness list --limit 100 --offset 0 --json
 signaliz awareness signals --monitor-id <uuid> --limit 100 --offset 0 --json
+signaliz awareness set-output --mode webhook --webhook-url https://hooks.example.com/signaliz
+signaliz awareness export --monitor-id <uuid> --json
 
 # Flow starts and resumes through the versioned REST contract.
 signaliz flow --signal-query "companies with recent hiring" \
@@ -157,7 +161,7 @@ Company Signals. Signal to Copy costs 1 credit per successful result on Free and
 Builder, and is unlimited on Team and Agency. `--lookback-days` remains a hard
 evidence-age bound.
 
-Signals Everything is a query-first company discovery command rather than a
+Signals First is a query-first company discovery command rather than a
 row batch. It returns only dated, source-linked signals that contain both a
 company name and company domain. The default request is 100 companies and the
 maximum is 1,000. It is included on Builder, Team, and Agency plans, is resumable with

package/dist/bin.js

@@ -39,11 +39,19 @@ Six product commands:
   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 create --company-name "Acme" --domain acme.com [--schedule daily|weekly|monthly | --schedule-cron "0 8 * * *"]
+  signaliz awareness import --input companies.json [--schedule daily]
   signaliz awareness list [--limit 100] [--offset 0]
+  signaliz awareness update --monitor-id <uuid> [--company-name "Acme"] [--schedule weekly] [--webhook-url https://...]
+  signaliz awareness schedule --monitor-id <uuid> --schedule monthly
   signaliz awareness run --monitor-id <uuid> --idempotency-key <key>
   signaliz awareness signals [--monitor-id <uuid>]
   signaliz awareness pause|resume|delete --monitor-id <uuid>
+  signaliz awareness settings
+  signaliz awareness set-output --mode csv|webhook [--webhook-url https://...]
+  signaliz awareness test-webhook --webhook-url https://...
+  signaliz awareness export [--monitor-id <uuid>] --json
+  signaliz awareness send-export --input signals.jsonl
   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
 
@@ -76,7 +84,7 @@ Common flags:
   --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 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.
+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 First is asynchronous by default; use --wait to poll until it completes.
 `;
 function loadConfig() {
   if (!(0, import_node_fs.existsSync)(CONFIG_FILE)) return {};
@@ -427,6 +435,15 @@ function customerEmailBillingMetadata(value) {
 function customerEmailResult(value, kind) {
   const result = record(value);
   const raw = record(result.raw);
+  if (kind === "verify") {
+    return {
+      email: typeof result.email === "string" ? result.email : typeof raw.email === "string" ? raw.email : null,
+      status: result.status || raw.status || "completed",
+      is_catch_all: result.isCatchAll === true || raw.is_catch_all === true || raw.email_is_catch_all === true,
+      credits_charged: safeNonNegativeNumber(result.creditsCharged ?? raw.credits_charged) ?? 0,
+      ok_to_send: result.okToSend === true || raw.ok_to_send === true
+    };
+  }
   if (String(result.status || "").toLowerCase() === "processing") {
     const verificationRunId2 = result.verificationRunId ?? raw.verification_run_id;
     const runId2 = result.runId ?? raw.run_id ?? verificationRunId2;
@@ -459,6 +476,7 @@ function customerEmailResult(value, kind) {
   const creditsCharged = Number(result.creditsCharged ?? raw.credits_charged ?? creditsUsed);
   const base = {
     email: typeof result.email === "string" && result.email.trim() ? result.email.trim() : null,
+    ...typeof result.checkedEmail === "string" || typeof raw.checked_email === "string" ? { checked_email: result.checkedEmail ?? raw.checked_email } : {},
     status: "completed",
     success: result.success === true,
     is_valid: typeof result.isValid === "boolean" ? result.isValid : typeof raw.is_valid === "boolean" ? raw.is_valid : result.isVerified ?? false,
@@ -519,6 +537,15 @@ function customerEmailResult(value, kind) {
       email_is_catch_all: isCatchAll2,
       is_catch_all: isCatchAll2,
       verification_source: result.verificationSource ?? raw.verification_source ?? result.providerUsed ?? "email_finder",
+      ...typeof raw.candidate_source === "string" ? { candidate_source: raw.candidate_source } : {},
+      ...typeof raw.primary_verifier === "string" ? { primary_verifier: raw.primary_verifier } : {},
+      ...typeof raw.primary_verdict === "string" ? { primary_verdict: raw.primary_verdict } : {},
+      ...typeof raw.terminal_verifier === "string" ? { terminal_verifier: raw.terminal_verifier } : {},
+      ...typeof raw.terminal_verdict === "string" ? { terminal_verdict: raw.terminal_verdict } : {},
+      ...typeof raw.terminal_result === "string" ? { terminal_result: raw.terminal_result } : {},
+      ...typeof raw.terminal_is_catch_all === "boolean" ? { terminal_is_catch_all: raw.terminal_is_catch_all } : {},
+      ...typeof raw.terminal_is_accept_all === "boolean" ? { terminal_is_accept_all: raw.terminal_is_accept_all } : {},
+      ...typeof raw.bounceban_id === "string" ? { bounceban_id: raw.bounceban_id } : {},
       ...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"),
       billing_replayed: typeof raw.billing_replayed === "boolean" ? raw.billing_replayed : result.billingReplayed === true,
@@ -594,6 +621,15 @@ function customerEmailResult(value, kind) {
     smtp_status: result.smtpStatus ?? raw.smtp_status ?? (isCatchAll ? "accept_all" : verifiedForSending ? "accepted" : "not_checked"),
     provider_status: result.providerStatus ?? raw.provider_status ?? verificationStatus,
     verification_source: result.verificationSource ?? raw.verification_source ?? "email_verification",
+    ...typeof raw.checked_email === "string" ? { checked_email: raw.checked_email } : {},
+    ...typeof raw.primary_verifier === "string" ? { primary_verifier: raw.primary_verifier } : {},
+    ...typeof raw.primary_verdict === "string" ? { primary_verdict: raw.primary_verdict } : {},
+    ...typeof raw.terminal_verifier === "string" ? { terminal_verifier: raw.terminal_verifier } : {},
+    ...typeof raw.terminal_verdict === "string" ? { terminal_verdict: raw.terminal_verdict } : {},
+    ...typeof raw.terminal_result === "string" ? { terminal_result: raw.terminal_result } : {},
+    ...typeof raw.terminal_is_catch_all === "boolean" ? { terminal_is_catch_all: raw.terminal_is_catch_all } : {},
+    ...typeof raw.terminal_is_accept_all === "boolean" ? { terminal_is_accept_all: raw.terminal_is_accept_all } : {},
+    ...typeof raw.bounceban_id === "string" ? { bounceban_id: raw.bounceban_id } : {},
     ...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"),
     billing_replayed: typeof raw.billing_replayed === "boolean" ? raw.billing_replayed : result.billingReplayed === true,
@@ -693,7 +729,7 @@ function customerCompanySignalBatch(value) {
 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;
+  const signals2 = Array.isArray(result.signals) ? publicSignalRows(result.signals) : void 0;
   return {
     ...publicResult,
     ...signals2 ? { signals: signals2 } : {}
@@ -824,7 +860,7 @@ function publicSignalDiscoveryFailure(value) {
   if (requestedCode === "IDEMPOTENCY_CONFLICT") {
     return {
       errorCode: requestedCode,
-      error: "This recovery key belongs to a different Signals Everything request."
+      error: "This recovery key belongs to a different Signals First request."
     };
   }
   if (requestedCode === "PERSISTENCE_UNAVAILABLE") {
@@ -835,7 +871,7 @@ function publicSignalDiscoveryFailure(value) {
   }
   return {
     errorCode: "SOURCE_UNAVAILABLE",
-    error: "Signals Everything could not complete this search."
+    error: "Signals First could not complete this search."
   };
 }
 function hasFindEmailLinkedInIdentity(value) {
@@ -1264,19 +1300,11 @@ async function verifyEmail(args) {
 `);
     process.stdout.write(`Status: ${publicResult.status}
 `);
-    process.stdout.write(`Success: ${publicResult.success}
-`);
-    process.stdout.write(`Valid: ${publicResult.is_valid}
-`);
-    process.stdout.write(`Verdict: ${publicResult.verification_status}
-`);
-    process.stdout.write(`Recommendation: ${publicResult.recommendation}
+    process.stdout.write(`Catch-all: ${publicResult.is_catch_all}
 `);
-    process.stdout.write(`Source: ${String(publicResult.verification_source || "email_verification").toLowerCase().includes("cache") ? "email_verification" : publicResult.verification_source}
+    process.stdout.write(`Credits charged: ${publicResult.credits_charged}
 `);
-    if (publicResult.run_id) process.stdout.write(`Run ID: ${publicResult.run_id}
-`);
-    process.stdout.write(`Credits used: ${publicResult.credits_used}
+    process.stdout.write(`OK to send: ${publicResult.ok_to_send ? "Yes" : "No"}
 `);
   });
 }
@@ -1458,7 +1486,7 @@ function sleep(milliseconds) {
   return new Promise((resolve) => setTimeout(resolve, milliseconds));
 }
 async function signals(args) {
-  if (flag("input")) fail("Signals Everything accepts one natural-language query at a time; do not pass --input.");
+  if (flag("input")) fail("Signals First accepts one natural-language query at a time; do not pass --input.");
   const signalSearchRunId = flag("signal-search-run-id");
   const query = signalQueryFromArgs(args);
   if (!query && !signalSearchRunId) {
@@ -1500,12 +1528,12 @@ 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. Included on plan; 0 Signaliz credits charged.
+      process.stdout.write(`Signals First 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(`Signals First ${result.status}: ${result.signalSearchRunId}
 `);
       process.stdout.write(`Billing: included on plan \xB7 ${result.creditsCharged} Signaliz credits charged.
 `);
@@ -1514,7 +1542,7 @@ async function signals(args) {
       return;
     }
     if (!result.success || result.status === "failed") {
-      process.stdout.write(`${result.error || "Signals Everything failed."}
+      process.stdout.write(`${result.error || "Signals First failed."}
 `);
       return;
     }
@@ -1840,18 +1868,36 @@ function awarenessSchedule() {
     every_6_hours: "0 */6 * * *",
     daily: "0 8 * * *",
     every_2_days: "0 8 */2 * *",
-    weekly: "0 8 * * 1"
+    weekly: "0 8 * * 1",
+    monthly: "0 8 1 * *"
   };
   if (!schedules[schedule]) {
-    throw new CliInputError("--schedule must be every_6_hours, daily, every_2_days, or weekly");
+    throw new CliInputError("--schedule must be every_6_hours, daily, every_2_days, weekly, or monthly");
   }
   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 actions = [
+    "create",
+    "import",
+    "list",
+    "update",
+    "schedule",
+    "run",
+    "signals",
+    "pause",
+    "resume",
+    "delete",
+    "settings",
+    "set-output",
+    "test-webhook",
+    "export",
+    "send-export"
+  ];
+  if (!action || !actions.includes(action)) {
+    throw new CliInputError(`Usage: signaliz awareness <${actions.join("|")}>`);
   }
   const client = createClient();
   if (action === "create") {
@@ -1860,32 +1906,42 @@ async function awareness(args) {
     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") } : {}
-      }
+      webhookUrl: flag("webhook-url")
     });
     output(result2, () => process.stdout.write(`Monitor created: ${String(result2.monitor?.id || "pending")}
+`));
+    return;
+  }
+  if (action === "import") {
+    const rows = readBatchInput();
+    if (!rows) throw new CliInputError("signaliz awareness import requires --input <json-or-jsonl-file>");
+    if (rows.length > 500) throw new CliInputError(`Signal Awareness imports at most 500 companies; received ${rows.length}`);
+    const monitors = rows.map((value, index) => {
+      const row = record(value);
+      const companyName = stringValue(row.company_name ?? row.companyName ?? row.company ?? row.name);
+      const domain = stringValue(row.domain ?? row.website);
+      if (!companyName || !domain) throw new CliInputError(`Awareness import row ${index + 1} requires company_name and domain`);
+      return { companyName, domain };
+    });
+    const result2 = await client.bulkCreateSignalMonitors(monitors, {
+      scheduleCron: awarenessSchedule(),
+      webhookUrl: flag("webhook-url")
+    });
+    output(result2, () => process.stdout.write(`Created: ${result2.created || 0}
+Skipped: ${result2.skipped || 0}
 `));
     return;
   }
   if (action === "list") {
     const offset = numberFlag("offset");
+    const limit = numberFlag("limit");
+    if (limit !== void 0) requireIntegerInRange(limit, "--limit", 1, 500);
     if (offset !== void 0) requireIntegerInRange(offset, "--offset", 0, 1e4);
-    const result2 = await client.listSignalMonitors(numberFlag("limit"), offset);
+    const result2 = await client.listSignalMonitors(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)}
@@ -1896,13 +1952,10 @@ async function awareness(args) {
   }
   if (action === "signals") {
     const offset = numberFlag("offset");
+    const limit = numberFlag("limit");
+    if (limit !== void 0) requireIntegerInRange(limit, "--limit", 1, 500);
     if (offset !== void 0) requireIntegerInRange(offset, "--offset", 0, 1e4);
-    const result2 = customerSignalAwarenessResult(await client.signalAwareness({
-      action: "list_signals",
-      monitorId,
-      limit: numberFlag("limit"),
-      offset
-    }));
+    const result2 = customerSignalAwarenessResult(await client.listSignalAwarenessSignals(monitorId, 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}
@@ -1911,7 +1964,64 @@ async function awareness(args) {
     });
     return;
   }
+  if (action === "settings") {
+    const result2 = await client.getSignalAwarenessSettings();
+    output(result2, () => process.stdout.write(`Output: ${result2.outputMode || "csv"}
+Webhook: ${result2.webhookUrl || "not configured"}
+`));
+    return;
+  }
+  if (action === "set-output") {
+    const mode = flag("mode");
+    if (mode !== "csv" && mode !== "webhook") throw new CliInputError("signaliz awareness set-output requires --mode csv|webhook");
+    const webhookUrl = flag("webhook-url");
+    if (mode === "webhook" && !webhookUrl) throw new CliInputError("--webhook-url is required when --mode webhook");
+    const result2 = await client.setSignalAwarenessOutput(mode, webhookUrl);
+    output(result2, () => process.stdout.write(`Signal Awareness output set to ${mode}
+`));
+    return;
+  }
+  if (action === "test-webhook") {
+    const webhookUrl = flag("webhook-url");
+    if (!webhookUrl) throw new CliInputError("signaliz awareness test-webhook requires --webhook-url https://...");
+    const result2 = await client.testSignalAwarenessWebhook(webhookUrl);
+    output(result2, () => process.stdout.write(`Webhook returned HTTP ${result2.webhookStatus || "unknown"}
+`));
+    return;
+  }
+  if (action === "export") {
+    const result2 = customerSignalAwarenessResult(await client.exportSignalAwareness(monitorId));
+    output(result2, () => process.stdout.write(`Companies: ${result2.monitors?.length || 0}
+Signals: ${result2.signals?.length || 0}
+`));
+    return;
+  }
+  if (action === "send-export") {
+    const rows = readBatchInput();
+    if (!rows) throw new CliInputError("signaliz awareness send-export requires --input <json-or-jsonl-file>");
+    if (rows.length > 2e3) throw new CliInputError(`Signal Awareness sends at most 2,000 signals per call; received ${rows.length}`);
+    const signals2 = publicSignalRows(rows);
+    if (signals2.length !== rows.length) throw new CliInputError("Every send-export row must contain signal_type, source, date, company_name, and domain");
+    const result2 = await client.sendSignalAwarenessExport(signals2);
+    output(result2, () => process.stdout.write(`Delivered: ${result2.delivered || 0}
+Webhook: HTTP ${result2.webhookStatus || "unknown"}
+`));
+    return;
+  }
   if (!monitorId) throw new CliInputError(`signaliz awareness ${action} requires --monitor-id <uuid>`);
+  if (action === "update" || action === "schedule") {
+    const scheduleCron = awarenessSchedule();
+    const companyName = flag("company-name");
+    const webhookUrl = hasFlag("clear-webhook") ? null : flag("webhook-url");
+    if (action === "schedule" && !scheduleCron) throw new CliInputError("signaliz awareness schedule requires --schedule or --schedule-cron");
+    if (!companyName && !scheduleCron && webhookUrl === void 0) {
+      throw new CliInputError("signaliz awareness update requires --company-name, --schedule/--schedule-cron, --webhook-url, or --clear-webhook");
+    }
+    const result2 = await client.updateSignalMonitor(monitorId, { companyName, scheduleCron, webhookUrl });
+    output(result2, () => process.stdout.write(`Monitor updated: ${monitorId}
+`));
+    return;
+  }
   if (action === "run") {
     if (hasFlag("dry-run")) {
       const result3 = await client.signalAwareness({ action: "manual_run", monitorId, idempotencyKey: flag("idempotency-key"), dryRun: true });
@@ -1927,9 +2037,7 @@ 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 } : {} } }
-  );
+  const result = action === "delete" ? await client.deleteSignalMonitor(monitorId) : action === "resume" ? await client.resumeSignalMonitor(monitorId) : await client.pauseSignalMonitor(monitorId);
   output(result, () => process.stdout.write(`Monitor ${action === "delete" ? "deleted" : action === "resume" ? "resumed" : "paused"}: ${monitorId}
 `));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.66",
+  "version": "1.0.68",
   "description": "Signaliz CLI for Company Signal Enrichment, Signals First, Signal Awareness, Signal to Copy AI, and Signaliz Flow.",
   "bin": {
     "signaliz": "dist/bin.js"
@@ -29,7 +29,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@signaliz/sdk": "^1.0.68"
+    "@signaliz/sdk": "^1.0.72"
   },
   "devDependencies": {
     "tsup": "^8.0.0",