@signaliz/sdk 1.0.17 → 1.0.18

package/dist/cli.mjs

@@ -1175,6 +1175,13 @@ function printCampaignAgentBuildStatus(status) {
   if (status.campaignId) console.log(`Campaign ID: ${status.campaignId}`);
   console.log(`Status: ${status.status}`);
   console.log(`Phase: ${status.currentPhase || "N/A"}`);
+  const terminalState = asRecord(status.terminalState);
+  if (terminalState.kind) {
+    console.log(`Terminal state: ${terminalState.kind} (${terminalState.label || "no label"})`);
+    if (terminalState.heartbeatAgeSeconds !== void 0 && terminalState.heartbeatAgeSeconds !== null) {
+      console.log(`Heartbeat age: ${terminalState.heartbeatAgeSeconds}s`);
+    }
+  }
   console.log(`Rows: ${status.recordsSucceeded}/${status.recordsTotal} succeeded, ${status.recordsFailed} failed`);
   printCampaignCustomerRowCounts(status);
   console.log(`Artifacts: ${status.artifactCount}`);
@@ -1196,6 +1203,8 @@ function printCampaignAgentBuildStatus(status) {
     console.log(`Next: ${status.nextAction}`);
   } else if (status.status === "pending_approval") {
     console.log(`Next: signaliz campaign-agent approve ${status.campaignBuildId} --destination-type webhook`);
+  } else if (terminalState.safeNextAction) {
+    console.log(`Next: ${terminalState.safeNextAction}`);
   }
 }
 function printCampaignCustomerRowCounts(status) {
@@ -1219,17 +1228,20 @@ function printCampaignAgentBuildReview(review) {
   console.log(`Campaign: ${review.status?.name || review.campaignBuildId}`);
   console.log(`Status: ${summary.status || review.status?.status}`);
   console.log(`Phase: ${summary.phase || review.status?.currentPhase || "N/A"}`);
+  console.log(`Terminal state: ${summary.terminalState || review.status?.terminalState?.kind || "unknown"}`);
   console.log(`Rows: ${summary.sampledRows || 0} sampled, ${summary.availableRows || 0} available`);
   console.log(`Qualified: ${summary.qualifiedRows || 0}`);
   console.log(`Emails: ${summary.rowsWithEmail || 0}`);
   console.log(`Copy ready: ${summary.copyReadyRows || 0}`);
   console.log(`Artifacts: ${summary.artifactCount || 0}`);
+  printCampaignAgentNorthStarScorecard(review.northStarScorecard);
   if (review.campaignBuildId) printCampaignArtifactDownload(review.status, review.campaignBuildId);
   console.log(`Delivery approval ready: ${summary.readyForDeliveryApproval === true ? "yes" : "no"}`);
   if (Array.isArray(review.gates) && review.gates.length > 0) {
     console.log("\nGates:");
     for (const gate of review.gates) {
-      console.log(`- ${gate.passed ? "PASS" : "BLOCKED"} ${gate.label}: ${gate.detail}`);
+      const status = String(gate.status || (gate.passed ? "pass" : "blocked")).toUpperCase();
+      console.log(`- ${status} ${gate.label}: ${gate.detail}`);
     }
   }
   const warnings = Array.isArray(summary.warnings) ? summary.warnings : [];
@@ -1243,6 +1255,21 @@ function printCampaignAgentBuildReview(review) {
     for (const action of nextActions) console.log(`- ${action}`);
   }
 }
+function printCampaignAgentNorthStarScorecard(scorecard) {
+  const card = asRecord(scorecard);
+  if (!card.version) return;
+  const score = card.score === null || card.score === void 0 ? "pending" : `${card.score}%`;
+  console.log(`North Star: ${String(card.status || "unknown")} (${score})`);
+  if (card.moatState) console.log(`Moat state: ${card.moatState}`);
+  const metrics = Array.isArray(card.metrics) ? card.metrics : [];
+  if (metrics.length > 0) {
+    console.log("\nNorth Star gates:");
+    for (const metric of metrics.slice(0, 12)) {
+      const item = asRecord(metric);
+      console.log(`- ${String(item.status || "review").toUpperCase()} ${item.label || item.id}: ${item.detail || ""}`);
+    }
+  }
+}
 function formatCampaignAgentRows(rows) {
   return rows.map((row) => {
     const data = asRecord(row.data);

package/dist/index.d.mts

@@ -517,6 +517,7 @@ interface CampaignBuildRequest$1 {
         suppressPriorListIds?: string[];
         uniqueness?: 'email' | 'domain' | 'email_and_domain';
         requireUsageMetadata?: boolean;
+        verifiedCacheTtlDays?: number;
     };
     policy?: {
         maxCredits?: number;
@@ -660,6 +661,10 @@ interface CampaignBuildResult$1 {
     brainContext?: Record<string, unknown>;
     learningHoldout?: Record<string, unknown>;
     providerRoute?: CampaignProviderRouteReadback$1 | null;
+    effectiveSourceRouting?: Record<string, unknown> | null;
+    sourcePlan?: Record<string, unknown> | null;
+    sourceRoutes?: Array<Record<string, unknown>>;
+    sourceShards?: Array<Record<string, unknown>>;
 }
 interface CampaignBuildStatus {
     campaignBuildId: string;
@@ -687,6 +692,32 @@ interface CampaignBuildStatus {
     triggerRunId?: string | null;
     staleRunningPhase?: boolean;
     phaseAgeSeconds?: number | null;
+    nextPollAfterSeconds?: number | null;
+    terminalReason?: string | null;
+    staleReason?: string | null;
+    safeNextAction?: string | null;
+    terminalState?: {
+        kind: 'terminal' | 'pending_approval' | 'running_healthy' | 'running_stale' | 'blocked' | 'unknown';
+        label: string;
+        reviewable: boolean;
+        terminal: boolean;
+        stale: boolean;
+        phase: string | null;
+        phaseStatus: string | null;
+        heartbeatAgeSeconds: number | null;
+        nextPollAfterSeconds: number | null;
+        terminalReason: string | null;
+        staleReason: string | null;
+        safeNextAction: string;
+    };
+    phaseHealth?: Array<{
+        phase: string;
+        status: string;
+        recordsProcessed: number | null;
+        recordsSucceeded: number | null;
+        recordsFailed: number | null;
+        heartbeatAgeSeconds: number | null;
+    }>;
     diagnostics?: Record<string, unknown>;
     nextAction: string;
     approvalAction?: string;
@@ -1075,6 +1106,8 @@ interface CampaignBuilderAgentRequest {
     icp?: CampaignBuildRequest['icp'];
     /** Optional output from gtm_brain_seed_defaults to attach to build_campaign. */
     brainDefaults?: UnknownRecord$1;
+    /** Optional control-vs-learned policy. Defaults to a Signaliz learning holdout for agent-built campaigns. */
+    learningHoldout?: CampaignBuildRequest['learningHoldout'];
     /** Optional output from gtm_brain_delivery_risk. Required before committed-campaign launch handoff. */
     deliveryRisk?: UnknownRecord$1;
     workspaceContext?: CampaignBuilderWorkspaceContext;
@@ -1357,11 +1390,34 @@ interface CampaignBuilderBuildReviewGate {
     id: string;
     label: string;
     passed: boolean;
+    status?: CampaignBuilderNorthStarMetricStatus;
+    detail: string;
+}
+type CampaignBuilderNorthStarMetricStatus = 'pass' | 'pending' | 'review' | 'blocked';
+interface CampaignBuilderNorthStarMetric {
+    id: string;
+    label: string;
+    status: CampaignBuilderNorthStarMetricStatus;
     detail: string;
+    value?: number | string | boolean | null;
+    target?: number | string | boolean | null;
+}
+interface CampaignBuilderNorthStarScorecard {
+    version: 'campaign-builder-north-star.v1';
+    status: CampaignBuilderNorthStarMetricStatus;
+    score: number | null;
+    moatState: 'scaffolding_ready' | 'moved_needs_lift_volume' | 'proved';
+    metrics: CampaignBuilderNorthStarMetric[];
+    blockers: string[];
+    warnings: string[];
+    nextAction: string;
 }
 interface CampaignBuilderBuildReviewSummary {
     status: string;
     phase: string | null;
+    terminalState: string;
+    scorecardStatus: CampaignBuilderNorthStarMetricStatus;
+    scorecardScore: number | null;
     sampledRows: number;
     availableRows: number;
     qualifiedRows: number;
@@ -1378,6 +1434,7 @@ interface CampaignBuilderBuildReview {
     rows: CampaignRowsResult;
     artifacts: CampaignArtifact[];
     gates: CampaignBuilderBuildReviewGate[];
+    northStarScorecard: CampaignBuilderNorthStarScorecard;
     summary: CampaignBuilderBuildReviewSummary;
     nextActions: string[];
 }
@@ -2005,6 +2062,13 @@ interface GtmBrainDistillRunInput {
     minWorkspaceCount?: number;
     minPrivacyK?: number;
 }
+interface GtmHistoricalCampaignBuildBridgeRunInput {
+    dryRun?: boolean;
+    writeApproved?: boolean;
+    maxEvents?: number;
+    maxCampaigns?: number;
+    minFeedbackEvents?: number;
+}
 interface GtmFeedbackWebhookPrepareInput {
     provider: string;
     campaignId?: string;
@@ -2763,6 +2827,8 @@ declare class GtmKernel {
     runKernelImport(input?: GtmKernelImportRunInput): Promise<any>;
     /** Queue Brain distillation over imported Instantly memory with abstracted-only outputs. */
     runBrainDistillation(input?: GtmBrainDistillRunInput): Promise<any>;
+    /** Queue a dry-run-first bridge from imported historical feedback to attribution-only Campaign Build surrogates. */
+    runHistoricalCampaignBuildBridge(input?: GtmHistoricalCampaignBuildBridgeRunInput): Promise<any>;
     /** Prepare a provider-agnostic feedback webhook URL for Smartlead, HeyReach, Airbyte, or custom sender events. */
     prepareFeedbackWebhook(input: GtmFeedbackWebhookPrepareInput): Promise<any>;
     /** Search ranked workspace campaign memory instead of dumping raw history. */

package/dist/index.d.ts

@@ -517,6 +517,7 @@ interface CampaignBuildRequest$1 {
         suppressPriorListIds?: string[];
         uniqueness?: 'email' | 'domain' | 'email_and_domain';
         requireUsageMetadata?: boolean;
+        verifiedCacheTtlDays?: number;
     };
     policy?: {
         maxCredits?: number;
@@ -660,6 +661,10 @@ interface CampaignBuildResult$1 {
     brainContext?: Record<string, unknown>;
     learningHoldout?: Record<string, unknown>;
     providerRoute?: CampaignProviderRouteReadback$1 | null;
+    effectiveSourceRouting?: Record<string, unknown> | null;
+    sourcePlan?: Record<string, unknown> | null;
+    sourceRoutes?: Array<Record<string, unknown>>;
+    sourceShards?: Array<Record<string, unknown>>;
 }
 interface CampaignBuildStatus {
     campaignBuildId: string;
@@ -687,6 +692,32 @@ interface CampaignBuildStatus {
     triggerRunId?: string | null;
     staleRunningPhase?: boolean;
     phaseAgeSeconds?: number | null;
+    nextPollAfterSeconds?: number | null;
+    terminalReason?: string | null;
+    staleReason?: string | null;
+    safeNextAction?: string | null;
+    terminalState?: {
+        kind: 'terminal' | 'pending_approval' | 'running_healthy' | 'running_stale' | 'blocked' | 'unknown';
+        label: string;
+        reviewable: boolean;
+        terminal: boolean;
+        stale: boolean;
+        phase: string | null;
+        phaseStatus: string | null;
+        heartbeatAgeSeconds: number | null;
+        nextPollAfterSeconds: number | null;
+        terminalReason: string | null;
+        staleReason: string | null;
+        safeNextAction: string;
+    };
+    phaseHealth?: Array<{
+        phase: string;
+        status: string;
+        recordsProcessed: number | null;
+        recordsSucceeded: number | null;
+        recordsFailed: number | null;
+        heartbeatAgeSeconds: number | null;
+    }>;
     diagnostics?: Record<string, unknown>;
     nextAction: string;
     approvalAction?: string;
@@ -1075,6 +1106,8 @@ interface CampaignBuilderAgentRequest {
     icp?: CampaignBuildRequest['icp'];
     /** Optional output from gtm_brain_seed_defaults to attach to build_campaign. */
     brainDefaults?: UnknownRecord$1;
+    /** Optional control-vs-learned policy. Defaults to a Signaliz learning holdout for agent-built campaigns. */
+    learningHoldout?: CampaignBuildRequest['learningHoldout'];
     /** Optional output from gtm_brain_delivery_risk. Required before committed-campaign launch handoff. */
     deliveryRisk?: UnknownRecord$1;
     workspaceContext?: CampaignBuilderWorkspaceContext;
@@ -1357,11 +1390,34 @@ interface CampaignBuilderBuildReviewGate {
     id: string;
     label: string;
     passed: boolean;
+    status?: CampaignBuilderNorthStarMetricStatus;
+    detail: string;
+}
+type CampaignBuilderNorthStarMetricStatus = 'pass' | 'pending' | 'review' | 'blocked';
+interface CampaignBuilderNorthStarMetric {
+    id: string;
+    label: string;
+    status: CampaignBuilderNorthStarMetricStatus;
     detail: string;
+    value?: number | string | boolean | null;
+    target?: number | string | boolean | null;
+}
+interface CampaignBuilderNorthStarScorecard {
+    version: 'campaign-builder-north-star.v1';
+    status: CampaignBuilderNorthStarMetricStatus;
+    score: number | null;
+    moatState: 'scaffolding_ready' | 'moved_needs_lift_volume' | 'proved';
+    metrics: CampaignBuilderNorthStarMetric[];
+    blockers: string[];
+    warnings: string[];
+    nextAction: string;
 }
 interface CampaignBuilderBuildReviewSummary {
     status: string;
     phase: string | null;
+    terminalState: string;
+    scorecardStatus: CampaignBuilderNorthStarMetricStatus;
+    scorecardScore: number | null;
     sampledRows: number;
     availableRows: number;
     qualifiedRows: number;
@@ -1378,6 +1434,7 @@ interface CampaignBuilderBuildReview {
     rows: CampaignRowsResult;
     artifacts: CampaignArtifact[];
     gates: CampaignBuilderBuildReviewGate[];
+    northStarScorecard: CampaignBuilderNorthStarScorecard;
     summary: CampaignBuilderBuildReviewSummary;
     nextActions: string[];
 }
@@ -2005,6 +2062,13 @@ interface GtmBrainDistillRunInput {
     minWorkspaceCount?: number;
     minPrivacyK?: number;
 }
+interface GtmHistoricalCampaignBuildBridgeRunInput {
+    dryRun?: boolean;
+    writeApproved?: boolean;
+    maxEvents?: number;
+    maxCampaigns?: number;
+    minFeedbackEvents?: number;
+}
 interface GtmFeedbackWebhookPrepareInput {
     provider: string;
     campaignId?: string;
@@ -2763,6 +2827,8 @@ declare class GtmKernel {
     runKernelImport(input?: GtmKernelImportRunInput): Promise<any>;
     /** Queue Brain distillation over imported Instantly memory with abstracted-only outputs. */
     runBrainDistillation(input?: GtmBrainDistillRunInput): Promise<any>;
+    /** Queue a dry-run-first bridge from imported historical feedback to attribution-only Campaign Build surrogates. */
+    runHistoricalCampaignBuildBridge(input?: GtmHistoricalCampaignBuildBridgeRunInput): Promise<any>;
     /** Prepare a provider-agnostic feedback webhook URL for Smartlead, HeyReach, Airbyte, or custom sender events. */
     prepareFeedbackWebhook(input: GtmFeedbackWebhookPrepareInput): Promise<any>;
     /** Search ranked workspace campaign memory instead of dumping raw history. */