@signaliz/cli 1.0.88 → 1.0.90

package/README.md

@@ -201,14 +201,28 @@ saved configuration.
 ## Campaign OS agent harness
 
 Use the same commands from Codex, Claude Code, Cursor, Devin, Grok, or a shell
-automation. All context is bounded and all provider actions remain gated:
+automation. All context is bounded. Safe Campaign OS work runs autonomously;
+consequential provider actions remain gated:
 
 ```bash
 signaliz campaign-os clients --status active --json
 signaliz campaign-os context --client-id <uuid> --json
 signaliz campaign-os provider-runtime --client-id <uuid> --provider clay --json
-signaliz campaign-os draft --client-id <uuid> --name "Launch intent" \
-  --lane realtime --agent codex --idempotency-key launch-draft-v1 --json
+signaliz campaign-os build --client-id <uuid> --name "Launch intent" \
+  --objective "Build an evidence-grounded 500-person campaign" \
+  --target-count 500 --agent codex --idempotency-key launch-build-v1 --json
+signaliz campaign-os build-status --build-run-id <uuid> --json
+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> \
+  --providers all --json
 signaliz campaign-os request --client-id <uuid> --campaign-id <uuid> \
   --agent devin --action provider_activation --instructions "Prepare for review" --json
 signaliz campaign-os receipts --client-id <uuid> --json
@@ -216,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. `draft` creates only a locked Signaliz campaign object.
-`request` creates only an auditable review request. None of these commands
-loads leads, activates a provider campaign, spends Clay allowance, or sends
-email.
+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

@@ -59,9 +59,15 @@ Product commands:
   signaliz campaign-os clients [--status active] [--query signaliz] [--limit 100]
   signaliz campaign-os context --client-id <uuid> [--source-limit 50]
   signaliz campaign-os knowledge --query "cache first" [--client-id <uuid>] [--record-kind campaign_playbook] [--limit 15]
-  signaliz campaign-os provider-runtime --client-id <uuid> --provider clay|instantly
-  signaliz campaign-os draft --client-id <uuid> --name "Campaign" [--objective "..."] [--lane one_time|always_on|realtime] [--audience-binding-id <uuid>] [--agent codex]
-  signaliz campaign-os request --client-id <uuid> [--campaign-id <uuid>] --agent codex --action build_campaign --instructions "..." [--idempotency-key <key>]
+  signaliz campaign-os provider-runtime --client-id <uuid> --provider clay|instantly|smartlead|bison
+  signaliz campaign-os build --client-id <uuid> --name "Campaign" --objective "Goal" --target-count 500 --idempotency-key <key>
+  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>]
   signaliz campaign-os receipts [--client-id <uuid>] [--campaign-id <uuid>] [--limit 50]
 
 Access and connection:
@@ -2083,22 +2089,21 @@ var CAMPAIGN_OS_AGENTS = /* @__PURE__ */ new Set([
   "cursor",
   "devin",
   "grok",
+  "signaliz_agent",
   "other"
 ]);
 var CAMPAIGN_OS_ACTIONS = /* @__PURE__ */ new Set([
-  "build_campaign",
-  "refresh_brain",
-  "sync_audience",
-  "prepare_realtime_policy",
+  "fresh_paid_sourcing",
   "provider_load",
   "provider_activation",
-  "provider_send"
+  "provider_send",
+  "realtime_arm"
 ]);
 function campaignOsAgentFlag() {
   const value = flag("agent")?.trim().toLowerCase().replace(/[\s-]+/g, "_");
   if (!value) return void 0;
   if (!CAMPAIGN_OS_AGENTS.has(value)) {
-    throw new CliInputError("--agent must be codex, claude_code, cursor, devin, grok, or other");
+    throw new CliInputError("--agent must be codex, claude_code, cursor, devin, grok, signaliz_agent, or other");
   }
   return value;
 }
@@ -2180,19 +2185,67 @@ async function campaignOs(args) {
     const clientId = flag("client-id");
     const provider = flag("provider");
     if (!clientId || !provider) {
-      throw new CliInputError("signaliz campaign-os provider-runtime requires --client-id <uuid> --provider clay|instantly");
+      throw new CliInputError("signaliz campaign-os provider-runtime requires --client-id <uuid> --provider clay|instantly|smartlead|bison");
     }
-    if (!["clay", "instantly"].includes(provider)) {
-      throw new CliInputError("--provider must be clay or instantly");
+    if (!["clay", "instantly", "smartlead", "bison"].includes(provider)) {
+      throw new CliInputError("--provider must be clay, instantly, smartlead, or bison");
     }
     const result = await client.getCampaignOsProviderRuntime(clientId, provider);
     output(result, () => {
-      process.stdout.write(`${provider === "clay" ? "Clay" : "Instantly"} runtime for ${result.client.name}: ${result.connected ? "connected" : "not connected"}
+      const providerName = { clay: "Clay", instantly: "Instantly", smartlead: "Smartlead", bison: "Bison" }[provider];
+      process.stdout.write(`${providerName} runtime for ${result.client.name}: ${result.connected ? "connected" : "not connected"}
 `);
       process.stdout.write("Provider secrets were not returned and no provider call, spend, or mutation started.\n");
     });
     return;
   }
