@signaliz/sdk 1.0.11 → 1.0.12

package/README.md

@@ -100,12 +100,16 @@ console.log(plan.mcpFlow.filter((step) =>
 ));
 
 // After an approved launch, keep review and delivery in the agent surface.
+const review = await signaliz.campaignBuilderAgent.reviewBuild('campaign_build_id', {
+  limit: 100,
+});
 const finalStatus = await signaliz.campaignBuilderAgent.getBuildStatus('campaign_build_id');
 const reviewRows = await signaliz.campaignBuilderAgent.getBuildRows('campaign_build_id', {
   limit: 100,
   qualified: true,
 });
 const artifacts = await signaliz.campaignBuilderAgent.listBuildArtifacts('campaign_build_id');
+console.log(review.summary.readyForDeliveryApproval);
 ```
 
 The CLI can run the same request shape from a reusable JSON file, with flags
@@ -125,6 +129,7 @@ npx @signaliz/sdk campaign-agent plan \
   --json
 
 npx @signaliz/sdk campaign-agent status campaign_build_id --json
+npx @signaliz/sdk campaign-agent review campaign_build_id --limit 100 --json
 npx @signaliz/sdk campaign-agent rows campaign_build_id --limit 100 --json
 ```
 

package/dist/{chunk-QQW6DZQ4.mjs → chunk-XJQ6KGNQ.mjs}

