@signaliz/sdk 1.0.15 → 1.0.17

package/dist/cli.mjs

@@ -1,30 +1,33 @@
 #!/usr/bin/env node
-import {
-  Signaliz,
-  createCampaignBuilderAgentRequestTemplate,
-  createCampaignBuilderApproval,
-  createCampaignBuilderBuildKit
-} from "./chunk-6OZWMAV3.mjs";
 
 // src/cli.ts
 import { readFileSync, writeFileSync } from "fs";
 var apiKey = process.env.SIGNALIZ_API_KEY;
 var baseUrl = process.env.SIGNALIZ_BASE_URL || process.env.SIGNALIZ_API_URL;
+var sdkModulePromise;
+function loadSdk() {
+  sdkModulePromise ?? (sdkModulePromise = import("./index.mjs"));
+  return sdkModulePromise;
+}
+async function createSignalizClient() {
+  const { Signaliz } = await loadSdk();
+  return new Signaliz({ apiKey: apiKey || "offline", baseUrl });
+}
 async function main() {
   const command = process.argv[2];
   if (!command || command === "help" || command === "--help" || command === "-h") {
     printHelp();
     return;
   }
-  const offlineCampaignAgentTemplate = (command === "campaign-agent" || command === "campaign-builder") && ["init", "template", "request-template", "new", "kit", "build-kit", "blueprint"].includes(String(process.argv[3] || ""));
+  const offlineCampaignAgentTemplate = (command === "campaign-agent" || command === "campaign-builder") && ["init", "template", "request-template", "new", "kit", "build-kit", "blueprint", "memory-kit", "seed-kit", "memory"].includes(String(process.argv[3] || ""));
   if (!apiKey && !offlineCampaignAgentTemplate) {
     console.error("\u274C SIGNALIZ_API_KEY environment variable is required.");
     console.error("   Set it with: export SIGNALIZ_API_KEY=sk_...");
     process.exit(1);
   }
-  const signaliz = new Signaliz({ apiKey: apiKey || "offline", baseUrl });
   switch (command) {
     case "test": {
+      const signaliz = await createSignalizClient();
       try {
         const ws = await signaliz.getWorkspace();
         console.log(`\u2705 Connected to workspace: ${ws.name} (${ws.creditsRemaining.toLocaleString()} credits remaining)`);
@@ -35,6 +38,7 @@ async function main() {
       break;
     }
     case "tools": {
+      const signaliz = await createSignalizClient();
       try {
         const tools = await signaliz.listTools();
         console.log(`
@@ -54,12 +58,13 @@ async function main() {
       break;
     }
     case "gtm": {
+      const signaliz = await createSignalizClient();
       await handleGtmCommand(signaliz, process.argv.slice(3));
       break;
     }
     case "campaign-agent":
     case "campaign-builder": {
-      await handleCampaignAgentCommand(signaliz, process.argv.slice(3));
+      await handleCampaignAgentCommand(createSignalizClient, process.argv.slice(3));
       break;
     }
     default:
@@ -116,6 +121,101 @@ async function handleGtmCommand(signaliz, argv) {
     printResult(result, flags);
     return;
   }
+  if (subcommand === "learning" && argv[1] === "status" || subcommand === "learning-status") {
+    const flags = parseFlags(argv.slice(subcommand === "learning" ? 2 : 1));
+    const campaignId = stringFlag(flags, "campaign-id");
+    const campaignBuildId = stringFlag(flags, "campaign-build-id", "build-id");
+    if (!campaignId && !campaignBuildId) {
+      throw new Error("gtm learning status requires --campaign-id or --campaign-build-id");
+    }
+    const result = await signaliz.gtm.campaignLearningStatus({
+      campaignId,
+      campaignBuildId,
+      days: numberFlag(flags, "days"),
+      networkDays: numberFlag(flags, "network-days"),
+      minSampleSize: numberFlag(flags, "min-sample-size"),
+      minWorkspaceCount: numberFlag(flags, "min-workspace-count"),
+      minPrivacyK: numberFlag(flags, "min-privacy-k"),
+      includeMemory: !booleanFlag(flags, "no-memory"),
+      includeNetwork: !booleanFlag(flags, "no-network"),
+      writeMode: stringFlag(flags, "write-mode"),
+      limit: numberFlag(flags, "limit")
+    });
+    printResult(result, flags);
+    return;
+  }
+  if (subcommand === "feedback") {
+    const feedbackCommand = argv[1];
+    if (!feedbackCommand || feedbackCommand === "help" || feedbackCommand === "--help" || feedbackCommand === "-h") {
+      printGtmHelp();
+      return;
+    }
+    if (feedbackCommand === "instantly-pull" || feedbackCommand === "pull-instantly") {
+      const flags = parseFlags(argv.slice(2));
+      const confirmWrite = booleanFlag(flags, "confirm-write");
+      const input = {
+        source: stringFlag(flags, "source", "pull-source"),
+        instantlyProfile: stringFlag(flags, "instantly-profile", "profile"),
+        campaignId: stringFlag(flags, "campaign-id"),
+        campaignBuildId: stringFlag(flags, "campaign-build-id", "build-id"),
+        providerLinkId: stringFlag(flags, "provider-link-id"),
+        providerCampaignId: stringFlag(flags, "provider-campaign-id", "instantly-campaign-id"),
+        instantlyCampaignId: stringFlag(flags, "instantly-campaign-id"),
+        integrationId: stringFlag(flags, "integration-id"),
+        cursor: stringFlag(flags, "cursor"),
+        from: stringFlag(flags, "from", "since"),
+        to: stringFlag(flags, "to", "until"),
+        limit: numberFlag(flags, "limit"),
+        maxPages: numberFlag(flags, "max-pages"),
+        emailType: stringFlag(flags, "email-type"),
+        mode: stringFlag(flags, "mode"),
+        sortOrder: stringFlag(flags, "sort-order"),
+        createMemory: !booleanFlag(flags, "no-create-memory"),
+        writeRoutineOutcomes: !booleanFlag(flags, "no-routine-outcomes"),
+        dryRun: !confirmWrite || booleanFlag(flags, "dry-run"),
+        runBrainCycle: optionalBooleanFlag(flags, "run-brain-cycle", "no-brain-cycle"),
+        brainCycleWriteMode: stringFlag(flags, "brain-cycle-write-mode", "write-mode"),
+        brainCyclePhases: csvFlag(flags, "brain-cycle-phases", "phases"),
+        brainCycleMinIngested: numberFlag(flags, "brain-cycle-min-ingested"),
+        brainCycleMinIntervalMinutes: numberFlag(flags, "brain-cycle-min-interval-minutes")
+      };
+      if (input.dryRun === false && !input.campaignId && !input.campaignBuildId && !input.providerLinkId && !input.providerCampaignId) {
+        throw new Error("gtm feedback instantly-pull --confirm-write requires --campaign-id, --campaign-build-id, --provider-link-id, or --provider-campaign-id");
+      }
+      const result = await signaliz.gtm.pullInstantlyFeedback(input);
+      printResult({
+        ...asRecord(result),
+        cli_policy: input.dryRun ? "CLI defaulted to dry_run. Re-run with --confirm-write to write feedback, memory, cursors, and optional Brain-cycle dispatch." : "Confirmed internal write: feedback/memory/cursor writes are enabled for this pull."
+      }, flags);
+      return;
+    }
+    if (feedbackCommand === "instantly-webhook-prepare" || feedbackCommand === "prepare-instantly-webhook") {
+      const flags = parseFlags(argv.slice(2));
+      if (!booleanFlag(flags, "confirm-write")) {
+        throw new Error("gtm feedback instantly-webhook-prepare writes provider-link webhook metadata; pass --confirm-write after review");
+      }
+      const input = {
+        campaignId: stringFlag(flags, "campaign-id"),
+        campaignBuildId: stringFlag(flags, "campaign-build-id", "build-id"),
+        providerLinkId: stringFlag(flags, "provider-link-id"),
+        providerCampaignId: stringFlag(flags, "provider-campaign-id", "instantly-campaign-id"),
+        instantlyCampaignId: stringFlag(flags, "instantly-campaign-id"),
+        integrationId: stringFlag(flags, "integration-id"),
+        providerWorkspaceId: stringFlag(flags, "provider-workspace-id"),
+        providerAccountId: stringFlag(flags, "provider-account-id"),
+        rotateSecret: booleanFlag(flags, "rotate-secret"),
+        runBrainCycle: optionalBooleanFlag(flags, "run-brain-cycle", "no-brain-cycle"),
+        brainCycleWriteMode: stringFlag(flags, "brain-cycle-write-mode", "write-mode"),
+        brainCyclePhases: csvFlag(flags, "brain-cycle-phases", "phases"),
+        brainCycleMinIngested: numberFlag(flags, "brain-cycle-min-ingested"),
+        brainCycleMinIntervalMinutes: numberFlag(flags, "brain-cycle-min-interval-minutes")
+      };
+      const result = await signaliz.gtm.prepareInstantlyFeedbackWebhook(input);
+      printResult(result, flags);
+      return;
+    }
+    throw new Error(`Unknown gtm feedback command "${feedbackCommand}". Use instantly-pull or instantly-webhook-prepare.`);
+  }
   if (subcommand === "templates" || subcommand === "strategy-templates") {
     const flags = parseFlags(argv.slice(1));
     const result = await signaliz.gtm.campaignStrategyTemplates({
@@ -358,7 +458,7 @@ async function handleGtmCommand(signaliz, argv) {
   }
   printGtmHelp();
 }
-async function handleCampaignAgentCommand(signaliz, argv) {
+async function handleCampaignAgentCommand(signalizFactory, argv) {
   const subcommand = argv[0];
   if (!subcommand || subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
     printCampaignAgentHelp();
@@ -366,7 +466,7 @@ async function handleCampaignAgentCommand(signaliz, argv) {
   }
   if (["init", "template", "request-template", "new"].includes(subcommand)) {
     const flags2 = parseFlags(argv.slice(1));
-    const request2 = campaignAgentRequestTemplateFromFlags(flags2);
+    const request2 = await campaignAgentRequestTemplateFromFlags(flags2);
     const outputFile = stringFlag(flags2, "output-file", "out");
     if (outputFile) {
       writeFileSync(outputFile, `${JSON.stringify(request2, null, 2)}
@@ -382,12 +482,13 @@ async function handleCampaignAgentCommand(signaliz, argv) {
   }
   if (["kit", "build-kit", "blueprint"].includes(subcommand)) {
     const flags2 = parseFlags(argv.slice(1));
+    const { createCampaignBuilderBuildKit } = await loadSdk();
     const requestFromFile2 = campaignAgentRequestFileFromFlags(flags2);
     const fallbackGoal = stringFlag(flags2, "goal", "brief") || stringOrUndefined(requestFromFile2?.goal) || "Build a strategy-template campaign for mature operators in the target ICP.";
     const request2 = requestFromFile2 ? mergeCampaignAgentRequests(
       requestFromFile2,
       campaignAgentRequestFromFlags(fallbackGoal, flags2, { includeDefaults: false })
-    ) : campaignAgentRequestTemplateFromFlags(flags2);
+    ) : await campaignAgentRequestTemplateFromFlags(flags2);
     const kit = createCampaignBuilderBuildKit({
       ...request2,
       includeLocalLeads: booleanFlag(flags2, "use-local-leads"),
@@ -412,14 +513,53 @@ async function handleCampaignAgentCommand(signaliz, argv) {
     }
     return;
   }
-  if (["review", "status", "rows", "artifacts", "approve", "approve-delivery"].includes(subcommand)) {
-    await handleCampaignAgentReviewCommand(signaliz, subcommand, argv.slice(1));
+  if (["memory-kit", "seed-kit", "memory"].includes(subcommand)) {
+    const flags2 = parseFlags(argv.slice(1));
+    const { createCampaignBuilderMemoryKit } = await loadSdk();
+    const requestFromFile2 = campaignAgentRequestFileFromFlags(flags2);
+    const fallbackGoal = stringFlag(flags2, "goal", "brief") || stringOrUndefined(requestFromFile2?.goal) || "Build a strategy-template campaign for mature operators in the target ICP.";
+    const request2 = requestFromFile2 ? mergeCampaignAgentRequests(
+      requestFromFile2,
+      campaignAgentRequestFromFlags(fallbackGoal, flags2, { includeDefaults: false })
+    ) : await campaignAgentRequestTemplateFromFlags(flags2);
+    const kit = createCampaignBuilderMemoryKit({
+      ...request2,
+      includeLocalLeads: booleanFlag(flags2, "use-local-leads"),
+      includeCustomToolPlaceholder: booleanFlag(flags2, "with-byo-placeholder") || booleanFlag(flags2, "include-custom-tool-placeholder") || booleanFlag(flags2, "include-byo-placeholder"),
+      includeNango: !booleanFlag(flags2, "no-nango-catalog"),
+      requestFile: stringFlag(flags2, "request-output-file", "request-file-name") || stringFlag(flags2, "request-file") || "campaign-request.json",
+      seedManifestFile: stringFlag(flags2, "seed-manifest-file", "manifest") || ".gtm-kernel-import-state/campaign-memory-dry-run.json",
+      source: stringFlag(flags2, "source", "memory-source", "seed-source"),
+      workspaceId: stringFlag(flags2, "workspace-id"),
+      cliPackage: stringFlag(flags2, "cli-package"),
+      sdkPackage: stringFlag(flags2, "sdk-package")
+    });
+    const outputFile = stringFlag(flags2, "output-file", "kit-file", "out");
+    if (outputFile) {
+      writeFileSync(outputFile, `${JSON.stringify(kit, null, 2)}
+`, "utf8");
+    }
+    if (booleanFlag(flags2, "json")) {
+      printJson(kit);
+    } else if (!outputFile) {
+      printCampaignAgentMemoryKit(kit);
+    } else {
+      console.log(`Campaign memory kit written: ${outputFile}`);
+      console.log(`Next: ${kit.cli_commands.find((command) => command.id === "memory_status")?.command}`);
+    }
     return;
   }
-  if (!["plan", "doctor", "readiness", "preflight", "proof", "smoke", "commit-plan", "dry-run", "build-approved", "launch-approved"].includes(subcommand)) {
+  const isReviewCommand = ["review", "status", "rows", "artifacts", "approve", "approve-delivery"].includes(subcommand);
+  const isPlanCommand = ["plan", "doctor", "readiness", "preflight", "proof", "smoke", "commit-plan", "dry-run", "build-approved", "launch-approved"].includes(subcommand);
+  if (!isReviewCommand && !isPlanCommand) {
     printCampaignAgentHelp();
     return;
   }
+  const signaliz = await signalizFactory();
+  if (isReviewCommand) {
+    await handleCampaignAgentReviewCommand(signaliz, subcommand, argv.slice(1));
+    return;
+  }
   const flags = parseFlags(argv.slice(1));
   const isDoctor = subcommand === "doctor" || subcommand === "readiness" || subcommand === "preflight";
   const requestFromFile = campaignAgentRequestFileFromFlags(flags);
@@ -493,6 +633,7 @@ async function handleCampaignAgentCommand(signaliz, argv) {
   }
   if (isApprovedBuild) {
     const approvedTypes = approvedTypesFromFlags(plan, flags);
+    const { createCampaignBuilderApproval } = await loadSdk();
     const approval = createCampaignBuilderApproval(plan, {
       approvedBy,
       approvedTypes,
@@ -537,6 +678,8 @@ async function handleCampaignAgentReviewCommand(signaliz, subcommand, argv) {
       cursor: stringFlag(flags, "cursor"),
       segment: stringFlag(flags, "segment"),
       rowStatus: stringFlag(flags, "row-status"),
+      includeData: optionalBooleanFlag(flags, "include-data"),
+      includeRaw: optionalBooleanFlag(flags, "include-raw"),
       qualified: booleanFlag(flags, "qualified") ? true : booleanFlag(flags, "disqualified") ? false : void 0
     });
     const operatorReview = {
@@ -568,6 +711,8 @@ async function handleCampaignAgentReviewCommand(signaliz, subcommand, argv) {
       cursor: stringFlag(flags, "cursor"),
       segment: stringFlag(flags, "segment"),
       rowStatus: stringFlag(flags, "row-status"),
+      includeData: optionalBooleanFlag(flags, "include-data"),
+      includeRaw: optionalBooleanFlag(flags, "include-raw"),
       qualified: booleanFlag(flags, "qualified") ? true : booleanFlag(flags, "disqualified") ? false : void 0
     });
     const operatorResult = {
@@ -611,7 +756,7 @@ async function handleCampaignAgentReviewCommand(signaliz, subcommand, argv) {
     if (result.message) console.log(result.message);
   }
 }
-function campaignAgentRequestTemplateFromFlags(flags) {
+async function campaignAgentRequestTemplateFromFlags(flags) {
   const goal = stringFlag(flags, "goal", "brief") || "Build a strategy-template campaign for mature operators in the target ICP.";
   const request = campaignAgentRequestFromFlags(goal, flags, { includeDefaults: true });
   const options = {
@@ -620,6 +765,7 @@ function campaignAgentRequestTemplateFromFlags(flags) {
     includeCustomToolPlaceholder: booleanFlag(flags, "with-byo-placeholder") || booleanFlag(flags, "include-custom-tool-placeholder") || booleanFlag(flags, "include-byo-placeholder"),
     includeNango: !booleanFlag(flags, "no-nango-catalog")
   };
+  const { createCampaignBuilderAgentRequestTemplate } = await loadSdk();
   return createCampaignBuilderAgentRequestTemplate(options);
 }
 function campaignAgentRequestFileFromFlags(flags) {
@@ -876,6 +1022,11 @@ function booleanFlag(flags, name, defaultValue = false) {
   if (Array.isArray(value)) return value.length > 0 ? parseBoolean(value.at(-1), defaultValue) : defaultValue;
   return parseBoolean(value, defaultValue);
 }
+function optionalBooleanFlag(flags, trueName, falseName) {
+  if (falseName && flagValue(flags, falseName) !== void 0) return false;
+  if (flagValue(flags, trueName) === void 0) return void 0;
+  return booleanFlag(flags, trueName);
+}
 function parseBoolean(value, defaultValue) {
   if (value === void 0) return defaultValue;
   if (typeof value === "boolean") return value;
@@ -957,6 +1108,26 @@ function printCampaignAgentBuildKit(kit) {
   console.log("\nNext:");
   for (const action of kit.next_actions.slice(0, 4)) console.log(`- ${action}`);
 }
+function printCampaignAgentMemoryKit(kit) {
+  console.log(`Campaign memory kit: ${kit.strategy_template || "custom strategy"}`);
+  console.log(`Request file: ${kit.request_file}`);
+  console.log(`Seed manifest: ${kit.seed_manifest_file}`);
+  console.log(`Sources: ${kit.memory_sources.map((source) => source.id).join(", ") || "none"}`);
+  console.log(`Playbooks: ${kit.operating_playbooks.join(", ") || "none"}`);
+  console.log("\nCLI:");
+  for (const command of kit.cli_commands.slice(0, 4)) {
+    console.log(`- ${command.label}: ${command.command}`);
+  }
+  console.log("\nMCP:");
+  for (const call of kit.mcp_calls.slice(0, 3)) {
+    console.log(`- ${call.tool}: ${call.safety}`);
+  }
+  console.log("\nSeed runner:");
+  console.log(`- Dry run: ${kit.seed_runner.dry_run_command}`);
+  if (kit.seed_runner.verify_manifest_command) console.log(`- Verify: ${kit.seed_runner.verify_manifest_command}`);
+  console.log("\nNext:");
+  for (const action of kit.next_actions.slice(0, 4)) console.log(`- ${action}`);
+}
 function printCampaignAgentExecution(payload, flags) {
   if (booleanFlag(flags, "json")) {
     printJson(payload);
@@ -1005,7 +1176,9 @@ function printCampaignAgentBuildStatus(status) {
   console.log(`Status: ${status.status}`);
   console.log(`Phase: ${status.currentPhase || "N/A"}`);
   console.log(`Rows: ${status.recordsSucceeded}/${status.recordsTotal} succeeded, ${status.recordsFailed} failed`);
+  printCampaignCustomerRowCounts(status);
   console.log(`Artifacts: ${status.artifactCount}`);
+  if (status.campaignBuildId) printCampaignArtifactDownload(status, status.campaignBuildId);
   if (status.triggerRunId) console.log(`Trigger: ${status.triggerRunId}`);
   if (Array.isArray(status.warnings) && status.warnings.length > 0) {
     console.log(`Warnings: ${status.warnings.slice(0, 3).join("; ")}`);
@@ -1013,12 +1186,34 @@ function printCampaignAgentBuildStatus(status) {
   if (Array.isArray(status.errors) && status.errors.length > 0) {
     console.log(`Errors: ${status.errors.slice(0, 3).join("; ")}`);
   }
-  if (status.status === "completed") {
+  if (status.status === "completed" && status.nextAction) {
+    console.log(`Next: ${status.nextAction}`);
+  } else if (status.status === "completed") {
     console.log(`Next: signaliz campaign-agent rows ${status.campaignBuildId} --limit 100`);
+  } else if (status.status === "pending_approval" && status.approvalAction) {
+    console.log(`Next: ${status.approvalAction}`);
+  } else if (status.status === "pending_approval" && status.nextAction) {
+    console.log(`Next: ${status.nextAction}`);
   } else if (status.status === "pending_approval") {
     console.log(`Next: signaliz campaign-agent approve ${status.campaignBuildId} --destination-type webhook`);
   }
 }
+function printCampaignCustomerRowCounts(status) {
+  const counts = status?.customerRowCounts || status?.customer_row_counts;
+  if (!counts || typeof counts !== "object") return;
+  const value = (camel, snake) => counts[camel] ?? counts[snake] ?? "n/a";
+  const requested = value("requestedTarget", "requested_target");
+  console.log(`Customer rows: accepted ${value("acceptedRows", "accepted_rows")}/${requested}, copied ${value("copiedRows", "copied_rows")}, approval-ready ${value("approvalReadyRows", "approval_ready_rows")}, QA-ready ${value("qaReadyRows", "qa_ready_rows")}, delivered ${value("deliveredRows", "delivered_rows")}`);
+  const shortfalls = [
+    ["accepted", value("acceptedShortfall", "accepted_shortfall")],
+    ["usable", value("usableShortfall", "usable_shortfall")],
+    ["QA-ready", value("qaReadyShortfall", "qa_ready_shortfall")],
+    ["delivery", value("deliveryShortfall", "delivery_shortfall")]
+  ].filter(([, count]) => typeof count === "number" && count > 0);
+  if (shortfalls.length > 0) {
+    console.log(`Shortfalls: ${shortfalls.map(([label, count]) => `${label} ${count}`).join(", ")}`);
+  }
+}
 function printCampaignAgentBuildReview(review) {
   const summary = asRecord(review.summary);
   console.log(`Campaign: ${review.status?.name || review.campaignBuildId}`);
@@ -1029,6 +1224,7 @@ function printCampaignAgentBuildReview(review) {
   console.log(`Emails: ${summary.rowsWithEmail || 0}`);
   console.log(`Copy ready: ${summary.copyReadyRows || 0}`);
   console.log(`Artifacts: ${summary.artifactCount || 0}`);
+  if (review.campaignBuildId) printCampaignArtifactDownload(review.status, review.campaignBuildId);
   console.log(`Delivery approval ready: ${summary.readyForDeliveryApproval === true ? "yes" : "no"}`);
   if (Array.isArray(review.gates) && review.gates.length > 0) {
     console.log("\nGates:");
@@ -1050,6 +1246,14 @@ function printCampaignAgentBuildReview(review) {
 function formatCampaignAgentRows(rows) {
   return rows.map((row) => {
     const data = asRecord(row.data);
+    const copyData = asRecord(data.copy);
+    const rawCopy = asRecord(data.raw_copy);
+    const copy = {
+      subject: data.subject || copyData.subject || rawCopy.subject || null,
+      opener: data.opener || copyData.opener || rawCopy.opener || null,
+      body: data.body || copyData.body || rawCopy.body || null,
+      cta: data.cta || copyData.cta || rawCopy.cta || null
+    };
     const fallbackName = `${data.first_name || ""} ${data.last_name || ""}`.trim() || null;
     return {
       ...row,
@@ -1059,7 +1263,8 @@ function formatCampaignAgentRows(rows) {
       company: data.company_name ?? null,
       domain: data.company_domain ?? null,
       score: data.overall_score ?? null,
-      has_copy: Boolean(data.subject || data.opener || data.body || data.cta || asRecord(data.raw_copy).subject)
+      copy,
+      has_copy: Boolean(copy.subject || copy.opener || copy.body || copy.cta)
     };
   });
 }
@@ -1077,9 +1282,41 @@ function printCampaignAgentRows(result) {
     segment: row.segment || "",
     score: row.score ?? ""
   })));
+  printCampaignAgentCopySnippets(result.rows);
   console.log(`Showing ${result.rows.length} row(s)${result.hasMore ? " (more available)" : ""}`);
   if (result.nextCursor) console.log(`Next: signaliz campaign-agent rows ${result.campaignBuildId} --cursor ${result.nextCursor}`);
 }
+function printCampaignArtifactDownload(status, buildId) {
+  const downloads = Array.isArray(status?.artifactDownloads) ? status.artifactDownloads : Array.isArray(status?.artifact_downloads) ? status.artifact_downloads : [];
+  const download = downloads.find((item) => String(item?.format || item?.artifactType || item?.artifact_type || "").toLowerCase() === "csv") || downloads[0];
+  const url = download?.downloadUrl || download?.download_url || download?.signedUrl || download?.signed_url;
+  if (typeof url === "string" && url.trim()) {
+    const format = download?.format || download?.artifactType || download?.artifact_type || "artifact";
+    const rowCount = Number(download?.rowCount ?? download?.row_count ?? 0);
+    console.log(`Download: ${format}${rowCount > 0 ? `, ${rowCount} rows` : ""}`);
+    console.log(`  ${url}`);
+  } else if (Number(status?.artifactCount ?? status?.artifact_count ?? 0) > 0) {
+    console.log(`Next: signaliz campaign download ${buildId} --format csv`);
+  }
+}
+function printCampaignAgentCopySnippets(rows, limit = 5) {
+  const rowsWithCopy = rows.filter((row) => {
+    const copy = asRecord(row.copy);
+    return Boolean(copy.subject || copy.opener || copy.body || copy.cta);
+  });
+  if (rowsWithCopy.length === 0) return;
+  console.log("\nCopy:");
+  for (const row of rowsWithCopy.slice(0, limit)) {
+    const copy = asRecord(row.copy);
+    const label = row.email || row.name || row.company || `row ${row.index ?? ""}`.trim();
+    console.log(`- ${label}`);
+    if (copy.subject) console.log(`  Subject: ${copy.subject}`);
+    if (copy.opener) console.log(`  Opener: ${copy.opener}`);
+    if (copy.body) console.log(`  Body: ${copy.body}`);
+    if (copy.cta) console.log(`  CTA: ${copy.cta}`);
+  }
+  if (rowsWithCopy.length > limit) console.log(`  ...${rowsWithCopy.length - limit} more row(s) with copy`);
+}
 function asRecord(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
@@ -1115,8 +1352,11 @@ Usage:
   signaliz gtm agent-plan --goal "Build a strategy-template campaign" --strategy-template non-medical-home-care --target-count 500 --json
   signaliz gtm provider-prepare --provider-id customer_mcp --layer company_enrichment --invocation-type mcp_tool --json
   signaliz gtm memory search --query "proof-first vertical gate" --json
+  signaliz gtm feedback instantly-pull --campaign-id <id> --source emails --email-type received --mode emode_all --sort-order asc --confirm-write --json
+  signaliz gtm learning status --campaign-id <id> --json
   signaliz gtm plan --brief "Build 500 verified leads for..." --strategy-template non-medical-home-care --lead-count 500 --json
   signaliz campaign-agent init --strategy-template non-medical-home-care --target-count 250 --use-local-leads --json > campaign-request.json
+  signaliz campaign-agent memory-kit --strategy-template non-medical-home-care --target-count 250 --use-local-leads --json
   signaliz campaign-agent doctor --request-file campaign-request.json --json
   signaliz campaign-agent plan --goal "Build a strategy-template campaign..." --strategy-template industrial-ot-resilience --target-count 500 --builtins lead_generation,email_finding,email_verification,signals
   signaliz campaign-agent proof --goal "Build a strategy-template campaign..." --strategy-template non-medical-home-care --target-count 100 --json
@@ -1146,6 +1386,9 @@ Signaliz GTM commands:
   signaliz gtm provider-prepare --provider-id ID [--layer NAME] [--invocation-type webhook|mcp_tool|api] [--json]
   signaliz gtm activate-route --provider-id ID --layer NAME [--confirm] [--json]
   signaliz gtm memory search --query TEXT [--layers a,b] [--provider-chain a,b] [--limit N] [--json]
+  signaliz gtm learning status (--campaign-id ID | --campaign-build-id ID) [--json]
+  signaliz gtm feedback instantly-pull (--campaign-id ID | --provider-link-id ID | --provider-campaign-id ID) [--source webhook_events|emails] [--email-type received|sent|manual] [--mode emode_focused|emode_others|emode_all] [--sort-order asc|desc] [--instantly-profile PROFILE] [--confirm-write] [--json]
+  signaliz gtm feedback instantly-webhook-prepare (--campaign-id ID | --provider-link-id ID) --confirm-write [--json]
   signaliz gtm plan --brief TEXT [--strategy-template industrial-ot-resilience|non-medical-home-care|agency-founder-led|cloud-infrastructure-displacement] [--lead-count N] [--layers a,b] [--providers a,b] [--partners clay,instantly,nango] [--target-icp JSON] [--json]
 `);
 }
@@ -1155,15 +1398,16 @@ Signaliz campaign-agent commands:
 
   signaliz campaign-agent init [--goal TEXT] [--strategy-template ID] [--target-count N] [--use-local-leads] [--with-byo-placeholder] [--output-file FILE] [--json]
   signaliz campaign-agent kit [--goal TEXT | --request-file FILE] [--strategy-template ID] [--target-count N] [--use-local-leads] [--custom-tool provider:layer:tool[:mcp]] [--output-file FILE] [--json]
+  signaliz campaign-agent memory-kit [--goal TEXT | --request-file FILE] [--strategy-template ID] [--source north-star|agency|workflow-patterns|instantly-feedback|all] [--seed-manifest-file FILE] [--json]
   signaliz campaign-agent doctor [--goal TEXT | --request-file FILE] [--strategy-template ID] [--target-count N] [--builtins lead_generation,email_finding,email_verification,signals,local_leads] [--custom-tool provider:layer:tool[:mcp]] [--json]
   signaliz campaign-agent plan (--goal TEXT | --request-file FILE) [--campaign-name NAME] [--workspace-label NAME] [--strategy-template industrial-ot-resilience|non-medical-home-care|agency-founder-led|cloud-infrastructure-displacement] [--operating-playbooks proof-first-vertical-gate,signal-led-copy-approval] [--target-count N] [--icp JSON] [--builtins lead_generation,email_finding,email_verification,signals,local_leads] [--use-local-leads] [--custom-tool provider:layer:tool[:mcp]] [--preferred-providers signaliz_native,octave] [--partners clay,instantly,nango] [--no-strategy-memory] [--no-kernel-plan] [--no-delivery-risk] [--json]
   signaliz campaign-agent proof (--goal TEXT | --request-file FILE) [--strategy-template ID] [--target-count N] [--use-local-leads] [--custom-tool provider:layer:tool[:mcp]] [--idempotency-key KEY] [--json]
   signaliz campaign-agent commit-plan (--goal TEXT | --request-file FILE) [--confirm-write --approved-by EMAIL] [--idempotency-key KEY] [--json]
   signaliz campaign-agent dry-run (--goal TEXT | --request-file FILE) [--gtm-campaign-id ID] [--delivery-risk JSON] [--idempotency-key KEY] [--json]
   signaliz campaign-agent build-approved (--goal TEXT | --request-file FILE) --confirm-launch --approved-by EMAIL (--approve-all | --approved-types a,b) [--commit-before-launch] [--spend-limit N] [--approved-route-ids a,b] [--wait] [--approve-delivery] [--delivery-destination-type json|csv|webhook] [--idempotency-key KEY] [--json]
-  signaliz campaign-agent review <campaign_build_id> [--limit N] [--qualified|--disqualified] [--json]
+  signaliz campaign-agent review <campaign_build_id> [--limit N] [--qualified|--disqualified] [--include-data] [--include-raw] [--json]
   signaliz campaign-agent status <campaign_build_id> [--json]
-  signaliz campaign-agent rows <campaign_build_id> [--limit N] [--cursor CURSOR] [--qualified|--disqualified] [--json]
+  signaliz campaign-agent rows <campaign_build_id> [--limit N] [--cursor CURSOR] [--qualified|--disqualified] [--include-data] [--include-raw] [--json]
   signaliz campaign-agent artifacts <campaign_build_id> [--json]
   signaliz campaign-agent approve <campaign_build_id> --destination-type json|csv|webhook [--destination-config JSON] [--json]