@signaliz/cli 1.0.86 → 1.0.88

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,8 @@ 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 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 receipts [--client-id <uuid>] [--campaign-id <uuid>] [--limit 50]
@@ -2137,6 +2139,60 @@ async function campaignOs(args) {
     });
     return;
   }
+  if (action === "knowledge") {
+    const query = flag("query");
+    if (!query || query.length < 2) {
+      throw new CliInputError('signaliz campaign-os knowledge requires --query "campaign method"');
+    }
+    const limit = numberFlag("limit") ?? 15;
+    requireIntegerInRange(limit, "--limit", 1, 50);
+    const allowedKinds = [
+      "client_brain",
+      "campaign_register",
+      "campaign_learning",
+      "campaign_methodology",
+      "campaign_genome",
+      "campaign_playbook",
+      "knowledge_inventory"
+    ];
+    const recordKind = flag("record-kind");
+    if (recordKind && !allowedKinds.includes(recordKind)) {
+      throw new CliInputError(`--record-kind must be one of: ${allowedKinds.join(", ")}`);
+    }
+    const result = await client.searchCampaignOsKnowledge({
+      query,
+      clientId: flag("client-id"),
+      recordKind,
+      limit
+    });
+    output(result, () => {
+      process.stdout.write(`Campaign memory results: ${result.total_returned}
+`);
+      for (const item of result.results) {
+        process.stdout.write(`- ${String(item.title || "Untitled")} \xB7 ${String(item.client_slug || "unknown")} \xB7 ${String(item.record_kind || "knowledge")}
+`);
+      }
+      process.stdout.write("Results are bounded excerpts from the immutable current CMM snapshot.\n");
+    });
+    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 +2265,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|knowledge|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.88",
   "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.92"
   },
   "devDependencies": {
     "tsup": "^8.0.0",