@signaliz/cli 1.0.85 → 1.0.87

package/README.md

@@ -197,3 +197,26 @@ signaliz mcp install
 Configuration is stored in `~/.signaliz/config.json` with file mode `0600`.
 `SIGNALIZ_API_KEY`, `SIGNALIZ_API_URL`, and `SIGNALIZ_BASE_URL` override the
 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:
+
+```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> \
+  --agent devin --action provider_activation --instructions "Prepare for review" --json
+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.

package/dist/bin.js

@@ -56,6 +56,12 @@ Product commands:
   signaliz builds run --build-id BLD-... [--input request.json] --confirm-spend --max-credits <number> [--idempotency-key <key>]
   signaliz builds status --run-id <uuid> [--limit 100]
   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]
 
 Access and connection:
   signaliz auth login
@@ -2070,6 +2076,159 @@ async function managedBuilds(args) {
   }
   throw new CliInputError("Usage: signaliz builds list|get|quote|run|status|download");
 }
+var CAMPAIGN_OS_AGENTS = /* @__PURE__ */ new Set([
+  "codex",
+  "claude_code",
+  "cursor",
+  "devin",
+  "grok",
+  "other"
+]);
+var CAMPAIGN_OS_ACTIONS = /* @__PURE__ */ new Set([
+  "build_campaign",
+  "refresh_brain",
+  "sync_audience",
+  "prepare_realtime_policy",
+  "provider_load",
+  "provider_activation",
+  "provider_send"
+]);
+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");
+  }
+  return value;
+}
+async function campaignOs(args) {
+  const action = args[0];
+  const client = createClient();
+  if (action === "clients") {
+    const limit = numberFlag("limit") ?? 100;
+    requireIntegerInRange(limit, "--limit", 1, 200);
+    const status = flag("status");
+    if (status && !["onboarding", "active", "paused", "archived"].includes(status)) {
+      throw new CliInputError("--status must be onboarding, active, paused, or archived");
+    }
+    const result = await client.listCampaignOsClients({ query: flag("query"), status, limit });
+    output(result, () => {
+      process.stdout.write(`Campaign OS clients: ${result.total_returned}
+`);
+      for (const item of result.clients) {
+        process.stdout.write(`- ${item.name} (${item.status}) \xB7 Brain v${item.brain_version} \xB7 ${item.counts.sources} sources \xB7 ${item.counts.audiences} audiences \xB7 ${item.counts.campaigns} campaigns
+`);
+      }
+    });
+    return;
+  }
+  if (action === "context") {
+    const clientId = flag("client-id");
+    if (!clientId) throw new CliInputError("signaliz campaign-os context requires --client-id <uuid>");
+    const sourceLimit = numberFlag("source-limit") ?? 50;
+    requireIntegerInRange(sourceLimit, "--source-limit", 1, 100);
+    const result = await client.getCampaignOsClientContext(clientId, sourceLimit);
+    output(result, () => {
+      const selected = result.client;
+      process.stdout.write(`${String(selected.name || clientId)} \xB7 Brain v${String(selected.brain_version || "?")}
+`);
+      process.stdout.write(`${result.brain_sources.length} bounded sources \xB7 ${result.audiences.length} audiences \xB7 ${result.campaigns.length} campaigns \xB7 ${result.realtime_policies.length} realtime policies
+`);
+      process.stdout.write("Raw source bodies and provider secrets were not returned.\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");
+    if (!clientId || !name) throw new CliInputError('signaliz campaign-os draft requires --client-id <uuid> --name "Campaign"');
+    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");
+    requireIntegerInRange(targetCount, "--target-count", 0, 1e7);
+    const result = await client.createCampaignOsDraft({
+      clientId,
+      name,
+      objective: flag("objective"),
+      lane,
+      targetCount,
+      audienceBindingId: flag("audience-binding-id"),
+      agentVendor: campaignOsAgentFlag(),
+      idempotencyKey: flag("idempotency-key")
+    });
+    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 load: locked \xB7 activation: locked \xB7 send: locked\n");
+      process.stdout.write("No Clay or Instantly mutation was performed.\n");
+    });
+    return;
+  }
+  if (action === "request") {
+    const clientId = flag("client-id");
+    const actionType = flag("action");
+    const instructions = flag("instructions");
+    if (!clientId || !actionType || !instructions) {
+      throw new CliInputError('signaliz campaign-os request requires --client-id <uuid> --action <type> --instructions "..."');
+    }
+    if (!CAMPAIGN_OS_ACTIONS.has(actionType)) {
+      throw new CliInputError(`--action must be one of: ${Array.from(CAMPAIGN_OS_ACTIONS).join(", ")}`);
+    }
+    const result = await client.submitCampaignOsActionRequest({
+      clientId,
+      campaignId: flag("campaign-id"),
+      agentVendor: campaignOsAgentFlag(),
+      actionType,
+      instructions,
+      idempotencyKey: flag("idempotency-key")
+    });
+    output(result, () => {
+      const request = record(result.request);
+      process.stdout.write(`Action request recorded: ${String(request.id || "")} \xB7 ${String(request.status || "review_required")}
+`);
+      process.stdout.write("Execution did not start. Provider mutations require a separate Signaliz admin approval.\n");
+    });
+    return;
+  }
+  if (action === "receipts") {
+    const limit = numberFlag("limit") ?? 50;
+    requireIntegerInRange(limit, "--limit", 1, 200);
+    const result = await client.listCampaignOsReceipts({
+      clientId: flag("client-id"),
+      campaignId: flag("campaign-id"),
+      limit
+    });
+    output(result, () => {
+      const requests = Array.isArray(result.action_requests) ? result.action_requests : [];
+      const deliveries = Array.isArray(result.delivery_receipts) ? result.delivery_receipts : [];
+      process.stdout.write(`${requests.length} agent request receipt(s) \xB7 ${deliveries.length} provider delivery receipt(s)
+`);
+      process.stdout.write("Provider accepted and mailbox sent remain distinct states.\n");
+    });
+    return;
+  }
+  throw new CliInputError("Usage: signaliz campaign-os clients|context|provider-runtime|draft|request|receipts");
+}
 async function main() {
   const [, , command, ...args] = process.argv;
   if (!command || ["help", "--help", "-h"].includes(command)) {
@@ -2095,6 +2254,8 @@ async function main() {
       return flow();
     case "builds":
       return managedBuilds(args);
+    case "campaign-os":
+      return campaignOs(args);
     case "signal-to-copy":
       return signalToCopy();
     case "health":

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.85",
-  "description": "Signaliz CLI for core products, Signal Awareness, Signaliz Flow, and reusable managed builds.",
+  "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"
   },
@@ -21,6 +21,7 @@
     "company-signals",
     "signal-to-copy",
     "signals-first",
+    "campaign-os",
     "signal-awareness",
     "signaliz-flow"
   ],
@@ -29,7 +30,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@signaliz/sdk": "^1.0.89"
+    "@signaliz/sdk": "^1.0.91"
   },
   "devDependencies": {
     "tsup": "^8.0.0",