+  if (action === "build") {
+    const clientId = flag("client-id");
+    const name = flag("name");
+    const objective = flag("objective");
+    const idempotencyKey = flag("idempotency-key");
+    if (!clientId || !name || !objective || !idempotencyKey) {
+      throw new CliInputError('signaliz campaign-os build requires --client-id <uuid> --name "Campaign" --objective "Goal" --idempotency-key <key>');
+    }
+    const lane = flag("lane") || "one_time";
+    if (!["one_time", "always_on", "realtime"].includes(lane)) {
+      throw new CliInputError("--lane must be one_time, always_on, or realtime");
+    }
+    const targetCount = numberFlag("target-count") ?? 0;
+    requireIntegerInRange(targetCount, "--target-count", 0, 1e7);
+    const result = await client.startCampaignOsBuild({
+      clientId,
+      name,
+      objective,
+      lane,
+      targetCount,
+      audienceDefinitionId: flag("audience-definition-id"),
+      agentVendor: campaignOsAgentFlag(),
+      idempotencyKey
+    });
+    output(result, () => {
+      const build = record(result.build);
+      process.stdout.write(`Campaign Brain build started: ${String(build.id || "")} \xB7 ${String(build.status || "queued")}
+`);
+      process.stdout.write("No admin approval was required. Provider load, activation, realtime arming, and send remain locked.\n");
+    });
+    return;
+  }
+  if (action === "build-status") {
+    const buildRunId = flag("build-run-id");
+    if (!buildRunId) throw new CliInputError("signaliz campaign-os build-status requires --build-run-id <uuid>");
+    const result = await client.getCampaignOsBuild(buildRunId);
+    output(result, () => {
+      const build = record(result.build);
+      const campaign = record(result.campaign);
+      process.stdout.write(`Campaign Brain build: ${String(build.status || "unknown")}
+`);
+      if (campaign.id) process.stdout.write(`Provider-locked campaign: ${String(campaign.name || "")} (${String(campaign.id)})
+`);
+      process.stdout.write("Provider execution remains locked.\n");
+    });
+    return;
+  }
   if (action === "draft") {
     const clientId = flag("client-id");
     const name = flag("name");
@@ -2203,6 +2256,21 @@ async function campaignOs(args) {
     }
     const targetCount = numberFlag("target-count");
     requireIntegerInRange(targetCount, "--target-count", 0, 1e7);
+    const campaignSpecFile = flag("campaign-spec-file");
+    const idempotencyKey = flag("idempotency-key");
+    if (!campaignSpecFile || !idempotencyKey) {
+      throw new CliInputError("signaliz campaign-os draft requires --campaign-spec-file <json> and --idempotency-key <key>");
+    }
+    let campaignSpec;
+    try {
+      const parsed = JSON.parse((0, import_node_fs.readFileSync)(campaignSpecFile, "utf8"));
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("file must contain one JSON object");
+      }
+      campaignSpec = parsed;
+    } catch (error) {
+      throw new CliInputError(`Unable to read --campaign-spec-file: ${error instanceof Error ? error.message : String(error)}`);
+    }
     const result = await client.createCampaignOsDraft({
       clientId,
       name,
@@ -2210,16 +2278,105 @@ async function campaignOs(args) {
       lane,
       targetCount,
       audienceBindingId: flag("audience-binding-id"),
+      audienceDefinitionId: flag("audience-definition-id"),
+      campaignSpec,
       agentVendor: campaignOsAgentFlag(),
-      idempotencyKey: flag("idempotency-key")
+      idempotencyKey
     });
     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 or Instantly mutation was performed.\n");
+      process.stdout.write("No Clay, Instantly, Smartlead, or Bison mutation was performed.\n");
+    });
+    return;
+  }
+  if (action === "audience-draft") {
+    const clientId = flag("client-id");
+    const name = flag("name");
+    const definitionFile = flag("definition-file");
+    const idempotencyKey = flag("idempotency-key");
+    const entityType = flag("entity-type");
+    const audienceRole = flag("audience-role");
+    const sourceMode = flag("source-mode");
+    if (!clientId || !name || !definitionFile || !idempotencyKey || !entityType || !audienceRole || !sourceMode) {
+      throw new CliInputError("signaliz campaign-os audience-draft requires --client-id, --name, --definition-file, --entity-type, --audience-role, --source-mode, and --idempotency-key");
+    }
+    let definition;
+    try {
+      const parsed = JSON.parse((0, import_node_fs.readFileSync)(definitionFile, "utf8"));
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("file must contain one JSON object");
+      definition = parsed;
+    } catch (error) {
+      throw new CliInputError(`Unable to read --definition-file: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const result = await client.createCampaignOsAudienceDraft({
+      clientId,
+      audienceId: flag("audience-id"),
+      name,
+      description: flag("description"),
+      entityType,
+      audienceRole,
+      sourceMode,
+      definition,
+      idempotencyKey
     });
+    output(result, () => {
+      const audience = record(result.audience);
+      process.stdout.write(`Audience draft saved: ${String(audience.name || name)} (${String(audience.id || "")})
+`);
+      process.stdout.write("Clay calls: 0 \xB7 provider mutation: false\n");
+    });
+    return;
+  }
+  if (action === "audience-preview") {
+    const clientId = flag("client-id");
+    const audienceId = flag("audience-id");
+    const idempotencyKey = flag("idempotency-key");
+    if (!clientId || !audienceId || !idempotencyKey) {
+      throw new CliInputError("signaliz campaign-os audience-preview requires --client-id, --audience-id, and --idempotency-key");
+    }
+    const result = await client.previewCampaignOsAudience(clientId, audienceId, idempotencyKey);
+    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");
+    const providers = flag("providers") || "all";
+    if (!clientId || !campaignId) throw new CliInputError("signaliz campaign-os compile requires --client-id and --campaign-id");
+    if (!["all", "instantly", "smartlead", "bison"].includes(providers)) throw new CliInputError("--providers must be all, instantly, smartlead, or bison");
+    const result = await client.compileCampaignOsPreview(clientId, campaignId, providers);
+    output(result, () => process.stdout.write("Compile preview recorded \xB7 provider calls 0 \xB7 no campaign created or sent\n"));
     return;
   }
   if (action === "request") {
@@ -2265,7 +2422,7 @@ async function campaignOs(args) {
     });
     return;
   }
-  throw new CliInputError("Usage: signaliz campaign-os clients|context|knowledge|provider-runtime|draft|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.88",
+  "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.92"
+    "@signaliz/sdk": "^1.0.94"
   },
   "devDependencies": {
     "tsup": "^8.0.0",