@signaliz/sdk 1.0.14 → 1.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli.mjs CHANGED
@@ -2,8 +2,9 @@
2
2
  import {
3
3
  Signaliz,
4
4
  createCampaignBuilderAgentRequestTemplate,
5
- createCampaignBuilderApproval
6
- } from "./chunk-EVFQETTN.mjs";
5
+ createCampaignBuilderApproval,
6
+ createCampaignBuilderBuildKit
7
+ } from "./chunk-6OZWMAV3.mjs";
7
8
 
8
9
  // src/cli.ts
9
10
  import { readFileSync, writeFileSync } from "fs";
@@ -15,7 +16,7 @@ async function main() {
15
16
  printHelp();
16
17
  return;
17
18
  }
18
- const offlineCampaignAgentTemplate = (command === "campaign-agent" || command === "campaign-builder") && ["init", "template", "request-template", "new"].includes(String(process.argv[3] || ""));
19
+ const offlineCampaignAgentTemplate = (command === "campaign-agent" || command === "campaign-builder") && ["init", "template", "request-template", "new", "kit", "build-kit", "blueprint"].includes(String(process.argv[3] || ""));
19
20
  if (!apiKey && !offlineCampaignAgentTemplate) {
20
21
  console.error("\u274C SIGNALIZ_API_KEY environment variable is required.");
21
22
  console.error(" Set it with: export SIGNALIZ_API_KEY=sk_...");
@@ -379,6 +380,38 @@ async function handleCampaignAgentCommand(signaliz, argv) {
379
380
  }
380
381
  return;
381
382
  }
383
+ if (["kit", "build-kit", "blueprint"].includes(subcommand)) {
384
+ const flags2 = parseFlags(argv.slice(1));
385
+ const requestFromFile2 = campaignAgentRequestFileFromFlags(flags2);
386
+ const fallbackGoal = stringFlag(flags2, "goal", "brief") || stringOrUndefined(requestFromFile2?.goal) || "Build a strategy-template campaign for mature operators in the target ICP.";
387
+ const request2 = requestFromFile2 ? mergeCampaignAgentRequests(
388
+ requestFromFile2,
389
+ campaignAgentRequestFromFlags(fallbackGoal, flags2, { includeDefaults: false })
390
+ ) : campaignAgentRequestTemplateFromFlags(flags2);
391
+ const kit = createCampaignBuilderBuildKit({
392
+ ...request2,
393
+ includeLocalLeads: booleanFlag(flags2, "use-local-leads"),
394
+ includeCustomToolPlaceholder: booleanFlag(flags2, "with-byo-placeholder") || booleanFlag(flags2, "include-custom-tool-placeholder") || booleanFlag(flags2, "include-byo-placeholder"),
395
+ includeNango: !booleanFlag(flags2, "no-nango-catalog"),
396
+ requestFile: stringFlag(flags2, "request-output-file", "request-file-name") || stringFlag(flags2, "request-file") || "campaign-request.json",
397
+ cliPackage: stringFlag(flags2, "cli-package"),
398
+ sdkPackage: stringFlag(flags2, "sdk-package")
399
+ });
400
+ const outputFile = stringFlag(flags2, "output-file", "kit-file", "out");
401
+ if (outputFile) {
402
+ writeFileSync(outputFile, `${JSON.stringify(kit, null, 2)}
403
+ `, "utf8");
404
+ }
405
+ if (booleanFlag(flags2, "json")) {
406
+ printJson(kit);
407
+ } else if (!outputFile) {
408
+ printCampaignAgentBuildKit(kit);
409
+ } else {
410
+ console.log(`Campaign build kit written: ${outputFile}`);
411
+ console.log(`Next: ${kit.cli_commands.find((command) => command.id === "proof_shortcut")?.command}`);
412
+ }
413
+ return;
414
+ }
382
415
  if (["review", "status", "rows", "artifacts", "approve", "approve-delivery"].includes(subcommand)) {
383
416
  await handleCampaignAgentReviewCommand(signaliz, subcommand, argv.slice(1));
384
417
  return;
@@ -905,6 +938,25 @@ function printCampaignAgentPlan(plan) {
905
938
  console.log(`- ${step.id}: ${step.tool}${step.approvalRequired ? " (approval required)" : ""}`);
906
939
  }
907
940
  }
