@signaliz/sdk 1.0.9 → 1.0.11

package/README.md

@@ -98,6 +98,14 @@ console.log(plan.strategyMemoryStatus?.ready);
 console.log(plan.mcpFlow.filter((step) =>
   ['gtm_provider_recipe_prepare', 'gtm_provider_route_activate'].includes(step.tool)
 ));
+
+// After an approved launch, keep review and delivery in the agent surface.
+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');
 ```
 
 The CLI can run the same request shape from a reusable JSON file, with flags
@@ -115,6 +123,9 @@ npx @signaliz/sdk campaign-agent plan \
   --request-file campaign-request.json \
   --target-count 250 \
   --json
+
+npx @signaliz/sdk campaign-agent status campaign_build_id --json
+npx @signaliz/sdk campaign-agent rows campaign_build_id --limit 100 --json
 ```
 
 Use the hosted MCP campaign-agent planner when you want Signaliz to return the

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

@@ -1832,10 +1832,7 @@ var CampaignBuilderAgent = class {
       ["completed", "failed", "canceled", "pending_approval"]
     );
     const result = { build, finalStatus };
-    if (options.approveDelivery === true) {
-      if (finalStatus.status !== "pending_approval") {
-        throw new Error(`Campaign build ${campaignBuildId} reached ${finalStatus.status}; delivery approval was not available`);
-      }
+    if (options.approveDelivery === true && finalStatus.status === "pending_approval") {
       const destinationType = options.deliveryDestinationType ?? plan.buildRequest.delivery?.destinationType ?? "json";
       result.deliveryApproval = await this.approveCampaignDelivery(campaignBuildId, destinationType, {
         destinationId: options.deliveryDestinationId,
@@ -1850,6 +1847,33 @@ var CampaignBuilderAgent = class {
     }
     return result;
   }
+  async getBuildStatus(campaignBuildId) {
+    return this.getCampaignBuildStatus(campaignBuildId);
+  }
+  async getBuildRows(campaignBuildId, options = {}) {
+    const filters = compact({
+      segment: options.segment,
+      qualified: options.qualified,
+      row_status: options.rowStatus
+    });
+    const args = compact({
+      campaign_build_id: campaignBuildId,
+      page_size: options.limit,
+      cursor: options.cursor
+    });
+    if (Object.keys(filters).length > 0) args.filters = filters;
+    const data = await this.callMcp("get_campaign_build_rows", args);
+    return mapAgentCampaignRowsResult(data);
+  }
+  async listBuildArtifacts(campaignBuildId) {
+    const data = await this.callMcp("list_campaign_build_artifacts", {
+      campaign_build_id: campaignBuildId
+    });
+    return Array.isArray(data.artifacts) ? data.artifacts.map(mapAgentCampaignArtifact) : [];
+  }
+  async approveDelivery(campaignBuildId, destinationType, options) {
+    return this.approveCampaignDelivery(campaignBuildId, destinationType, options);
+  }
   async getCampaignBuildStatus(campaignBuildId) {
     const data = await this.callMcp("get_campaign_build_status", {
       campaign_build_id: campaignBuildId
@@ -3243,6 +3267,40 @@ function mapAgentCampaignBuildStatus(data) {
     completedAt: stringValue(data.completed_at) ?? null
   };
 }
+function mapAgentCampaignRowsResult(data) {
+  const rows = Array.isArray(data.rows) ? data.rows : [];
+  return {
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    rows: rows.map((row, index) => {
+      const record = asRecord(row);
+      return {
+        index: numberOrUndefined2(record.index) ?? index,
+        status: stringValue(record.status) ?? stringValue(record.row_status) ?? "unknown",
+        qualified: record.qualified !== false,
+        segment: stringValue(record.segment) ?? null,
+        data: nullableRecord(record.data) ?? record
+      };
+    }),
+    count: numberOrUndefined2(data.count) ?? rows.length,
+    pageSize: numberOrUndefined2(data.page_size) ?? rows.length,
+    nextCursor: stringValue(data.next_cursor) ?? null,
+    hasMore: data.has_more === true
+  };
+}
+function mapAgentCampaignArtifact(data) {
+  return {
+    id: stringValue(data.id) ?? "",
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    artifactType: stringValue(data.artifact_type) ?? "",
+    destination: stringValue(data.destination) ?? "",
+    storagePath: stringValue(data.storage_path) ?? "",
+    signedUrl: stringValue(data.signed_url) ?? null,
+    rowCount: numberOrUndefined2(data.row_count) ?? 0,
+    checksum: stringValue(data.checksum) ?? null,
+    metadata: nullableRecord(data.metadata) ?? {},
+    createdAt: stringValue(data.created_at) ?? ""
+  };
+}
 function diagnosticMessages2(value) {
   if (!Array.isArray(value)) return [];
   return value.map((item) => {

package/dist/cli.js

@@ -1838,10 +1838,7 @@ var CampaignBuilderAgent = class {
       ["completed", "failed", "canceled", "pending_approval"]
     );
     const result = { build, finalStatus };
-    if (options.approveDelivery === true) {
-      if (finalStatus.status !== "pending_approval") {
-        throw new Error(`Campaign build ${campaignBuildId} reached ${finalStatus.status}; delivery approval was not available`);
-      }
+    if (options.approveDelivery === true && finalStatus.status === "pending_approval") {
       const destinationType = options.deliveryDestinationType ?? plan.buildRequest.delivery?.destinationType ?? "json";
       result.deliveryApproval = await this.approveCampaignDelivery(campaignBuildId, destinationType, {
         destinationId: options.deliveryDestinationId,
@@ -1856,6 +1853,33 @@ var CampaignBuilderAgent = class {
     }
     return result;
   }
+  async getBuildStatus(campaignBuildId) {
+    return this.getCampaignBuildStatus(campaignBuildId);
+  }
+  async getBuildRows(campaignBuildId, options = {}) {
+    const filters = compact({
+      segment: options.segment,
+      qualified: options.qualified,
+      row_status: options.rowStatus
+    });
+    const args = compact({
+      campaign_build_id: campaignBuildId,
+      page_size: options.limit,
+      cursor: options.cursor
+    });
+    if (Object.keys(filters).length > 0) args.filters = filters;
+    const data = await this.callMcp("get_campaign_build_rows", args);
+    return mapAgentCampaignRowsResult(data);
+  }
+  async listBuildArtifacts(campaignBuildId) {
+    const data = await this.callMcp("list_campaign_build_artifacts", {
+      campaign_build_id: campaignBuildId
+    });
+    return Array.isArray(data.artifacts) ? data.artifacts.map(mapAgentCampaignArtifact) : [];
+  }
+  async approveDelivery(campaignBuildId, destinationType, options) {
+    return this.approveCampaignDelivery(campaignBuildId, destinationType, options);
+  }
   async getCampaignBuildStatus(campaignBuildId) {
     const data = await this.callMcp("get_campaign_build_status", {
       campaign_build_id: campaignBuildId
@@ -3249,6 +3273,40 @@ function mapAgentCampaignBuildStatus(data) {
     completedAt: stringValue(data.completed_at) ?? null
   };
 }
+function mapAgentCampaignRowsResult(data) {
+  const rows = Array.isArray(data.rows) ? data.rows : [];
+  return {
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    rows: rows.map((row, index) => {
+      const record = asRecord(row);
+      return {
+        index: numberOrUndefined2(record.index) ?? index,
+        status: stringValue(record.status) ?? stringValue(record.row_status) ?? "unknown",
+        qualified: record.qualified !== false,
+        segment: stringValue(record.segment) ?? null,
+        data: nullableRecord(record.data) ?? record
+      };
+    }),
+    count: numberOrUndefined2(data.count) ?? rows.length,
+    pageSize: numberOrUndefined2(data.page_size) ?? rows.length,
+    nextCursor: stringValue(data.next_cursor) ?? null,
+    hasMore: data.has_more === true
+  };
+}
+function mapAgentCampaignArtifact(data) {
+  return {
+    id: stringValue(data.id) ?? "",
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    artifactType: stringValue(data.artifact_type) ?? "",
+    destination: stringValue(data.destination) ?? "",
+    storagePath: stringValue(data.storage_path) ?? "",
+    signedUrl: stringValue(data.signed_url) ?? null,
+    rowCount: numberOrUndefined2(data.row_count) ?? 0,
+    checksum: stringValue(data.checksum) ?? null,
+    metadata: nullableRecord(data.metadata) ?? {},
+    createdAt: stringValue(data.created_at) ?? ""
+  };
+}
 function diagnosticMessages2(value) {
   if (!Array.isArray(value)) return [];
   return value.map((item) => {
@@ -6622,6 +6680,10 @@ async function handleCampaignAgentCommand(signaliz, argv) {
     }
     return;
   }
+  if (["status", "rows", "artifacts", "approve", "approve-delivery"].includes(subcommand)) {
+    await handleCampaignAgentReviewCommand(signaliz, subcommand, argv.slice(1));
+    return;
+  }
   if (!["plan", "proof", "smoke", "commit-plan", "dry-run", "build-approved", "launch-approved"].includes(subcommand)) {
     printCampaignAgentHelp();
     return;
@@ -6721,6 +6783,68 @@ async function handleCampaignAgentCommand(signaliz, argv) {
     printCampaignAgentPlan(plan);
   }
 }
+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 === "status") {
+    const status = await signaliz.campaignBuilderAgent.getBuildStatus(buildId);
+    if (booleanFlag(flags, "json")) {
+      printJson(status);
+    } else {
+      printCampaignAgentBuildStatus(status);
+    }
+    return;
+  }
+  if (subcommand === "rows") {
+    const result2 = await signaliz.campaignBuilderAgent.getBuildRows(buildId, {
+      limit: numberFlag(flags, "limit"),
+      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 operatorResult = {
+      ...result2,
+      rows: formatCampaignAgentRows(result2.rows)
+    };
+    if (booleanFlag(flags, "json")) {
+      printJson(operatorResult);
+    } else {
+      printCampaignAgentRows(operatorResult);
+    }
+    return;
+  }
+  if (subcommand === "artifacts") {
+    const artifacts = await signaliz.campaignBuilderAgent.listBuildArtifacts(buildId);
+    if (booleanFlag(flags, "json")) {
+      printJson(artifacts);
+    } else if (artifacts.length === 0) {
+      console.log("No artifacts yet.");
+      console.log(`Next: signaliz campaign-agent status ${buildId}`);
+    } else {
+      for (const artifact of artifacts) {
+        console.log(`${artifact.artifactType || "artifact"}: ${artifact.rowCount} rows${artifact.signedUrl ? `
+  ${artifact.signedUrl}` : ""}`);
+      }
+    }
+    return;
+  }
+  const destinationType = stringFlag(flags, "destination-type", "delivery-destination-type", "type");
+  if (!destinationType || !["json", "csv", "webhook"].includes(destinationType)) {
+    throw new Error("campaign-agent approve requires --destination-type json|csv|webhook");
+  }
+  const result = await signaliz.campaignBuilderAgent.approveDelivery(buildId, destinationType, {
+    destinationId: stringFlag(flags, "destination-id", "delivery-destination-id"),
+    destinationConfig: jsonObjectFlag(flags, "destination-config", "delivery-config")
+  });
+  if (booleanFlag(flags, "json")) {
+    printJson(result);
+  } else {
+    console.log(`Delivery ${result.status}: ${result.destinationType}`);
+    if (result.message) console.log(result.message);
+  }
+}
 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 });
@@ -7057,6 +7181,59 @@ function printCampaignAgentExecution(payload, flags) {
   console.log("\nResult:");
   printJson(payload.result);
 }
+function printCampaignAgentBuildStatus(status) {
+  console.log(`Campaign: ${status.name || status.campaignBuildId}`);
+  if (status.campaignId) console.log(`Campaign ID: ${status.campaignId}`);
+  console.log(`Status: ${status.status}`);
+  console.log(`Phase: ${status.currentPhase || "N/A"}`);
+  console.log(`Rows: ${status.recordsSucceeded}/${status.recordsTotal} succeeded, ${status.recordsFailed} failed`);
+  console.log(`Artifacts: ${status.artifactCount}`);
+  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("; ")}`);
+  }
+  if (Array.isArray(status.errors) && status.errors.length > 0) {
+    console.log(`Errors: ${status.errors.slice(0, 3).join("; ")}`);
+  }
+  if (status.status === "completed") {
+    console.log(`Next: signaliz campaign-agent rows ${status.campaignBuildId} --limit 100`);
+  } else if (status.status === "pending_approval") {
+    console.log(`Next: signaliz campaign-agent approve ${status.campaignBuildId} --destination-type webhook`);
+  }
+}
+function formatCampaignAgentRows(rows) {
+  return rows.map((row) => {
+    const data = asRecord4(row.data);
+    const fallbackName = `${data.first_name || ""} ${data.last_name || ""}`.trim() || null;
+    return {
+      ...row,
+      email: data.email ?? null,
+      name: data.full_name ?? fallbackName,
+      title: data.title ?? null,
+      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 || asRecord4(data.raw_copy).subject)
+    };
+  });
+}
+function printCampaignAgentRows(result) {
+  if (!Array.isArray(result.rows) || result.rows.length === 0) {
+    console.log("No rows found.");
+    return;
+  }
+  console.table(result.rows.map((row) => ({
+    email: row.email || "",
+    name: row.name || "",
+    title: row.title || "",
+    company: row.company || row.domain || "",
+    status: row.status || "",
+    segment: row.segment || "",
+    score: row.score ?? ""
+  })));
+  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 asRecord4(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
@@ -7233,6 +7410,8 @@ 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 status <campaign_build_id> --json
+  signaliz campaign-agent rows <campaign_build_id> --limit 100 --json
 
 Environment:
   SIGNALIZ_API_KEY   Your API key (not required for campaign-agent init)
@@ -7264,8 +7443,12 @@ 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 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 JSON/CSV/webhook delivery after pending_approval.
+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.
 `);
 }
 main().catch((e) => {

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   Signaliz,
   createCampaignBuilderAgentRequestTemplate,
   createCampaignBuilderApproval
-} from "./chunk-EQZJFFS7.mjs";
+} from "./chunk-QQW6DZQ4.mjs";
 
 // src/cli.ts
 import { readFileSync, writeFileSync } from "fs";
@@ -379,6 +379,10 @@ async function handleCampaignAgentCommand(signaliz, argv) {
     }
     return;
   }
+  if (["status", "rows", "artifacts", "approve", "approve-delivery"].includes(subcommand)) {
+    await handleCampaignAgentReviewCommand(signaliz, subcommand, argv.slice(1));
+    return;
+  }
   if (!["plan", "proof", "smoke", "commit-plan", "dry-run", "build-approved", "launch-approved"].includes(subcommand)) {
     printCampaignAgentHelp();
     return;
@@ -478,6 +482,68 @@ async function handleCampaignAgentCommand(signaliz, argv) {
     printCampaignAgentPlan(plan);
   }
 }
+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 === "status") {
+    const status = await signaliz.campaignBuilderAgent.getBuildStatus(buildId);
+    if (booleanFlag(flags, "json")) {
+      printJson(status);
+    } else {
+      printCampaignAgentBuildStatus(status);
+    }
+    return;
+  }
+  if (subcommand === "rows") {
+    const result2 = await signaliz.campaignBuilderAgent.getBuildRows(buildId, {
+      limit: numberFlag(flags, "limit"),
+      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 operatorResult = {
+      ...result2,
+      rows: formatCampaignAgentRows(result2.rows)
+    };
+    if (booleanFlag(flags, "json")) {
+      printJson(operatorResult);
+    } else {
+      printCampaignAgentRows(operatorResult);
+    }
+    return;
+  }
+  if (subcommand === "artifacts") {
+    const artifacts = await signaliz.campaignBuilderAgent.listBuildArtifacts(buildId);
+    if (booleanFlag(flags, "json")) {
+      printJson(artifacts);
+    } else if (artifacts.length === 0) {
+      console.log("No artifacts yet.");
+      console.log(`Next: signaliz campaign-agent status ${buildId}`);
+    } else {
+      for (const artifact of artifacts) {
+        console.log(`${artifact.artifactType || "artifact"}: ${artifact.rowCount} rows${artifact.signedUrl ? `
+  ${artifact.signedUrl}` : ""}`);
+      }
+    }
+    return;
+  }
+  const destinationType = stringFlag(flags, "destination-type", "delivery-destination-type", "type");
+  if (!destinationType || !["json", "csv", "webhook"].includes(destinationType)) {
+    throw new Error("campaign-agent approve requires --destination-type json|csv|webhook");
+  }
+  const result = await signaliz.campaignBuilderAgent.approveDelivery(buildId, destinationType, {
+    destinationId: stringFlag(flags, "destination-id", "delivery-destination-id"),
+    destinationConfig: jsonObjectFlag(flags, "destination-config", "delivery-config")
+  });
+  if (booleanFlag(flags, "json")) {
+    printJson(result);
+  } else {
+    console.log(`Delivery ${result.status}: ${result.destinationType}`);
+    if (result.message) console.log(result.message);
+  }
+}
 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 });
@@ -814,6 +880,59 @@ function printCampaignAgentExecution(payload, flags) {
   console.log("\nResult:");
   printJson(payload.result);
 }
+function printCampaignAgentBuildStatus(status) {
+  console.log(`Campaign: ${status.name || status.campaignBuildId}`);
+  if (status.campaignId) console.log(`Campaign ID: ${status.campaignId}`);
+  console.log(`Status: ${status.status}`);
+  console.log(`Phase: ${status.currentPhase || "N/A"}`);
+  console.log(`Rows: ${status.recordsSucceeded}/${status.recordsTotal} succeeded, ${status.recordsFailed} failed`);
+  console.log(`Artifacts: ${status.artifactCount}`);
+  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("; ")}`);
+  }
+  if (Array.isArray(status.errors) && status.errors.length > 0) {
+    console.log(`Errors: ${status.errors.slice(0, 3).join("; ")}`);
+  }
+  if (status.status === "completed") {
+    console.log(`Next: signaliz campaign-agent rows ${status.campaignBuildId} --limit 100`);
+  } else if (status.status === "pending_approval") {
+    console.log(`Next: signaliz campaign-agent approve ${status.campaignBuildId} --destination-type webhook`);
+  }
+}
+function formatCampaignAgentRows(rows) {
+  return rows.map((row) => {
+    const data = asRecord(row.data);
+    const fallbackName = `${data.first_name || ""} ${data.last_name || ""}`.trim() || null;
+    return {
+      ...row,
+      email: data.email ?? null,
+      name: data.full_name ?? fallbackName,
+      title: data.title ?? null,
+      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)
+    };
+  });
+}
+function printCampaignAgentRows(result) {
+  if (!Array.isArray(result.rows) || result.rows.length === 0) {
+    console.log("No rows found.");
+    return;
+  }
+  console.table(result.rows.map((row) => ({
+    email: row.email || "",
+    name: row.name || "",
+    title: row.title || "",
+    company: row.company || row.domain || "",
+    status: row.status || "",
+    segment: row.segment || "",
+    score: row.score ?? ""
+  })));
+  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 asRecord(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
@@ -990,6 +1109,8 @@ 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 status <campaign_build_id> --json
+  signaliz campaign-agent rows <campaign_build_id> --limit 100 --json
 
 Environment:
   SIGNALIZ_API_KEY   Your API key (not required for campaign-agent init)
@@ -1021,8 +1142,12 @@ 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 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 JSON/CSV/webhook delivery after pending_approval.
+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.
 `);
 }
 main().catch((e) => {

package/dist/index.d.mts

@@ -1107,6 +1107,13 @@ declare class CampaignBuilderAgent {
     dryRunPlan(plan: CampaignBuilderAgentPlan, options?: BuildOptions): Promise<CampaignBuildResult>;
     buildApprovedPlan(plan: CampaignBuilderAgentPlan, approval: CampaignBuilderApproval, options?: CampaignBuilderBuildOptions): Promise<CampaignBuildResult>;
     runApprovedPlan(plan: CampaignBuilderAgentPlan, approval: CampaignBuilderApproval, options?: CampaignBuilderApprovedRunOptions): Promise<CampaignBuilderApprovedRunResult>;
+    getBuildStatus(campaignBuildId: string): Promise<CampaignBuildStatus>;
+    getBuildRows(campaignBuildId: string, options?: CampaignRowsOptions): Promise<CampaignRowsResult>;
+    listBuildArtifacts(campaignBuildId: string): Promise<CampaignArtifact[]>;
+    approveDelivery(campaignBuildId: string, destinationType: CampaignDeliveryMode, options?: {
+        destinationId?: string;
+        destinationConfig?: UnknownRecord$1;
+    }): Promise<ApproveDeliveryResult>;
     private getCampaignBuildStatus;
     private waitForCampaignBuildStatus;
     private approveCampaignDelivery;

package/dist/index.d.ts

@@ -1107,6 +1107,13 @@ declare class CampaignBuilderAgent {
     dryRunPlan(plan: CampaignBuilderAgentPlan, options?: BuildOptions): Promise<CampaignBuildResult>;
     buildApprovedPlan(plan: CampaignBuilderAgentPlan, approval: CampaignBuilderApproval, options?: CampaignBuilderBuildOptions): Promise<CampaignBuildResult>;
     runApprovedPlan(plan: CampaignBuilderAgentPlan, approval: CampaignBuilderApproval, options?: CampaignBuilderApprovedRunOptions): Promise<CampaignBuilderApprovedRunResult>;
+    getBuildStatus(campaignBuildId: string): Promise<CampaignBuildStatus>;
+    getBuildRows(campaignBuildId: string, options?: CampaignRowsOptions): Promise<CampaignRowsResult>;
+    listBuildArtifacts(campaignBuildId: string): Promise<CampaignArtifact[]>;
+    approveDelivery(campaignBuildId: string, destinationType: CampaignDeliveryMode, options?: {
+        destinationId?: string;
+        destinationConfig?: UnknownRecord$1;
+    }): Promise<ApproveDeliveryResult>;
     private getCampaignBuildStatus;
     private waitForCampaignBuildStatus;
     private approveCampaignDelivery;

package/dist/index.js

@@ -1881,10 +1881,7 @@ var CampaignBuilderAgent = class {
       ["completed", "failed", "canceled", "pending_approval"]
     );
     const result = { build, finalStatus };
-    if (options.approveDelivery === true) {
-      if (finalStatus.status !== "pending_approval") {
-        throw new Error(`Campaign build ${campaignBuildId} reached ${finalStatus.status}; delivery approval was not available`);
-      }
+    if (options.approveDelivery === true && finalStatus.status === "pending_approval") {
       const destinationType = options.deliveryDestinationType ?? plan.buildRequest.delivery?.destinationType ?? "json";
       result.deliveryApproval = await this.approveCampaignDelivery(campaignBuildId, destinationType, {
         destinationId: options.deliveryDestinationId,
@@ -1899,6 +1896,33 @@ var CampaignBuilderAgent = class {
     }
     return result;
   }
+  async getBuildStatus(campaignBuildId) {
+    return this.getCampaignBuildStatus(campaignBuildId);
+  }
+  async getBuildRows(campaignBuildId, options = {}) {
+    const filters = compact({
+      segment: options.segment,
+      qualified: options.qualified,
+      row_status: options.rowStatus
+    });
+    const args = compact({
+      campaign_build_id: campaignBuildId,
+      page_size: options.limit,
+      cursor: options.cursor
+    });
+    if (Object.keys(filters).length > 0) args.filters = filters;
+    const data = await this.callMcp("get_campaign_build_rows", args);
+    return mapAgentCampaignRowsResult(data);
+  }
+  async listBuildArtifacts(campaignBuildId) {
+    const data = await this.callMcp("list_campaign_build_artifacts", {
+      campaign_build_id: campaignBuildId
+    });
+    return Array.isArray(data.artifacts) ? data.artifacts.map(mapAgentCampaignArtifact) : [];
+  }
+  async approveDelivery(campaignBuildId, destinationType, options) {
+    return this.approveCampaignDelivery(campaignBuildId, destinationType, options);
+  }
   async getCampaignBuildStatus(campaignBuildId) {
     const data = await this.callMcp("get_campaign_build_status", {
       campaign_build_id: campaignBuildId
@@ -3292,6 +3316,40 @@ function mapAgentCampaignBuildStatus(data) {
     completedAt: stringValue(data.completed_at) ?? null
   };
 }
+function mapAgentCampaignRowsResult(data) {
+  const rows = Array.isArray(data.rows) ? data.rows : [];
+  return {
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    rows: rows.map((row, index) => {
+      const record = asRecord(row);
+      return {
+        index: numberOrUndefined2(record.index) ?? index,
+        status: stringValue(record.status) ?? stringValue(record.row_status) ?? "unknown",
+        qualified: record.qualified !== false,
+        segment: stringValue(record.segment) ?? null,
+        data: nullableRecord(record.data) ?? record
+      };
+    }),
+    count: numberOrUndefined2(data.count) ?? rows.length,
+    pageSize: numberOrUndefined2(data.page_size) ?? rows.length,
+    nextCursor: stringValue(data.next_cursor) ?? null,
+    hasMore: data.has_more === true
+  };
+}
+function mapAgentCampaignArtifact(data) {
+  return {
+    id: stringValue(data.id) ?? "",
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    artifactType: stringValue(data.artifact_type) ?? "",
+    destination: stringValue(data.destination) ?? "",
+    storagePath: stringValue(data.storage_path) ?? "",
+    signedUrl: stringValue(data.signed_url) ?? null,
+    rowCount: numberOrUndefined2(data.row_count) ?? 0,
+    checksum: stringValue(data.checksum) ?? null,
+    metadata: nullableRecord(data.metadata) ?? {},
+    createdAt: stringValue(data.created_at) ?? ""
+  };
+}
 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-EQZJFFS7.mjs";
+} from "./chunk-QQW6DZQ4.mjs";
 export {
   Ai,
   CAMPAIGN_BUILDER_OPERATING_PLAYBOOKS,

package/dist/mcp-config.js

@@ -1855,10 +1855,7 @@ var CampaignBuilderAgent = class {
       ["completed", "failed", "canceled", "pending_approval"]
     );
     const result = { build, finalStatus };
-    if (options.approveDelivery === true) {
-      if (finalStatus.status !== "pending_approval") {
-        throw new Error(`Campaign build ${campaignBuildId} reached ${finalStatus.status}; delivery approval was not available`);
-      }
+    if (options.approveDelivery === true && finalStatus.status === "pending_approval") {
       const destinationType = options.deliveryDestinationType ?? plan.buildRequest.delivery?.destinationType ?? "json";
       result.deliveryApproval = await this.approveCampaignDelivery(campaignBuildId, destinationType, {
         destinationId: options.deliveryDestinationId,
@@ -1873,6 +1870,33 @@ var CampaignBuilderAgent = class {
     }
     return result;
   }
+  async getBuildStatus(campaignBuildId) {
+    return this.getCampaignBuildStatus(campaignBuildId);
+  }
+  async getBuildRows(campaignBuildId, options = {}) {
+    const filters = compact({
+      segment: options.segment,
+      qualified: options.qualified,
+      row_status: options.rowStatus
+    });
+    const args = compact({
+      campaign_build_id: campaignBuildId,
+      page_size: options.limit,
+      cursor: options.cursor
+    });
+    if (Object.keys(filters).length > 0) args.filters = filters;
+    const data = await this.callMcp("get_campaign_build_rows", args);
+    return mapAgentCampaignRowsResult(data);
+  }
+  async listBuildArtifacts(campaignBuildId) {
+    const data = await this.callMcp("list_campaign_build_artifacts", {
+      campaign_build_id: campaignBuildId
+    });
+    return Array.isArray(data.artifacts) ? data.artifacts.map(mapAgentCampaignArtifact) : [];
+  }
+  async approveDelivery(campaignBuildId, destinationType, options) {
+    return this.approveCampaignDelivery(campaignBuildId, destinationType, options);
+  }
   async getCampaignBuildStatus(campaignBuildId) {
     const data = await this.callMcp("get_campaign_build_status", {
       campaign_build_id: campaignBuildId
@@ -3165,6 +3189,40 @@ function mapAgentCampaignBuildStatus(data) {
     completedAt: stringValue(data.completed_at) ?? null
   };
 }
+function mapAgentCampaignRowsResult(data) {
+  const rows = Array.isArray(data.rows) ? data.rows : [];
+  return {
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    rows: rows.map((row, index) => {
+      const record = asRecord(row);
+      return {
+        index: numberOrUndefined2(record.index) ?? index,
+        status: stringValue(record.status) ?? stringValue(record.row_status) ?? "unknown",
+        qualified: record.qualified !== false,
+        segment: stringValue(record.segment) ?? null,
+        data: nullableRecord(record.data) ?? record
+      };
+    }),
+    count: numberOrUndefined2(data.count) ?? rows.length,
+    pageSize: numberOrUndefined2(data.page_size) ?? rows.length,
+    nextCursor: stringValue(data.next_cursor) ?? null,
+    hasMore: data.has_more === true
+  };
+}
+function mapAgentCampaignArtifact(data) {
+  return {
+    id: stringValue(data.id) ?? "",
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    artifactType: stringValue(data.artifact_type) ?? "",
+    destination: stringValue(data.destination) ?? "",
+    storagePath: stringValue(data.storage_path) ?? "",
+    signedUrl: stringValue(data.signed_url) ?? null,
+    rowCount: numberOrUndefined2(data.row_count) ?? 0,
+    checksum: stringValue(data.checksum) ?? null,
+    metadata: nullableRecord(data.metadata) ?? {},
+    createdAt: stringValue(data.created_at) ?? ""
+  };
+}
 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-EQZJFFS7.mjs";
+} from "./chunk-QQW6DZQ4.mjs";
 
 // src/mcp-config.ts
 import * as fs from "fs";

package/package.json

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