@signaliz/sdk 1.0.7 → 1.0.9

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

@@ -1815,6 +1815,79 @@ var CampaignBuilderAgent = class {
     const data = await this.callMcp("build_campaign", args);
     return mapBuildResult(data, false);
   }
+  async runApprovedPlan(plan, approval, options = {}) {
+    const build = await this.buildApprovedPlan(plan, approval, options);
+    const campaignBuildId = build.campaignBuildId;
+    if (!campaignBuildId) {
+      if (options.wait || options.approveDelivery) {
+        throw new Error("Campaign builder approved run did not return a campaignBuildId to poll");
+      }
+      return { build };
+    }
+    const shouldWait = options.wait === true || options.approveDelivery === true;
+    if (!shouldWait) return { build };
+    let finalStatus = await this.waitForCampaignBuildStatus(
+      campaignBuildId,
+      options,
+      ["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`);
+      }
+      const destinationType = options.deliveryDestinationType ?? plan.buildRequest.delivery?.destinationType ?? "json";
+      result.deliveryApproval = await this.approveCampaignDelivery(campaignBuildId, destinationType, {
+        destinationId: options.deliveryDestinationId,
+        destinationConfig: options.deliveryDestinationConfig ?? plan.buildRequest.delivery?.destinationConfig
+      });
+      finalStatus = await this.waitForCampaignBuildStatus(
+        campaignBuildId,
+        options,
+        ["completed", "failed", "canceled"]
+      );
+      result.finalStatus = finalStatus;
+    }
+    return result;
+  }
+  async getCampaignBuildStatus(campaignBuildId) {
+    const data = await this.callMcp("get_campaign_build_status", {
+      campaign_build_id: campaignBuildId
+    });
+    return mapAgentCampaignBuildStatus(data);
+  }
+  async waitForCampaignBuildStatus(campaignBuildId, options, stopStatuses) {
+    const interval = options.waitIntervalMs ?? 5e3;
+    const timeout = options.waitTimeoutMs ?? 6e5;
+    const startedAt = Date.now();
+    while (true) {
+      const status = await this.getCampaignBuildStatus(campaignBuildId);
+      options.onStatus?.(status);
+      if (stopStatuses.includes(status.status)) return status;
+      if (Date.now() - startedAt > timeout) {
+        throw new Error(`Campaign build ${campaignBuildId} timed out after ${timeout}ms (status: ${status.status})`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+  }
+  async approveCampaignDelivery(campaignBuildId, destinationType, options) {
+    const args = compact({
+      campaign_build_id: campaignBuildId,
+      destination_type: destinationType,
+      destination_id: options?.destinationId,
+      destination_config: options?.destinationConfig
+    });
+    const data = await this.callMcp("approve_campaign_delivery", args);
+    return {
+      campaignBuildId: data.campaign_build_id,
+      destinationType: data.destination_type ?? destinationType,
+      status: data.status ?? "approved",
+      message: data.message ?? "",
+      deliveryId: data.delivery_id,
+      deliveryIds: data.delivery_ids,
+      approvedCount: data.approved_count
+    };
+  }
   async getWorkspaceContext(warnings) {
     try {
       const workspace = await this.callMcp("get_workspace", {});
@@ -2760,6 +2833,17 @@ function createMcpFlow(request, buildRequest, routes, memory, approvals) {
     readOnly: false,
     approvalRequired: approvals.some((approval) => approval.blocking)
   });
+  const deliveryApprovalArgs = buildDeliveryApprovalArgs(buildRequest);
+  if (deliveryApprovalArgs) {
+    steps.push({
+      id: "delivery-approval",
+      phase: "delivery",
+      tool: "approve_campaign_delivery",
+      arguments: deliveryApprovalArgs,
+      readOnly: false,
+      approvalRequired: true
+    });
+  }
   return steps.map((step) => ({ ...step, arguments: compact(step.arguments) }));
 }
 function shouldPrepareProviderRoute(route) {
@@ -3102,6 +3186,14 @@ function buildExecutionPrepareArgs(request, dryRun, confirmSpend) {
     enhancers: buildArgs2.enhancers
   });
 }
+function buildDeliveryApprovalArgs(request) {
+  if (request.delivery?.enabled === false || request.delivery?.approvalRequired === false) return void 0;
+  return compact({
+    campaign_build_id: "<campaign_build_id_from_approved_build>",
+    destination_type: request.delivery?.destinationType ?? "json",
+    destination_config: request.delivery?.destinationConfig
+  });
+}
 function mapBuildResult(data, dryRun) {
   return {
     campaignBuildId: data.campaign_build_id ?? null,
@@ -3123,6 +3215,55 @@ function mapBuildResult(data, dryRun) {
     providerRoute: mapProviderRoute2(data)
   };
 }
+function mapAgentCampaignBuildStatus(data) {
+  return {
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    campaignId: stringValue(data.campaign_id) ?? null,
+    campaignObject: nullableRecord(data.campaign_object),
+    name: stringValue(data.name) ?? "",
+    status: stringValue(data.status) ?? "unknown",
+    currentPhase: stringValue(data.current_phase) ?? null,
+    currentPhaseStatus: stringValue(data.current_phase_status) ?? null,
+    phases: Array.isArray(data.phases) ? data.phases : [],
+    recordsTotal: numberOrUndefined2(data.records_total) ?? 0,
+    recordsProcessed: numberOrUndefined2(data.records_processed) ?? 0,
+    recordsSucceeded: numberOrUndefined2(data.records_succeeded) ?? 0,
+    recordsFailed: numberOrUndefined2(data.records_failed) ?? 0,
+    warnings: diagnosticMessages2(data.warnings),
+    errors: diagnosticMessages2(data.errors),
+    artifactCount: numberOrUndefined2(data.artifact_count) ?? 0,
+    providerRoute: mapProviderRoute2(data),
+    triggerRunId: stringValue(data.trigger_run_id) ?? null,
+    staleRunningPhase: data.stale_running_phase === true,
+    phaseAgeSeconds: numberOrNull2(data.phase_age_seconds),
+    diagnostics: nullableRecord(data.diagnostics) ?? {},
+    nextAction: formatAgentNextAction(data.next_action),
+    createdAt: stringValue(data.created_at) ?? "",
+    updatedAt: stringValue(data.updated_at) ?? "",
+    completedAt: stringValue(data.completed_at) ?? null
+  };
+}
+function diagnosticMessages2(value) {
+  if (!Array.isArray(value)) return [];
+  return value.map((item) => {
+    if (typeof item === "string") return item;
+    const record = nullableRecord(item);
+    return stringValue(record?.message);
+  }).filter((item) => typeof item === "string" && item.length > 0);
+}
+function formatAgentNextAction(value) {
+  if (!value) return "";
+  if (typeof value === "string") return value;
+  const record = nullableRecord(value);
+  if (!record) return "";
+  const tool = stringValue(record.tool);
+  const type = stringValue(record.type);
+  const reason = stringValue(record.reason);
+  const args = nullableRecord(record.arguments);
+  const argText = args && Object.keys(args).length > 0 ? ` ${JSON.stringify(args)}` : "";
+  const action = tool ? `${tool}${argText}` : type ?? "";
+  return [action, reason].filter(Boolean).join(" - ");
+}
 function mapProviderRoute2(data) {
   const brainContext = asRecord(data?.brain_context);
   const plan = nullableRecord(data?.provider_route_plan) ?? nullableRecord(brainContext.provider_route_plan);

package/dist/cli.js

@@ -1821,6 +1821,79 @@ var CampaignBuilderAgent = class {
     const data = await this.callMcp("build_campaign", args);
     return mapBuildResult(data, false);
   }
+  async runApprovedPlan(plan, approval, options = {}) {
+    const build = await this.buildApprovedPlan(plan, approval, options);
+    const campaignBuildId = build.campaignBuildId;
+    if (!campaignBuildId) {
+      if (options.wait || options.approveDelivery) {
+        throw new Error("Campaign builder approved run did not return a campaignBuildId to poll");
+      }
+      return { build };
+    }
+    const shouldWait = options.wait === true || options.approveDelivery === true;
+    if (!shouldWait) return { build };
+    let finalStatus = await this.waitForCampaignBuildStatus(
+      campaignBuildId,
+      options,
+      ["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`);
+      }
+      const destinationType = options.deliveryDestinationType ?? plan.buildRequest.delivery?.destinationType ?? "json";
+      result.deliveryApproval = await this.approveCampaignDelivery(campaignBuildId, destinationType, {
+        destinationId: options.deliveryDestinationId,
+        destinationConfig: options.deliveryDestinationConfig ?? plan.buildRequest.delivery?.destinationConfig
+      });
+      finalStatus = await this.waitForCampaignBuildStatus(
+        campaignBuildId,
+        options,
+        ["completed", "failed", "canceled"]
+      );
+      result.finalStatus = finalStatus;
+    }
+    return result;
+  }
+  async getCampaignBuildStatus(campaignBuildId) {
+    const data = await this.callMcp("get_campaign_build_status", {
+      campaign_build_id: campaignBuildId
+    });
+    return mapAgentCampaignBuildStatus(data);
+  }
+  async waitForCampaignBuildStatus(campaignBuildId, options, stopStatuses) {
+    const interval = options.waitIntervalMs ?? 5e3;
+    const timeout = options.waitTimeoutMs ?? 6e5;
+    const startedAt = Date.now();
+    while (true) {
+      const status = await this.getCampaignBuildStatus(campaignBuildId);
+      options.onStatus?.(status);
+      if (stopStatuses.includes(status.status)) return status;
+      if (Date.now() - startedAt > timeout) {
+        throw new Error(`Campaign build ${campaignBuildId} timed out after ${timeout}ms (status: ${status.status})`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+  }
+  async approveCampaignDelivery(campaignBuildId, destinationType, options) {
+    const args = compact({
+      campaign_build_id: campaignBuildId,
+      destination_type: destinationType,
+      destination_id: options?.destinationId,
+      destination_config: options?.destinationConfig
+    });
+    const data = await this.callMcp("approve_campaign_delivery", args);
+    return {
+      campaignBuildId: data.campaign_build_id,
+      destinationType: data.destination_type ?? destinationType,
+      status: data.status ?? "approved",
+      message: data.message ?? "",
+      deliveryId: data.delivery_id,
+      deliveryIds: data.delivery_ids,
+      approvedCount: data.approved_count
+    };
+  }
   async getWorkspaceContext(warnings) {
     try {
       const workspace = await this.callMcp("get_workspace", {});
@@ -2766,6 +2839,17 @@ function createMcpFlow(request, buildRequest, routes, memory, approvals) {
     readOnly: false,
     approvalRequired: approvals.some((approval) => approval.blocking)
   });
+  const deliveryApprovalArgs = buildDeliveryApprovalArgs(buildRequest);
+  if (deliveryApprovalArgs) {
+    steps.push({
+      id: "delivery-approval",
+      phase: "delivery",
+      tool: "approve_campaign_delivery",
+      arguments: deliveryApprovalArgs,
+      readOnly: false,
+      approvalRequired: true
+    });
+  }
   return steps.map((step) => ({ ...step, arguments: compact(step.arguments) }));
 }
 function shouldPrepareProviderRoute(route) {
@@ -3108,6 +3192,14 @@ function buildExecutionPrepareArgs(request, dryRun, confirmSpend) {
     enhancers: buildArgs2.enhancers
   });
 }
+function buildDeliveryApprovalArgs(request) {
+  if (request.delivery?.enabled === false || request.delivery?.approvalRequired === false) return void 0;
+  return compact({
+    campaign_build_id: "<campaign_build_id_from_approved_build>",
+    destination_type: request.delivery?.destinationType ?? "json",
+    destination_config: request.delivery?.destinationConfig
+  });
+}
 function mapBuildResult(data, dryRun) {
   return {
     campaignBuildId: data.campaign_build_id ?? null,
@@ -3129,6 +3221,55 @@ function mapBuildResult(data, dryRun) {
     providerRoute: mapProviderRoute2(data)
   };
 }
+function mapAgentCampaignBuildStatus(data) {
+  return {
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    campaignId: stringValue(data.campaign_id) ?? null,
+    campaignObject: nullableRecord(data.campaign_object),
+    name: stringValue(data.name) ?? "",
+    status: stringValue(data.status) ?? "unknown",
+    currentPhase: stringValue(data.current_phase) ?? null,
+    currentPhaseStatus: stringValue(data.current_phase_status) ?? null,
+    phases: Array.isArray(data.phases) ? data.phases : [],
+    recordsTotal: numberOrUndefined2(data.records_total) ?? 0,
+    recordsProcessed: numberOrUndefined2(data.records_processed) ?? 0,
+    recordsSucceeded: numberOrUndefined2(data.records_succeeded) ?? 0,
+    recordsFailed: numberOrUndefined2(data.records_failed) ?? 0,
+    warnings: diagnosticMessages2(data.warnings),
+    errors: diagnosticMessages2(data.errors),
+    artifactCount: numberOrUndefined2(data.artifact_count) ?? 0,
+    providerRoute: mapProviderRoute2(data),
+    triggerRunId: stringValue(data.trigger_run_id) ?? null,
+    staleRunningPhase: data.stale_running_phase === true,
+    phaseAgeSeconds: numberOrNull2(data.phase_age_seconds),
+    diagnostics: nullableRecord(data.diagnostics) ?? {},
+    nextAction: formatAgentNextAction(data.next_action),
+    createdAt: stringValue(data.created_at) ?? "",
+    updatedAt: stringValue(data.updated_at) ?? "",
+    completedAt: stringValue(data.completed_at) ?? null
+  };
+}
+function diagnosticMessages2(value) {
+  if (!Array.isArray(value)) return [];
+  return value.map((item) => {
+    if (typeof item === "string") return item;
+    const record = nullableRecord(item);
+    return stringValue(record?.message);
+  }).filter((item) => typeof item === "string" && item.length > 0);
+}
+function formatAgentNextAction(value) {
+  if (!value) return "";
+  if (typeof value === "string") return value;
+  const record = nullableRecord(value);
+  if (!record) return "";
+  const tool = stringValue(record.tool);
+  const type = stringValue(record.type);
+  const reason = stringValue(record.reason);
+  const args = nullableRecord(record.arguments);
+  const argText = args && Object.keys(args).length > 0 ? ` ${JSON.stringify(args)}` : "";
+  const action = tool ? `${tool}${argText}` : type ?? "";
+  return [action, reason].filter(Boolean).join(" - ");
+}
 function mapProviderRoute2(data) {
   const brainContext = asRecord(data?.brain_context);
   const plan = nullableRecord(data?.provider_route_plan) ?? nullableRecord(brainContext.provider_route_plan);
@@ -6553,7 +6694,21 @@ async function handleCampaignAgentCommand(signaliz, argv) {
       approvedRouteIds: approvedRouteIdsFromFlags(plan, flags),
       notes: stringFlag(flags, "approval-notes", "notes")
     });
-    const result = await signaliz.campaignBuilderAgent.buildApprovedPlan(plan, approval, {
+    const runApproved = booleanFlag(flags, "wait") || booleanFlag(flags, "approve-delivery");
+    const result = runApproved ? await signaliz.campaignBuilderAgent.runApprovedPlan(plan, approval, {
+      idempotencyKey: stringFlag(flags, "idempotency-key"),
+      commitBeforeLaunch: booleanFlag(flags, "commit-before-launch"),
+      wait: booleanFlag(flags, "wait"),
+      approveDelivery: booleanFlag(flags, "approve-delivery"),
+      deliveryDestinationType: stringFlag(flags, "delivery-destination-type", "destination-type"),
+      deliveryDestinationId: stringFlag(flags, "delivery-destination-id", "destination-id"),
+      deliveryDestinationConfig: jsonObjectFlag(flags, "delivery-config", "destination-config"),
+      waitIntervalMs: numberFlag(flags, "wait-interval-ms"),
+      waitTimeoutMs: numberFlag(flags, "wait-timeout-ms"),
+      onStatus: booleanFlag(flags, "json") ? void 0 : (status) => {
+        console.error(`campaign-agent build-approved: ${status.status} phase=${status.currentPhase ?? "N/A"} rows=${status.recordsSucceeded}/${status.recordsTotal} artifacts=${status.artifactCount}`);
+      }
+    }) : await signaliz.campaignBuilderAgent.buildApprovedPlan(plan, approval, {
       idempotencyKey: stringFlag(flags, "idempotency-key"),
       commitBeforeLaunch: booleanFlag(flags, "commit-before-launch")
     });
@@ -6966,7 +7121,8 @@ function createCampaignAgentProofReceipt(plan, result) {
     recommended_next_actions: [
       "Review the plan, approvals, and dry-run result.",
       "Use campaign-agent commit-plan --confirm-write only after review.",
-      "Use campaign-agent build-approved only with --confirm-launch, approval identity, approval types, and spend limit."
+      "Use campaign-agent build-approved only with --confirm-launch, approval identity, approval types, and spend limit.",
+      "When an approved build reaches pending_approval, review rows and approve delivery through the Campaigns SDK."
     ]
   };
 }
@@ -7076,6 +7232,7 @@ Usage:
   signaliz campaign-agent commit-plan --goal "Build a strategy-template campaign..." --json
   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
 
 Environment:
   SIGNALIZ_API_KEY   Your API key (not required for campaign-agent init)
@@ -7106,9 +7263,9 @@ Signaliz campaign-agent commands:
   signaliz campaign-agent proof (--goal TEXT | --request-file FILE) [--strategy-template ID] [--target-count N] [--use-local-leads] [--custom-tool provider:layer:tool[:mcp]] [--idempotency-key KEY] [--json]
   signaliz campaign-agent commit-plan (--goal TEXT | --request-file FILE) [--confirm-write --approved-by EMAIL] [--idempotency-key KEY] [--json]
   signaliz campaign-agent dry-run (--goal TEXT | --request-file FILE) [--gtm-campaign-id ID] [--delivery-risk JSON] [--idempotency-key KEY] [--json]
-  signaliz campaign-agent build-approved (--goal TEXT | --request-file FILE) --confirm-launch --approved-by EMAIL (--approve-all | --approved-types a,b) [--commit-before-launch] [--spend-limit N] [--approved-route-ids a,b] [--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]
 
-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.
+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.
 `);
 }
 main().catch((e) => {

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   Signaliz,
   createCampaignBuilderAgentRequestTemplate,
   createCampaignBuilderApproval
-} from "./chunk-BHL5NHVO.mjs";
+} from "./chunk-EQZJFFS7.mjs";
 
 // src/cli.ts
 import { readFileSync, writeFileSync } from "fs";
@@ -451,7 +451,21 @@ async function handleCampaignAgentCommand(signaliz, argv) {
       approvedRouteIds: approvedRouteIdsFromFlags(plan, flags),
       notes: stringFlag(flags, "approval-notes", "notes")
     });
-    const result = await signaliz.campaignBuilderAgent.buildApprovedPlan(plan, approval, {
+    const runApproved = booleanFlag(flags, "wait") || booleanFlag(flags, "approve-delivery");
+    const result = runApproved ? await signaliz.campaignBuilderAgent.runApprovedPlan(plan, approval, {
+      idempotencyKey: stringFlag(flags, "idempotency-key"),
+      commitBeforeLaunch: booleanFlag(flags, "commit-before-launch"),
+      wait: booleanFlag(flags, "wait"),
+      approveDelivery: booleanFlag(flags, "approve-delivery"),
+      deliveryDestinationType: stringFlag(flags, "delivery-destination-type", "destination-type"),
+      deliveryDestinationId: stringFlag(flags, "delivery-destination-id", "destination-id"),
+      deliveryDestinationConfig: jsonObjectFlag(flags, "delivery-config", "destination-config"),
+      waitIntervalMs: numberFlag(flags, "wait-interval-ms"),
+      waitTimeoutMs: numberFlag(flags, "wait-timeout-ms"),
+      onStatus: booleanFlag(flags, "json") ? void 0 : (status) => {
+        console.error(`campaign-agent build-approved: ${status.status} phase=${status.currentPhase ?? "N/A"} rows=${status.recordsSucceeded}/${status.recordsTotal} artifacts=${status.artifactCount}`);
+      }
+    }) : await signaliz.campaignBuilderAgent.buildApprovedPlan(plan, approval, {
       idempotencyKey: stringFlag(flags, "idempotency-key"),
       commitBeforeLaunch: booleanFlag(flags, "commit-before-launch")
     });
@@ -864,7 +878,8 @@ function createCampaignAgentProofReceipt(plan, result) {
     recommended_next_actions: [
       "Review the plan, approvals, and dry-run result.",
       "Use campaign-agent commit-plan --confirm-write only after review.",
-      "Use campaign-agent build-approved only with --confirm-launch, approval identity, approval types, and spend limit."
+      "Use campaign-agent build-approved only with --confirm-launch, approval identity, approval types, and spend limit.",
+      "When an approved build reaches pending_approval, review rows and approve delivery through the Campaigns SDK."
     ]
   };
 }
@@ -974,6 +989,7 @@ Usage:
   signaliz campaign-agent commit-plan --goal "Build a strategy-template campaign..." --json
   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
 
 Environment:
   SIGNALIZ_API_KEY   Your API key (not required for campaign-agent init)
@@ -1004,9 +1020,9 @@ Signaliz campaign-agent commands:
   signaliz campaign-agent proof (--goal TEXT | --request-file FILE) [--strategy-template ID] [--target-count N] [--use-local-leads] [--custom-tool provider:layer:tool[:mcp]] [--idempotency-key KEY] [--json]
   signaliz campaign-agent commit-plan (--goal TEXT | --request-file FILE) [--confirm-write --approved-by EMAIL] [--idempotency-key KEY] [--json]
   signaliz campaign-agent dry-run (--goal TEXT | --request-file FILE) [--gtm-campaign-id ID] [--delivery-risk JSON] [--idempotency-key KEY] [--json]
-  signaliz campaign-agent build-approved (--goal TEXT | --request-file FILE) --confirm-launch --approved-by EMAIL (--approve-all | --approved-types a,b) [--commit-before-launch] [--spend-limit N] [--approved-route-ids a,b] [--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]
 
-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.
+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.
 `);
 }
 main().catch((e) => {

package/dist/index.d.mts

@@ -1079,6 +1079,21 @@ interface CampaignBuilderPlanCommitResult {
 type CampaignBuilderBuildOptions = BuildOptions & {
     commitBeforeLaunch?: boolean;
 };
+type CampaignBuilderApprovedRunOptions = CampaignBuilderBuildOptions & {
+    wait?: boolean;
+    approveDelivery?: boolean;
+    deliveryDestinationType?: CampaignDeliveryMode;
+    deliveryDestinationId?: string;
+    deliveryDestinationConfig?: UnknownRecord$1;
+    waitIntervalMs?: number;
+    waitTimeoutMs?: number;
+    onStatus?: (status: CampaignBuildStatus) => void;
+};
+interface CampaignBuilderApprovedRunResult {
+    build: CampaignBuildResult;
+    finalStatus?: CampaignBuildStatus;
+    deliveryApproval?: ApproveDeliveryResult;
+}
 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[];
@@ -1091,6 +1106,10 @@ declare class CampaignBuilderAgent {
     commitPlan(plan: CampaignBuilderAgentPlan, options?: CampaignBuilderPlanCommitOptions): Promise<CampaignBuilderPlanCommitResult>;
     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>;
+    private getCampaignBuildStatus;
+    private waitForCampaignBuildStatus;
+    private approveCampaignDelivery;
     private getWorkspaceContext;
     private scopeCampaign;
     private discoverPlannedRoutes;
@@ -3365,4 +3384,4 @@ declare class Signaliz {
     discover(query: string, category?: string): Promise<MCPToolInfo[]>;
 }
 
-export { Ai, type ApproveDeliveryResult, type BuildOptions, CAMPAIGN_BUILDER_OPERATING_PLAYBOOKS, CAMPAIGN_BUILDER_STRATEGY_TEMPLATES, type CampaignArtifact, type CampaignBuildRequest$1 as CampaignBuildRequest, type CampaignBuildResult$1 as CampaignBuildResult, type CampaignBuildRow, type CampaignBuildStatus, CampaignBuilderAgent, type CampaignBuilderAgentPlan, type CampaignBuilderAgentProvider, type CampaignBuilderAgentRequest, type CampaignBuilderAgentRequestTemplateOptions, type CampaignBuilderApproval, type CampaignBuilderApprovalPolicy, type CampaignBuilderApprovalType, type CampaignBuilderBuildOptions, type CampaignBuilderBuiltInTool, type CampaignBuilderCustomerTool, type CampaignBuilderGtmLayer, type CampaignBuilderIntegrationRoute, type CampaignBuilderLayer, type CampaignBuilderMcpStep, type CampaignBuilderMemoryPlan, type CampaignBuilderMemoryQuery, type CampaignBuilderMemoryScope, type CampaignBuilderOperatingPlaybook, type CampaignBuilderOperatingPlaybookSlug, type CampaignBuilderPlanCommitOptions, type CampaignBuilderPlanCommitResult, type CampaignBuilderPlanOptions, type CampaignBuilderProvider, type CampaignBuilderRequiredApproval, type CampaignBuilderRouteMode, type CampaignBuilderStrategyTemplate, type CampaignBuilderStrategyTemplateSlug, type CampaignBuilderWorkspaceContext, type CampaignDeliveryMode, type CampaignProviderRouteReadback, type CampaignRowsOptions, type CampaignRowsResult, Campaigns, type CancelBuildResult, type CompanyIntelligenceParams, type CompanyIntelligenceResult, type CreateOutputSinkRequest, type CreateRoutineRequest, type CreateSystemParams, type CustomAiAttachment, type CustomAiFusionConfig, type CustomAiMultiModelParams, type CustomAiMultiModelResult, type CustomAiOutputField, DEFAULT_CAMPAIGN_BUILDER_APPROVAL_TYPES, DEFAULT_CAMPAIGN_BUILDER_BUILT_INS, DEFAULT_SIGNALIZ_CAMPAIGN_BUILDER_DEFAULTS, type EmailBatchJobResult, type EnrichSignalsParams, type EnrichSignalsResult, type ErrorType, type ExecutionReference, type ExecutionReferenceInput, type ExecutionReferenceKind, type FindAndVerifyEmailContact, type FindEmailParams, type FindEmailResult, type GenerateLeadsParams, type GenerateLocalLeadsParams, type GtmActorType, type GtmAuthStrategy, type GtmBrainAggregateCalibrationsInput, type GtmBrainAggregatePatternsInput, type GtmBrainCalibrateDeliverabilityInput, type GtmBrainDeliveryRiskInput, type GtmBrainDistillRunInput, type GtmBrainExtractPatternsInput, type GtmBrainFailurePatternsOptions, type GtmBrainLearningAction, type GtmBrainLearningCyclePhase, type GtmBrainLearningCyclePlanInput, type GtmBrainLearningCyclePlanResult, type GtmBrainLearningCycleRunInput, type GtmBrainLearningEvidenceCounts, type GtmBrainLearningLane, type GtmBrainLearningLaneId, type GtmBrainLearningLaneState, type GtmBrainLearningLaneSummary, type GtmBrainLearningPhaseReadiness, type GtmBrainLearningPhaseStatus, type GtmBrainLearningRecommendedToolCall, type GtmBrainPatternsOptions, type GtmBrainSeedDefaultsInput, type GtmCalibrationDimensionType, type GtmCampaignAgentPlanInput, type GtmCampaignAgentRequestTemplateInput, type GtmCampaignBuildPlanInput, type GtmCampaignCreateInput, type GtmCampaignGetOptions, type GtmCampaignHistoryCampaignInput, type GtmCampaignHistoryImportBatchInput, type GtmCampaignHistoryImportInput, type GtmCampaignHistoryImportRunInput, type GtmCampaignHistoryMemoryInput, type GtmCampaignLearningStatusResult, type GtmCampaignListOptions, type GtmCampaignLogInput, type GtmCampaignSource, type GtmCampaignStartContextInput, type GtmCampaignStatus, type GtmCampaignStrategyMemoryStatusInput, type GtmCampaignStrategyTemplateSlug, type GtmCampaignStrategyTemplatesOptions, type GtmCampaignUpdateInput, type GtmConnectionRegisterInput, type GtmConnectionsListOptions, type GtmExistingCampaignAuditBoundary, type GtmExistingCampaignAuditBySearchOptions, type GtmExistingCampaignAuditOptions, type GtmExistingCampaignAuditRecommendation, type GtmExistingCampaignAuditResult, type GtmExistingCampaignCompletenessStep, type GtmExistingCampaignDiscoverOptions, type GtmExistingCampaignDiscoveryResult, type GtmExistingCampaignMcpRequest, type GtmExistingCampaignOption, type GtmFeedbackIngestInput, type GtmIntegrationRecipeCreateInput, type GtmInvocationType, GtmKernel, type GtmKernelImportPreviewInput, type GtmKernelImportRunInput, type GtmLayer, type GtmLayerRouteSetInput, type GtmLayerRoutesGetOptions, type GtmMemorySearchOptions, type GtmMemoryType, type GtmPatternType, type GtmProviderLinkInput, type GtmProviderRecipePrepareInput, type GtmProviderRouteActivateInput, type GtmWebhookDeliverInput, type GtmWorkspaceBootstrapStatusOptions, type GtmWorkspaceContextOptions, type HttpRequestParams, type HttpRequestResult, type IcpDetail, type IcpSummary, Icps, type ImportOctaveResult, type LeadGenJobResult, type ListOutputSinksOptions, type MCPToolInfo, type NativeGtmCapabilityInfo, Ops, type OpsApproveRequest, type OpsApproveResult, type OpsBlueprint, type OpsCadence, type OpsCreateRequest, type OpsCreateResult, type OpsDashboardOptions, type OpsDashboardResult, type OpsDebugDiagnosticError, type OpsDebugOptions, type OpsDebugResult, type OpsPlanRequest, type OpsPlanResult, type OpsPrimitive, type OpsPrimitiveConcurrencyPolicy, type OpsPrimitiveDeadLetterPolicy, type OpsPrimitiveObservabilityPolicy, type OpsPrimitivePermissionLevel, type OpsPrimitiveRetryPolicy, type OpsPrimitiveWorkspaceScope, type OpsQueueStatus, type OpsQueueStatusOptions, type OpsQuickstartStep, type OpsQuickstartWorkflow, type OpsReadinessCheck, type OpsReadinessOptions, type OpsReadinessResult, type OpsReplayResult, type OpsResultsOptions, type OpsResultsResult, type OpsRoutine, type OpsRoutineDeleteResult, type OpsRoutineRunResult, type OpsRoutineSinkResult, type OpsRoutineStatus, type OpsRoutineTick, type OpsRoutineTickItem, type OpsRoutineTickItemsResult, type OpsRoutineTicksResult, type OpsRoutinesResult, type OpsRunOptions, type OpsRunResult, type OpsSink, type OpsSinkType, type OpsStatusOptions, type OpsStatusResult, type OpsTriggerBatchRunStatus, type OpsTriggerRunStatus, type OpsTriggerRunStatusOptions, type PlatformHealth, type RunNativeGtmCapabilityParams, type RunProgressEvent, type RunResult, type RunRoutineRequest, type RunSystemParams, type Signal, Signaliz, type SignalizCampaignBuilderDefaults, type SignalizConfig, SignalizError, type SignalizErrorData, type SimpleOpStatus, type SystemResult, type UpdateRoutineRequest, type VerifyEmailResult, type WaitOptions, type WorkspaceInfo, applyCampaignBuilderStrategyTemplate, collectExecutionReferences, createCampaignBuilderAgentPlan, createCampaignBuilderAgentRequestTemplate, createCampaignBuilderApproval, createCampaignBuilderToolRoute, getCampaignBuilderOperatingPlaybook, getCampaignBuilderOperatingPlaybooksForRequest, getCampaignBuilderStrategyTemplate, getMissingCampaignBuilderApprovals, normalizeExecutionReference };
+export { Ai, type ApproveDeliveryResult, type BuildOptions, CAMPAIGN_BUILDER_OPERATING_PLAYBOOKS, CAMPAIGN_BUILDER_STRATEGY_TEMPLATES, type CampaignArtifact, type CampaignBuildRequest$1 as CampaignBuildRequest, type CampaignBuildResult$1 as CampaignBuildResult, type CampaignBuildRow, type CampaignBuildStatus, CampaignBuilderAgent, type CampaignBuilderAgentPlan, type CampaignBuilderAgentProvider, type CampaignBuilderAgentRequest, type CampaignBuilderAgentRequestTemplateOptions, type CampaignBuilderApproval, type CampaignBuilderApprovalPolicy, type CampaignBuilderApprovalType, type CampaignBuilderApprovedRunOptions, type CampaignBuilderApprovedRunResult, type CampaignBuilderBuildOptions, type CampaignBuilderBuiltInTool, type CampaignBuilderCustomerTool, type CampaignBuilderGtmLayer, type CampaignBuilderIntegrationRoute, type CampaignBuilderLayer, type CampaignBuilderMcpStep, type CampaignBuilderMemoryPlan, type CampaignBuilderMemoryQuery, type CampaignBuilderMemoryScope, type CampaignBuilderOperatingPlaybook, type CampaignBuilderOperatingPlaybookSlug, type CampaignBuilderPlanCommitOptions, type CampaignBuilderPlanCommitResult, type CampaignBuilderPlanOptions, type CampaignBuilderProvider, type CampaignBuilderRequiredApproval, type CampaignBuilderRouteMode, type CampaignBuilderStrategyTemplate, type CampaignBuilderStrategyTemplateSlug, type CampaignBuilderWorkspaceContext, type CampaignDeliveryMode, type CampaignProviderRouteReadback, type CampaignRowsOptions, type CampaignRowsResult, Campaigns, type CancelBuildResult, type CompanyIntelligenceParams, type CompanyIntelligenceResult, type CreateOutputSinkRequest, type CreateRoutineRequest, type CreateSystemParams, type CustomAiAttachment, type CustomAiFusionConfig, type CustomAiMultiModelParams, type CustomAiMultiModelResult, type CustomAiOutputField, DEFAULT_CAMPAIGN_BUILDER_APPROVAL_TYPES, DEFAULT_CAMPAIGN_BUILDER_BUILT_INS, DEFAULT_SIGNALIZ_CAMPAIGN_BUILDER_DEFAULTS, type EmailBatchJobResult, type EnrichSignalsParams, type EnrichSignalsResult, type ErrorType, type ExecutionReference, type ExecutionReferenceInput, type ExecutionReferenceKind, type FindAndVerifyEmailContact, type FindEmailParams, type FindEmailResult, type GenerateLeadsParams, type GenerateLocalLeadsParams, type GtmActorType, type GtmAuthStrategy, type GtmBrainAggregateCalibrationsInput, type GtmBrainAggregatePatternsInput, type GtmBrainCalibrateDeliverabilityInput, type GtmBrainDeliveryRiskInput, type GtmBrainDistillRunInput, type GtmBrainExtractPatternsInput, type GtmBrainFailurePatternsOptions, type GtmBrainLearningAction, type GtmBrainLearningCyclePhase, type GtmBrainLearningCyclePlanInput, type GtmBrainLearningCyclePlanResult, type GtmBrainLearningCycleRunInput, type GtmBrainLearningEvidenceCounts, type GtmBrainLearningLane, type GtmBrainLearningLaneId, type GtmBrainLearningLaneState, type GtmBrainLearningLaneSummary, type GtmBrainLearningPhaseReadiness, type GtmBrainLearningPhaseStatus, type GtmBrainLearningRecommendedToolCall, type GtmBrainPatternsOptions, type GtmBrainSeedDefaultsInput, type GtmCalibrationDimensionType, type GtmCampaignAgentPlanInput, type GtmCampaignAgentRequestTemplateInput, type GtmCampaignBuildPlanInput, type GtmCampaignCreateInput, type GtmCampaignGetOptions, type GtmCampaignHistoryCampaignInput, type GtmCampaignHistoryImportBatchInput, type GtmCampaignHistoryImportInput, type GtmCampaignHistoryImportRunInput, type GtmCampaignHistoryMemoryInput, type GtmCampaignLearningStatusResult, type GtmCampaignListOptions, type GtmCampaignLogInput, type GtmCampaignSource, type GtmCampaignStartContextInput, type GtmCampaignStatus, type GtmCampaignStrategyMemoryStatusInput, type GtmCampaignStrategyTemplateSlug, type GtmCampaignStrategyTemplatesOptions, type GtmCampaignUpdateInput, type GtmConnectionRegisterInput, type GtmConnectionsListOptions, type GtmExistingCampaignAuditBoundary, type GtmExistingCampaignAuditBySearchOptions, type GtmExistingCampaignAuditOptions, type GtmExistingCampaignAuditRecommendation, type GtmExistingCampaignAuditResult, type GtmExistingCampaignCompletenessStep, type GtmExistingCampaignDiscoverOptions, type GtmExistingCampaignDiscoveryResult, type GtmExistingCampaignMcpRequest, type GtmExistingCampaignOption, type GtmFeedbackIngestInput, type GtmIntegrationRecipeCreateInput, type GtmInvocationType, GtmKernel, type GtmKernelImportPreviewInput, type GtmKernelImportRunInput, type GtmLayer, type GtmLayerRouteSetInput, type GtmLayerRoutesGetOptions, type GtmMemorySearchOptions, type GtmMemoryType, type GtmPatternType, type GtmProviderLinkInput, type GtmProviderRecipePrepareInput, type GtmProviderRouteActivateInput, type GtmWebhookDeliverInput, type GtmWorkspaceBootstrapStatusOptions, type GtmWorkspaceContextOptions, type HttpRequestParams, type HttpRequestResult, type IcpDetail, type IcpSummary, Icps, type ImportOctaveResult, type LeadGenJobResult, type ListOutputSinksOptions, type MCPToolInfo, type NativeGtmCapabilityInfo, Ops, type OpsApproveRequest, type OpsApproveResult, type OpsBlueprint, type OpsCadence, type OpsCreateRequest, type OpsCreateResult, type OpsDashboardOptions, type OpsDashboardResult, type OpsDebugDiagnosticError, type OpsDebugOptions, type OpsDebugResult, type OpsPlanRequest, type OpsPlanResult, type OpsPrimitive, type OpsPrimitiveConcurrencyPolicy, type OpsPrimitiveDeadLetterPolicy, type OpsPrimitiveObservabilityPolicy, type OpsPrimitivePermissionLevel, type OpsPrimitiveRetryPolicy, type OpsPrimitiveWorkspaceScope, type OpsQueueStatus, type OpsQueueStatusOptions, type OpsQuickstartStep, type OpsQuickstartWorkflow, type OpsReadinessCheck, type OpsReadinessOptions, type OpsReadinessResult, type OpsReplayResult, type OpsResultsOptions, type OpsResultsResult, type OpsRoutine, type OpsRoutineDeleteResult, type OpsRoutineRunResult, type OpsRoutineSinkResult, type OpsRoutineStatus, type OpsRoutineTick, type OpsRoutineTickItem, type OpsRoutineTickItemsResult, type OpsRoutineTicksResult, type OpsRoutinesResult, type OpsRunOptions, type OpsRunResult, type OpsSink, type OpsSinkType, type OpsStatusOptions, type OpsStatusResult, type OpsTriggerBatchRunStatus, type OpsTriggerRunStatus, type OpsTriggerRunStatusOptions, type PlatformHealth, type RunNativeGtmCapabilityParams, type RunProgressEvent, type RunResult, type RunRoutineRequest, type RunSystemParams, type Signal, Signaliz, type SignalizCampaignBuilderDefaults, type SignalizConfig, SignalizError, type SignalizErrorData, type SimpleOpStatus, type SystemResult, type UpdateRoutineRequest, type VerifyEmailResult, type WaitOptions, type WorkspaceInfo, applyCampaignBuilderStrategyTemplate, collectExecutionReferences, createCampaignBuilderAgentPlan, createCampaignBuilderAgentRequestTemplate, createCampaignBuilderApproval, createCampaignBuilderToolRoute, getCampaignBuilderOperatingPlaybook, getCampaignBuilderOperatingPlaybooksForRequest, getCampaignBuilderStrategyTemplate, getMissingCampaignBuilderApprovals, normalizeExecutionReference };

package/dist/index.d.ts

@@ -1079,6 +1079,21 @@ interface CampaignBuilderPlanCommitResult {
 type CampaignBuilderBuildOptions = BuildOptions & {
     commitBeforeLaunch?: boolean;
 };
+type CampaignBuilderApprovedRunOptions = CampaignBuilderBuildOptions & {
+    wait?: boolean;
+    approveDelivery?: boolean;
+    deliveryDestinationType?: CampaignDeliveryMode;
+    deliveryDestinationId?: string;
+    deliveryDestinationConfig?: UnknownRecord$1;
+    waitIntervalMs?: number;
+    waitTimeoutMs?: number;
+    onStatus?: (status: CampaignBuildStatus) => void;
+};
+interface CampaignBuilderApprovedRunResult {
+    build: CampaignBuildResult;
+    finalStatus?: CampaignBuildStatus;
+    deliveryApproval?: ApproveDeliveryResult;
+}
 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[];
@@ -1091,6 +1106,10 @@ declare class CampaignBuilderAgent {
     commitPlan(plan: CampaignBuilderAgentPlan, options?: CampaignBuilderPlanCommitOptions): Promise<CampaignBuilderPlanCommitResult>;
     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>;
+    private getCampaignBuildStatus;
+    private waitForCampaignBuildStatus;
+    private approveCampaignDelivery;
     private getWorkspaceContext;
     private scopeCampaign;
     private discoverPlannedRoutes;
@@ -3365,4 +3384,4 @@ declare class Signaliz {
     discover(query: string, category?: string): Promise<MCPToolInfo[]>;
 }
 
-export { Ai, type ApproveDeliveryResult, type BuildOptions, CAMPAIGN_BUILDER_OPERATING_PLAYBOOKS, CAMPAIGN_BUILDER_STRATEGY_TEMPLATES, type CampaignArtifact, type CampaignBuildRequest$1 as CampaignBuildRequest, type CampaignBuildResult$1 as CampaignBuildResult, type CampaignBuildRow, type CampaignBuildStatus, CampaignBuilderAgent, type CampaignBuilderAgentPlan, type CampaignBuilderAgentProvider, type CampaignBuilderAgentRequest, type CampaignBuilderAgentRequestTemplateOptions, type CampaignBuilderApproval, type CampaignBuilderApprovalPolicy, type CampaignBuilderApprovalType, type CampaignBuilderBuildOptions, type CampaignBuilderBuiltInTool, type CampaignBuilderCustomerTool, type CampaignBuilderGtmLayer, type CampaignBuilderIntegrationRoute, type CampaignBuilderLayer, type CampaignBuilderMcpStep, type CampaignBuilderMemoryPlan, type CampaignBuilderMemoryQuery, type CampaignBuilderMemoryScope, type CampaignBuilderOperatingPlaybook, type CampaignBuilderOperatingPlaybookSlug, type CampaignBuilderPlanCommitOptions, type CampaignBuilderPlanCommitResult, type CampaignBuilderPlanOptions, type CampaignBuilderProvider, type CampaignBuilderRequiredApproval, type CampaignBuilderRouteMode, type CampaignBuilderStrategyTemplate, type CampaignBuilderStrategyTemplateSlug, type CampaignBuilderWorkspaceContext, type CampaignDeliveryMode, type CampaignProviderRouteReadback, type CampaignRowsOptions, type CampaignRowsResult, Campaigns, type CancelBuildResult, type CompanyIntelligenceParams, type CompanyIntelligenceResult, type CreateOutputSinkRequest, type CreateRoutineRequest, type CreateSystemParams, type CustomAiAttachment, type CustomAiFusionConfig, type CustomAiMultiModelParams, type CustomAiMultiModelResult, type CustomAiOutputField, DEFAULT_CAMPAIGN_BUILDER_APPROVAL_TYPES, DEFAULT_CAMPAIGN_BUILDER_BUILT_INS, DEFAULT_SIGNALIZ_CAMPAIGN_BUILDER_DEFAULTS, type EmailBatchJobResult, type EnrichSignalsParams, type EnrichSignalsResult, type ErrorType, type ExecutionReference, type ExecutionReferenceInput, type ExecutionReferenceKind, type FindAndVerifyEmailContact, type FindEmailParams, type FindEmailResult, type GenerateLeadsParams, type GenerateLocalLeadsParams, type GtmActorType, type GtmAuthStrategy, type GtmBrainAggregateCalibrationsInput, type GtmBrainAggregatePatternsInput, type GtmBrainCalibrateDeliverabilityInput, type GtmBrainDeliveryRiskInput, type GtmBrainDistillRunInput, type GtmBrainExtractPatternsInput, type GtmBrainFailurePatternsOptions, type GtmBrainLearningAction, type GtmBrainLearningCyclePhase, type GtmBrainLearningCyclePlanInput, type GtmBrainLearningCyclePlanResult, type GtmBrainLearningCycleRunInput, type GtmBrainLearningEvidenceCounts, type GtmBrainLearningLane, type GtmBrainLearningLaneId, type GtmBrainLearningLaneState, type GtmBrainLearningLaneSummary, type GtmBrainLearningPhaseReadiness, type GtmBrainLearningPhaseStatus, type GtmBrainLearningRecommendedToolCall, type GtmBrainPatternsOptions, type GtmBrainSeedDefaultsInput, type GtmCalibrationDimensionType, type GtmCampaignAgentPlanInput, type GtmCampaignAgentRequestTemplateInput, type GtmCampaignBuildPlanInput, type GtmCampaignCreateInput, type GtmCampaignGetOptions, type GtmCampaignHistoryCampaignInput, type GtmCampaignHistoryImportBatchInput, type GtmCampaignHistoryImportInput, type GtmCampaignHistoryImportRunInput, type GtmCampaignHistoryMemoryInput, type GtmCampaignLearningStatusResult, type GtmCampaignListOptions, type GtmCampaignLogInput, type GtmCampaignSource, type GtmCampaignStartContextInput, type GtmCampaignStatus, type GtmCampaignStrategyMemoryStatusInput, type GtmCampaignStrategyTemplateSlug, type GtmCampaignStrategyTemplatesOptions, type GtmCampaignUpdateInput, type GtmConnectionRegisterInput, type GtmConnectionsListOptions, type GtmExistingCampaignAuditBoundary, type GtmExistingCampaignAuditBySearchOptions, type GtmExistingCampaignAuditOptions, type GtmExistingCampaignAuditRecommendation, type GtmExistingCampaignAuditResult, type GtmExistingCampaignCompletenessStep, type GtmExistingCampaignDiscoverOptions, type GtmExistingCampaignDiscoveryResult, type GtmExistingCampaignMcpRequest, type GtmExistingCampaignOption, type GtmFeedbackIngestInput, type GtmIntegrationRecipeCreateInput, type GtmInvocationType, GtmKernel, type GtmKernelImportPreviewInput, type GtmKernelImportRunInput, type GtmLayer, type GtmLayerRouteSetInput, type GtmLayerRoutesGetOptions, type GtmMemorySearchOptions, type GtmMemoryType, type GtmPatternType, type GtmProviderLinkInput, type GtmProviderRecipePrepareInput, type GtmProviderRouteActivateInput, type GtmWebhookDeliverInput, type GtmWorkspaceBootstrapStatusOptions, type GtmWorkspaceContextOptions, type HttpRequestParams, type HttpRequestResult, type IcpDetail, type IcpSummary, Icps, type ImportOctaveResult, type LeadGenJobResult, type ListOutputSinksOptions, type MCPToolInfo, type NativeGtmCapabilityInfo, Ops, type OpsApproveRequest, type OpsApproveResult, type OpsBlueprint, type OpsCadence, type OpsCreateRequest, type OpsCreateResult, type OpsDashboardOptions, type OpsDashboardResult, type OpsDebugDiagnosticError, type OpsDebugOptions, type OpsDebugResult, type OpsPlanRequest, type OpsPlanResult, type OpsPrimitive, type OpsPrimitiveConcurrencyPolicy, type OpsPrimitiveDeadLetterPolicy, type OpsPrimitiveObservabilityPolicy, type OpsPrimitivePermissionLevel, type OpsPrimitiveRetryPolicy, type OpsPrimitiveWorkspaceScope, type OpsQueueStatus, type OpsQueueStatusOptions, type OpsQuickstartStep, type OpsQuickstartWorkflow, type OpsReadinessCheck, type OpsReadinessOptions, type OpsReadinessResult, type OpsReplayResult, type OpsResultsOptions, type OpsResultsResult, type OpsRoutine, type OpsRoutineDeleteResult, type OpsRoutineRunResult, type OpsRoutineSinkResult, type OpsRoutineStatus, type OpsRoutineTick, type OpsRoutineTickItem, type OpsRoutineTickItemsResult, type OpsRoutineTicksResult, type OpsRoutinesResult, type OpsRunOptions, type OpsRunResult, type OpsSink, type OpsSinkType, type OpsStatusOptions, type OpsStatusResult, type OpsTriggerBatchRunStatus, type OpsTriggerRunStatus, type OpsTriggerRunStatusOptions, type PlatformHealth, type RunNativeGtmCapabilityParams, type RunProgressEvent, type RunResult, type RunRoutineRequest, type RunSystemParams, type Signal, Signaliz, type SignalizCampaignBuilderDefaults, type SignalizConfig, SignalizError, type SignalizErrorData, type SimpleOpStatus, type SystemResult, type UpdateRoutineRequest, type VerifyEmailResult, type WaitOptions, type WorkspaceInfo, applyCampaignBuilderStrategyTemplate, collectExecutionReferences, createCampaignBuilderAgentPlan, createCampaignBuilderAgentRequestTemplate, createCampaignBuilderApproval, createCampaignBuilderToolRoute, getCampaignBuilderOperatingPlaybook, getCampaignBuilderOperatingPlaybooksForRequest, getCampaignBuilderStrategyTemplate, getMissingCampaignBuilderApprovals, normalizeExecutionReference };
+export { Ai, type ApproveDeliveryResult, type BuildOptions, CAMPAIGN_BUILDER_OPERATING_PLAYBOOKS, CAMPAIGN_BUILDER_STRATEGY_TEMPLATES, type CampaignArtifact, type CampaignBuildRequest$1 as CampaignBuildRequest, type CampaignBuildResult$1 as CampaignBuildResult, type CampaignBuildRow, type CampaignBuildStatus, CampaignBuilderAgent, type CampaignBuilderAgentPlan, type CampaignBuilderAgentProvider, type CampaignBuilderAgentRequest, type CampaignBuilderAgentRequestTemplateOptions, type CampaignBuilderApproval, type CampaignBuilderApprovalPolicy, type CampaignBuilderApprovalType, type CampaignBuilderApprovedRunOptions, type CampaignBuilderApprovedRunResult, type CampaignBuilderBuildOptions, type CampaignBuilderBuiltInTool, type CampaignBuilderCustomerTool, type CampaignBuilderGtmLayer, type CampaignBuilderIntegrationRoute, type CampaignBuilderLayer, type CampaignBuilderMcpStep, type CampaignBuilderMemoryPlan, type CampaignBuilderMemoryQuery, type CampaignBuilderMemoryScope, type CampaignBuilderOperatingPlaybook, type CampaignBuilderOperatingPlaybookSlug, type CampaignBuilderPlanCommitOptions, type CampaignBuilderPlanCommitResult, type CampaignBuilderPlanOptions, type CampaignBuilderProvider, type CampaignBuilderRequiredApproval, type CampaignBuilderRouteMode, type CampaignBuilderStrategyTemplate, type CampaignBuilderStrategyTemplateSlug, type CampaignBuilderWorkspaceContext, type CampaignDeliveryMode, type CampaignProviderRouteReadback, type CampaignRowsOptions, type CampaignRowsResult, Campaigns, type CancelBuildResult, type CompanyIntelligenceParams, type CompanyIntelligenceResult, type CreateOutputSinkRequest, type CreateRoutineRequest, type CreateSystemParams, type CustomAiAttachment, type CustomAiFusionConfig, type CustomAiMultiModelParams, type CustomAiMultiModelResult, type CustomAiOutputField, DEFAULT_CAMPAIGN_BUILDER_APPROVAL_TYPES, DEFAULT_CAMPAIGN_BUILDER_BUILT_INS, DEFAULT_SIGNALIZ_CAMPAIGN_BUILDER_DEFAULTS, type EmailBatchJobResult, type EnrichSignalsParams, type EnrichSignalsResult, type ErrorType, type ExecutionReference, type ExecutionReferenceInput, type ExecutionReferenceKind, type FindAndVerifyEmailContact, type FindEmailParams, type FindEmailResult, type GenerateLeadsParams, type GenerateLocalLeadsParams, type GtmActorType, type GtmAuthStrategy, type GtmBrainAggregateCalibrationsInput, type GtmBrainAggregatePatternsInput, type GtmBrainCalibrateDeliverabilityInput, type GtmBrainDeliveryRiskInput, type GtmBrainDistillRunInput, type GtmBrainExtractPatternsInput, type GtmBrainFailurePatternsOptions, type GtmBrainLearningAction, type GtmBrainLearningCyclePhase, type GtmBrainLearningCyclePlanInput, type GtmBrainLearningCyclePlanResult, type GtmBrainLearningCycleRunInput, type GtmBrainLearningEvidenceCounts, type GtmBrainLearningLane, type GtmBrainLearningLaneId, type GtmBrainLearningLaneState, type GtmBrainLearningLaneSummary, type GtmBrainLearningPhaseReadiness, type GtmBrainLearningPhaseStatus, type GtmBrainLearningRecommendedToolCall, type GtmBrainPatternsOptions, type GtmBrainSeedDefaultsInput, type GtmCalibrationDimensionType, type GtmCampaignAgentPlanInput, type GtmCampaignAgentRequestTemplateInput, type GtmCampaignBuildPlanInput, type GtmCampaignCreateInput, type GtmCampaignGetOptions, type GtmCampaignHistoryCampaignInput, type GtmCampaignHistoryImportBatchInput, type GtmCampaignHistoryImportInput, type GtmCampaignHistoryImportRunInput, type GtmCampaignHistoryMemoryInput, type GtmCampaignLearningStatusResult, type GtmCampaignListOptions, type GtmCampaignLogInput, type GtmCampaignSource, type GtmCampaignStartContextInput, type GtmCampaignStatus, type GtmCampaignStrategyMemoryStatusInput, type GtmCampaignStrategyTemplateSlug, type GtmCampaignStrategyTemplatesOptions, type GtmCampaignUpdateInput, type GtmConnectionRegisterInput, type GtmConnectionsListOptions, type GtmExistingCampaignAuditBoundary, type GtmExistingCampaignAuditBySearchOptions, type GtmExistingCampaignAuditOptions, type GtmExistingCampaignAuditRecommendation, type GtmExistingCampaignAuditResult, type GtmExistingCampaignCompletenessStep, type GtmExistingCampaignDiscoverOptions, type GtmExistingCampaignDiscoveryResult, type GtmExistingCampaignMcpRequest, type GtmExistingCampaignOption, type GtmFeedbackIngestInput, type GtmIntegrationRecipeCreateInput, type GtmInvocationType, GtmKernel, type GtmKernelImportPreviewInput, type GtmKernelImportRunInput, type GtmLayer, type GtmLayerRouteSetInput, type GtmLayerRoutesGetOptions, type GtmMemorySearchOptions, type GtmMemoryType, type GtmPatternType, type GtmProviderLinkInput, type GtmProviderRecipePrepareInput, type GtmProviderRouteActivateInput, type GtmWebhookDeliverInput, type GtmWorkspaceBootstrapStatusOptions, type GtmWorkspaceContextOptions, type HttpRequestParams, type HttpRequestResult, type IcpDetail, type IcpSummary, Icps, type ImportOctaveResult, type LeadGenJobResult, type ListOutputSinksOptions, type MCPToolInfo, type NativeGtmCapabilityInfo, Ops, type OpsApproveRequest, type OpsApproveResult, type OpsBlueprint, type OpsCadence, type OpsCreateRequest, type OpsCreateResult, type OpsDashboardOptions, type OpsDashboardResult, type OpsDebugDiagnosticError, type OpsDebugOptions, type OpsDebugResult, type OpsPlanRequest, type OpsPlanResult, type OpsPrimitive, type OpsPrimitiveConcurrencyPolicy, type OpsPrimitiveDeadLetterPolicy, type OpsPrimitiveObservabilityPolicy, type OpsPrimitivePermissionLevel, type OpsPrimitiveRetryPolicy, type OpsPrimitiveWorkspaceScope, type OpsQueueStatus, type OpsQueueStatusOptions, type OpsQuickstartStep, type OpsQuickstartWorkflow, type OpsReadinessCheck, type OpsReadinessOptions, type OpsReadinessResult, type OpsReplayResult, type OpsResultsOptions, type OpsResultsResult, type OpsRoutine, type OpsRoutineDeleteResult, type OpsRoutineRunResult, type OpsRoutineSinkResult, type OpsRoutineStatus, type OpsRoutineTick, type OpsRoutineTickItem, type OpsRoutineTickItemsResult, type OpsRoutineTicksResult, type OpsRoutinesResult, type OpsRunOptions, type OpsRunResult, type OpsSink, type OpsSinkType, type OpsStatusOptions, type OpsStatusResult, type OpsTriggerBatchRunStatus, type OpsTriggerRunStatus, type OpsTriggerRunStatusOptions, type PlatformHealth, type RunNativeGtmCapabilityParams, type RunProgressEvent, type RunResult, type RunRoutineRequest, type RunSystemParams, type Signal, Signaliz, type SignalizCampaignBuilderDefaults, type SignalizConfig, SignalizError, type SignalizErrorData, type SimpleOpStatus, type SystemResult, type UpdateRoutineRequest, type VerifyEmailResult, type WaitOptions, type WorkspaceInfo, applyCampaignBuilderStrategyTemplate, collectExecutionReferences, createCampaignBuilderAgentPlan, createCampaignBuilderAgentRequestTemplate, createCampaignBuilderApproval, createCampaignBuilderToolRoute, getCampaignBuilderOperatingPlaybook, getCampaignBuilderOperatingPlaybooksForRequest, getCampaignBuilderStrategyTemplate, getMissingCampaignBuilderApprovals, normalizeExecutionReference };

package/dist/index.js

@@ -1864,6 +1864,79 @@ var CampaignBuilderAgent = class {
     const data = await this.callMcp("build_campaign", args);
     return mapBuildResult(data, false);
   }
+  async runApprovedPlan(plan, approval, options = {}) {
+    const build = await this.buildApprovedPlan(plan, approval, options);
+    const campaignBuildId = build.campaignBuildId;
+    if (!campaignBuildId) {
+      if (options.wait || options.approveDelivery) {
+        throw new Error("Campaign builder approved run did not return a campaignBuildId to poll");
+      }
+      return { build };
+    }
+    const shouldWait = options.wait === true || options.approveDelivery === true;
+    if (!shouldWait) return { build };
+    let finalStatus = await this.waitForCampaignBuildStatus(
+      campaignBuildId,
+      options,
+      ["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`);
+      }
+      const destinationType = options.deliveryDestinationType ?? plan.buildRequest.delivery?.destinationType ?? "json";
+      result.deliveryApproval = await this.approveCampaignDelivery(campaignBuildId, destinationType, {
+        destinationId: options.deliveryDestinationId,
+        destinationConfig: options.deliveryDestinationConfig ?? plan.buildRequest.delivery?.destinationConfig
+      });
+      finalStatus = await this.waitForCampaignBuildStatus(
+        campaignBuildId,
+        options,
+        ["completed", "failed", "canceled"]
+      );
+      result.finalStatus = finalStatus;
+    }
+    return result;
+  }
+  async getCampaignBuildStatus(campaignBuildId) {
+    const data = await this.callMcp("get_campaign_build_status", {
+      campaign_build_id: campaignBuildId
+    });
+    return mapAgentCampaignBuildStatus(data);
+  }
+  async waitForCampaignBuildStatus(campaignBuildId, options, stopStatuses) {
+    const interval = options.waitIntervalMs ?? 5e3;
+    const timeout = options.waitTimeoutMs ?? 6e5;
+    const startedAt = Date.now();
+    while (true) {
+      const status = await this.getCampaignBuildStatus(campaignBuildId);
+      options.onStatus?.(status);
+      if (stopStatuses.includes(status.status)) return status;
+      if (Date.now() - startedAt > timeout) {
+        throw new Error(`Campaign build ${campaignBuildId} timed out after ${timeout}ms (status: ${status.status})`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+  }
+  async approveCampaignDelivery(campaignBuildId, destinationType, options) {
+    const args = compact({
+      campaign_build_id: campaignBuildId,
+      destination_type: destinationType,
+      destination_id: options?.destinationId,
+      destination_config: options?.destinationConfig
+    });
+    const data = await this.callMcp("approve_campaign_delivery", args);
+    return {
+      campaignBuildId: data.campaign_build_id,
+      destinationType: data.destination_type ?? destinationType,
+      status: data.status ?? "approved",
+      message: data.message ?? "",
+      deliveryId: data.delivery_id,
+      deliveryIds: data.delivery_ids,
+      approvedCount: data.approved_count
+    };
+  }
   async getWorkspaceContext(warnings) {
     try {
       const workspace = await this.callMcp("get_workspace", {});
@@ -2809,6 +2882,17 @@ function createMcpFlow(request, buildRequest, routes, memory, approvals) {
     readOnly: false,
     approvalRequired: approvals.some((approval) => approval.blocking)
   });
+  const deliveryApprovalArgs = buildDeliveryApprovalArgs(buildRequest);
+  if (deliveryApprovalArgs) {
+    steps.push({
+      id: "delivery-approval",
+      phase: "delivery",
+      tool: "approve_campaign_delivery",
+      arguments: deliveryApprovalArgs,
+      readOnly: false,
+      approvalRequired: true
+    });
+  }
   return steps.map((step) => ({ ...step, arguments: compact(step.arguments) }));
 }
 function shouldPrepareProviderRoute(route) {
@@ -3151,6 +3235,14 @@ function buildExecutionPrepareArgs(request, dryRun, confirmSpend) {
     enhancers: buildArgs2.enhancers
   });
 }
+function buildDeliveryApprovalArgs(request) {
+  if (request.delivery?.enabled === false || request.delivery?.approvalRequired === false) return void 0;
+  return compact({
+    campaign_build_id: "<campaign_build_id_from_approved_build>",
+    destination_type: request.delivery?.destinationType ?? "json",
+    destination_config: request.delivery?.destinationConfig
+  });
+}
 function mapBuildResult(data, dryRun) {
   return {
     campaignBuildId: data.campaign_build_id ?? null,
@@ -3172,6 +3264,55 @@ function mapBuildResult(data, dryRun) {
     providerRoute: mapProviderRoute2(data)
   };
 }
+function mapAgentCampaignBuildStatus(data) {
+  return {
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    campaignId: stringValue(data.campaign_id) ?? null,
+    campaignObject: nullableRecord(data.campaign_object),
+    name: stringValue(data.name) ?? "",
+    status: stringValue(data.status) ?? "unknown",
+    currentPhase: stringValue(data.current_phase) ?? null,
+    currentPhaseStatus: stringValue(data.current_phase_status) ?? null,
+    phases: Array.isArray(data.phases) ? data.phases : [],
+    recordsTotal: numberOrUndefined2(data.records_total) ?? 0,
+    recordsProcessed: numberOrUndefined2(data.records_processed) ?? 0,
+    recordsSucceeded: numberOrUndefined2(data.records_succeeded) ?? 0,
+    recordsFailed: numberOrUndefined2(data.records_failed) ?? 0,
+    warnings: diagnosticMessages2(data.warnings),
+    errors: diagnosticMessages2(data.errors),
+    artifactCount: numberOrUndefined2(data.artifact_count) ?? 0,
+    providerRoute: mapProviderRoute2(data),
+    triggerRunId: stringValue(data.trigger_run_id) ?? null,
+    staleRunningPhase: data.stale_running_phase === true,
+    phaseAgeSeconds: numberOrNull2(data.phase_age_seconds),
+    diagnostics: nullableRecord(data.diagnostics) ?? {},
+    nextAction: formatAgentNextAction(data.next_action),
+    createdAt: stringValue(data.created_at) ?? "",
+    updatedAt: stringValue(data.updated_at) ?? "",
+    completedAt: stringValue(data.completed_at) ?? null
+  };
+}
+function diagnosticMessages2(value) {
+  if (!Array.isArray(value)) return [];
+  return value.map((item) => {
+    if (typeof item === "string") return item;
+    const record = nullableRecord(item);
+    return stringValue(record?.message);
+  }).filter((item) => typeof item === "string" && item.length > 0);
+}
+function formatAgentNextAction(value) {
+  if (!value) return "";
+  if (typeof value === "string") return value;
+  const record = nullableRecord(value);
+  if (!record) return "";
+  const tool = stringValue(record.tool);
+  const type = stringValue(record.type);
+  const reason = stringValue(record.reason);
+  const args = nullableRecord(record.arguments);
+  const argText = args && Object.keys(args).length > 0 ? ` ${JSON.stringify(args)}` : "";
+  const action = tool ? `${tool}${argText}` : type ?? "";
+  return [action, reason].filter(Boolean).join(" - ");
+}
 function mapProviderRoute2(data) {
   const brainContext = asRecord(data?.brain_context);
   const plan = nullableRecord(data?.provider_route_plan) ?? nullableRecord(brainContext.provider_route_plan);

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -1838,6 +1838,79 @@ var CampaignBuilderAgent = class {
     const data = await this.callMcp("build_campaign", args);
     return mapBuildResult(data, false);
   }
+  async runApprovedPlan(plan, approval, options = {}) {
+    const build = await this.buildApprovedPlan(plan, approval, options);
+    const campaignBuildId = build.campaignBuildId;
+    if (!campaignBuildId) {
+      if (options.wait || options.approveDelivery) {
+        throw new Error("Campaign builder approved run did not return a campaignBuildId to poll");
+      }
+      return { build };
+    }
+    const shouldWait = options.wait === true || options.approveDelivery === true;
+    if (!shouldWait) return { build };
+    let finalStatus = await this.waitForCampaignBuildStatus(
+      campaignBuildId,
+      options,
+      ["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`);
+      }
+      const destinationType = options.deliveryDestinationType ?? plan.buildRequest.delivery?.destinationType ?? "json";
+      result.deliveryApproval = await this.approveCampaignDelivery(campaignBuildId, destinationType, {
+        destinationId: options.deliveryDestinationId,
+        destinationConfig: options.deliveryDestinationConfig ?? plan.buildRequest.delivery?.destinationConfig
+      });
+      finalStatus = await this.waitForCampaignBuildStatus(
+        campaignBuildId,
+        options,
+        ["completed", "failed", "canceled"]
+      );
+      result.finalStatus = finalStatus;
+    }
+    return result;
+  }
+  async getCampaignBuildStatus(campaignBuildId) {
+    const data = await this.callMcp("get_campaign_build_status", {
+      campaign_build_id: campaignBuildId
+    });
+    return mapAgentCampaignBuildStatus(data);
+  }
+  async waitForCampaignBuildStatus(campaignBuildId, options, stopStatuses) {
+    const interval = options.waitIntervalMs ?? 5e3;
+    const timeout = options.waitTimeoutMs ?? 6e5;
+    const startedAt = Date.now();
+    while (true) {
+      const status = await this.getCampaignBuildStatus(campaignBuildId);
+      options.onStatus?.(status);
+      if (stopStatuses.includes(status.status)) return status;
+      if (Date.now() - startedAt > timeout) {
+        throw new Error(`Campaign build ${campaignBuildId} timed out after ${timeout}ms (status: ${status.status})`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+  }
+  async approveCampaignDelivery(campaignBuildId, destinationType, options) {
+    const args = compact({
+      campaign_build_id: campaignBuildId,
+      destination_type: destinationType,
+      destination_id: options?.destinationId,
+      destination_config: options?.destinationConfig
+    });
+    const data = await this.callMcp("approve_campaign_delivery", args);
+    return {
+      campaignBuildId: data.campaign_build_id,
+      destinationType: data.destination_type ?? destinationType,
+      status: data.status ?? "approved",
+      message: data.message ?? "",
+      deliveryId: data.delivery_id,
+      deliveryIds: data.delivery_ids,
+      approvedCount: data.approved_count
+    };
+  }
   async getWorkspaceContext(warnings) {
     try {
       const workspace = await this.callMcp("get_workspace", {});
@@ -2682,6 +2755,17 @@ function createMcpFlow(request, buildRequest, routes, memory, approvals) {
     readOnly: false,
     approvalRequired: approvals.some((approval) => approval.blocking)
   });
+  const deliveryApprovalArgs = buildDeliveryApprovalArgs(buildRequest);
+  if (deliveryApprovalArgs) {
+    steps.push({
+      id: "delivery-approval",
+      phase: "delivery",
+      tool: "approve_campaign_delivery",
+      arguments: deliveryApprovalArgs,
+      readOnly: false,
+      approvalRequired: true
+    });
+  }
   return steps.map((step) => ({ ...step, arguments: compact(step.arguments) }));
 }
 function shouldPrepareProviderRoute(route) {
@@ -3024,6 +3108,14 @@ function buildExecutionPrepareArgs(request, dryRun, confirmSpend) {
     enhancers: buildArgs2.enhancers
   });
 }
+function buildDeliveryApprovalArgs(request) {
+  if (request.delivery?.enabled === false || request.delivery?.approvalRequired === false) return void 0;
+  return compact({
+    campaign_build_id: "<campaign_build_id_from_approved_build>",
+    destination_type: request.delivery?.destinationType ?? "json",
+    destination_config: request.delivery?.destinationConfig
+  });
+}
 function mapBuildResult(data, dryRun) {
   return {
     campaignBuildId: data.campaign_build_id ?? null,
@@ -3045,6 +3137,55 @@ function mapBuildResult(data, dryRun) {
     providerRoute: mapProviderRoute2(data)
   };
 }
+function mapAgentCampaignBuildStatus(data) {
+  return {
+    campaignBuildId: stringValue(data.campaign_build_id) ?? "",
+    campaignId: stringValue(data.campaign_id) ?? null,
+    campaignObject: nullableRecord(data.campaign_object),
+    name: stringValue(data.name) ?? "",
+    status: stringValue(data.status) ?? "unknown",
+    currentPhase: stringValue(data.current_phase) ?? null,
+    currentPhaseStatus: stringValue(data.current_phase_status) ?? null,
+    phases: Array.isArray(data.phases) ? data.phases : [],
+    recordsTotal: numberOrUndefined2(data.records_total) ?? 0,
+    recordsProcessed: numberOrUndefined2(data.records_processed) ?? 0,
+    recordsSucceeded: numberOrUndefined2(data.records_succeeded) ?? 0,
+    recordsFailed: numberOrUndefined2(data.records_failed) ?? 0,
+    warnings: diagnosticMessages2(data.warnings),
+    errors: diagnosticMessages2(data.errors),
+    artifactCount: numberOrUndefined2(data.artifact_count) ?? 0,
+    providerRoute: mapProviderRoute2(data),
+    triggerRunId: stringValue(data.trigger_run_id) ?? null,
+    staleRunningPhase: data.stale_running_phase === true,
+    phaseAgeSeconds: numberOrNull2(data.phase_age_seconds),
+    diagnostics: nullableRecord(data.diagnostics) ?? {},
+    nextAction: formatAgentNextAction(data.next_action),
+    createdAt: stringValue(data.created_at) ?? "",
+    updatedAt: stringValue(data.updated_at) ?? "",
+    completedAt: stringValue(data.completed_at) ?? null
+  };
+}
+function diagnosticMessages2(value) {
+  if (!Array.isArray(value)) return [];
+  return value.map((item) => {
+    if (typeof item === "string") return item;
+    const record = nullableRecord(item);
+    return stringValue(record?.message);
+  }).filter((item) => typeof item === "string" && item.length > 0);
+}
+function formatAgentNextAction(value) {
+  if (!value) return "";
+  if (typeof value === "string") return value;
+  const record = nullableRecord(value);
+  if (!record) return "";
+  const tool = stringValue(record.tool);
+  const type = stringValue(record.type);
+  const reason = stringValue(record.reason);
+  const args = nullableRecord(record.arguments);
+  const argText = args && Object.keys(args).length > 0 ? ` ${JSON.stringify(args)}` : "";
+  const action = tool ? `${tool}${argText}` : type ?? "";
+  return [action, reason].filter(Boolean).join(" - ");
+}
 function mapProviderRoute2(data) {
   const brainContext = asRecord(data?.brain_context);
   const plan = nullableRecord(data?.provider_route_plan) ?? nullableRecord(brainContext.provider_route_plan);

package/dist/mcp-config.mjs

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

package/package.json

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