941
+ function printCampaignAgentBuildKit(kit) {
942
+ console.log(`Campaign build kit: ${kit.strategy_template || "custom strategy"}`);
943
+ console.log(`Request file: ${kit.request_file}`);
944
+ console.log(`Built-ins: ${kit.built_in_lanes.join(", ") || "none"}`);
945
+ console.log(`Playbooks: ${kit.operating_playbooks.join(", ") || "none"}`);
946
+ console.log(`BYO routes: ${kit.custom_routes.length}`);
947
+ console.log("\nCLI:");
948
+ for (const command of kit.cli_commands.slice(0, 4)) {
949
+ console.log(`- ${command.label}: ${command.command}`);
950
+ }
951
+ console.log("\nMCP:");
952
+ for (const call of kit.mcp_calls.slice(0, 3)) {
953
+ console.log(`- ${call.tool}: ${call.safety}`);
954
+ }
955
+ console.log("\nBYO tool pattern:");
956
+ console.log(`- ${kit.byo_tool_pattern.cli_flag}`);
957
+ console.log("\nNext:");
958
+ for (const action of kit.next_actions.slice(0, 4)) console.log(`- ${action}`);
959
+ }
908
960
  function printCampaignAgentExecution(payload, flags) {
909
961
  if (booleanFlag(flags, "json")) {
910
962
  printJson(payload);
@@ -1102,6 +1154,7 @@ function printCampaignAgentHelp() {
1102
1154
  Signaliz campaign-agent commands:
1103
1155
 
1104
1156
  signaliz campaign-agent init [--goal TEXT] [--strategy-template ID] [--target-count N] [--use-local-leads] [--with-byo-placeholder] [--output-file FILE] [--json]
1157
+ signaliz campaign-agent kit [--goal TEXT | --request-file FILE] [--strategy-template ID] [--target-count N] [--use-local-leads] [--custom-tool provider:layer:tool[:mcp]] [--output-file FILE] [--json]
1105
1158
  signaliz campaign-agent doctor [--goal TEXT | --request-file FILE] [--strategy-template ID] [--target-count N] [--builtins lead_generation,email_finding,email_verification,signals,local_leads] [--custom-tool provider:layer:tool[:mcp]] [--json]
1106
1159
  signaliz campaign-agent plan (--goal TEXT | --request-file FILE) [--campaign-name NAME] [--workspace-label NAME] [--strategy-template industrial-ot-resilience|non-medical-home-care|agency-founder-led|cloud-infrastructure-displacement] [--operating-playbooks proof-first-vertical-gate,signal-led-copy-approval] [--target-count N] [--icp JSON] [--builtins lead_generation,email_finding,email_verification,signals,local_leads] [--use-local-leads] [--custom-tool provider:layer:tool[:mcp]] [--preferred-providers signaliz_native,octave] [--partners clay,instantly,nango] [--no-strategy-memory] [--no-kernel-plan] [--no-delivery-risk] [--json]
1107
1160
  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]
@@ -1114,7 +1167,7 @@ Signaliz campaign-agent commands:
1114
1167
  signaliz campaign-agent artifacts <campaign_build_id> [--json]
1115
1168
  signaliz campaign-agent approve <campaign_build_id> --destination-type json|csv|webhook [--destination-config JSON] [--json]
1116
1169
 
1117
- The init command emits a reusable JSON CampaignBuilderAgentRequest. Doctor returns a readiness packet for built-in lanes, BYO routes, Memory, Brain, Kernel planning, and approval gates. The plan command composes an approval-gated strategy-template MCP flow. Proof runs the same plan path plus build_campaign dry_run=true and returns a no-spend receipt. Use --request-file to load a reusable request, then override fields such as --target-count or --strategy-template from the command line. Use --strategy-template to merge a private-safe strategy pattern into the plan without exposing private account labels, and --operating-playbooks to add reusable build-loop gates such as proof-first vertical qualification, net-new suppression, cache-first inventory, and signal-led copy approval. Built-ins map to Signaliz-native tools: lead_generation -> generate_leads, local_leads -> generate_local_leads, email_finding -> find_and_verify_emails, email_verification -> verify_emails, signals -> enrich_company_signals. Add BYO tools with --custom-tool provider:layer:tool[:mcp] or key=value pairs such as provider=apollo,layer=source,tool=apollo_search,mcp=apollo. Use --no-strategy-patterns or --no-workflow-patterns to disable default private strategy memory hints. Commit-plan dry-runs by default and writes only with --confirm-write plus approval identity. Dry-run executes build_campaign with dry_run=true. Approved build requires explicit launch confirmation and approval metadata; add --commit-before-launch to persist the reviewed plan as a GTM campaign before launch, --wait to poll until completion or pending approval, and --approve-delivery to approve reviewed webhook delivery after pending_approval. Use review to inspect status, sampled rows, artifacts, and delivery-readiness gates before approving delivery or routing rows to external tools.
1170
+ The init command emits a reusable JSON CampaignBuilderAgentRequest. Kit emits the full build packet: request JSON, exact CLI commands, MCP calls, SDK example, approval boundaries, and BYO integration pattern. Doctor returns a readiness packet for built-in lanes, BYO routes, Memory, Brain, Kernel planning, and approval gates. The plan command composes an approval-gated strategy-template MCP flow. Proof runs the same plan path plus build_campaign dry_run=true and returns a no-spend receipt. Use --request-file to load a reusable request, then override fields such as --target-count or --strategy-template from the command line. Use --strategy-template to merge a private-safe strategy pattern into the plan without exposing private account labels, and --operating-playbooks to add reusable build-loop gates such as proof-first vertical qualification, net-new suppression, cache-first inventory, and signal-led copy approval. Built-ins map to Signaliz-native tools: lead_generation -> generate_leads, local_leads -> generate_local_leads, email_finding -> find_and_verify_emails, email_verification -> verify_emails, signals -> enrich_company_signals. Add BYO tools with --custom-tool provider:layer:tool[:mcp] or key=value pairs such as provider=apollo,layer=source,tool=apollo_search,mcp=apollo. Use --no-strategy-patterns or --no-workflow-patterns to disable default private strategy memory hints. Commit-plan dry-runs by default and writes only with --confirm-write plus approval identity. Dry-run executes build_campaign with dry_run=true. Approved build requires explicit launch confirmation and approval metadata; add --commit-before-launch to persist the reviewed plan as a GTM campaign before launch, --wait to poll until completion or pending approval, and --approve-delivery to approve reviewed webhook delivery after pending_approval. Use review to inspect status, sampled rows, artifacts, and delivery-readiness gates before approving delivery or routing rows to external tools.
1118
1171
  `);
1119
1172
  }
1120
1173
  main().catch((e) => {
package/dist/index.d.mts CHANGED
@@ -1122,6 +1122,57 @@ interface CampaignBuilderProofReceipt {
1122
1122
  dry_run_result: UnknownRecord$1;
1123
1123
  recommended_next_actions: string[];
1124
1124
  }
1125
+ interface CampaignBuilderBuildKitOptions extends CampaignBuilderAgentRequestTemplateOptions {
1126
+ requestFile?: string;
1127
+ cliPackage?: string;
1128
+ sdkPackage?: string;
1129
+ }
1130
+ interface CampaignBuilderBuildKitCommand {
1131
+ id: string;
1132
+ label: string;
1133
+ command: string;
1134
+ safety: string;
1135
+ }
1136
+ interface CampaignBuilderBuildKitMcpCall {
1137
+ id: string;
1138
+ tool: string;
1139
+ arguments: UnknownRecord$1;
1140
+ safety: string;
1141
+ }
1142
+ interface CampaignBuilderBuildKit {
1143
+ kit_version: 'campaign-builder-kit.v1';
1144
+ source: string;
1145
+ request_file: string;
1146
+ request: CampaignBuilderAgentRequest;
1147
+ strategy_template: string | null;
1148
+ built_in_lanes: string[];
1149
+ operating_playbooks: string[];
1150
+ custom_routes: Array<{
1151
+ provider: string;
1152
+ layer: string;
1153
+ tool: string | null;
1154
+ mcp_server: string | null;
1155
+ mode: string;
1156
+ approval_required: boolean;
1157
+ }>;
1158
+ approval_boundaries: string[];
1159
+ byo_tool_pattern: {
1160
+ cli_flag: string;
1161
+ request_fragment: CampaignBuilderIntegrationRoute;
1162
+ };
1163
+ cli_commands: CampaignBuilderBuildKitCommand[];
1164
+ mcp_calls: CampaignBuilderBuildKitMcpCall[];
1165
+ sdk_example: {
1166
+ language: 'typescript';
1167
+ code: string;
1168
+ };
1169
+ verification: string[];
1170
+ privacy: {
1171
+ client_names_allowed: boolean;
1172
+ notes: string[];
1173
+ };
1174
+ next_actions: string[];
1175
+ }
1125
1176
  interface CampaignBuilderBuildReviewOptions extends CampaignRowsOptions {
1126
1177
  /** Number of rows to sample for review. Defaults to 100. */
1127
1178
  limit?: number;
@@ -1207,6 +1258,7 @@ declare class CampaignBuilderAgent {
1207
1258
  createPlan(request: CampaignBuilderAgentRequest, options?: CampaignBuilderPlanOptions): Promise<CampaignBuilderAgentPlan>;
1208
1259
  readiness(request: CampaignBuilderAgentRequest, options?: CampaignBuilderPlanOptions): Promise<CampaignBuilderReadinessPacket>;
1209
1260
  proof(request: CampaignBuilderAgentRequest, options?: CampaignBuilderProofOptions): Promise<CampaignBuilderProofReceipt>;
1261
+ buildKit(options?: CampaignBuilderBuildKitOptions): CampaignBuilderBuildKit;
1210
1262
  commitPlan(plan: CampaignBuilderAgentPlan, options?: CampaignBuilderPlanCommitOptions): Promise<CampaignBuilderPlanCommitResult>;
1211
1263
  dryRunPlan(plan: CampaignBuilderAgentPlan, options?: BuildOptions): Promise<CampaignBuildResult>;
1212
1264
  buildApprovedPlan(plan: CampaignBuilderAgentPlan, approval: CampaignBuilderApproval, options?: CampaignBuilderBuildOptions): Promise<CampaignBuildResult>;
@@ -1245,6 +1297,7 @@ declare function getCampaignBuilderOperatingPlaybook(value: unknown): CampaignBu
1245
1297
  declare function getCampaignBuilderOperatingPlaybooksForRequest(request: CampaignBuilderAgentRequest): CampaignBuilderOperatingPlaybook[];
1246
1298
  declare function applyCampaignBuilderStrategyTemplate(request: CampaignBuilderAgentRequest): CampaignBuilderAgentRequest;
1247
1299
  declare function createCampaignBuilderAgentRequestTemplate(input?: CampaignBuilderAgentRequestTemplateOptions): CampaignBuilderAgentRequest;
1300
+ declare function createCampaignBuilderBuildKit(input?: CampaignBuilderBuildKitOptions): CampaignBuilderBuildKit;
1248
1301
  declare function createCampaignBuilderToolRoute(input: {
1249
1302
  provider?: CampaignBuilderProvider;
1250
1303
  layer: CampaignBuilderLayer;
@@ -3498,4 +3551,4 @@ declare class Signaliz {
3498
3551
  discover(query: string, category?: string): Promise<MCPToolInfo[]>;
3499
3552
  }
3500
3553
 
3501
- 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 CampaignBuilderProofOptions, type CampaignBuilderProofReceipt, type CampaignBuilderProvider, type CampaignBuilderReadinessGate, type CampaignBuilderReadinessLane, type CampaignBuilderReadinessPacket, type CampaignBuilderReadinessSummary, 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, createCampaignBuilderProofReceipt, createCampaignBuilderReadiness, createCampaignBuilderToolRoute, getCampaignBuilderOperatingPlaybook, getCampaignBuilderOperatingPlaybooksForRequest, getCampaignBuilderStrategyTemplate, getMissingCampaignBuilderApprovals, normalizeExecutionReference };
3554
+ 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 CampaignBuilderBuildKit, type CampaignBuilderBuildKitCommand, type CampaignBuilderBuildKitMcpCall, type CampaignBuilderBuildKitOptions, 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 CampaignBuilderProofOptions, type CampaignBuilderProofReceipt, type CampaignBuilderProvider, type CampaignBuilderReadinessGate, type CampaignBuilderReadinessLane, type CampaignBuilderReadinessPacket, type CampaignBuilderReadinessSummary, 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, createCampaignBuilderBuildKit, createCampaignBuilderProofReceipt, createCampaignBuilderReadiness, createCampaignBuilderToolRoute, getCampaignBuilderOperatingPlaybook, getCampaignBuilderOperatingPlaybooksForRequest, getCampaignBuilderStrategyTemplate, getMissingCampaignBuilderApprovals, normalizeExecutionReference };
package/dist/index.d.ts CHANGED
@@ -1122,6 +1122,57 @@ interface CampaignBuilderProofReceipt {
1122
1122
  dry_run_result: UnknownRecord$1;
1123
1123
  recommended_next_actions: string[];
1124
1124
  }
1125
+ interface CampaignBuilderBuildKitOptions extends CampaignBuilderAgentRequestTemplateOptions {
1126
+ requestFile?: string;
1127
+ cliPackage?: string;
1128
+ sdkPackage?: string;
1129
+ }
1130
+ interface CampaignBuilderBuildKitCommand {
1131
+ id: string;
1132
+ label: string;
1133
+ command: string;
1134
+ safety: string;
1135
+ }
1136
+ interface CampaignBuilderBuildKitMcpCall {
1137
+ id: string;
1138
+ tool: string;
1139
+ arguments: UnknownRecord$1;
1140
+ safety: string;
1141
+ }
1142
+ interface CampaignBuilderBuildKit {
1143
+ kit_version: 'campaign-builder-kit.v1';
1144
+ source: string;
1145
+ request_file: string;
1146
+ request: CampaignBuilderAgentRequest;
1147
+ strategy_template: string | null;
1148
+ built_in_lanes: string[];
1149
+ operating_playbooks: string[];
1150
+ custom_routes: Array<{
1151
+ provider: string;
1152
+ layer: string;
1153
+ tool: string | null;
1154
+ mcp_server: string | null;
1155
+ mode: string;
1156
+ approval_required: boolean;
1157
+ }>;
1158
+ approval_boundaries: string[];
1159
+ byo_tool_pattern: {
1160
+ cli_flag: string;
1161
+ request_fragment: CampaignBuilderIntegrationRoute;
1162
+ };
1163
+ cli_commands: CampaignBuilderBuildKitCommand[];
1164
+ mcp_calls: CampaignBuilderBuildKitMcpCall[];
1165
+ sdk_example: {
1166
+ language: 'typescript';
1167
+ code: string;
1168
+ };
1169
+ verification: string[];
1170
+ privacy: {
1171
+ client_names_allowed: boolean;
1172
+ notes: string[];
1173
+ };
1174
+ next_actions: string[];
1175
+ }
1125
1176
  interface CampaignBuilderBuildReviewOptions extends CampaignRowsOptions {
1126
1177
  /** Number of rows to sample for review. Defaults to 100. */
1127
1178
  limit?: number;
@@ -1207,6 +1258,7 @@ declare class CampaignBuilderAgent {
1207
1258
  createPlan(request: CampaignBuilderAgentRequest, options?: CampaignBuilderPlanOptions): Promise<CampaignBuilderAgentPlan>;
1208
1259
  readiness(request: CampaignBuilderAgentRequest, options?: CampaignBuilderPlanOptions): Promise<CampaignBuilderReadinessPacket>;
1209
1260
  proof(request: CampaignBuilderAgentRequest, options?: CampaignBuilderProofOptions): Promise<CampaignBuilderProofReceipt>;
1261
+ buildKit(options?: CampaignBuilderBuildKitOptions): CampaignBuilderBuildKit;
1210
1262
  commitPlan(plan: CampaignBuilderAgentPlan, options?: CampaignBuilderPlanCommitOptions): Promise<CampaignBuilderPlanCommitResult>;
1211
1263
  dryRunPlan(plan: CampaignBuilderAgentPlan, options?: BuildOptions): Promise<CampaignBuildResult>;
1212
1264
  buildApprovedPlan(plan: CampaignBuilderAgentPlan, approval: CampaignBuilderApproval, options?: CampaignBuilderBuildOptions): Promise<CampaignBuildResult>;
@@ -1245,6 +1297,7 @@ declare function getCampaignBuilderOperatingPlaybook(value: unknown): CampaignBu
1245
1297
  declare function getCampaignBuilderOperatingPlaybooksForRequest(request: CampaignBuilderAgentRequest): CampaignBuilderOperatingPlaybook[];
1246
1298
  declare function applyCampaignBuilderStrategyTemplate(request: CampaignBuilderAgentRequest): CampaignBuilderAgentRequest;
1247
1299
  declare function createCampaignBuilderAgentRequestTemplate(input?: CampaignBuilderAgentRequestTemplateOptions): CampaignBuilderAgentRequest;
1300
+ declare function createCampaignBuilderBuildKit(input?: CampaignBuilderBuildKitOptions): CampaignBuilderBuildKit;
1248
1301
  declare function createCampaignBuilderToolRoute(input: {
1249
1302
  provider?: CampaignBuilderProvider;
1250
1303
  layer: CampaignBuilderLayer;
@@ -3498,4 +3551,4 @@ declare class Signaliz {
3498
3551
  discover(query: string, category?: string): Promise<MCPToolInfo[]>;
3499
3552
  }
3500
3553
 
3501
- 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 CampaignBuilderProofOptions, type CampaignBuilderProofReceipt, type CampaignBuilderProvider, type CampaignBuilderReadinessGate, type CampaignBuilderReadinessLane, type CampaignBuilderReadinessPacket, type CampaignBuilderReadinessSummary, 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, createCampaignBuilderProofReceipt, createCampaignBuilderReadiness, createCampaignBuilderToolRoute, getCampaignBuilderOperatingPlaybook, getCampaignBuilderOperatingPlaybooksForRequest, getCampaignBuilderStrategyTemplate, getMissingCampaignBuilderApprovals, normalizeExecutionReference };
3554
+ 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 CampaignBuilderBuildKit, type CampaignBuilderBuildKitCommand, type CampaignBuilderBuildKitMcpCall, type CampaignBuilderBuildKitOptions, 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 CampaignBuilderProofOptions, type CampaignBuilderProofReceipt, type CampaignBuilderProvider, type CampaignBuilderReadinessGate, type CampaignBuilderReadinessLane, type CampaignBuilderReadinessPacket, type CampaignBuilderReadinessSummary, 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, createCampaignBuilderBuildKit, createCampaignBuilderProofReceipt, createCampaignBuilderReadiness, createCampaignBuilderToolRoute, getCampaignBuilderOperatingPlaybook, getCampaignBuilderOperatingPlaybooksForRequest, getCampaignBuilderStrategyTemplate, getMissingCampaignBuilderApprovals, normalizeExecutionReference };
package/dist/index.js CHANGED
@@ -38,6 +38,7 @@ __export(index_exports, {
38
38
  createCampaignBuilderAgentPlan: () => createCampaignBuilderAgentPlan,
39
39
  createCampaignBuilderAgentRequestTemplate: () => createCampaignBuilderAgentRequestTemplate,
40
40
  createCampaignBuilderApproval: () => createCampaignBuilderApproval,
41
+ createCampaignBuilderBuildKit: () => createCampaignBuilderBuildKit,
41
42
  createCampaignBuilderProofReceipt: () => createCampaignBuilderProofReceipt,
42
43
  createCampaignBuilderReadiness: () => createCampaignBuilderReadiness,
43
44
  createCampaignBuilderToolRoute: () => createCampaignBuilderToolRoute,
@@ -1756,6 +1757,9 @@ var CampaignBuilderAgent = class {
1756
1757
  });
1757
1758
  return createCampaignBuilderProofReceipt(plan, result);
1758
1759
  }
1760
+ buildKit(options = {}) {
1761
+ return createCampaignBuilderBuildKit(options);
1762
+ }
1759
1763
  async commitPlan(plan, options = {}) {
1760
1764
  const writeMode = options.confirm === true && options.dryRun === false;
1761
1765
  if (writeMode && !options.approvedBy) {
@@ -2420,6 +2424,156 @@ function createCampaignBuilderAgentRequestTemplate(input = {}) {
2420
2424
  }
2421
2425
  });
2422
2426
  }
2427
+ function createCampaignBuilderBuildKit(input = {}) {
2428
+ const requestFile = input.requestFile || "campaign-request.json";
2429
+ const cliPackage = input.cliPackage || "@signaliz/cli";
2430
+ const sdkPackage = input.sdkPackage || "@signaliz/sdk";
2431
+ const request = createCampaignBuilderAgentRequestTemplate(input);
2432
+ const strategyTemplate = stringValue(request.strategyTemplate) ?? null;
2433
+ const builtIns = request.builtIns ?? DEFAULT_CAMPAIGN_BUILDER_BUILT_INS;
2434
+ const useLocalLeads = builtIns.includes("local_leads");
2435
+ const customRoutes = [
2436
+ ...request.integrations ?? [],
2437
+ ...routesFromCustomerTools(request.customerTools ?? [])
2438
+ ].filter((route) => route.provider !== "signaliz");
2439
+ const strategyFlag = strategyTemplate ? ` --strategy-template ${shellArg(strategyTemplate)}` : "";
2440
+ const targetFlag = request.targetCount ? ` --target-count ${request.targetCount}` : "";
2441
+ const localLeadsFlag = useLocalLeads ? " --use-local-leads" : "";
2442
+ const cliBase = `npx ${cliPackage}`;
2443
+ const sdkCliBase = `npx ${sdkPackage}`;
2444
+ const brief = request.goal || "Build a strategy-template campaign for the target ICP.";
2445
+ const mcpArgs = campaignBuilderBuildKitMcpArgs(request);
2446
+ return {
2447
+ kit_version: "campaign-builder-kit.v1",
2448
+ source: "signaliz.campaignBuilderAgent.buildKit",
2449
+ request_file: requestFile,
2450
+ request,
2451
+ strategy_template: strategyTemplate,
2452
+ built_in_lanes: builtIns,
2453
+ operating_playbooks: getCampaignBuilderOperatingPlaybooksForRequest(request).map((playbook) => playbook.slug),
2454
+ custom_routes: customRoutes.map((route) => ({
2455
+ provider: String(route.provider),
2456
+ layer: String(route.layer),
2457
+ tool: firstNonEmptyString(route.toolName),
2458
+ mcp_server: firstNonEmptyString(route.mcpServerName),
2459
+ mode: route.mode ?? "if_available",
2460
+ approval_required: route.approvalRequired === true || route.mode === "required"
2461
+ })),
2462
+ approval_boundaries: request.approvalPolicy?.requireApprovalFor ?? DEFAULT_CAMPAIGN_BUILDER_APPROVAL_TYPES,
2463
+ byo_tool_pattern: {
2464
+ cli_flag: "--custom-tool provider:layer:tool[:mcp]",
2465
+ request_fragment: createCampaignBuilderToolRoute({
2466
+ provider: "workspace_mcp",
2467
+ layer: "enrichment",
2468
+ gtmLayers: ["company_enrichment"],
2469
+ toolName: "workspace_account_enrich",
2470
+ mcpServerName: "workspace-mcp",
2471
+ label: "Workspace account enrichment",
2472
+ mode: "required",
2473
+ approvalRequired: true
2474
+ })
2475
+ },
2476
+ cli_commands: [
2477
+ {
2478
+ id: "write_request",
2479
+ label: "Write reusable request JSON",
2480
+ command: `${cliBase} campaign-agent init${strategyFlag}${targetFlag}${localLeadsFlag} --output-file ${shellArg(requestFile)}`,
2481
+ safety: "local file only; no MCP calls, credits, provider writes, sender loads, exports, or sends"
2482
+ },
2483
+ {
2484
+ id: "proof_shortcut",
2485
+ label: "Run no-spend campaign-builder proof",
2486
+ command: `${cliBase} build ${shellArg(brief)}${strategyFlag}${targetFlag}${localLeadsFlag} --json`,
2487
+ safety: "strategy memory, Kernel plan, approvals, and forced build_campaign dry-run only"
2488
+ },
2489
+ {
2490
+ id: "plan",
2491
+ label: "Inspect the full campaign-agent plan",
2492
+ command: `${sdkCliBase} campaign-agent plan --request-file ${shellArg(requestFile)} --json`,
2493
+ safety: "read-only MCP planning and provider-route dry-runs"
2494
+ },
2495
+ {
2496
+ id: "doctor",
2497
+ label: "Check readiness gates",
2498
+ command: `${sdkCliBase} campaign-agent doctor --request-file ${shellArg(requestFile)} --json`,
2499
+ safety: "read-only readiness checks for Memory, Brain, built-ins, BYO routes, and approvals"
2500
+ },
2501
+ {
2502
+ id: "commit_preview",
2503
+ label: "Preview GTM campaign object commit",
2504
+ command: `${sdkCliBase} campaign-agent commit-plan --request-file ${shellArg(requestFile)} --json`,
2505
+ safety: "dry-run commit; writes only with --confirm-write and --approved-by"
2506
+ },
2507
+ {
2508
+ id: "approved_launch",
2509
+ label: "Launch after explicit approval",
2510
+ command: `${sdkCliBase} campaign-agent build-approved --request-file ${shellArg(requestFile)} --confirm-launch --approve-all --approved-by operator@example.com --spend-limit ${request.signalizDefaults?.maxCredits ?? 0} --json`,
2511
+ safety: "spendful path; requires human approval identity, approval types, and spend limit"
2512
+ }
2513
+ ],
2514
+ mcp_calls: [
2515
+ {
2516
+ id: "request_template",
2517
+ tool: "gtm_campaign_agent_request_template",
2518
+ arguments: mcpArgs,
2519
+ safety: "read-only reusable request generation"
2520
+ },
2521
+ {
2522
+ id: "readiness",
2523
+ tool: "gtm_campaign_agent_readiness",
2524
+ arguments: mcpArgs,
2525
+ safety: "read-only preflight across strategy memory, Kernel plan, lanes, routes, and approvals"
2526
+ },
2527
+ {
2528
+ id: "proof",
2529
+ tool: "gtm_campaign_agent_proof",
2530
+ arguments: { ...mcpArgs, idempotency_key: "campaign-agent-proof-001" },
2531
+ safety: "forces build_campaign dry_run=true and confirm_spend=false"
2532
+ },
2533
+ {
2534
+ id: "plan",
2535
+ tool: "gtm_campaign_agent_plan",
2536
+ arguments: mcpArgs,
2537
+ safety: "read-only one-call campaign-agent runbook"
2538
+ },
2539
+ {
2540
+ id: "commit_preview",
2541
+ tool: "gtm_campaign_build_plan_commit",
2542
+ arguments: {
2543
+ name: request.campaignName,
2544
+ campaign_brief: request.goal,
2545
+ lead_count: request.targetCount,
2546
+ dry_run: true,
2547
+ confirm: false
2548
+ },
2549
+ safety: "dry-run commit preview only"
2550
+ }
2551
+ ],
2552
+ sdk_example: {
2553
+ language: "typescript",
2554
+ code: campaignBuilderBuildKitSdkExample(request, requestFile)
2555
+ },
2556
+ verification: [
2557
+ `${cliBase} campaign-agent proof --request-file ${shellArg(requestFile)} --json`,
2558
+ `${cliBase} campaign-agent doctor --request-file ${shellArg(requestFile)} --json`,
2559
+ "Confirm proof.success is true and dry_run_result.status is dry_run before any approved launch.",
2560
+ "Confirm no campaign_build_id exists in a proof receipt before moving to approved launch."
2561
+ ],
2562
+ privacy: {
2563
+ client_names_allowed: false,
2564
+ notes: [
2565
+ "Use strategy templates, operating playbooks, and anonymized workflow patterns instead of client names.",
2566
+ "Do not include raw leads, private replies, domains, secrets, or customer account labels in public kit output."
2567
+ ]
2568
+ },
2569
+ next_actions: [
2570
+ `Write or review ${requestFile}.`,
2571
+ "Run the proof command before spending credits or activating provider writes.",
2572
+ "Add BYO integrations with --custom-tool provider:layer:tool[:mcp] or the request_fragment shape.",
2573
+ "Use build-approved only after human approval, spend limit, and delivery review policy are set."
2574
+ ]
2575
+ };
2576
+ }
2423
2577
  function createCampaignBuilderToolRoute(input) {
2424
2578
  return {
2425
2579
  provider: input.provider ?? "custom_mcp",
@@ -2435,6 +2589,63 @@ function createCampaignBuilderToolRoute(input) {
2435
2589
  rationale: `${input.label ?? input.provider ?? "Custom tool"} is a user-provided campaign-builder route for ${input.layer}.`
2436
2590
  };
2437
2591
  }
2592
+ function campaignBuilderBuildKitMcpArgs(request) {
2593
+ return compact({
2594
+ goal: request.goal,
2595
+ campaign_brief: request.goal,
2596
+ campaign_name: request.campaignName,
2597
+ account_label: request.accountLabel,
2598
+ account_context: request.accountContext,
2599
+ strategy_template: request.strategyTemplate,
2600
+ operating_playbooks: request.operatingPlaybooks,
2601
+ target_icp: request.icp,
2602
+ target_count: request.targetCount,
2603
+ builtins: request.builtIns,
2604
+ include_local_leads: request.builtIns?.includes("local_leads") || void 0,
2605
+ preferred_providers: request.preferredProviders,
2606
+ custom_tools: request.integrations?.map((route) => compact({
2607
+ provider: route.provider,
2608
+ layer: route.layer,
2609
+ gtm_layers: route.gtmLayers ?? (route.gtmLayer ? [route.gtmLayer] : void 0),
2610
+ tool: route.toolName,
2611
+ mcp: route.mcpServerName,
2612
+ mode: route.mode,
2613
+ approval_required: route.approvalRequired
2614
+ })),
2615
+ include_nango_catalog: request.agencyContext?.includeNangoCatalog,
2616
+ include_memory: request.memory?.enabled,
2617
+ include_brain: true,
2618
+ include_provider_routes: true,
2619
+ include_delivery_risk: true
2620
+ });
2621
+ }
2622
+ function campaignBuilderBuildKitSdkExample(request, requestFile) {
2623
+ const proofRequest = {
2624
+ goal: request.goal,
2625
+ strategyTemplate: request.strategyTemplate,
2626
+ targetCount: request.targetCount,
2627
+ builtIns: request.builtIns,
2628
+ integrations: request.integrations
2629
+ };
2630
+ return [
2631
+ "import { Signaliz, createCampaignBuilderBuildKit } from '@signaliz/sdk';",
2632
+ "",
2633
+ `const kit = createCampaignBuilderBuildKit({ requestFile: ${JSON.stringify(requestFile)}, ...${JSON.stringify(proofRequest, null, 2)} });`,
2634
+ "console.log(kit.cli_commands.find((command) => command.id === 'proof_shortcut')?.command);",
2635
+ "",
2636
+ "const signaliz = new Signaliz({ apiKey: process.env.SIGNALIZ_API_KEY! });",
2637
+ "const proof = await signaliz.campaignBuilderAgent.proof(kit.request, {",
2638
+ " idempotencyKey: `campaign-agent-proof-${Date.now()}`,",
2639
+ "});",
2640
+ "",
2641
+ 'if (!proof.success || proof.dry_run_result?.status !== "dry_run") {',
2642
+ " throw new Error('Campaign proof failed or launched work unexpectedly');",
2643
+ "}"
2644
+ ].join("\n");
2645
+ }
2646
+ function shellArg(value) {
2647
+ return `'${value.replace(/'/g, "'\\''")}'`;
2648
+ }
2438
2649
  function normalizeTemplateKey(value) {
2439
2650
  return String(value || "").trim().toLowerCase().replace(/[_\s]+/g, "-");
2440
2651
  }
