@signaliz/cli 1.0.89 → 1.0.90

package/README.md

@@ -216,6 +216,9 @@ signaliz campaign-os audience-draft --client-id <uuid> --name "Launch ICP" \
   --definition-file audience.json --entity-type people \
   --audience-role campaign_segment --source-mode signaliz_owned \
   --idempotency-key launch-audience-v1 --json
+signaliz campaign-os materialize-cache-audience --client-id <uuid> \
+  --audience-id <uuid> --target-count 500 \
+  --idempotency-key launch-cache-materialization-v1 --json
 signaliz campaign-os audience-preview --client-id <uuid> \
   --audience-id <uuid> --idempotency-key launch-preview-v1 --json
 signaliz campaign-os compile --client-id <uuid> --campaign-id <uuid> \
@@ -227,7 +230,9 @@ signaliz campaign-os receipts --client-id <uuid> --json
 
 `provider-runtime` explains the safe Clay or Instantly route, adapter source,
 approval boundaries, and receipt semantics without returning credentials or
-calling the provider. `build`, `audience-draft`, `audience-preview`, and
-`compile` do not need CMM-admin approval and keep providers locked. `request`
+calling the provider. `build`, `audience-draft`, `materialize-cache-audience`,
+`audience-preview`, and `compile` do not need CMM-admin approval and keep
+providers locked. Cache materialization is capped at 500 members and returns
+exact zero-provider/Clay usage plus a terminal reconciliation receipt. `request`
 creates only an auditable review request for paid sourcing, provider load,
 activation, real-time arming, queueing, or sending; it does not execute them.

package/dist/bin.js

@@ -64,6 +64,7 @@ Product commands:
   signaliz campaign-os build-status --build-run-id <uuid>
   signaliz campaign-os draft --client-id <uuid> --name "Campaign" --campaign-spec-file campaign-spec.json --idempotency-key <key> [--agent codex]
   signaliz campaign-os audience-draft --client-id <uuid> --name "Audience" --definition-file audience.json --entity-type people --audience-role campaign_segment --source-mode signaliz_owned --idempotency-key <key>
+  signaliz campaign-os materialize-cache-audience --client-id <uuid> --audience-id <uuid> --target-count <1-500> --idempotency-key <key>
   signaliz campaign-os audience-preview --client-id <uuid> --audience-id <uuid> --idempotency-key <key>
   signaliz campaign-os compile --client-id <uuid> --campaign-id <uuid> [--providers all]
   signaliz campaign-os request --client-id <uuid> [--campaign-id <uuid>] --agent codex --action provider_load --instructions "..." [--idempotency-key <key>]
@@ -2239,7 +2240,7 @@ async function campaignOs(args) {
       const campaign = record(result.campaign);
       process.stdout.write(`Campaign Brain build: ${String(build.status || "unknown")}
 `);
-      if (campaign.id) process.stdout.write(`Review-held campaign: ${String(campaign.name || "")} (${String(campaign.id)})
+      if (campaign.id) process.stdout.write(`Provider-locked campaign: ${String(campaign.name || "")} (${String(campaign.id)})
 `);
       process.stdout.write("Provider execution remains locked.\n");
     });
@@ -2284,7 +2285,7 @@ async function campaignOs(args) {
     });
     output(result, () => {
       const campaign = record(result.campaign);
-      process.stdout.write(`Review-held draft created: ${String(campaign.name || name)} (${String(campaign.id || "")})
+      process.stdout.write(`Provider-locked draft created without admin approval: ${String(campaign.name || name)} (${String(campaign.id || "")})
 `);
       process.stdout.write("Provider load: locked \xB7 activation: locked \xB7 send: locked\n");
       process.stdout.write("No Clay, Instantly, Smartlead, or Bison mutation was performed.\n");
@@ -2340,6 +2341,34 @@ async function campaignOs(args) {
     output(result, () => process.stdout.write("No-spend Audience preview recorded \xB7 provider calls 0 \xB7 Clay usage 0\n"));
     return;
   }
+  if (action === "materialize-cache-audience") {
+    const clientId = flag("client-id");
+    const audienceId = flag("audience-id");
+    const targetCount = numberFlag("target-count");
+    const idempotencyKey = flag("idempotency-key");
+    if (!clientId || !audienceId || targetCount === void 0 || !idempotencyKey) {
+      throw new CliInputError("signaliz campaign-os materialize-cache-audience requires --client-id, --audience-id, --target-count <1-500>, and --idempotency-key");
+    }
+    requireIntegerInRange(targetCount, "--target-count", 1, 500);
+    const result = await client.materializeCampaignOsCacheAudience({
+      clientId,
+      audienceId,
+      targetCount,
+      idempotencyKey
+    });
+    output(result, () => {
+      const usage = record(result.usage_receipt);
+      const reconciliation = record(result.terminal_reconciliation_receipt);
+      process.stdout.write(`Cache Audience materialized: target ${targetCount}
+`);
+      process.stdout.write(`Provider calls: ${String(usage.provider_calls)} \xB7 Clay Search allowance: ${String(usage.clay_search_allowance_used)} \xB7 Clay Actions: ${String(usage.clay_actions_used)} \xB7 Clay Data Credits: ${String(usage.clay_data_credits_used)}
+`);
+      process.stdout.write(`Terminal reconciliation receipt: ${JSON.stringify(reconciliation)}
+`);
+      process.stdout.write("No provider approval was requested.\n");
+    });
+    return;
+  }
   if (action === "compile") {
     const clientId = flag("client-id");
     const campaignId = flag("campaign-id");
@@ -2393,7 +2422,7 @@ async function campaignOs(args) {
     });
     return;
   }
-  throw new CliInputError("Usage: signaliz campaign-os clients|context|knowledge|provider-runtime|build|build-status|draft|audience-draft|audience-preview|compile|request|receipts");
+  throw new CliInputError("Usage: signaliz campaign-os clients|context|knowledge|provider-runtime|build|build-status|draft|audience-draft|materialize-cache-audience|audience-preview|compile|request|receipts");
 }
 async function main() {
   const [, , command, ...args] = process.argv;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.89",
+  "version": "1.0.90",
   "description": "Signaliz CLI for Campaign OS, core products, Signal Awareness, Signaliz Flow, and reusable managed builds.",
   "bin": {
     "signaliz": "dist/bin.js"
@@ -30,7 +30,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@signaliz/sdk": "^1.0.93"
+    "@signaliz/sdk": "^1.0.94"
   },
   "devDependencies": {
     "tsup": "^8.0.0",