@signaliz/cli 1.0.86 → 1.0.87

package/README.md

@@ -206,6 +206,7 @@ automation. All context is bounded and all 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 request --client-id <uuid> --campaign-id <uuid> \
@@ -213,6 +214,9 @@ signaliz campaign-os request --client-id <uuid> --campaign-id <uuid> \
 signaliz campaign-os receipts --client-id <uuid> --json
 ```
 
-`draft` creates only a locked Signaliz campaign object. `request` creates only
-an auditable review request. Neither command loads leads, activates a provider
-campaign, or sends email.
+`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.

package/dist/bin.js

@@ -58,6 +58,7 @@ Product commands:
   signaliz builds download --run-id <uuid> --out results.csv
   signaliz campaign-os clients [--status active] [--query signaliz] [--limit 100]
   signaliz campaign-os context --client-id <uuid> [--source-limit 50]
+  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 receipts [--client-id <uuid>] [--campaign-id <uuid>] [--limit 50]
@@ -2137,6 +2138,23 @@ async function campaignOs(args) {
     });
     return;
   }
+  if (action === "provider-runtime") {
+    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");
+    }
+    if (!["clay", "instantly"].includes(provider)) {
+      throw new CliInputError("--provider must be clay or instantly");
+    }
+    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"}
+`);
+      process.stdout.write("Provider secrets were not returned and no provider call, spend, or mutation started.\n");
+    });
+    return;
+  }
   if (action === "draft") {
     const clientId = flag("client-id");
     const name = flag("name");
@@ -2209,7 +2227,7 @@ async function campaignOs(args) {
     });
     return;
   }
-  throw new CliInputError("Usage: signaliz campaign-os clients|context|draft|request|receipts");
+  throw new CliInputError("Usage: signaliz campaign-os clients|context|provider-runtime|draft|request|receipts");
 }
 async function main() {
   const [, , command, ...args] = process.argv;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.86",
+  "version": "1.0.87",
   "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.90"
+    "@signaliz/sdk": "^1.0.91"
   },
   "devDependencies": {
     "tsup": "^8.0.0",