@@ -1874,6 +1874,15 @@ var CampaignBuilderAgent = class {
   async approveDelivery(campaignBuildId, destinationType, options) {
     return this.approveCampaignDelivery(campaignBuildId, destinationType, options);
   }
+  async reviewBuild(campaignBuildId, options = {}) {
+    const status = await this.getBuildStatus(campaignBuildId);
+    const rows = await this.getBuildRows(campaignBuildId, {
+      ...options,
+      limit: options.limit ?? 100
+    });
+    const artifacts = await this.listBuildArtifacts(campaignBuildId);
+    return createCampaignBuilderBuildReview(status, rows, artifacts);
+  }
   async getCampaignBuildStatus(campaignBuildId) {
     const data = await this.callMcp("get_campaign_build_status", {
       campaign_build_id: campaignBuildId
@@ -3301,6 +3310,120 @@ function mapAgentCampaignArtifact(data) {
     createdAt: stringValue(data.created_at) ?? ""
   };
 }
+function createCampaignBuilderBuildReview(status, rows, artifacts) {
+  const sampledRows = rows.rows.length;
+  const availableRows = rows.count || sampledRows;
+  const qualifiedRows = rows.rows.filter((row) => row.qualified !== false).length;
+  const rowsWithEmail = rows.rows.filter(campaignReviewRowHasEmail).length;
+  const copyReadyRows = rows.rows.filter(campaignReviewRowHasCopy).length;
+  const artifactCount = artifacts.length || status.artifactCount || 0;
+  const gates = [
+    {
+      id: "build_completed",
+      label: "Build completed",
+      passed: status.status === "completed",
+      detail: status.status === "completed" ? "The campaign build is completed." : `The campaign build is ${status.status}; review again after completion.`
+    },
+    {
+      id: "rows_available",
+      label: "Rows available",
+      passed: sampledRows > 0,
+      detail: sampledRows > 0 ? `${sampledRows} sampled row(s) are available for review.` : "No rows were returned for review."
+    },
+    {
+      id: "qualified_sample",
+      label: "Sample rows qualified",
+      passed: sampledRows > 0 && qualifiedRows === sampledRows,
+      detail: sampledRows > 0 ? `${qualifiedRows}/${sampledRows} sampled row(s) are marked qualified.` : "Qualification could not be checked without sampled rows."
+    },
+    {
+      id: "email_coverage",
+      label: "Email coverage",
+      passed: sampledRows > 0 && rowsWithEmail === sampledRows,
+      detail: sampledRows > 0 ? `${rowsWithEmail}/${sampledRows} sampled row(s) include an email.` : "Email coverage could not be checked without sampled rows."
+    },
+    {
+      id: "artifact_available",
+      label: "Artifact available",
+      passed: artifactCount > 0,
+      detail: artifactCount > 0 ? `${artifactCount} artifact(s) are available.` : "No delivery artifact is available yet."
+    },
+    {
+      id: "no_failed_rows",
+      label: "No failed rows",
+      passed: status.recordsFailed === 0,
+      detail: status.recordsFailed === 0 ? "The build reports zero failed rows." : `${status.recordsFailed} row(s) failed during the build.`
+    }
+  ];
+  const blockedReasons = gates.filter((gate) => !gate.passed).map((gate) => gate.detail);
+  const warnings = [
+    rows.hasMore ? "This review is based on a row sample; page through remaining rows before final approval." : void 0,
+    sampledRows > 0 && copyReadyRows < sampledRows ? `${copyReadyRows}/${sampledRows} sampled row(s) include generated copy.` : void 0,
+    ...status.warnings
+  ].filter((item) => Boolean(item));
+  const readyForDeliveryApproval = blockedReasons.length === 0;
+  return {
+    campaignBuildId: status.campaignBuildId || rows.campaignBuildId,
+    status,
+    rows,
+    artifacts,
+    gates,
+    summary: {
+      status: status.status,
+      phase: status.currentPhase,
+      sampledRows,
+      availableRows,
+      qualifiedRows,
+      rowsWithEmail,
+      copyReadyRows,
+      artifactCount,
+      readyForDeliveryApproval,
+      blockedReasons,
+      warnings
+    },
+    nextActions: campaignReviewNextActions(status, readyForDeliveryApproval)
+  };
+}
+function campaignReviewNextActions(status, readyForDeliveryApproval) {
+  const buildId = status.campaignBuildId;
+  if (!buildId) return [];
+  if (status.status === "completed" && readyForDeliveryApproval) {
+    return [
+      `signaliz campaign-agent approve ${buildId} --destination-type json`,
+      `signaliz campaign-agent artifacts ${buildId}`
+    ];
+  }
+  if (status.status === "completed") {
+    return [
+      `signaliz campaign-agent rows ${buildId} --limit 100`,
+      `signaliz campaign-agent artifacts ${buildId}`
+    ];
+  }
+  if (status.status === "pending_approval") {
+    return [
+      `signaliz campaign-agent rows ${buildId} --limit 100`,
+      `signaliz campaign-agent approve ${buildId} --destination-type json`
+    ];
+  }
+  if ((status.status === "queued" || status.status === "running") && status.triggerRunId) {
+    return [`signaliz ops run-status ${status.triggerRunId} --watch`];
+  }
+  return [`signaliz campaign-agent status ${buildId}`];
+}
+function campaignReviewRowHasEmail(row) {
+  const data = asRecord(row.data);
+  return Boolean(
+    stringValue(data.email) || stringValue(data.work_email) || stringValue(data.workEmail)
+  );
+}
+function campaignReviewRowHasCopy(row) {
+  const data = asRecord(row.data);
+  const copy = asRecord(data.copy);
+  const rawCopy = asRecord(data.raw_copy ?? data.rawCopy);
+  return row.status === "copy_ready" || data.copy_ready === true || Boolean(
+    stringValue(data.subject) || stringValue(data.subject_line) || stringValue(data.subjectLine) || stringValue(data.opener) || stringValue(data.body) || stringValue(data.cta) || stringValue(copy.subject) || stringValue(copy.body) || stringValue(rawCopy.subject) || stringValue(rawCopy.body)
+  );
+}
 function diagnosticMessages2(value) {
   if (!Array.isArray(value)) return [];
   return value.map((item) => {

package/dist/cli.js

@@ -1880,6 +1880,15 @@ var CampaignBuilderAgent = class {
   async approveDelivery(campaignBuildId, destinationType, options) {
     return this.approveCampaignDelivery(campaignBuildId, destinationType, options);
   }
+  async reviewBuild(campaignBuildId, options = {}) {
+    const status = await this.getBuildStatus(campaignBuildId);
+    const rows = await this.getBuildRows(campaignBuildId, {
+      ...options,
+      limit: options.limit ?? 100
+    });
+    const artifacts = await this.listBuildArtifacts(campaignBuildId);
+    return createCampaignBuilderBuildReview(status, rows, artifacts);
+  }
   async getCampaignBuildStatus(campaignBuildId) {
     const data = await this.callMcp("get_campaign_build_status", {
       campaign_build_id: campaignBuildId
@@ -3307,6 +3316,120 @@ function mapAgentCampaignArtifact(data) {
     createdAt: stringValue(data.created_at) ?? ""
   };
 }
+function createCampaignBuilderBuildReview(status, rows, artifacts) {
+  const sampledRows = rows.rows.length;
+  const availableRows = rows.count || sampledRows;
+  const qualifiedRows = rows.rows.filter((row) => row.qualified !== false).length;
+  const rowsWithEmail = rows.rows.filter(campaignReviewRowHasEmail).length;
+  const copyReadyRows = rows.rows.filter(campaignReviewRowHasCopy).length;
+  const artifactCount = artifacts.length || status.artifactCount || 0;
+  const gates = [
+    {
+      id: "build_completed",
+      label: "Build completed",
+      passed: status.status === "completed",
+      detail: status.status === "completed" ? "The campaign build is completed." : `The campaign build is ${status.status}; review again after completion.`
+    },
+    {
+      id: "rows_available",
+      label: "Rows available",
+      passed: sampledRows > 0,
+      detail: sampledRows > 0 ? `${sampledRows} sampled row(s) are available for review.` : "No rows were returned for review."
+    },
+    {
+      id: "qualified_sample",
+      label: "Sample rows qualified",
+      passed: sampledRows > 0 && qualifiedRows === sampledRows,
+      detail: sampledRows > 0 ? `${qualifiedRows}/${sampledRows} sampled row(s) are marked qualified.` : "Qualification could not be checked without sampled rows."
+    },
+    {
+      id: "email_coverage",
+      label: "Email coverage",
+      passed: sampledRows > 0 && rowsWithEmail === sampledRows,
+      detail: sampledRows > 0 ? `${rowsWithEmail}/${sampledRows} sampled row(s) include an email.` : "Email coverage could not be checked without sampled rows."
+    },
+    {
+      id: "artifact_available",
+      label: "Artifact available",
+      passed: artifactCount > 0,
+      detail: artifactCount > 0 ? `${artifactCount} artifact(s) are available.` : "No delivery artifact is available yet."
+    },
+    {
+      id: "no_failed_rows",
+      label: "No failed rows",
+      passed: status.recordsFailed === 0,
+      detail: status.recordsFailed === 0 ? "The build reports zero failed rows." : `${status.recordsFailed} row(s) failed during the build.`
+    }
+  ];
+  const blockedReasons = gates.filter((gate) => !gate.passed).map((gate) => gate.detail);
+  const warnings = [
+    rows.hasMore ? "This review is based on a row sample; page through remaining rows before final approval." : void 0,
+    sampledRows > 0 && copyReadyRows < sampledRows ? `${copyReadyRows}/${sampledRows} sampled row(s) include generated copy.` : void 0,
+    ...status.warnings
+  ].filter((item) => Boolean(item));
+  const readyForDeliveryApproval = blockedReasons.length === 0;
+  return {
+    campaignBuildId: status.campaignBuildId || rows.campaignBuildId,
+    status,
+    rows,
+    artifacts,
+    gates,
+    summary: {
+      status: status.status,
+      phase: status.currentPhase,
+      sampledRows,
+      availableRows,
+      qualifiedRows,
+      rowsWithEmail,
+      copyReadyRows,
+      artifactCount,
+      readyForDeliveryApproval,
+      blockedReasons,
+      warnings
+    },
+    nextActions: campaignReviewNextActions(status, readyForDeliveryApproval)
+  };
+}
+function campaignReviewNextActions(status, readyForDeliveryApproval) {
+  const buildId = status.campaignBuildId;
+  if (!buildId) return [];
+  if (status.status === "completed" && readyForDeliveryApproval) {
+    return [
+      `signaliz campaign-agent approve ${buildId} --destination-type json`,
+      `signaliz campaign-agent artifacts ${buildId}`
+    ];
+  }
+  if (status.status === "completed") {
+    return [
+      `signaliz campaign-agent rows ${buildId} --limit 100`,
+      `signaliz campaign-agent artifacts ${buildId}`
+    ];
+  }
+  if (status.status === "pending_approval") {
+    return [
+      `signaliz campaign-agent rows ${buildId} --limit 100`,
+      `signaliz campaign-agent approve ${buildId} --destination-type json`
+    ];
+  }
+  if ((status.status === "queued" || status.status === "running") && status.triggerRunId) {
+    return [`signaliz ops run-status ${status.triggerRunId} --watch`];
+  }
+  return [`signaliz campaign-agent status ${buildId}`];
+}
+function campaignReviewRowHasEmail(row) {
+  const data = asRecord(row.data);
+  return Boolean(
+    stringValue(data.email) || stringValue(data.work_email) || stringValue(data.workEmail)
+  );
+}
+function campaignReviewRowHasCopy(row) {
+  const data = asRecord(row.data);
+  const copy = asRecord(data.copy);
+  const rawCopy = asRecord(data.raw_copy ?? data.rawCopy);
+  return row.status === "copy_ready" || data.copy_ready === true || Boolean(
+    stringValue(data.subject) || stringValue(data.subject_line) || stringValue(data.subjectLine) || stringValue(data.opener) || stringValue(data.body) || stringValue(data.cta) || stringValue(copy.subject) || stringValue(copy.body) || stringValue(rawCopy.subject) || stringValue(rawCopy.body)
+  );
+}
 function diagnosticMessages2(value) {
   if (!Array.isArray(value)) return [];
   return value.map((item) => {
@@ -6680,7 +6803,7 @@ async function handleCampaignAgentCommand(signaliz, argv) {
     }
     return;
   }
-  if (["status", "rows", "artifacts", "approve", "approve-delivery"].includes(subcommand)) {
+  if (["review", "status", "rows", "artifacts", "approve", "approve-delivery"].includes(subcommand)) {
     await handleCampaignAgentReviewCommand(signaliz, subcommand, argv.slice(1));
     return;
   }
@@ -6787,6 +6910,28 @@ async function handleCampaignAgentReviewCommand(signaliz, subcommand, argv) {
   const flags = parseFlags(argv);
   const buildId = argv[0] && !argv[0].startsWith("--") ? argv[0] : stringFlag(flags, "campaign-build-id", "build-id");
   if (!buildId) throw new Error(`campaign-agent ${subcommand} requires <campaign_build_id> or --campaign-build-id`);
+  if (subcommand === "review") {
+    const review = await signaliz.campaignBuilderAgent.reviewBuild(buildId, {
+      limit: numberFlag(flags, "limit") ?? 100,
+      cursor: stringFlag(flags, "cursor"),
+      segment: stringFlag(flags, "segment"),
+      rowStatus: stringFlag(flags, "row-status"),
+      qualified: booleanFlag(flags, "qualified") ? true : booleanFlag(flags, "disqualified") ? false : void 0
+    });
+    const operatorReview = {
+      ...review,
+      rows: {
+        ...review.rows,
+        rows: formatCampaignAgentRows(review.rows.rows)
+      }
+    };
+    if (booleanFlag(flags, "json")) {
+      printJson(operatorReview);
+    } else {
+      printCampaignAgentBuildReview(operatorReview);
+    }
+    return;
+  }
   if (subcommand === "status") {
     const status = await signaliz.campaignBuilderAgent.getBuildStatus(buildId);
     if (booleanFlag(flags, "json")) {
@@ -7201,6 +7346,34 @@ function printCampaignAgentBuildStatus(status) {
     console.log(`Next: signaliz campaign-agent approve ${status.campaignBuildId} --destination-type webhook`);
   }
 }
+function printCampaignAgentBuildReview(review) {
+  const summary = asRecord4(review.summary);
+  console.log(`Campaign: ${review.status?.name || review.campaignBuildId}`);
+  console.log(`Status: ${summary.status || review.status?.status}`);
+  console.log(`Phase: ${summary.phase || review.status?.currentPhase || "N/A"}`);
+  console.log(`Rows: ${summary.sampledRows || 0} sampled, ${summary.availableRows || 0} available`);
+  console.log(`Qualified: ${summary.qualifiedRows || 0}`);
+  console.log(`Emails: ${summary.rowsWithEmail || 0}`);
+  console.log(`Copy ready: ${summary.copyReadyRows || 0}`);
+  console.log(`Artifacts: ${summary.artifactCount || 0}`);
+  console.log(`Delivery approval ready: ${summary.readyForDeliveryApproval === true ? "yes" : "no"}`);
+  if (Array.isArray(review.gates) && review.gates.length > 0) {
+    console.log("\nGates:");
+    for (const gate of review.gates) {
+      console.log(`- ${gate.passed ? "PASS" : "BLOCKED"} ${gate.label}: ${gate.detail}`);
+    }
+  }
+  const warnings = Array.isArray(summary.warnings) ? summary.warnings : [];
+  if (warnings.length > 0) {
+    console.log("\nWarnings:");
+    for (const warning of warnings.slice(0, 5)) console.log(`- ${warning}`);
+  }
+  const nextActions = Array.isArray(review.nextActions) ? review.nextActions : [];
+  if (nextActions.length > 0) {
+    console.log("\nNext:");
+    for (const action of nextActions) console.log(`- ${action}`);
+  }
+}
 function formatCampaignAgentRows(rows) {
   return rows.map((row) => {
     const data = asRecord4(row.data);
@@ -7410,6 +7583,7 @@ Usage:
   signaliz campaign-agent dry-run --goal "Build a strategy-template campaign..." --target-count 500 --use-local-leads --json
   signaliz campaign-agent build-approved --goal "Build a strategy-template campaign..." --confirm-launch --approve-all --approved-by you@example.com --spend-limit 500
   signaliz campaign-agent build-approved --request-file campaign-request.json --confirm-launch --approve-all --approved-by you@example.com --spend-limit 500 --wait --approve-delivery --delivery-destination-type json
+  signaliz campaign-agent review <campaign_build_id> --limit 100 --json
   signaliz campaign-agent status <campaign_build_id> --json
   signaliz campaign-agent rows <campaign_build_id> --limit 100 --json
 
@@ -7443,12 +7617,13 @@ Signaliz campaign-agent commands:
   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 status <campaign_build_id> [--json]
   signaliz campaign-agent rows <campaign_build_id> [--limit N] [--cursor CURSOR] [--qualified|--disqualified] [--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]
 
-The init command emits a reusable JSON CampaignBuilderAgentRequest. The plan command composes an approval-gated strategy-template MCP flow. Proof runs the same plan path plus build_campaign dry_run=true and returns a no-spend receipt. Use --request-file to load a reusable request, then override fields such as --target-count or --strategy-template from the command line. Use --strategy-template to merge a private-safe strategy pattern into the plan without exposing private account labels, and --operating-playbooks to add reusable build-loop gates such as proof-first vertical qualification, net-new suppression, cache-first inventory, and signal-led copy approval. Built-ins map to Signaliz-native tools: lead_generation -> generate_leads, local_leads -> generate_local_leads, email_finding -> find_and_verify_emails, email_verification -> verify_emails, signals -> enrich_company_signals. Add BYO tools with --custom-tool provider:layer:tool[:mcp] or key=value pairs such as provider=apollo,layer=source,tool=apollo_search,mcp=apollo. Use --no-strategy-patterns or --no-workflow-patterns to disable default private strategy memory hints. Commit-plan dry-runs by default and writes only with --confirm-write plus approval identity. Dry-run executes build_campaign with dry_run=true. Approved build requires explicit launch confirmation and approval metadata; add --commit-before-launch to persist the reviewed plan as a GTM campaign before launch, --wait to poll until completion or pending approval, and --approve-delivery to approve reviewed webhook delivery after pending_approval. Use status, rows, and artifacts to inspect the finished campaign-agent build before routing rows to external tools.
+The init command emits a reusable JSON CampaignBuilderAgentRequest. The plan command composes an approval-gated strategy-template MCP flow. Proof runs the same plan path plus build_campaign dry_run=true and returns a no-spend receipt. Use --request-file to load a reusable request, then override fields such as --target-count or --strategy-template from the command line. Use --strategy-template to merge a private-safe strategy pattern into the plan without exposing private account labels, and --operating-playbooks to add reusable build-loop gates such as proof-first vertical qualification, net-new suppression, cache-first inventory, and signal-led copy approval. Built-ins map to Signaliz-native tools: lead_generation -> generate_leads, local_leads -> generate_local_leads, email_finding -> find_and_verify_emails, email_verification -> verify_emails, signals -> enrich_company_signals. Add BYO tools with --custom-tool provider:layer:tool[:mcp] or key=value pairs such as provider=apollo,layer=source,tool=apollo_search,mcp=apollo. Use --no-strategy-patterns or --no-workflow-patterns to disable default private strategy memory hints. Commit-plan dry-runs by default and writes only with --confirm-write plus approval identity. Dry-run executes build_campaign with dry_run=true. Approved build requires explicit launch confirmation and approval metadata; add --commit-before-launch to persist the reviewed plan as a GTM campaign before launch, --wait to poll until completion or pending approval, and --approve-delivery to approve reviewed webhook delivery after pending_approval. Use review to inspect status, sampled rows, artifacts, and delivery-readiness gates before approving delivery or routing rows to external tools.
 `);
 }
 main().catch((e) => {

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   Signaliz,
   createCampaignBuilderAgentRequestTemplate,
   createCampaignBuilderApproval
-} from "./chunk-QQW6DZQ4.mjs";
+} from "./chunk-XJQ6KGNQ.mjs";
 
 // src/cli.ts
 import { readFileSync, writeFileSync } from "fs";
@@ -379,7 +379,7 @@ async function handleCampaignAgentCommand(signaliz, argv) {
     }
     return;
   }
-  if (["status", "rows", "artifacts", "approve", "approve-delivery"].includes(subcommand)) {
+  if (["review", "status", "rows", "artifacts", "approve", "approve-delivery"].includes(subcommand)) {
     await handleCampaignAgentReviewCommand(signaliz, subcommand, argv.slice(1));
     return;
   }
@@ -486,6 +486,28 @@ async function handleCampaignAgentReviewCommand(signaliz, subcommand, argv) {
   const flags = parseFlags(argv);
   const buildId = argv[0] && !argv[0].startsWith("--") ? argv[0] : stringFlag(flags, "campaign-build-id", "build-id");
   if (!buildId) throw new Error(`campaign-agent ${subcommand} requires <campaign_build_id> or --campaign-build-id`);
+  if (subcommand === "review") {
+    const review = await signaliz.campaignBuilderAgent.reviewBuild(buildId, {
+      limit: numberFlag(flags, "limit") ?? 100,
+      cursor: stringFlag(flags, "cursor"),
+      segment: stringFlag(flags, "segment"),
+      rowStatus: stringFlag(flags, "row-status"),
+      qualified: booleanFlag(flags, "qualified") ? true : booleanFlag(flags, "disqualified") ? false : void 0
+    });
+    const operatorReview = {
+      ...review,
+      rows: {
+        ...review.rows,
+        rows: formatCampaignAgentRows(review.rows.rows)
+      }
+    };
+    if (booleanFlag(flags, "json")) {
+      printJson(operatorReview);
+    } else {
+      printCampaignAgentBuildReview(operatorReview);
+    }
+    return;
+  }
   if (subcommand === "status") {
     const status = await signaliz.campaignBuilderAgent.getBuildStatus(buildId);
     if (booleanFlag(flags, "json")) {
@@ -900,6 +922,34 @@ function printCampaignAgentBuildStatus(status) {
     console.log(`Next: signaliz campaign-agent approve ${status.campaignBuildId} --destination-type webhook`);
   }
 }
+function printCampaignAgentBuildReview(review) {
+  const summary = asRecord(review.summary);
+  console.log(`Campaign: ${review.status?.name || review.campaignBuildId}`);
+  console.log(`Status: ${summary.status || review.status?.status}`);
+  console.log(`Phase: ${summary.phase || review.status?.currentPhase || "N/A"}`);
+  console.log(`Rows: ${summary.sampledRows || 0} sampled, ${summary.availableRows || 0} available`);
+  console.log(`Qualified: ${summary.qualifiedRows || 0}`);
+  console.log(`Emails: ${summary.rowsWithEmail || 0}`);
+  console.log(`Copy ready: ${summary.copyReadyRows || 0}`);
+  console.log(`Artifacts: ${summary.artifactCount || 0}`);
+  console.log(`Delivery approval ready: ${summary.readyForDeliveryApproval === true ? "yes" : "no"}`);
+  if (Array.isArray(review.gates) && review.gates.length > 0) {
+    console.log("\nGates:");
+    for (const gate of review.gates) {
+      console.log(`- ${gate.passed ? "PASS" : "BLOCKED"} ${gate.label}: ${gate.detail}`);
+    }
+  }
+  const warnings = Array.isArray(summary.warnings) ? summary.warnings : [];
+  if (warnings.length > 0) {
+    console.log("\nWarnings:");
+    for (const warning of warnings.slice(0, 5)) console.log(`- ${warning}`);
+  }
+  const nextActions = Array.isArray(review.nextActions) ? review.nextActions : [];
+  if (nextActions.length > 0) {
+    console.log("\nNext:");
+    for (const action of nextActions) console.log(`- ${action}`);
+  }
+}
 function formatCampaignAgentRows(rows) {
   return rows.map((row) => {
     const data = asRecord(row.data);
@@ -1109,6 +1159,7 @@ Usage:
   signaliz campaign-agent dry-run --goal "Build a strategy-template campaign..." --target-count 500 --use-local-leads --json
   signaliz campaign-agent build-approved --goal "Build a strategy-template campaign..." --confirm-launch --approve-all --approved-by you@example.com --spend-limit 500
   signaliz campaign-agent build-approved --request-file campaign-request.json --confirm-launch --approve-all --approved-by you@example.com --spend-limit 500 --wait --approve-delivery --delivery-destination-type json
+  signaliz campaign-agent review <campaign_build_id> --limit 100 --json
   signaliz campaign-agent status <campaign_build_id> --json
   signaliz campaign-agent rows <campaign_build_id> --limit 100 --json
 
@@ -1142,12 +1193,13 @@ Signaliz campaign-agent commands:
   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 status <campaign_build_id> [--json]
   signaliz campaign-agent rows <campaign_build_id> [--limit N] [--cursor CURSOR] [--qualified|--disqualified] [--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]
 
-The init command emits a reusable JSON CampaignBuilderAgentRequest. The plan command composes an approval-gated strategy-template MCP flow. Proof runs the same plan path plus build_campaign dry_run=true and returns a no-spend receipt. Use --request-file to load a reusable request, then override fields such as --target-count or --strategy-template from the command line. Use --strategy-template to merge a private-safe strategy pattern into the plan without exposing private account labels, and --operating-playbooks to add reusable build-loop gates such as proof-first vertical qualification, net-new suppression, cache-first inventory, and signal-led copy approval. Built-ins map to Signaliz-native tools: lead_generation -> generate_leads, local_leads -> generate_local_leads, email_finding -> find_and_verify_emails, email_verification -> verify_emails, signals -> enrich_company_signals. Add BYO tools with --custom-tool provider:layer:tool[:mcp] or key=value pairs such as provider=apollo,layer=source,tool=apollo_search,mcp=apollo. Use --no-strategy-patterns or --no-workflow-patterns to disable default private strategy memory hints. Commit-plan dry-runs by default and writes only with --confirm-write plus approval identity. Dry-run executes build_campaign with dry_run=true. Approved build requires explicit launch confirmation and approval metadata; add --commit-before-launch to persist the reviewed plan as a GTM campaign before launch, --wait to poll until completion or pending approval, and --approve-delivery to approve reviewed webhook delivery after pending_approval. Use status, rows, and artifacts to inspect the finished campaign-agent build before routing rows to external tools.
+The init command emits a reusable JSON CampaignBuilderAgentRequest. The plan command composes an approval-gated strategy-template MCP flow. Proof runs the same plan path plus build_campaign dry_run=true and returns a no-spend receipt. Use --request-file to load a reusable request, then override fields such as --target-count or --strategy-template from the command line. Use --strategy-template to merge a private-safe strategy pattern into the plan without exposing private account labels, and --operating-playbooks to add reusable build-loop gates such as proof-first vertical qualification, net-new suppression, cache-first inventory, and signal-led copy approval. Built-ins map to Signaliz-native tools: lead_generation -> generate_leads, local_leads -> generate_local_leads, email_finding -> find_and_verify_emails, email_verification -> verify_emails, signals -> enrich_company_signals. Add BYO tools with --custom-tool provider:layer:tool[:mcp] or key=value pairs such as provider=apollo,layer=source,tool=apollo_search,mcp=apollo. Use --no-strategy-patterns or --no-workflow-patterns to disable default private strategy memory hints. Commit-plan dry-runs by default and writes only with --confirm-write plus approval identity. Dry-run executes build_campaign with dry_run=true. Approved build requires explicit launch confirmation and approval metadata; add --commit-before-launch to persist the reviewed plan as a GTM campaign before launch, --wait to poll until completion or pending approval, and --approve-delivery to approve reviewed webhook delivery after pending_approval. Use review to inspect status, sampled rows, artifacts, and delivery-readiness gates before approving delivery or routing rows to external tools.
 `);
 }
 main().catch((e) => {

package/dist/index.d.mts

@@ -1094,6 +1094,38 @@ interface CampaignBuilderApprovedRunResult {
     finalStatus?: CampaignBuildStatus;
     deliveryApproval?: ApproveDeliveryResult;
 }
+interface CampaignBuilderBuildReviewOptions extends CampaignRowsOptions {
+    /** Number of rows to sample for review. Defaults to 100. */
+    limit?: number;
+}
+interface CampaignBuilderBuildReviewGate {
+    id: string;
+    label: string;
+    passed: boolean;
+    detail: string;
+}
+interface CampaignBuilderBuildReviewSummary {
+    status: string;
+    phase: string | null;
+    sampledRows: number;
+    availableRows: number;
+    qualifiedRows: number;
+    rowsWithEmail: number;
+    copyReadyRows: number;
+    artifactCount: number;
+    readyForDeliveryApproval: boolean;
+    blockedReasons: string[];
+    warnings: string[];
+}
+interface CampaignBuilderBuildReview {
+    campaignBuildId: string;
+    status: CampaignBuildStatus;
+    rows: CampaignRowsResult;
+    artifacts: CampaignArtifact[];
+    gates: CampaignBuilderBuildReviewGate[];
+    summary: CampaignBuilderBuildReviewSummary;
+    nextActions: string[];
+}
 declare const DEFAULT_SIGNALIZ_CAMPAIGN_BUILDER_DEFAULTS: Required<Pick<SignalizCampaignBuilderDefaults, 'requireVerifiedEmail' | 'dedupKeys' | 'allowDownscale'>> & SignalizCampaignBuilderDefaults;
 declare const DEFAULT_CAMPAIGN_BUILDER_BUILT_INS: CampaignBuilderBuiltInTool[];
 declare const DEFAULT_CAMPAIGN_BUILDER_APPROVAL_TYPES: CampaignBuilderApprovalType[];
@@ -1114,6 +1146,7 @@ declare class CampaignBuilderAgent {
         destinationId?: string;
         destinationConfig?: UnknownRecord$1;
     }): Promise<ApproveDeliveryResult>;
+    reviewBuild(campaignBuildId: string, options?: CampaignBuilderBuildReviewOptions): Promise<CampaignBuilderBuildReview>;
     private getCampaignBuildStatus;
     private waitForCampaignBuildStatus;
     private approveCampaignDelivery;

package/dist/index.d.ts

@@ -1094,6 +1094,38 @@ interface CampaignBuilderApprovedRunResult {
     finalStatus?: CampaignBuildStatus;
     deliveryApproval?: ApproveDeliveryResult;
 }
+interface CampaignBuilderBuildReviewOptions extends CampaignRowsOptions {
+    /** Number of rows to sample for review. Defaults to 100. */
+    limit?: number;
+}
+interface CampaignBuilderBuildReviewGate {
+    id: string;
+    label: string;
+    passed: boolean;
+    detail: string;
+}
+interface CampaignBuilderBuildReviewSummary {
+    status: string;
+    phase: string | null;
+    sampledRows: number;
+    availableRows: number;
+    qualifiedRows: number;
+    rowsWithEmail: number;
+    copyReadyRows: number;
+    artifactCount: number;
+    readyForDeliveryApproval: boolean;
+    blockedReasons: string[];
+    warnings: string[];
+}
+interface CampaignBuilderBuildReview {
+    campaignBuildId: string;
+    status: CampaignBuildStatus;
+    rows: CampaignRowsResult;
+    artifacts: CampaignArtifact[];
+    gates: CampaignBuilderBuildReviewGate[];
+    summary: CampaignBuilderBuildReviewSummary;
+    nextActions: string[];
+}
 declare const DEFAULT_SIGNALIZ_CAMPAIGN_BUILDER_DEFAULTS: Required<Pick<SignalizCampaignBuilderDefaults, 'requireVerifiedEmail' | 'dedupKeys' | 'allowDownscale'>> & SignalizCampaignBuilderDefaults;
 declare const DEFAULT_CAMPAIGN_BUILDER_BUILT_INS: CampaignBuilderBuiltInTool[];
 declare const DEFAULT_CAMPAIGN_BUILDER_APPROVAL_TYPES: CampaignBuilderApprovalType[];
@@ -1114,6 +1146,7 @@ declare class CampaignBuilderAgent {
         destinationId?: string;
         destinationConfig?: UnknownRecord$1;
     }): Promise<ApproveDeliveryResult>;
+    reviewBuild(campaignBuildId: string, options?: CampaignBuilderBuildReviewOptions): Promise<CampaignBuilderBuildReview>;
     private getCampaignBuildStatus;
     private waitForCampaignBuildStatus;
     private approveCampaignDelivery;

package/dist/index.js

@@ -1923,6 +1923,15 @@ var CampaignBuilderAgent = class {
   async approveDelivery(campaignBuildId, destinationType, options) {
     return this.approveCampaignDelivery(campaignBuildId, destinationType, options);
   }
+  async reviewBuild(campaignBuildId, options = {}) {
+    const status = await this.getBuildStatus(campaignBuildId);
+    const rows = await this.getBuildRows(campaignBuildId, {
+      ...options,
+      limit: options.limit ?? 100
+    });
+    const artifacts = await this.listBuildArtifacts(campaignBuildId);
+    return createCampaignBuilderBuildReview(status, rows, artifacts);
+  }
   async getCampaignBuildStatus(campaignBuildId) {
     const data = await this.callMcp("get_campaign_build_status", {
       campaign_build_id: campaignBuildId
@@ -3350,6 +3359,120 @@ function mapAgentCampaignArtifact(data) {
     createdAt: stringValue(data.created_at) ?? ""
   };
 }
+function createCampaignBuilderBuildReview(status, rows, artifacts) {
+  const sampledRows = rows.rows.length;
+  const availableRows = rows.count || sampledRows;
+  const qualifiedRows = rows.rows.filter((row) => row.qualified !== false).length;
+  const rowsWithEmail = rows.rows.filter(campaignReviewRowHasEmail).length;
+  const copyReadyRows = rows.rows.filter(campaignReviewRowHasCopy).length;
+  const artifactCount = artifacts.length || status.artifactCount || 0;
+  const gates = [
+    {
+      id: "build_completed",
+      label: "Build completed",
+      passed: status.status === "completed",
+      detail: status.status === "completed" ? "The campaign build is completed." : `The campaign build is ${status.status}; review again after completion.`
+    },
+    {
+      id: "rows_available",
+      label: "Rows available",
+      passed: sampledRows > 0,
+      detail: sampledRows > 0 ? `${sampledRows} sampled row(s) are available for review.` : "No rows were returned for review."
+    },
+    {
+      id: "qualified_sample",
+      label: "Sample rows qualified",
+      passed: sampledRows > 0 && qualifiedRows === sampledRows,
+      detail: sampledRows > 0 ? `${qualifiedRows}/${sampledRows} sampled row(s) are marked qualified.` : "Qualification could not be checked without sampled rows."
+    },
+    {
+      id: "email_coverage",
+      label: "Email coverage",
+      passed: sampledRows > 0 && rowsWithEmail === sampledRows,
+      detail: sampledRows > 0 ? `${rowsWithEmail}/${sampledRows} sampled row(s) include an email.` : "Email coverage could not be checked without sampled rows."
+    },
+    {
+      id: "artifact_available",
+      label: "Artifact available",
+      passed: artifactCount > 0,
+      detail: artifactCount > 0 ? `${artifactCount} artifact(s) are available.` : "No delivery artifact is available yet."
+    },
+    {
+      id: "no_failed_rows",
+      label: "No failed rows",
+      passed: status.recordsFailed === 0,
+      detail: status.recordsFailed === 0 ? "The build reports zero failed rows." : `${status.recordsFailed} row(s) failed during the build.`
+    }
+  ];
+  const blockedReasons = gates.filter((gate) => !gate.passed).map((gate) => gate.detail);
+  const warnings = [
+    rows.hasMore ? "This review is based on a row sample; page through remaining rows before final approval." : void 0,
+    sampledRows > 0 && copyReadyRows < sampledRows ? `${copyReadyRows}/${sampledRows} sampled row(s) include generated copy.` : void 0,
+    ...status.warnings
+  ].filter((item) => Boolean(item));
+  const readyForDeliveryApproval = blockedReasons.length === 0;
+  return {
+    campaignBuildId: status.campaignBuildId || rows.campaignBuildId,
+    status,
+    rows,
+    artifacts,
+    gates,
+    summary: {
+      status: status.status,
+      phase: status.currentPhase,
+      sampledRows,
+      availableRows,
+      qualifiedRows,
+      rowsWithEmail,
+      copyReadyRows,
+      artifactCount,
+      readyForDeliveryApproval,
+      blockedReasons,
+      warnings
+    },
+    nextActions: campaignReviewNextActions(status, readyForDeliveryApproval)
+  };
+}
+function campaignReviewNextActions(status, readyForDeliveryApproval) {
+  const buildId = status.campaignBuildId;
+  if (!buildId) return [];
+  if (status.status === "completed" && readyForDeliveryApproval) {
+    return [
+      `signaliz campaign-agent approve ${buildId} --destination-type json`,
+      `signaliz campaign-agent artifacts ${buildId}`
+    ];
+  }
+  if (status.status === "completed") {
+    return [
+      `signaliz campaign-agent rows ${buildId} --limit 100`,
+      `signaliz campaign-agent artifacts ${buildId}`
+    ];
+  }
+  if (status.status === "pending_approval") {
+    return [
+      `signaliz campaign-agent rows ${buildId} --limit 100`,
+      `signaliz campaign-agent approve ${buildId} --destination-type json`
+    ];
+  }
+  if ((status.status === "queued" || status.status === "running") && status.triggerRunId) {
+    return [`signaliz ops run-status ${status.triggerRunId} --watch`];
+  }
+  return [`signaliz campaign-agent status ${buildId}`];
+}
+function campaignReviewRowHasEmail(row) {
+  const data = asRecord(row.data);
+  return Boolean(
+    stringValue(data.email) || stringValue(data.work_email) || stringValue(data.workEmail)
+  );
+}
+function campaignReviewRowHasCopy(row) {
+  const data = asRecord(row.data);
+  const copy = asRecord(data.copy);
+  const rawCopy = asRecord(data.raw_copy ?? data.rawCopy);
+  return row.status === "copy_ready" || data.copy_ready === true || Boolean(
+    stringValue(data.subject) || stringValue(data.subject_line) || stringValue(data.subjectLine) || stringValue(data.opener) || stringValue(data.body) || stringValue(data.cta) || stringValue(copy.subject) || stringValue(copy.body) || stringValue(rawCopy.subject) || stringValue(rawCopy.body)
+  );
+}
 function diagnosticMessages2(value) {
   if (!Array.isArray(value)) return [];
   return value.map((item) => {

package/dist/index.mjs

@@ -23,7 +23,7 @@ import {
   getCampaignBuilderStrategyTemplate,
   getMissingCampaignBuilderApprovals,
   normalizeExecutionReference
-} from "./chunk-QQW6DZQ4.mjs";
+} from "./chunk-XJQ6KGNQ.mjs";
 export {
   Ai,
   CAMPAIGN_BUILDER_OPERATING_PLAYBOOKS,

package/dist/mcp-config.js

@@ -1897,6 +1897,15 @@ var CampaignBuilderAgent = class {
   async approveDelivery(campaignBuildId, destinationType, options) {
     return this.approveCampaignDelivery(campaignBuildId, destinationType, options);
   }
+  async reviewBuild(campaignBuildId, options = {}) {
+    const status = await this.getBuildStatus(campaignBuildId);
+    const rows = await this.getBuildRows(campaignBuildId, {
+      ...options,
+      limit: options.limit ?? 100
+    });
+    const artifacts = await this.listBuildArtifacts(campaignBuildId);
+    return createCampaignBuilderBuildReview(status, rows, artifacts);
+  }
   async getCampaignBuildStatus(campaignBuildId) {
     const data = await this.callMcp("get_campaign_build_status", {
       campaign_build_id: campaignBuildId
@@ -3223,6 +3232,120 @@ function mapAgentCampaignArtifact(data) {
     createdAt: stringValue(data.created_at) ?? ""
   };
 }
+function createCampaignBuilderBuildReview(status, rows, artifacts) {
+  const sampledRows = rows.rows.length;
+  const availableRows = rows.count || sampledRows;
+  const qualifiedRows = rows.rows.filter((row) => row.qualified !== false).length;
+  const rowsWithEmail = rows.rows.filter(campaignReviewRowHasEmail).length;
+  const copyReadyRows = rows.rows.filter(campaignReviewRowHasCopy).length;
+  const artifactCount = artifacts.length || status.artifactCount || 0;
+  const gates = [
+    {
+      id: "build_completed",
+      label: "Build completed",
+      passed: status.status === "completed",
+      detail: status.status === "completed" ? "The campaign build is completed." : `The campaign build is ${status.status}; review again after completion.`
+    },
+    {
+      id: "rows_available",
+      label: "Rows available",
+      passed: sampledRows > 0,
+      detail: sampledRows > 0 ? `${sampledRows} sampled row(s) are available for review.` : "No rows were returned for review."
+    },
+    {
+      id: "qualified_sample",
+      label: "Sample rows qualified",
+      passed: sampledRows > 0 && qualifiedRows === sampledRows,
+      detail: sampledRows > 0 ? `${qualifiedRows}/${sampledRows} sampled row(s) are marked qualified.` : "Qualification could not be checked without sampled rows."
+    },
+    {
+      id: "email_coverage",
+      label: "Email coverage",
+      passed: sampledRows > 0 && rowsWithEmail === sampledRows,
+      detail: sampledRows > 0 ? `${rowsWithEmail}/${sampledRows} sampled row(s) include an email.` : "Email coverage could not be checked without sampled rows."
+    },
+    {
+      id: "artifact_available",
+      label: "Artifact available",
+      passed: artifactCount > 0,
+      detail: artifactCount > 0 ? `${artifactCount} artifact(s) are available.` : "No delivery artifact is available yet."
+    },
+    {
+      id: "no_failed_rows",
+      label: "No failed rows",
+      passed: status.recordsFailed === 0,
+      detail: status.recordsFailed === 0 ? "The build reports zero failed rows." : `${status.recordsFailed} row(s) failed during the build.`
+    }
+  ];
+  const blockedReasons = gates.filter((gate) => !gate.passed).map((gate) => gate.detail);
+  const warnings = [
+    rows.hasMore ? "This review is based on a row sample; page through remaining rows before final approval." : void 0,
+    sampledRows > 0 && copyReadyRows < sampledRows ? `${copyReadyRows}/${sampledRows} sampled row(s) include generated copy.` : void 0,
+    ...status.warnings
+  ].filter((item) => Boolean(item));
+  const readyForDeliveryApproval = blockedReasons.length === 0;
+  return {
+    campaignBuildId: status.campaignBuildId || rows.campaignBuildId,
+    status,
+    rows,
+    artifacts,
+    gates,
+    summary: {
+      status: status.status,
+      phase: status.currentPhase,
+      sampledRows,
+      availableRows,
+      qualifiedRows,
+      rowsWithEmail,
+      copyReadyRows,
+      artifactCount,
+      readyForDeliveryApproval,
+      blockedReasons,
+      warnings
+    },
+    nextActions: campaignReviewNextActions(status, readyForDeliveryApproval)
+  };
+}
+function campaignReviewNextActions(status, readyForDeliveryApproval) {
+  const buildId = status.campaignBuildId;
+  if (!buildId) return [];
+  if (status.status === "completed" && readyForDeliveryApproval) {
+    return [
+      `signaliz campaign-agent approve ${buildId} --destination-type json`,
+      `signaliz campaign-agent artifacts ${buildId}`
+    ];
+  }
+  if (status.status === "completed") {
+    return [
+      `signaliz campaign-agent rows ${buildId} --limit 100`,
+      `signaliz campaign-agent artifacts ${buildId}`
+    ];
+  }
+  if (status.status === "pending_approval") {
+    return [
+      `signaliz campaign-agent rows ${buildId} --limit 100`,
+      `signaliz campaign-agent approve ${buildId} --destination-type json`
+    ];
+  }
+  if ((status.status === "queued" || status.status === "running") && status.triggerRunId) {
+    return [`signaliz ops run-status ${status.triggerRunId} --watch`];
+  }
+  return [`signaliz campaign-agent status ${buildId}`];
+}
+function campaignReviewRowHasEmail(row) {
+  const data = asRecord(row.data);
+  return Boolean(
+    stringValue(data.email) || stringValue(data.work_email) || stringValue(data.workEmail)
+  );
+}
+function campaignReviewRowHasCopy(row) {
+  const data = asRecord(row.data);
+  const copy = asRecord(data.copy);
+  const rawCopy = asRecord(data.raw_copy ?? data.rawCopy);
+  return row.status === "copy_ready" || data.copy_ready === true || Boolean(
+    stringValue(data.subject) || stringValue(data.subject_line) || stringValue(data.subjectLine) || stringValue(data.opener) || stringValue(data.body) || stringValue(data.cta) || stringValue(copy.subject) || stringValue(copy.body) || stringValue(rawCopy.subject) || stringValue(rawCopy.body)
+  );
+}
 function diagnosticMessages2(value) {
   if (!Array.isArray(value)) return [];
   return value.map((item) => {

package/dist/mcp-config.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   Signaliz
-} from "./chunk-QQW6DZQ4.mjs";
+} from "./chunk-XJQ6KGNQ.mjs";
 
 // src/mcp-config.ts
 import * as fs from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/sdk",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "Signaliz SDK — GTM Kernel, Nango routes, MCP, and enrichment for AI agents",
   "main": "dist/index.js",
   "module": "dist/index.mjs",