@signaliz/sdk 1.0.10 → 1.0.12

package/dist/mcp-config.js

@@ -1870,6 +1870,42 @@ 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 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
@@ -3162,6 +3198,154 @@ 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 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-2EXN3RAX.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.10",
+  "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",