@@ -6794,6 +7005,7 @@ var Signaliz = class {
6794
7005
  createCampaignBuilderAgentPlan,
6795
7006
  createCampaignBuilderAgentRequestTemplate,
6796
7007
  createCampaignBuilderApproval,
7008
+ createCampaignBuilderBuildKit,
6797
7009
  createCampaignBuilderProofReceipt,
6798
7010
  createCampaignBuilderReadiness,
6799
7011
  createCampaignBuilderToolRoute,
package/dist/index.mjs CHANGED
@@ -17,6 +17,7 @@ import {
17
17
  createCampaignBuilderAgentPlan,
18
18
  createCampaignBuilderAgentRequestTemplate,
19
19
  createCampaignBuilderApproval,
20
+ createCampaignBuilderBuildKit,
20
21
  createCampaignBuilderProofReceipt,
21
22
  createCampaignBuilderReadiness,
22
23
  createCampaignBuilderToolRoute,
@@ -25,7 +26,7 @@ import {
25
26
  getCampaignBuilderStrategyTemplate,
26
27
  getMissingCampaignBuilderApprovals,
27
28
  normalizeExecutionReference
28
- } from "./chunk-EVFQETTN.mjs";
29
+ } from "./chunk-6OZWMAV3.mjs";
29
30
  export {
30
31
  Ai,
31
32
  CAMPAIGN_BUILDER_OPERATING_PLAYBOOKS,
@@ -45,6 +46,7 @@ export {
45
46
  createCampaignBuilderAgentPlan,
46
47
  createCampaignBuilderAgentRequestTemplate,
47
48
  createCampaignBuilderApproval,
49
+ createCampaignBuilderBuildKit,
48
50
  createCampaignBuilderProofReceipt,
49
51
  createCampaignBuilderReadiness,
50
52
  createCampaignBuilderToolRoute,