@signaliz/sdk 1.0.15 → 1.0.17

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/index.d.ts CHANGED
@@ -87,7 +87,6 @@ interface EnrichSignalsV2Params {
87
87
  online?: boolean;
88
88
  targetSignalCount?: number;
89
89
  lookbackDays?: number;
90
- model?: string;
91
90
  enableDeepSearch?: boolean;
92
91
  enableOutreachIntelligence?: boolean;
93
92
  enablePredictiveIntelligence?: boolean;
@@ -232,8 +231,6 @@ interface CustomAiAttachment {
232
231
  }
233
232
  interface CustomAiFusionConfig {
234
233
  required?: boolean;
235
- analysis_models?: string[];
236
- judge_model?: string;
237
234
  include_raw_analysis?: boolean;
238
235
  }
239
236
  interface CustomAiMultiModelParams {
@@ -245,8 +242,6 @@ interface CustomAiMultiModelParams {
245
242
  inputs?: Record<string, unknown>[];
246
243
  /** Alias for inputs. */
247
244
  records?: Record<string, unknown>[];
248
- /** OpenRouter model id, e.g. anthropic/claude-sonnet-4. */
249
- model: string;
250
245
  systemPrompt?: string;
251
246
  system_prompt?: string;
252
247
  userTemplate?: string;
@@ -402,6 +397,7 @@ declare class HttpClient {
402
397
  private maxRetries;
403
398
  private apiKey?;
404
399
  private accessToken?;
400
+ private accessTokenPromise?;
405
401
  private clientId?;
406
402
  private clientSecret?;
407
403
  constructor(config: SignalizConfig);
@@ -481,6 +477,16 @@ declare class Http {
481
477
 
482
478
  /** Allowed delivery output modes. */
483
479
  type CampaignDeliveryMode = 'json' | 'csv' | 'webhook';
480
+ type CampaignAcquisitionMode = 'cache_first' | 'fresh_only' | 'hybrid';
481
+ type CampaignLearningHoldoutPrimaryMetric = 'reply_rate' | 'positive_reply_rate' | 'meeting_rate' | 'meetings_per_1000';
482
+ interface CampaignLearningHoldoutPolicy {
483
+ enabled?: boolean;
484
+ controlPercentage?: number;
485
+ minControlSize?: number;
486
+ experimentKey?: string;
487
+ sourceCampaignId?: string;
488
+ primaryMetric?: CampaignLearningHoldoutPrimaryMetric;
489
+ }
484
490
  interface CampaignBuildRequest$1 {
485
491
  name: string;
486
492
  prompt: string;
@@ -504,6 +510,14 @@ interface CampaignBuildRequest$1 {
504
510
  /** Explicitly acknowledge spendful campaign generation when the API asks for approval. */
505
511
  confirmSpend?: boolean;
506
512
  dedupKeys?: ('email' | 'linkedin_url' | 'company_domain')[];
513
+ acquisitionMode?: CampaignAcquisitionMode;
514
+ cacheReusePolicy?: {
515
+ allowVerifiedCache?: boolean;
516
+ suppressPriorCampaignIds?: string[];
517
+ suppressPriorListIds?: string[];
518
+ uniqueness?: 'email' | 'domain' | 'email_and_domain';
519
+ requireUsageMetadata?: boolean;
520
+ };
507
521
  policy?: {
508
522
  maxCredits?: number;
509
523
  verifyEmails?: boolean;
@@ -527,6 +541,16 @@ interface CampaignBuildRequest$1 {
527
541
  senderContext?: string;
528
542
  offerContext?: string;
529
543
  model?: string;
544
+ styleSource?: {
545
+ sampleText?: string;
546
+ campaignIds?: string[];
547
+ artifactIds?: string[];
548
+ };
549
+ sequenceSteps?: 1 | 2 | 3;
550
+ copySchema?: 'single_message' | 'three_step_email';
551
+ bannedPhrases?: string[];
552
+ approvalRequired?: boolean;
553
+ qualityTier?: 'quality';
530
554
  };
531
555
  delivery?: {
532
556
  enabled?: boolean;
@@ -555,6 +579,10 @@ interface CampaignBuildRequest$1 {
555
579
  brainPreflight?: Record<string, unknown>;
556
580
  /** Optional output from gtm_brain_seed_defaults. */
557
581
  brainDefaults?: Record<string, unknown>;
582
+ /** Explicit control-vs-learned policy for honest closed-loop lift measurement. */
583
+ learningHoldout?: CampaignLearningHoldoutPolicy;
584
+ /** Sanitized strategy context returned by gtm_campaign_build_plan. */
585
+ campaignStrategyContext?: Record<string, unknown>;
558
586
  /** Optional output from gtm_brain_delivery_risk. */
559
587
  deliveryRisk?: Record<string, unknown>;
560
588
  }
@@ -621,12 +649,16 @@ interface CampaignBuildResult$1 {
621
649
  dryRun?: boolean;
622
650
  requestedTargetCount?: number;
623
651
  plannedTargetCount?: number;
652
+ acquisitionMode?: CampaignAcquisitionMode;
653
+ acquisitionSource?: string;
654
+ cacheReusePolicy?: Record<string, unknown>;
624
655
  estimatedCredits?: number;
625
656
  estimatedDurationSeconds?: number;
626
657
  targetLimitApplied?: boolean;
627
658
  targetLimitReason?: string | null;
628
659
  maxSupportedTargetCount?: number;
629
660
  brainContext?: Record<string, unknown>;
661
+ learningHoldout?: Record<string, unknown>;
630
662
  providerRoute?: CampaignProviderRouteReadback$1 | null;
631
663
  }
632
664
  interface CampaignBuildStatus {
@@ -648,16 +680,45 @@ interface CampaignBuildStatus {
648
680
  warnings: string[];
649
681
  errors: string[];
650
682
  artifactCount: number;
683
+ artifactDownloads?: CampaignArtifactDownload[];
684
+ customerRowCounts?: CampaignCustomerRowCounts;
685
+ phaseAttemptTotals?: Record<string, unknown>;
651
686
  providerRoute?: CampaignProviderRouteReadback$1 | null;
652
687
  triggerRunId?: string | null;
653
688
  staleRunningPhase?: boolean;
654
689
  phaseAgeSeconds?: number | null;
655
690
  diagnostics?: Record<string, unknown>;
656
691
  nextAction: string;
692
+ approvalAction?: string;
657
693
  createdAt: string;
658
694
  updatedAt: string;
659
695
  completedAt: string | null;
660
696
  }
697
+ interface CampaignCustomerRowCounts {
698
+ requestedTarget?: number | null;
699
+ acquiredRows?: number;
700
+ acceptedRows?: number;
701
+ usableRows?: number;
702
+ copiedRows?: number;
703
+ approvalReadyRows?: number;
704
+ qaReadyRows?: number;
705
+ deliveredRows?: number;
706
+ disqualifiedRows?: number;
707
+ reviewableRows?: number;
708
+ rowFailures?: number;
709
+ acceptedShortfall?: number | null;
710
+ usableShortfall?: number | null;
711
+ qaReadyShortfall?: number | null;
712
+ deliveryShortfall?: number | null;
713
+ fillRatio?: number | null;
714
+ qaReadyFillRatio?: number | null;
715
+ deliveredFillRatio?: number | null;
716
+ terminalReason?: string | null;
717
+ acceptedShortfallReason?: string | null;
718
+ usableShortfallReason?: string | null;
719
+ qaReadyShortfallReason?: string | null;
720
+ deliveryShortfallReason?: string | null;
721
+ }
661
722
  interface CampaignBuildRow {
662
723
  /** Row index within the build */
663
724
  index: number;
@@ -676,12 +737,53 @@ interface CampaignArtifact {
676
737
  artifactType: string;
677
738
  destination: string;
678
739
  storagePath: string;
740
+ format?: string | null;
679
741
  signedUrl: string | null;
742
+ downloadUrl?: string | null;
743
+ manifestUrl?: string | null;
744
+ expiresAt?: string | null;
680
745
  rowCount: number;
681
746
  checksum: string | null;
682
747
  metadata: Record<string, unknown>;
683
748
  createdAt: string;
684
749
  }
750
+ interface CampaignArtifactDownload {
751
+ id: string;
752
+ artifactType: string | null;
753
+ format: string | null;
754
+ rowCount: number;
755
+ signedUrl: string | null;
756
+ downloadUrl: string | null;
757
+ manifestUrl: string | null;
758
+ expiresAt: string | null;
759
+ }
760
+ interface CampaignArtifactDownloadPart {
761
+ partIndex: number;
762
+ rowCount: number;
763
+ byteSize: number | null;
764
+ checksum: string | null;
765
+ signedUrl: string | null;
766
+ }
767
+ interface CampaignArtifactDownloadResult {
768
+ campaignBuildId: string;
769
+ artifactId: string;
770
+ format: string;
771
+ rowCount: number;
772
+ byteSize: number | null;
773
+ partCount: number;
774
+ checksum: string | null;
775
+ signedUrl: string | null;
776
+ downloadUrl: string | null;
777
+ manifestUrl: string | null;
778
+ expiresAt: string | null;
779
+ parts: CampaignArtifactDownloadPart[];
780
+ downloadCommands: Record<string, unknown>;
781
+ expiresInSeconds: number | null;
782
+ }
783
+ interface CampaignArtifactDownloadOptions {
784
+ /** Artifact format to sign for download (default: csv) */
785
+ format?: 'csv' | 'ndjson' | string;
786
+ }
685
787
  interface CampaignRowsOptions {
686
788
  /** Max rows per page (default: 50) */
687
789
  limit?: number;
@@ -693,6 +795,14 @@ interface CampaignRowsOptions {
693
795
  qualified?: boolean;
694
796
  /** Filter by row processing status */
695
797
  rowStatus?: string;
798
+ /** Filter cache-reused rows */
799
+ cached?: boolean;
800
+ /** Filter rows that passed QA and approval gates for export */
801
+ exportReady?: boolean;
802
+ /** Include rich row data such as generated copy fields */
803
+ includeData?: boolean;
804
+ /** Include raw provider/qualification payloads when the API exposes them */
805
+ includeRaw?: boolean;
696
806
  }
697
807
  interface CampaignRowsResult {
698
808
  campaignBuildId: string;
@@ -710,6 +820,9 @@ interface ApproveDeliveryResult {
710
820
  deliveryId?: string;
711
821
  deliveryIds?: string[];
712
822
  approvedCount?: number;
823
+ partialDelivery?: boolean;
824
+ effectiveTargetCount?: number | null;
825
+ requestedTargetCount?: number | null;
713
826
  }
714
827
  interface CancelBuildResult {
715
828
  campaignBuildId: string;
@@ -752,6 +865,8 @@ declare class Campaigns {
752
865
  rows(campaignBuildId: string, options?: CampaignRowsOptions): Promise<CampaignRowsResult>;
753
866
  /** List all artifacts (CSV exports, etc.) for a build. */
754
867
  artifacts(campaignBuildId: string): Promise<CampaignArtifact[]>;
868
+ /** Generate fresh signed URLs for a downloadable campaign artifact. */
869
+ downloadArtifact(campaignBuildId: string, options?: CampaignArtifactDownloadOptions): Promise<CampaignArtifactDownloadResult>;
755
870
  /** Cancel a queued or running build. */
756
871
  cancel(campaignBuildId: string, reason?: string): Promise<CancelBuildResult>;
757
872
  /**
@@ -768,10 +883,12 @@ declare class Campaigns {
768
883
  buildCampaign(request: CampaignBuildRequest$1, options?: BuildOptions): Promise<CampaignBuildResult$1>;
769
884
  getCampaignBuildStatus(campaignBuildId: string): Promise<CampaignBuildStatus>;
770
885
  listCampaignBuildArtifacts(campaignBuildId: string): Promise<CampaignArtifact[]>;
886
+ downloadCampaignArtifact(campaignBuildId: string, options?: CampaignArtifactDownloadOptions): Promise<CampaignArtifactDownloadResult>;
771
887
  getCampaignBuildRows(campaignBuildId: string, options?: CampaignRowsOptions): Promise<CampaignRowsResult>;
772
888
  approveCampaignDelivery(campaignBuildId: string, destinationType: CampaignDeliveryMode, options?: {
773
889
  destinationId?: string;
774
890
  destinationConfig?: Record<string, unknown>;
891
+ allowPartialDelivery?: boolean;
775
892
  }): Promise<ApproveDeliveryResult>;
776
893
  cancelCampaignBuild(campaignBuildId: string, reason?: string): Promise<CancelBuildResult>;
777
894
  waitForCompletion(campaignBuildId: string, options?: {
@@ -787,8 +904,17 @@ type CampaignBuildRequest = CampaignBuildRequest$1 & {
787
904
  gtmCampaignId?: string;
788
905
  brainPreflight?: UnknownRecord$1;
789
906
  brainDefaults?: UnknownRecord$1;
907
+ campaignStrategyContext?: UnknownRecord$1;
790
908
  deliveryRisk?: UnknownRecord$1;
909
+ sourceRouting?: CampaignBuilderSourceRouting;
791
910
  };
911
+ interface CampaignBuilderSourceRouting {
912
+ mode?: 'auto' | 'local_leads' | 'company_first' | 'people_first' | 'verified_leads';
913
+ fillPolicy?: 'aggressive';
914
+ shardSize?: number;
915
+ maxSourceShardSize?: number;
916
+ maxLocalSourceShardSize?: number;
917
+ }
792
918
  type CampaignBuildResult = CampaignBuildResult$1 & {
793
919
  campaignId?: string | null;
794
920
  campaignObject?: UnknownRecord$1 | null;
@@ -807,7 +933,7 @@ type CampaignBuilderLayer = 'workspace_context' | 'memory' | 'source' | 'enrichm
807
933
  type CampaignBuilderGtmLayer = 'icp' | 'find_company' | 'find_people' | 'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'company_enrichment' | 'copy_enrichment' | 'qualification' | 'sender' | 'feedback' | 'approval' | 'source_import' | 'destination_export' | 'customer_data' | 'custom';
808
934
  type CampaignBuilderProvider = 'signaliz' | 'octave' | 'apollo' | 'ai_ark' | 'clay_webhook' | 'airbyte' | 'nango' | 'instantly' | 'smartlead' | 'heyreach' | 'custom_mcp' | 'custom_api' | 'custom_webhook' | 'webhook' | 'csv' | (string & {});
809
935
  type CampaignBuilderAgentProvider = CampaignBuilderProvider;
810
- type CampaignBuilderBuiltInTool = 'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'signals';
936
+ type CampaignBuilderBuiltInTool = 'lead_generation' | 'local_leads' | 'company_discovery' | 'people_discovery' | 'email_finding' | 'email_verification' | 'signals';
811
937
  type CampaignBuilderStrategyTemplateSlug = 'industrial-ot-resilience' | 'non-medical-home-care' | 'agency-founder-led' | 'cloud-infrastructure-displacement';
812
938
  type CampaignBuilderOperatingPlaybookSlug = 'cache-first-large-list' | 'net-new-suppressed-list' | 'proof-first-vertical-gate' | 'signal-led-copy-approval' | 'domain-first-recovery' | 'table-workflow-handoff';
813
939
  type CampaignBuilderRouteMode = 'required' | 'if_available' | 'fallback' | 'disabled';
@@ -956,7 +1082,8 @@ interface CampaignBuilderAgentRequest {
956
1082
  integrations?: CampaignBuilderIntegrationRoute[];
957
1083
  customerTools?: CampaignBuilderCustomerTool[];
958
1084
  preferredProviders?: CampaignBuilderProvider[];
959
- /** Signaliz-native lanes to include in the campaign plan. Defaults to lead generation, email finding, verification, and signals. */
1085
+ sourceRouting?: CampaignBuilderSourceRouting;
1086
+ /** Signaliz-native lanes to include in the campaign plan. Defaults to source discovery, lead generation, email finding, verification, and signals. */
960
1087
  builtIns?: CampaignBuilderBuiltInTool[];
961
1088
  agencyContext?: {
962
1089
  /** Public strategy model. Defaults to strategy_template. */
@@ -1085,6 +1212,7 @@ type CampaignBuilderApprovedRunOptions = CampaignBuilderBuildOptions & {
1085
1212
  deliveryDestinationType?: CampaignDeliveryMode;
1086
1213
  deliveryDestinationId?: string;
1087
1214
  deliveryDestinationConfig?: UnknownRecord$1;
1215
+ allowPartialDelivery?: boolean;
1088
1216
  waitIntervalMs?: number;
1089
1217
  waitTimeoutMs?: number;
1090
1218
  onStatus?: (status: CampaignBuildStatus) => void;
@@ -1120,6 +1248,7 @@ interface CampaignBuilderProofReceipt {
1120
1248
  }>;
1121
1249
  strategy_memory_status: UnknownRecord$1;
1122
1250
  dry_run_result: UnknownRecord$1;
1251
+ learn_back_plan: UnknownRecord$1;
1123
1252
  recommended_next_actions: string[];
1124
1253
  }
1125
1254
  interface CampaignBuilderBuildKitOptions extends CampaignBuilderAgentRequestTemplateOptions {
@@ -1127,6 +1256,15 @@ interface CampaignBuilderBuildKitOptions extends CampaignBuilderAgentRequestTemp
1127
1256
  cliPackage?: string;
1128
1257
  sdkPackage?: string;
1129
1258
  }
1259
+ type CampaignBuilderMemoryKitSource = 'agency' | 'north-star' | 'workflow-patterns' | 'instantly-feedback' | 'all' | (string & {});
1260
+ interface CampaignBuilderMemoryKitOptions extends CampaignBuilderAgentRequestTemplateOptions {
1261
+ requestFile?: string;
1262
+ seedManifestFile?: string;
1263
+ source?: CampaignBuilderMemoryKitSource;
1264
+ workspaceId?: string;
1265
+ cliPackage?: string;
1266
+ sdkPackage?: string;
1267
+ }
1130
1268
  interface CampaignBuilderBuildKitCommand {
1131
1269
  id: string;
1132
1270
  label: string;
@@ -1173,6 +1311,44 @@ interface CampaignBuilderBuildKit {
1173
1311
  };
1174
1312
  next_actions: string[];
1175
1313
  }
1314
+ interface CampaignBuilderMemoryKit {
1315
+ kit_version: 'campaign-memory-kit.v1';
1316
+ source: string;
1317
+ read_only: boolean;
1318
+ no_spend: boolean;
1319
+ no_provider_writes: boolean;
1320
+ client_names_allowed: boolean;
1321
+ request_file: string;
1322
+ seed_manifest_file: string;
1323
+ request: CampaignBuilderAgentRequest;
1324
+ strategy_template: string | null;
1325
+ operating_playbooks: string[];
1326
+ memory_sources: Array<{
1327
+ id: string;
1328
+ label: string;
1329
+ seed_source: string;
1330
+ scope: string;
1331
+ privacy: string;
1332
+ }>;
1333
+ seed_runner: {
1334
+ local_script: string;
1335
+ dry_run_command: string;
1336
+ verify_manifest_command: string | null;
1337
+ write_command: string;
1338
+ write_requires: string[];
1339
+ };
1340
+ cli_commands: CampaignBuilderBuildKitCommand[];
1341
+ mcp_calls: CampaignBuilderBuildKitMcpCall[];
1342
+ sdk_example: {
1343
+ language: 'typescript';
1344
+ code: string;
1345
+ };
1346
+ privacy: {
1347
+ client_names_allowed: boolean;
1348
+ notes: string[];
1349
+ };
1350
+ next_actions: string[];
1351
+ }
1176
1352
  interface CampaignBuilderBuildReviewOptions extends CampaignRowsOptions {
1177
1353
  /** Number of rows to sample for review. Defaults to 100. */
1178
1354
  limit?: number;
@@ -1259,6 +1435,7 @@ declare class CampaignBuilderAgent {
1259
1435
  readiness(request: CampaignBuilderAgentRequest, options?: CampaignBuilderPlanOptions): Promise<CampaignBuilderReadinessPacket>;
1260
1436
  proof(request: CampaignBuilderAgentRequest, options?: CampaignBuilderProofOptions): Promise<CampaignBuilderProofReceipt>;
1261
1437
  buildKit(options?: CampaignBuilderBuildKitOptions): CampaignBuilderBuildKit;
1438
+ memoryKit(options?: CampaignBuilderMemoryKitOptions): CampaignBuilderMemoryKit;
1262
1439
  commitPlan(plan: CampaignBuilderAgentPlan, options?: CampaignBuilderPlanCommitOptions): Promise<CampaignBuilderPlanCommitResult>;
1263
1440
  dryRunPlan(plan: CampaignBuilderAgentPlan, options?: BuildOptions): Promise<CampaignBuildResult>;
1264
1441
  buildApprovedPlan(plan: CampaignBuilderAgentPlan, approval: CampaignBuilderApproval, options?: CampaignBuilderBuildOptions): Promise<CampaignBuildResult>;
@@ -1269,6 +1446,7 @@ declare class CampaignBuilderAgent {
1269
1446
  approveDelivery(campaignBuildId: string, destinationType: CampaignDeliveryMode, options?: {
1270
1447
  destinationId?: string;
1271
1448
  destinationConfig?: UnknownRecord$1;
1449
+ allowPartialDelivery?: boolean;
1272
1450
  }): Promise<ApproveDeliveryResult>;
1273
1451
  reviewBuild(campaignBuildId: string, options?: CampaignBuilderBuildReviewOptions): Promise<CampaignBuilderBuildReview>;
1274
1452
  private getCampaignBuildStatus;
@@ -1298,6 +1476,7 @@ declare function getCampaignBuilderOperatingPlaybooksForRequest(request: Campaig
1298
1476
  declare function applyCampaignBuilderStrategyTemplate(request: CampaignBuilderAgentRequest): CampaignBuilderAgentRequest;
1299
1477
  declare function createCampaignBuilderAgentRequestTemplate(input?: CampaignBuilderAgentRequestTemplateOptions): CampaignBuilderAgentRequest;
1300
1478
  declare function createCampaignBuilderBuildKit(input?: CampaignBuilderBuildKitOptions): CampaignBuilderBuildKit;
1479
+ declare function createCampaignBuilderMemoryKit(input?: CampaignBuilderMemoryKitOptions): CampaignBuilderMemoryKit;
1301
1480
  declare function createCampaignBuilderToolRoute(input: {
1302
1481
  provider?: CampaignBuilderProvider;
1303
1482
  layer: CampaignBuilderLayer;
@@ -1406,2113 +1585,2610 @@ declare class Leads {
1406
1585
  checkStatus(jobId: string): Promise<Record<string, unknown>>;
1407
1586
  }
1408
1587
 
1409
- type ExecutionReferenceKind = 'op' | 'routine' | 'routine_tick' | 'trigger_run' | 'dataplane_run' | 'queue_job' | 'execution_event' | 'replay_run' | 'unknown';
1410
- interface ExecutionReference {
1411
- kind: ExecutionReferenceKind;
1412
- id: string;
1413
- original: string;
1414
- label: string;
1415
- query_field: string;
1416
- status_command?: string;
1417
- replay_command?: string;
1588
+ type UnknownRecord = Record<string, unknown>;
1589
+ type GtmCampaignStatus = 'draft' | 'building' | 'ready' | 'active' | 'paused' | 'completed' | 'archived' | 'failed';
1590
+ type GtmCampaignSource = 'mcp' | 'campaign_builder' | 'routine' | 'manual' | 'import' | 'api' | 'webhook';
1591
+ type GtmActorType = 'human' | 'agent' | 'system' | 'provider';
1592
+ type GtmPatternType = 'angle' | 'subject_line' | 'opener' | 'sequence_structure' | 'icp' | 'lead_source' | 'provider_chain' | 'verification' | 'failure' | 'default' | 'calibration' | 'other';
1593
+ type GtmMemoryType = 'subject_line' | 'opener' | 'sequence_step' | 'icp' | 'lead_source' | 'provider_chain' | 'verification' | 'reply' | 'objection' | 'meeting' | 'failure' | 'campaign_summary' | 'agent_note' | 'other';
1594
+ type GtmLayer = 'icp' | 'find_company' | 'find_people' | 'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'company_enrichment' | 'copy_enrichment' | 'qualification' | 'sender' | 'feedback' | 'approval' | 'source_import' | 'destination_export' | 'customer_data' | 'custom';
1595
+ type GtmInvocationType = 'signaliz_native' | 'webhook' | 'mcp_tool' | 'airbyte' | 'api' | 'managed_integration' | 'manual';
1596
+ type GtmAuthStrategy = 'none' | 'integration_key' | 'mcp_auth' | 'webhook_secret' | 'session_vault' | 'byo_runtime';
1597
+ interface GtmWorkspaceContextOptions {
1598
+ includeCampaigns?: boolean;
1599
+ includeMemory?: boolean;
1600
+ includeBrain?: boolean;
1601
+ includeConnections?: boolean;
1602
+ limit?: number;
1418
1603
  }
1419
- interface ExecutionReferenceInput {
1420
- id: string;
1421
- kind?: ExecutionReferenceKind;
1422
- source_field?: string;
1604
+ interface GtmWorkspaceBootstrapStatusOptions {
1605
+ campaignId?: string;
1606
+ days?: number;
1607
+ minSampleSize?: number;
1608
+ includeConnections?: boolean;
1609
+ includeSamples?: boolean;
1610
+ limit?: number;
1423
1611
  }
1424
- declare function normalizeExecutionReference(input: string | ExecutionReferenceInput): ExecutionReference;
1425
- declare function collectExecutionReferences(payload: Record<string, unknown>): ExecutionReference[];
1426
-
1427
- type OpsCadence = 'hourly' | 'daily' | 'weekly' | 'manual';
1428
- type OpsRoutineStatus = 'draft' | 'active' | 'paused' | 'archived' | 'failed';
1429
- type OpsSinkType = 'csv' | 'webhook' | 'airbyte' | 'nango' | 'slack' | 'google_sheets' | 'notion' | 'instantly' | 'routine';
1430
- type OpsBlueprint = 'monitor_companies' | 'build_leads' | 'enrich_list' | 'route_signals' | 'launch_campaign';
1431
- type SimpleOpStatus = 'draft' | 'ready' | 'running' | 'blocked' | 'needs_approval' | 'completed' | 'failed';
1432
- type OpsPrimitivePermissionLevel = 'read' | 'write' | 'spend' | 'admin';
1433
- type OpsPrimitiveWorkspaceScope = 'required';
1434
- interface OpsPrimitiveRetryPolicy {
1435
- max_retries: number;
1436
- maxRetries?: number;
1437
- initial_delay_ms: number;
1438
- initialDelayMs?: number;
1439
- max_delay_ms: number;
1440
- maxDelayMs?: number;
1441
- backoff_multiplier: number;
1442
- backoffMultiplier?: number;
1443
- jitter: boolean;
1444
- retryable_errors: string[];
1445
- retryableErrors?: string[];
1446
- respect_retry_after: boolean;
1447
- respectRetryAfter?: boolean;
1612
+ interface GtmExistingCampaignDiscoverOptions {
1613
+ provider?: string;
1614
+ integrationId?: string;
1615
+ search?: string;
1616
+ limit?: number;
1617
+ includeKernelLinked?: boolean;
1618
+ includeProviderLive?: boolean;
1448
1619
  }
1449
- interface OpsPrimitiveConcurrencyPolicy {
1450
- workspace_key: string;
1451
- workspaceKey?: string;
1452
- provider_key?: string;
1453
- providerKey?: string;
1454
- max_concurrency: number;
1455
- maxConcurrency?: number;
1620
+ interface GtmExistingCampaignAuditOptions {
1621
+ campaignId?: string;
1622
+ provider?: string;
1623
+ providerCampaignId?: string;
1624
+ campaignName?: string;
1625
+ days?: number;
1626
+ includeRoutePreview?: boolean;
1627
+ includeMemory?: boolean;
1628
+ includeBrain?: boolean;
1456
1629
  }
1457
- interface OpsPrimitiveDeadLetterPolicy {
1458
- enabled: boolean;
1459
- queue: string;
1460
- include_input_hash: boolean;
1461
- includeInputHash?: boolean;
1462
- include_execution_refs: boolean;
1463
- includeExecutionRefs?: boolean;
1630
+ interface GtmExistingCampaignAuditBySearchOptions extends Omit<GtmExistingCampaignAuditOptions, 'campaignId' | 'providerCampaignId' | 'campaignName'> {
1631
+ search: string;
1632
+ integrationId?: string;
1633
+ includeKernelLinked?: boolean;
1634
+ includeProviderLive?: boolean;
1464
1635
  }
1465
- interface OpsPrimitiveObservabilityPolicy {
1466
- emits_execution_refs: boolean;
1467
- emitsExecutionRefs?: boolean;
1468
- emits_progress_events: boolean;
1469
- emitsProgressEvents?: boolean;
1470
- event_fields: string[];
1471
- eventFields?: string[];
1636
+ type GtmExistingCampaignAuditBoundary = 'read_only' | 'dry_run' | 'write_import' | 'route_write' | 'sender_load' | 'export' | 'delivery' | 'approval_decision' | string;
1637
+ interface GtmExistingCampaignMcpRequest {
1638
+ tool: string;
1639
+ arguments: UnknownRecord;
1472
1640
  }
1473
- interface OpsPrimitive {
1474
- id: string;
1475
- version: string;
1476
- capability: string;
1477
- permission_level: OpsPrimitivePermissionLevel;
1478
- permissionLevel?: OpsPrimitivePermissionLevel;
1479
- workspace_scope: OpsPrimitiveWorkspaceScope;
1480
- workspaceScope?: OpsPrimitiveWorkspaceScope;
1481
- input_schema: Record<string, unknown>;
1482
- inputSchema?: Record<string, unknown>;
1483
- output_schema: Record<string, unknown>;
1484
- outputSchema?: Record<string, unknown>;
1485
- retry_policy: OpsPrimitiveRetryPolicy;
1486
- retryPolicy?: OpsPrimitiveRetryPolicy;
1487
- concurrency_policy: OpsPrimitiveConcurrencyPolicy;
1488
- concurrencyPolicy?: OpsPrimitiveConcurrencyPolicy;
1489
- rate_limit_key?: string;
1490
- rateLimitKey?: string;
1491
- idempotency_key_fields: string[];
1492
- idempotencyKeyFields?: string[];
1493
- dead_letter_policy: OpsPrimitiveDeadLetterPolicy;
1494
- deadLetterPolicy?: OpsPrimitiveDeadLetterPolicy;
1495
- observability: OpsPrimitiveObservabilityPolicy;
1641
+ interface GtmExistingCampaignOption {
1642
+ source?: 'kernel_linked' | 'provider_live' | string;
1643
+ provider?: string;
1644
+ provider_link_id?: string | null;
1645
+ provider_campaign_id?: string | null;
1646
+ name?: string | null;
1647
+ status?: string | number | null;
1648
+ integration_id?: string | null;
1649
+ integration_label?: string | null;
1650
+ linked_kernel_campaign_id?: string | null;
1651
+ linked_kernel_campaign_name?: string | null;
1652
+ linked_kernel_campaign_status?: string | null;
1653
+ audit_request?: GtmExistingCampaignMcpRequest;
1654
+ [key: string]: unknown;
1496
1655
  }
1497
- interface OpsSink {
1656
+ interface GtmExistingCampaignDiscoveryResult {
1657
+ provider?: string;
1658
+ campaigns?: GtmExistingCampaignOption[];
1659
+ counts?: {
1660
+ total_returned?: number;
1661
+ kernel_linked?: number;
1662
+ provider_live?: number;
1663
+ [key: string]: unknown;
1664
+ };
1665
+ integration_summaries?: UnknownRecord[];
1666
+ blockers?: string[];
1667
+ warnings?: string[];
1668
+ next_safe_action?: GtmExistingCampaignMcpRequest | UnknownRecord;
1669
+ }
1670
+ interface GtmExistingCampaignCompletenessStep {
1671
+ id: 'provider_history' | 'feedback_events' | 'kernel_memory' | 'brain_evidence' | 'provider_routes' | string;
1672
+ label: string;
1673
+ ready: boolean;
1674
+ count: number;
1675
+ approval_boundary: GtmExistingCampaignAuditBoundary;
1676
+ detail?: string;
1677
+ next_safe_request?: GtmExistingCampaignMcpRequest;
1678
+ post_action_verification?: GtmExistingCampaignMcpRequest;
1679
+ }
1680
+ interface GtmExistingCampaignAuditRecommendation {
1498
1681
  id?: string;
1499
- sinkId?: string;
1500
- sink_id?: string;
1501
- connectionId?: string;
1502
- connection_id?: string;
1503
- type: OpsSinkType;
1504
- name?: string;
1505
- connectorId?: string;
1506
- connector_id?: string;
1507
- connectorName?: string;
1508
- connector_name?: string;
1509
1682
  category?: string;
1510
- status?: string;
1511
- syncStatus?: string | null;
1512
- sync_status?: string | null;
1513
- lastSyncedAt?: string | null;
1514
- last_synced_at?: string | null;
1515
- config?: Record<string, unknown>;
1516
- deliveryMode?: string;
1517
- delivery_mode?: string;
1518
- providerConfigKey?: string;
1519
- provider_config_key?: string;
1520
- integrationId?: string;
1521
- integration_id?: string;
1522
- nangoConnectionId?: string;
1523
- nango_connection_id?: string;
1524
- actionName?: string;
1525
- action_name?: string;
1526
- nangoAction?: string;
1527
- nango_action?: string;
1528
- proxyPath?: string;
1529
- proxy_path?: string;
1530
- nangoProxyPath?: string;
1531
- nango_proxy_path?: string;
1532
- method?: string;
1533
- fieldMap?: Record<string, unknown>;
1534
- field_map?: Record<string, unknown>;
1535
- requiredFields?: string[];
1536
- required_fields?: string[];
1537
- writeConfirmed?: boolean;
1538
- write_confirmed?: boolean;
1539
- agentWriteConfirmed?: boolean;
1540
- agent_write_confirmed?: boolean;
1541
- enabled?: boolean;
1683
+ title?: string;
1684
+ summary?: string;
1685
+ confidence?: string;
1686
+ approval_boundary?: GtmExistingCampaignAuditBoundary;
1687
+ evidence?: string[];
1688
+ suggested_tool?: string;
1689
+ suggested_action?: string;
1690
+ next_safe_request?: GtmExistingCampaignMcpRequest;
1691
+ post_action_verification?: GtmExistingCampaignMcpRequest;
1542
1692
  }
1543
- interface OpsRoutine {
1544
- id?: string;
1545
- routine_id?: string;
1546
- routineId?: string;
1547
- name?: string;
1548
- goal?: string;
1549
- cadence?: OpsCadence | string;
1550
- status?: OpsRoutineStatus | string;
1551
- lastTickAt?: string | null;
1552
- last_tick_at?: string | null;
1553
- nextTickAt?: string | null;
1554
- next_tick_at?: string | null;
1555
- outputSinks?: OpsSink[];
1556
- output_sinks?: OpsSink[];
1557
- execution_refs?: ExecutionReference[];
1558
- [key: string]: unknown;
1693
+ interface GtmExistingCampaignAuditResult {
1694
+ workspace_id?: string;
1695
+ provider?: string;
1696
+ provider_campaign_id?: string | null;
1697
+ campaign?: UnknownRecord | null;
1698
+ audit_score?: number;
1699
+ evidence_counts?: UnknownRecord;
1700
+ completeness?: GtmExistingCampaignCompletenessStep[];
1701
+ aggregate_metrics?: UnknownRecord;
1702
+ provider_links?: UnknownRecord[];
1703
+ memory_samples?: UnknownRecord[];
1704
+ brain_samples?: UnknownRecord;
1705
+ route_summary?: UnknownRecord;
1706
+ blockers?: string[];
1707
+ warnings?: string[];
1708
+ recommendations?: GtmExistingCampaignAuditRecommendation[];
1709
+ next_safe_actions?: GtmExistingCampaignMcpRequest[];
1710
+ execution_policy?: string;
1711
+ privacy_policy?: string;
1559
1712
  }
1560
- interface OpsRoutinesResult {
1561
- routines: OpsRoutine[];
1562
- total?: number;
1563
- next_cursor?: string | null;
1564
- nextCursor?: string | null;
1565
- has_more?: boolean;
1566
- hasMore?: boolean;
1713
+ interface GtmProviderLinkInput {
1714
+ provider: string;
1715
+ providerCampaignId: string;
1716
+ integrationId?: string;
1717
+ providerWorkspaceId?: string;
1718
+ providerAccountId?: string;
1719
+ status?: string;
1720
+ metadata?: UnknownRecord;
1567
1721
  }
1568
- interface OpsRoutineTick {
1569
- id?: string;
1570
- tick_id?: string;
1571
- tickId?: string;
1572
- routine_id?: string;
1722
+ interface GtmCampaignCreateInput {
1723
+ name: string;
1724
+ description?: string;
1725
+ source?: GtmCampaignSource;
1726
+ status?: GtmCampaignStatus;
1727
+ campaignBuildId?: string;
1728
+ campaignBuilderJobId?: string;
1573
1729
  routineId?: string;
1574
- status?: string;
1575
- state?: string;
1576
- started_at?: string | null;
1577
- startedAt?: string | null;
1578
- completed_at?: string | null;
1579
- completedAt?: string | null;
1580
- error_message?: string | null;
1581
- errorMessage?: string | null;
1582
- execution_refs?: ExecutionReference[];
1583
- [key: string]: unknown;
1730
+ targetIcp?: UnknownRecord;
1731
+ sequences?: UnknownRecord[];
1732
+ leadListRefs?: UnknownRecord[];
1733
+ sendConfig?: UnknownRecord;
1734
+ providerLinks?: GtmProviderLinkInput[];
1735
+ brainConfig?: UnknownRecord;
1736
+ metadata?: UnknownRecord;
1737
+ log?: GtmCampaignLogInput;
1584
1738
  }
1585
- interface OpsRoutineTicksResult {
1586
- ticks: OpsRoutineTick[];
1587
- items?: OpsRoutineTick[];
1588
- next_cursor?: string | null;
1589
- nextCursor?: string | null;
1590
- has_more?: boolean;
1591
- hasMore?: boolean;
1592
- [key: string]: unknown;
1739
+ interface GtmCampaignHistoryMemoryInput {
1740
+ idempotencyKey?: string;
1741
+ memoryType?: GtmMemoryType;
1742
+ title: string;
1743
+ content: string;
1744
+ keywords?: string[];
1745
+ dimensions?: UnknownRecord;
1746
+ outcomeType?: string;
1747
+ outcomeValue?: number;
1748
+ sampleSize?: number;
1749
+ confidence?: number;
1750
+ shareable?: boolean;
1751
+ redactionState?: 'raw' | 'redacted' | 'abstracted';
1752
+ metadata?: UnknownRecord;
1753
+ recencyAt?: string;
1593
1754
  }
1594
- interface OpsRoutineTickItem {
1595
- id?: string;
1596
- item_id?: string;
1597
- itemId?: string;
1598
- tick_id?: string;
1599
- tickId?: string;
1600
- routine_id?: string;
1755
+ interface GtmCampaignHistoryCampaignInput {
1756
+ campaignId?: string;
1757
+ idempotencyKey?: string;
1758
+ name?: string;
1759
+ description?: string;
1760
+ source?: GtmCampaignSource;
1761
+ status?: GtmCampaignStatus;
1762
+ campaignBuildId?: string;
1763
+ campaignBuilderJobId?: string;
1601
1764
  routineId?: string;
1602
- state?: string;
1603
- status?: string;
1604
- error_message?: string | null;
1605
- errorMessage?: string | null;
1606
- payload?: Record<string, unknown>;
1607
- row?: Record<string, unknown>;
1608
- execution_refs?: ExecutionReference[];
1609
- [key: string]: unknown;
1765
+ targetIcp?: UnknownRecord;
1766
+ sequences?: UnknownRecord[];
1767
+ leadListRefs?: UnknownRecord[];
1768
+ sendConfig?: UnknownRecord;
1769
+ performanceMetrics?: UnknownRecord;
1770
+ brainConfig?: UnknownRecord;
1771
+ memorySummary?: UnknownRecord;
1772
+ metadata?: UnknownRecord;
1773
+ providerLinks?: GtmProviderLinkInput[];
1774
+ feedbackEvents?: UnknownRecord[];
1775
+ memoryItems?: GtmCampaignHistoryMemoryInput[];
1776
+ startedAt?: string;
1777
+ completedAt?: string;
1778
+ summary?: string;
1779
+ memorySummaryText?: string;
1610
1780
  }
1611
- interface OpsRoutineTickItemsResult {
1612
- items: OpsRoutineTickItem[];
1613
- rows?: OpsRoutineTickItem[];
1614
- next_cursor?: string | null;
1615
- nextCursor?: string | null;
1616
- has_more?: boolean;
1617
- hasMore?: boolean;
1618
- [key: string]: unknown;
1781
+ interface GtmCampaignHistoryImportInput {
1782
+ source?: GtmCampaignSource;
1783
+ dryRun?: boolean;
1784
+ createMemory?: boolean;
1785
+ campaigns: GtmCampaignHistoryCampaignInput[];
1619
1786
  }
1620
- interface OpsReadinessOptions {
1621
- windowHours?: number;
1622
- includeDetails?: boolean;
1623
- runAcquisitionProbe?: boolean;
1787
+ interface GtmCampaignHistoryImportBatchInput {
1788
+ batchId?: string;
1789
+ campaigns: GtmCampaignHistoryCampaignInput[];
1624
1790
  }
1625
- interface OpsReadinessCheck {
1626
- id: string;
1627
- label: string;
1628
- status: 'pass' | 'warn' | 'fail';
1629
- detail: string;
1630
- next_action?: string;
1631
- nextAction?: string;
1791
+ interface GtmCampaignHistoryImportRunInput {
1792
+ source?: GtmCampaignSource;
1793
+ dryRun?: boolean;
1794
+ createMemory?: boolean;
1795
+ campaigns?: GtmCampaignHistoryCampaignInput[];
1796
+ batches?: GtmCampaignHistoryImportBatchInput[];
1797
+ batchSize?: number;
1798
+ continueOnError?: boolean;
1799
+ runBrainCycle?: boolean;
1800
+ brainCycleWriteMode?: 'dry_run' | 'write';
1801
+ brainCyclePhases?: GtmBrainLearningCyclePhase[];
1802
+ brainCycleDays?: number;
1803
+ brainCycleNetworkDays?: number;
1804
+ brainCycleMinSampleSize?: number;
1805
+ brainCycleLimit?: number;
1632
1806
  }
1633
- interface OpsReadinessResult {
1634
- status: 'ready' | 'degraded' | 'blocked';
1635
- checked_at?: string;
1636
- checkedAt: string;
1637
- credits_used?: 0;
1638
- creditsUsed: 0;
1639
- credits_charged?: 0;
1640
- creditsCharged: 0;
1641
- summary: {
1642
- active_connections?: number;
1643
- activeConnections: number;
1644
- failing_connections?: number;
1645
- failingConnections: number;
1646
- active_routines?: number;
1647
- activeRoutines: number;
1648
- recent_failed_ticks?: number;
1649
- recentFailedTicks: number;
1650
- queued_deliveries?: number;
1651
- queuedDeliveries: number;
1652
- pending_approvals?: number;
1653
- pendingApprovals: number;
1654
- lead_records?: number;
1655
- leadRecords: number;
1656
- recent_acquisition_failures?: number;
1657
- recentAcquisitionFailures: number;
1658
- acquisition_probe_status?: string;
1659
- acquisitionProbeStatus?: string;
1660
- };
1661
- checks: OpsReadinessCheck[];
1662
- next_actions?: string[];
1663
- nextActions: string[];
1664
- raw?: Record<string, unknown>;
1807
+ interface GtmCampaignBuildBackfillPreviewOptions {
1808
+ campaignBuildId: string;
1809
+ includeSampleRows?: boolean;
1810
+ includeCopySamples?: boolean;
1811
+ sampleRowLimit?: number;
1812
+ createMemory?: boolean;
1813
+ includePayload?: boolean;
1665
1814
  }
1666
- interface OpsProofOptions {
1667
- windowHours?: number;
1815
+ interface GtmCampaignBuildBackfillRunInput {
1816
+ campaignBuildIds: string[];
1817
+ source?: GtmCampaignSource;
1818
+ dryRun?: boolean;
1819
+ createMemory?: boolean;
1820
+ includeSampleRows?: boolean;
1821
+ includeCopySamples?: boolean;
1822
+ includePayload?: boolean;
1823
+ sampleRowLimit?: number;
1824
+ batchSize?: number;
1825
+ continueOnError?: boolean;
1826
+ runBrainCycle?: boolean;
1827
+ brainCycleWriteMode?: 'dry_run' | 'write';
1828
+ brainCyclePhases?: GtmBrainLearningCyclePhase[];
1829
+ brainCycleDays?: number;
1830
+ brainCycleNetworkDays?: number;
1831
+ brainCycleMinSampleSize?: number;
1832
+ brainCycleLimit?: number;
1668
1833
  }
1669
- interface OpsProofDestination {
1670
- type: string;
1671
- label: string;
1672
- connected: boolean;
1673
- healthy: boolean;
1674
- delivered: number;
1675
- failed: number;
1676
- proof: 'verified' | 'connected' | 'needs_attention' | 'not_connected' | string;
1677
- }
1678
- interface OpsProofResult {
1679
- success?: boolean;
1680
- status: 'ready' | 'partial' | 'unproven' | 'blocked' | string;
1681
- proof_state?: string;
1682
- proofState?: string;
1683
- phase?: string;
1684
- checked_at?: string;
1685
- checkedAt?: string;
1686
- window_hours?: number;
1687
- windowHours?: number;
1688
- label: string;
1689
- ui_summary?: string;
1690
- uiSummary?: string;
1691
- founder_verdict?: string;
1692
- founderVerdict?: string;
1693
- description?: string;
1694
- summary: {
1695
- connected_destinations?: number;
1696
- connectedDestinations: number;
1697
- healthy_destinations?: number;
1698
- healthyDestinations: number;
1699
- failing_destinations?: number;
1700
- failingDestinations: number;
1701
- deliveries_30d?: number;
1702
- deliveries30d: number;
1703
- delivered_30d?: number;
1704
- delivered30d: number;
1705
- failed_30d?: number;
1706
- failed30d: number;
1707
- external_delivered_30d?: number;
1708
- externalDelivered30d: number;
1709
- nango_proofs_30d?: number;
1710
- nangoProofs30d: number;
1711
- nango_failures_30d?: number;
1712
- nangoFailures30d: number;
1713
- airbyte_configured?: number;
1714
- airbyteConfigured: number;
1715
- airbyte_proofs_30d?: number;
1716
- airbyteProofs30d: number;
1717
- airbyte_failures_30d?: number;
1718
- airbyteFailures30d: number;
1719
- };
1720
- destinations: OpsProofDestination[];
1721
- blockers?: string[];
1722
- next_action?: string;
1723
- nextAction?: string;
1724
- next_actions?: string[];
1725
- nextActions?: string[];
1726
- estimated_credits?: number;
1727
- estimatedCredits?: number;
1728
- approval_required?: boolean;
1729
- approvalRequired?: boolean;
1730
- credits_charged?: 0;
1731
- creditsCharged?: 0;
1732
- proof_mode?: boolean;
1733
- proofMode?: boolean;
1734
- query_errors?: string[];
1735
- queryErrors?: string[];
1736
- raw?: Record<string, unknown>;
1834
+ interface GtmCampaignBuildBackfillStatusOptions {
1835
+ campaignBuildId: string;
1836
+ includePhases?: boolean;
1837
+ includeLinkedCampaign?: boolean;
1737
1838
  }
1738
- interface OpsAutopilotOptions {
1739
- windowHours?: number;
1839
+ interface GtmCampaignListOptions {
1840
+ status?: GtmCampaignStatus;
1841
+ provider?: string;
1842
+ search?: string;
1843
+ limit?: number;
1844
+ includeArchived?: boolean;
1740
1845
  }
1741
- interface OpsAutopilotStep {
1742
- tool: string;
1743
- purpose?: string;
1744
- arguments?: Record<string, unknown>;
1846
+ interface GtmCampaignGetOptions {
1847
+ logLimit?: number;
1848
+ memoryLimit?: number;
1745
1849
  }
1746
- interface OpsAutopilotMotion {
1747
- id: string;
1748
- blueprint: OpsBlueprint;
1749
- title: string;
1750
- outcome: string;
1751
- prompt: string;
1752
- target_count: number;
1753
- targetCount?: number;
1754
- cadence: OpsCadence | string;
1755
- destinations: OpsSinkType[];
1756
- estimated_credits: number;
1757
- estimatedCredits?: number;
1758
- proof_gate?: string;
1759
- proofGate?: string;
1760
- why_now?: string;
1761
- whyNow?: string;
1762
- agent_prompt?: string;
1763
- agentPrompt?: string;
1764
- cli_command?: string;
1765
- cliCommand?: string;
1766
- mcp_sequence?: OpsAutopilotStep[];
1767
- mcpSequence?: OpsAutopilotStep[];
1850
+ interface GtmCampaignExecutionStatusOptions {
1851
+ campaignId?: string;
1852
+ campaignBuildId?: string;
1853
+ includeProviderReadiness?: boolean;
1854
+ includeFeedback?: boolean;
1855
+ includeMemory?: boolean;
1856
+ includeRecentLog?: boolean;
1857
+ logLimit?: number;
1858
+ memoryLimit?: number;
1768
1859
  }
1769
- interface OpsAutopilotResult {
1770
- success?: boolean;
1771
- status?: string;
1772
- phase?: string;
1773
- stage: string;
1774
- headline: string;
1775
- verdict: string;
1776
- next_action: string;
1777
- nextAction?: string;
1778
- primary_motion: OpsAutopilotMotion;
1779
- primaryMotion?: OpsAutopilotMotion;
1780
- motions: OpsAutopilotMotion[];
1781
- scale_rule?: string;
1782
- scaleRule?: string;
1783
- agent_handoff?: string;
1784
- agentHandoff?: string;
1785
- proof_state?: string;
1786
- proofState?: string;
1787
- proof_summary?: Record<string, unknown>;
1788
- proofSummary?: Record<string, unknown>;
1789
- next_step?: Record<string, unknown>;
1790
- nextStep?: Record<string, unknown>;
1791
- query_errors?: string[];
1792
- queryErrors?: string[];
1793
- credits_charged?: 0;
1794
- creditsCharged?: 0;
1860
+ interface GtmCampaignLearningStatusOptions {
1861
+ campaignId?: string;
1862
+ campaignBuildId?: string;
1863
+ days?: number;
1864
+ networkDays?: number;
1865
+ minSampleSize?: number;
1866
+ holdoutMinSampleSize?: number;
1867
+ predictiveMinLabeledOutcomes?: number;
1868
+ predictiveMinPositiveOutcomes?: number;
1869
+ predictiveMinMemorySampleSize?: number;
1870
+ minWorkspaceCount?: number;
1871
+ minPrivacyK?: number;
1872
+ includeMemory?: boolean;
1873
+ includeNetwork?: boolean;
1874
+ writeMode?: 'dry_run' | 'write';
1875
+ limit?: number;
1795
1876
  }
1796
- interface CreateRoutineRequest {
1797
- name: string;
1798
- goal: string;
1877
+ interface GtmCampaignUpdateInput {
1878
+ campaignId: string;
1879
+ name?: string;
1799
1880
  description?: string;
1800
- cadence?: OpsCadence;
1801
- timezone?: string;
1802
- status?: Extract<OpsRoutineStatus, 'draft' | 'active' | 'paused'>;
1803
- policy?: Record<string, unknown>;
1804
- output_sinks?: OpsSink[];
1805
- outputSinks?: OpsSink[];
1806
- wake_on_events?: string[];
1807
- wakeOnEvents?: string[];
1808
- }
1809
- interface UpdateRoutineRequest extends Partial<CreateRoutineRequest> {
1810
- routine_id?: string;
1811
- routineId?: string;
1881
+ status?: GtmCampaignStatus;
1882
+ targetIcp?: UnknownRecord;
1883
+ sequences?: UnknownRecord[];
1884
+ leadListRefs?: UnknownRecord[];
1885
+ sendConfig?: UnknownRecord;
1886
+ performanceMetrics?: UnknownRecord;
1887
+ brainConfig?: UnknownRecord;
1888
+ memorySummary?: UnknownRecord;
1889
+ metadata?: UnknownRecord;
1890
+ providerLinks?: GtmProviderLinkInput[];
1891
+ log?: GtmCampaignLogInput;
1812
1892
  }
1813
- interface RunRoutineRequest {
1814
- routine_id?: string;
1815
- routineId?: string;
1816
- instruction?: string;
1817
- force?: boolean;
1893
+ interface GtmCampaignLogInput {
1894
+ campaignId?: string;
1895
+ actorType?: GtmActorType;
1896
+ actorId?: string;
1897
+ action?: string;
1898
+ rationale?: string;
1899
+ payload?: UnknownRecord;
1900
+ idempotencyKey?: string;
1818
1901
  }
1819
- interface OpsRoutineRunResult {
1820
- success?: boolean;
1821
- routine_id?: string;
1822
- routineId?: string;
1823
- tick_id?: string;
1824
- tickId?: string;
1825
- run_id?: string | null;
1826
- runId?: string | null;
1827
- status?: string;
1828
- state?: string;
1829
- next_action?: string;
1830
- nextAction?: string;
1831
- execution_refs?: ExecutionReference[];
1832
- [key: string]: unknown;
1902
+ interface GtmFeedbackIngestInput {
1903
+ source: string;
1904
+ campaignId?: string;
1905
+ campaignBuildId?: string;
1906
+ providerCampaignId?: string;
1907
+ events?: UnknownRecord[];
1908
+ providerPayload?: UnknownRecord;
1909
+ createMemory?: boolean;
1910
+ writeRoutineOutcomes?: boolean;
1833
1911
  }
1834
- interface OpsRoutineDeleteResult {
1835
- success?: boolean;
1836
- routine_id?: string;
1837
- routineId?: string;
1838
- deleted?: boolean;
1839
- permanent?: boolean;
1840
- status?: string;
1841
- next_action?: string;
1842
- nextAction?: string;
1843
- execution_refs?: ExecutionReference[];
1844
- [key: string]: unknown;
1912
+ interface GtmCampaignAuditRunInput {
1913
+ provider: 'instantly' | 'heyreach' | 'smartlead' | 'custom';
1914
+ providerCampaignId?: string;
1915
+ campaignId?: string;
1916
+ campaignName?: string;
1917
+ lookbackDays?: number;
1918
+ limitFindings?: number;
1845
1919
  }
1846
- interface OpsRoutineSinkResult {
1847
- success?: boolean;
1848
- routine_id?: string;
1849
- routineId?: string;
1850
- sink_id?: string;
1851
- sinkId?: string;
1852
- status?: string;
1853
- next_action?: string;
1854
- nextAction?: string;
1855
- routine?: OpsRoutine;
1856
- sink?: OpsSink;
1857
- execution_refs?: ExecutionReference[];
1858
- [key: string]: unknown;
1920
+ interface GtmCampaignAuditGetOptions {
1921
+ auditId?: string;
1922
+ campaignId?: string;
1923
+ limitFindings?: number;
1859
1924
  }
1860
- interface ListOutputSinksOptions {
1861
- status?: string;
1862
- category?: string;
1863
- include_inactive?: boolean;
1864
- includeInactive?: boolean;
1925
+ interface GtmInstantlyFeedbackSyncInput {
1926
+ campaignId?: string;
1927
+ campaignBuildId?: string;
1928
+ providerCampaignId?: string;
1929
+ instantlyCampaignId?: string;
1930
+ syncMode?: 'webhook' | 'pull' | 'manual';
1931
+ events?: UnknownRecord[];
1932
+ providerPayload?: UnknownRecord;
1933
+ cursor?: string;
1934
+ since?: string;
1935
+ until?: string;
1936
+ aggregateSnapshot?: UnknownRecord;
1937
+ createMemory?: boolean;
1938
+ writeRoutineOutcomes?: boolean;
1865
1939
  }
1866
- interface CreateOutputSinkRequest {
1867
- type: Exclude<OpsSinkType, 'routine'>;
1868
- name?: string;
1869
- connection_id?: string;
1870
- connectionId?: string;
1871
- config?: Record<string, unknown>;
1872
- webhook_url?: string;
1873
- webhookUrl?: string;
1940
+ interface GtmInstantlyFeedbackPullInput {
1941
+ source?: 'webhook_events' | 'emails';
1942
+ instantlyProfile?: string;
1943
+ campaignId?: string;
1944
+ campaignBuildId?: string;
1945
+ providerLinkId?: string;
1946
+ providerCampaignId?: string;
1947
+ instantlyCampaignId?: string;
1948
+ integrationId?: string;
1949
+ cursor?: string;
1950
+ from?: string;
1951
+ to?: string;
1952
+ limit?: number;
1953
+ maxPages?: number;
1954
+ emailType?: 'received' | 'sent' | 'manual';
1955
+ mode?: 'emode_focused' | 'emode_others' | 'emode_all';
1956
+ sortOrder?: 'asc' | 'desc';
1957
+ createMemory?: boolean;
1958
+ writeRoutineOutcomes?: boolean;
1959
+ dryRun?: boolean;
1960
+ runBrainCycle?: boolean;
1961
+ brainCycleWriteMode?: 'dry_run' | 'write';
1962
+ brainCyclePhases?: GtmBrainLearningCyclePhase[];
1963
+ brainCycleMinIngested?: number;
1964
+ brainCycleMinIntervalMinutes?: number;
1874
1965
  }
1875
- interface OpsApproveRequest {
1876
- token_id?: string;
1877
- tokenId?: string;
1878
- token_ids?: string[];
1879
- tokenIds?: string[];
1880
- decision?: 'approved' | 'rejected';
1881
- reviewer_notes?: string;
1882
- reviewerNotes?: string;
1966
+ interface GtmInstantlyFeedbackWebhookPrepareInput {
1967
+ campaignId?: string;
1968
+ campaignBuildId?: string;
1969
+ providerLinkId?: string;
1970
+ providerCampaignId?: string;
1971
+ instantlyCampaignId?: string;
1972
+ integrationId?: string;
1973
+ providerWorkspaceId?: string;
1974
+ providerAccountId?: string;
1975
+ rotateSecret?: boolean;
1976
+ runBrainCycle?: boolean;
1977
+ brainCycleWriteMode?: 'dry_run' | 'write';
1978
+ brainCyclePhases?: GtmBrainLearningCyclePhase[];
1979
+ brainCycleMinIngested?: number;
1980
+ brainCycleMinIntervalMinutes?: number;
1883
1981
  }
1884
- interface OpsApproveResult {
1885
- success: boolean;
1886
- decision?: 'approved' | 'rejected' | string;
1887
- token_id?: string;
1888
- tokenId?: string;
1889
- token_ids?: string[];
1890
- tokenIds?: string[];
1891
- reviewer_notes?: string;
1892
- reviewerNotes?: string;
1893
- [key: string]: unknown;
1982
+ interface GtmKernelImportPreviewInput {
1983
+ sourceIds?: string[];
1984
+ includeLeads?: boolean;
1985
+ includeReplies?: boolean;
1986
+ includePrivateCopy?: boolean;
1987
+ maxPages?: number;
1988
+ limit?: number;
1894
1989
  }
1895
- interface OpsPlanRequest {
1896
- prompt: string;
1897
- blueprint?: OpsBlueprint;
1898
- target_count?: number;
1899
- targetCount?: number;
1900
- cadence?: OpsCadence;
1901
- destinations?: Array<Record<string, unknown>>;
1902
- company_domains?: string[];
1903
- companyDomains?: string[];
1904
- custom_ai_prompt?: string;
1905
- customAiPrompt?: string;
1906
- signal_prompt?: string;
1907
- signalPrompt?: string;
1908
- output_prompt?: string;
1909
- outputPrompt?: string;
1990
+ interface GtmKernelImportRunInput extends GtmKernelImportPreviewInput {
1991
+ dryRun?: boolean;
1992
+ writeApproved?: boolean;
1993
+ privateCopyApproved?: boolean;
1994
+ promoteGlobalPatterns?: boolean;
1995
+ minGlobalPrivacyK?: number;
1910
1996
  }
1911
- interface OpsPlanResult {
1912
- plan_id: string;
1913
- planId?: string;
1914
- blueprint: OpsBlueprint;
1915
- title: string;
1916
- goal: string;
1917
- target_count: number;
1918
- targetCount?: number;
1919
- cadence: OpsCadence;
1920
- status: SimpleOpStatus | string;
1921
- estimated_credits: number;
1922
- estimatedCredits?: number;
1923
- approval_required: boolean;
1924
- approvalRequired?: boolean;
1925
- destinations: Array<Record<string, unknown>>;
1926
- blockers: string[];
1927
- expected_output?: string;
1928
- expectedOutput?: string;
1929
- next_action: string;
1930
- nextAction?: string;
1931
- ui_summary?: string;
1932
- uiSummary?: string;
1933
- review_steps?: Array<{
1934
- label: string;
1935
- value: string;
1936
- status?: string;
1937
- }>;
1938
- reviewSteps?: Array<{
1939
- label: string;
1940
- value: string;
1941
- status?: string;
1942
- }>;
1943
- fix_actions?: string[];
1944
- fixActions?: string[];
1945
- destination_status?: string;
1946
- destinationStatus?: string;
1947
- customization?: {
1948
- custom_ai_prompt?: string;
1949
- signal_prompt?: string;
1950
- output_prompt?: string;
1951
- [key: string]: unknown;
1952
- };
1953
- primitive_graph?: OpsPrimitive[];
1954
- primitiveGraph?: OpsPrimitive[];
1955
- advanced?: Record<string, unknown>;
1997
+ interface GtmBrainDistillRunInput {
1998
+ sourceIds?: string[];
1999
+ writeMode?: 'dry_run' | 'write';
2000
+ writeApproved?: boolean;
2001
+ brainCyclePhases?: GtmBrainLearningCyclePhase[];
2002
+ days?: number;
2003
+ networkDays?: number;
2004
+ minSampleSize?: number;
2005
+ minWorkspaceCount?: number;
2006
+ minPrivacyK?: number;
1956
2007
  }
1957
- interface OpsCreateRequest extends OpsPlanRequest {
1958
- name?: string;
1959
- description?: string;
1960
- policy?: Record<string, unknown>;
1961
- activate?: boolean;
1962
- confirm_spend?: boolean;
1963
- confirmSpend?: boolean;
2008
+ interface GtmFeedbackWebhookPrepareInput {
2009
+ provider: string;
2010
+ campaignId?: string;
2011
+ campaignBuildId?: string;
2012
+ providerLinkId?: string;
2013
+ providerCampaignId?: string;
2014
+ integrationId?: string;
2015
+ providerWorkspaceId?: string;
2016
+ providerAccountId?: string;
2017
+ rotateSecret?: boolean;
2018
+ runBrainCycle?: boolean;
2019
+ brainCycleWriteMode?: 'dry_run' | 'write';
2020
+ brainCyclePhases?: GtmBrainLearningCyclePhase[];
2021
+ brainCycleMinIngested?: number;
2022
+ brainCycleMinIntervalMinutes?: number;
1964
2023
  }
1965
- interface OpsExecuteRequest extends OpsCreateRequest {
1966
- auto_run?: boolean;
1967
- autoRun?: boolean;
1968
- dry_run?: boolean;
1969
- dryRun?: boolean;
1970
- output_format?: 'markdown' | 'json';
1971
- outputFormat?: 'markdown' | 'json';
2024
+ interface GtmMemorySearchOptions {
2025
+ query?: string;
2026
+ campaignId?: string;
2027
+ memoryType?: GtmMemoryType;
2028
+ keywords?: string[];
2029
+ outcomeType?: string;
2030
+ targetIcp?: UnknownRecord;
2031
+ layers?: GtmLayer[];
2032
+ providerChain?: string[];
2033
+ dimensionFilters?: UnknownRecord;
2034
+ requireDimensionMatch?: boolean;
2035
+ days?: number;
2036
+ limit?: number;
1972
2037
  }
1973
- interface OpsCreateResult {
1974
- success: boolean;
1975
- op_id: string;
1976
- opId?: string;
1977
- routine_id?: string;
1978
- routineId?: string;
1979
- run_id?: string | null;
1980
- runId?: string | null;
1981
- status: SimpleOpStatus | string;
1982
- phase: string;
1983
- next_action: string;
1984
- nextAction?: string;
1985
- results_count: number;
1986
- resultsCount?: number;
1987
- results_url?: string;
1988
- resultsUrl?: string;
1989
- delivery_status?: string;
1990
- deliveryStatus?: string;
1991
- estimated_credits?: number;
1992
- estimatedCredits?: number;
1993
- plan?: OpsPlanResult;
1994
- execution_refs?: ExecutionReference[];
2038
+ interface GtmBrainPatternsOptions {
2039
+ campaignId?: string;
2040
+ patternType?: GtmPatternType;
2041
+ segmentKey?: string;
2042
+ includeGlobal?: boolean;
2043
+ minConfidence?: number;
2044
+ limit?: number;
1995
2045
  }
1996
- interface OpsExecuteResult extends OpsCreateResult {
1997
- error_code?: string;
1998
- errorCode?: string;
1999
- approval?: Record<string, unknown>;
2000
- approval_required?: boolean;
2001
- approvalRequired?: boolean;
2002
- retry_arguments?: Record<string, unknown>;
2003
- retryArguments?: Record<string, unknown>;
2004
- next_step?: Record<string, unknown>;
2005
- nextStep?: Record<string, unknown>;
2006
- next_steps?: string[];
2007
- nextSteps?: string[];
2008
- blockers?: string[];
2046
+ interface GtmBrainSeedDefaultsInput {
2047
+ campaignId?: string;
2048
+ campaignBrief?: string;
2049
+ targetIcp?: UnknownRecord;
2050
+ layers?: GtmLayer[];
2051
+ includeGlobal?: boolean;
2052
+ includeMemory?: boolean;
2053
+ minConfidence?: number;
2054
+ writeCampaign?: boolean;
2055
+ limit?: number;
2009
2056
  }
2010
- interface OpsRunOptions {
2011
- op_id?: string;
2012
- opId?: string;
2013
- instruction?: string;
2014
- force?: boolean;
2015
- }
2016
- interface OpsRunResult {
2017
- success: boolean;
2018
- op_id: string;
2019
- opId?: string;
2020
- routine_id?: string;
2021
- routineId?: string;
2022
- run_id?: string | null;
2023
- runId?: string | null;
2024
- status: SimpleOpStatus | string;
2025
- phase: string;
2026
- next_action: string;
2027
- nextAction?: string;
2028
- results_count?: number;
2029
- resultsCount?: number;
2030
- results_url?: string;
2031
- resultsUrl?: string;
2032
- delivery_status?: string;
2033
- deliveryStatus?: string;
2034
- execution_refs?: ExecutionReference[];
2035
- }
2036
- interface OpsStatusOptions {
2037
- op_id?: string;
2038
- opId?: string;
2057
+ interface GtmBrainLearningCyclePlanInput {
2058
+ campaignId?: string;
2059
+ campaignBrief?: string;
2060
+ targetIcp?: UnknownRecord;
2061
+ layers?: GtmLayer[];
2062
+ providerChain?: string[];
2063
+ leadSource?: string;
2064
+ days?: number;
2065
+ networkDays?: number;
2066
+ minSampleSize?: number;
2067
+ holdoutMinSampleSize?: number;
2068
+ minWorkspaceCount?: number;
2069
+ minPrivacyK?: number;
2070
+ includeMemory?: boolean;
2071
+ includeNetwork?: boolean;
2072
+ writeMode?: 'dry_run' | 'write';
2073
+ limit?: number;
2039
2074
  }
2040
- interface OpsStatusResult extends OpsRunResult {
2041
- estimated_credits?: number | null;
2042
- estimatedCredits?: number | null;
2043
- latest_run?: Record<string, unknown> | null;
2044
- latestRun?: Record<string, unknown> | null;
2045
- diagnosis?: OpsDebugDiagnosis;
2075
+ type GtmBrainLearningCyclePhase = 'workspace_pattern_extraction' | 'deliverability_calibration' | 'failure_pattern_detection' | 'aggregate_patterns' | 'aggregate_calibrations' | 'defaults_seed' | 'delivery_risk';
2076
+ type GtmBrainLearningLaneId = 'workspace_patterns' | 'network_patterns' | 'defaults_learning' | 'failure_detection' | 'deliverability_calibration' | 'holdout_lift_proof';
2077
+ type GtmBrainLearningLaneState = 'ready' | 'attention' | 'blocked' | 'unknown';
2078
+ interface GtmBrainLearningLane {
2079
+ id: GtmBrainLearningLaneId;
2080
+ label: string;
2081
+ state: GtmBrainLearningLaneState;
2082
+ metric: string;
2083
+ detail: string;
2084
+ blockers: string[];
2085
+ warnings: string[];
2086
+ next_mcp_action: string;
2087
+ raw_data_policy?: string;
2046
2088
  }
2047
- interface OpsResultsOptions {
2048
- op_id?: string;
2049
- opId?: string;
2050
- limit?: number;
2051
- cursor?: string;
2052
- nextCursor?: string;
2053
- state?: string;
2054
- include_failed_runs?: boolean;
2055
- includeFailedRuns?: boolean;
2089
+ interface GtmBrainLearningLaneSummary {
2090
+ total_lanes: number;
2091
+ ready_lanes: number;
2092
+ blocked_lanes: number;
2093
+ attention_lanes: number;
2094
+ unknown_lanes: number;
2056
2095
  }
2057
- interface OpsResultsResult {
2058
- success: boolean;
2059
- op_id: string;
2060
- opId?: string;
2061
- routine_id?: string;
2062
- routineId?: string;
2063
- run_id?: string | null;
2064
- runId?: string | null;
2065
- status: SimpleOpStatus | string;
2066
- phase: string;
2067
- results_count: number;
2068
- resultsCount?: number;
2069
- results_total?: number | null;
2070
- resultsTotal?: number | null;
2071
- results: Array<Record<string, unknown>>;
2072
- next_cursor?: string | null;
2073
- nextCursor?: string | null;
2074
- has_more: boolean;
2075
- hasMore?: boolean;
2076
- next_action: string;
2077
- nextAction?: string;
2078
- results_url?: string;
2079
- resultsUrl?: string;
2080
- delivery_status?: string;
2081
- deliveryStatus?: string;
2082
- execution_refs?: ExecutionReference[];
2096
+ interface GtmBrainLearningEvidenceCounts {
2097
+ feedback_events?: number;
2098
+ deliverability_events?: number;
2099
+ failure_events?: number;
2100
+ positive_events?: number;
2101
+ holdout_control_sample_size?: number;
2102
+ holdout_learned_sample_size?: number;
2103
+ event_type_counts?: UnknownRecord;
2104
+ classification_counts?: UnknownRecord;
2105
+ memory_items?: number;
2106
+ memory_sample_size?: number;
2107
+ workspace_patterns?: number;
2108
+ workspace_calibrations?: number;
2109
+ global_patterns?: number;
2110
+ global_calibrations?: number;
2111
+ opted_in_workspaces?: number;
2083
2112
  }
2084
- interface OpsTriggerRunStatus {
2085
- success: boolean;
2086
- run_id: string;
2087
- runId?: string;
2088
- status: string;
2089
- output?: unknown;
2090
- error?: unknown;
2091
- costInCents?: number;
2092
- baseCostInCents?: number;
2093
- durationMs?: number;
2094
- _note?: string;
2095
- diagnosis?: OpsDebugDiagnosis;
2096
- execution_refs?: ExecutionReference[];
2113
+ interface GtmBrainLearningPhaseStatus {
2114
+ phase: GtmBrainLearningCyclePhase | string;
2115
+ ready: boolean;
2116
+ blocked_by?: string[];
2097
2117
  }
2098
- interface OpsTriggerBatchRunStatus {
2099
- success: boolean;
2100
- runs: OpsTriggerRunStatus[];
2118
+ interface GtmBrainLearningPhaseReadiness {
2119
+ ready: boolean;
2120
+ blocked_by: string[];
2101
2121
  }
2102
- type OpsTriggerRunStatusOptions = {
2103
- run_id: string;
2104
- runId?: never;
2105
- run_ids?: never;
2106
- runIds?: never;
2107
- } | {
2108
- runId: string;
2109
- run_id?: never;
2110
- run_ids?: never;
2111
- runIds?: never;
2112
- } | {
2113
- run_ids: string[];
2114
- run_id?: never;
2115
- runId?: never;
2116
- runIds?: never;
2117
- } | {
2118
- runIds: string[];
2119
- run_id?: never;
2120
- runId?: never;
2121
- run_ids?: never;
2122
- };
2123
- interface OpsQueueStatusOptions {
2124
- job_id?: string;
2125
- jobId?: string;
2126
- idempotency_key?: string;
2127
- idempotencyKey?: string;
2128
- summary?: boolean;
2122
+ interface GtmBrainLearningAction {
2123
+ tool: string;
2124
+ arguments?: UnknownRecord;
2125
+ reason?: string;
2129
2126
  }
2130
- interface OpsQueueStatus {
2131
- success: boolean;
2132
- producer_envelope?: OpsQueueProducerEnvelope;
2133
- producerEnvelope?: OpsQueueProducerEnvelope;
2134
- queue?: {
2135
- pending?: number;
2136
- processing?: number;
2137
- };
2138
- summary?: {
2139
- queue?: {
2140
- pending?: number;
2141
- processing?: number;
2142
- completed_last_hour?: number;
2143
- completedLastHour?: number;
2144
- failed_last_hour?: number;
2145
- failedLastHour?: number;
2146
- pending_by_function?: Record<string, number>;
2147
- pendingByFunction?: Record<string, number>;
2148
- };
2149
- providers?: Record<string, unknown>;
2150
- provider_stats?: Record<string, unknown>;
2151
- providerStats?: Record<string, unknown>;
2152
- redis_status?: Record<string, unknown>;
2153
- redisStatus?: Record<string, unknown>;
2154
- recent_events?: Array<Record<string, unknown>>;
2155
- recentEvents?: Array<Record<string, unknown>>;
2127
+ interface GtmHoldoutLiftProof {
2128
+ status?: string;
2129
+ honest_measurement?: boolean;
2130
+ positive_lift?: boolean;
2131
+ primary_metric?: string;
2132
+ min_cohort_sample_size?: number;
2133
+ volume?: {
2134
+ control_sample_size?: number;
2135
+ learned_sample_size?: number;
2136
+ total_sample_size?: number;
2156
2137
  };
2157
- job?: {
2158
- id?: string;
2159
- jobId?: string;
2160
- status?: string;
2161
- function_name?: string;
2162
- functionName?: string;
2163
- estimated_wait_ms?: number;
2164
- estimatedWaitMs?: number;
2165
- error_message?: string;
2166
- errorMessage?: string;
2167
- [key: string]: unknown;
2138
+ cohorts?: {
2139
+ control?: UnknownRecord | null;
2140
+ learned?: UnknownRecord | null;
2168
2141
  };
2169
- error?: string;
2170
- diagnosis?: OpsDebugDiagnosis;
2171
- execution_refs?: ExecutionReference[];
2172
- }
2173
- interface OpsQueueProducerEnvelope {
2174
- schema_version?: string;
2175
- schemaVersion?: string;
2176
- producer?: string;
2177
- queue_name?: string;
2178
- queueName?: string;
2179
- status_source?: string;
2180
- statusSource?: string;
2181
- idempotency_key?: string | null;
2182
- idempotencyKey?: string | null;
2183
- job_id?: string | null;
2184
- jobId?: string | null;
2185
- summary_requested?: boolean;
2186
- summaryRequested?: boolean;
2187
- retry_after_ms?: number;
2188
- retryAfterMs?: number;
2189
- poll_after_seconds?: number;
2190
- pollAfterSeconds?: number;
2191
- emitted_at?: string;
2192
- emittedAt?: string;
2193
- [key: string]: unknown;
2142
+ lift?: UnknownRecord;
2143
+ blockers?: string[];
2144
+ warnings?: string[];
2145
+ measurement_policy?: string;
2146
+ next_action?: string;
2194
2147
  }
2195
- interface OpsReplayResult {
2196
- success: boolean;
2197
- replay_run_id: string;
2198
- replayRunId?: string;
2199
- original_run_id: string;
2200
- originalRunId?: string;
2201
- start_from_node: number;
2202
- startFromNode?: number;
2203
- total_nodes: number;
2204
- totalNodes?: number;
2205
- diagnosis?: OpsDebugDiagnosis;
2206
- execution_refs?: ExecutionReference[];
2148
+ type GtmPredictiveModelingStatus = 'blocked' | 'advisory_only' | 'canary_ready' | 'production_ready';
2149
+ type GtmPredictiveModelingMode = 'disabled' | 'operator_advisory' | 'holdout_canary' | 'production_candidate';
2150
+ type GtmPredictiveModelingDomainState = 'blocked' | 'advisory' | 'canary_ready' | 'ready';
2151
+ interface GtmPredictiveModelingDomain {
2152
+ id?: 'lead_scoring' | 'copy_strategy' | 'deliverability_risk' | 'audience_precision' | string;
2153
+ label?: string;
2154
+ state?: GtmPredictiveModelingDomainState;
2155
+ confidence_tier?: 'none' | 'low' | 'medium' | 'high';
2156
+ evidence?: UnknownRecord;
2157
+ blockers?: string[];
2158
+ warnings?: string[];
2159
+ allowed_use?: string;
2160
+ recommended_method?: string;
2161
+ next_action?: string;
2207
2162
  }
2208
- interface OpsDashboardOptions {
2209
- section?: 'summary' | 'functions' | 'workspaces' | 'timeseries' | 'sources' | 'recent';
2210
- timeRangeDays?: number;
2211
- granularity?: 'hour' | 'day' | 'week' | 'month';
2212
- limit?: number;
2213
- }
2214
- interface OpsDashboardResult {
2215
- today_executions?: number;
2216
- todayExecutions?: number;
2217
- today_credits?: number;
2218
- todayCredits?: number;
2219
- month_executions?: number;
2220
- monthExecutions?: number;
2221
- month_credits?: number;
2222
- monthCredits?: number;
2223
- avg_execution_time_ms?: number;
2224
- avgExecutionTimeMs?: number;
2225
- [key: string]: unknown;
2226
- }
2227
- interface OpsDebugOptions {
2228
- op_id?: string;
2229
- opId?: string;
2230
- include_results?: boolean;
2231
- includeResults?: boolean;
2232
- results_limit?: number;
2233
- resultsLimit?: number;
2234
- include_queue?: boolean;
2235
- includeQueue?: boolean;
2236
- include_dashboard?: boolean;
2237
- includeDashboard?: boolean;
2238
- dashboard_limit?: number;
2239
- dashboardLimit?: number;
2240
- time_range_days?: number;
2241
- timeRangeDays?: number;
2242
- }
2243
- interface OpsDebugDiagnosticError {
2244
- step: string;
2245
- message: string;
2246
- }
2247
- interface OpsDebugDiagnosis {
2248
- state: 'healthy' | 'running' | 'failed' | 'degraded' | 'unknown';
2249
- retryable: boolean;
2250
- queue_pending: number;
2251
- queuePending?: number;
2252
- queue_processing: number;
2253
- queueProcessing?: number;
2254
- queue_failed_last_hour: number;
2255
- queueFailedLastHour?: number;
2256
- provider_pressure: 'none' | 'low' | 'medium' | 'high';
2257
- providerPressure?: 'none' | 'low' | 'medium' | 'high';
2258
- failed_run_count: number;
2259
- failedRunCount?: number;
2260
- primary_error?: string;
2261
- primaryError?: string;
2262
- summary: string;
2263
- }
2264
- interface OpsDebugResult {
2265
- success: boolean;
2266
- op_id: string;
2267
- opId?: string;
2268
- checked_at: string;
2269
- checkedAt?: string;
2270
- diagnosis: OpsDebugDiagnosis;
2271
- status: OpsStatusResult;
2272
- execution_refs: ExecutionReference[];
2273
- executionRefs?: ExecutionReference[];
2274
- run_statuses: OpsTriggerRunStatus[];
2275
- runStatuses?: OpsTriggerRunStatus[];
2276
- queue?: OpsQueueStatus;
2277
- dashboard_recent?: unknown;
2278
- dashboardRecent?: unknown;
2279
- results?: OpsResultsResult;
2280
- replay_candidates: ExecutionReference[];
2281
- replayCandidates?: ExecutionReference[];
2282
- next_actions: string[];
2283
- nextActions?: string[];
2284
- diagnostic_errors: OpsDebugDiagnosticError[];
2285
- diagnosticErrors?: OpsDebugDiagnosticError[];
2286
- }
2287
- interface OpsQuickstartStep {
2288
- step: number;
2289
- tool?: string;
2290
- action?: string;
2291
- arguments?: Record<string, unknown>;
2292
- description: string;
2293
- primitive_id?: string;
2294
- primitiveId?: string;
2295
- primitive_version?: string;
2296
- primitiveVersion?: string;
2163
+ interface GtmPredictiveModelingReadiness {
2164
+ status?: GtmPredictiveModelingStatus;
2165
+ prediction_mode?: GtmPredictiveModelingMode;
2166
+ confidence_tier?: 'none' | 'low' | 'medium' | 'high';
2167
+ score?: number;
2168
+ evidence_counts?: UnknownRecord;
2169
+ thresholds?: UnknownRecord;
2170
+ domains?: GtmPredictiveModelingDomain[];
2171
+ blockers?: string[];
2172
+ warnings?: string[];
2173
+ next_action?: string;
2174
+ guardrails?: UnknownRecord;
2175
+ modeling_policy?: string;
2176
+ privacy_policy?: string;
2297
2177
  }
2298
- interface OpsQuickstartWorkflow {
2299
- workflow_type: string;
2300
- workflowType?: string;
2301
- requested_workflow_type?: string;
2302
- requestedWorkflowType?: string;
2303
- name: string;
2304
- description: string;
2305
- credits_required: number;
2306
- creditsRequired?: number;
2307
- steps: OpsQuickstartStep[];
2308
- primitive_graph?: OpsPrimitive[];
2309
- primitiveGraph?: OpsPrimitive[];
2310
- available_types: string[];
2311
- availableTypes?: string[];
2178
+ interface GtmBrainLearningRecommendedToolCall extends GtmBrainLearningAction {
2179
+ step?: number;
2180
+ phase?: GtmBrainLearningCyclePhase | string;
2181
+ ready?: boolean;
2182
+ blocked_by?: string[];
2312
2183
  }
2313
- declare class Ops {
2314
- private client;
2315
- constructor(client: HttpClient);
2316
- plan(params: OpsPlanRequest | string): Promise<OpsPlanResult>;
2317
- autopilot(params?: OpsAutopilotOptions): Promise<OpsAutopilotResult>;
2318
- create(params: OpsCreateRequest | string): Promise<OpsCreateResult>;
2319
- execute(params: OpsExecuteRequest | string): Promise<OpsExecuteResult>;
2320
- run(params: OpsRunOptions | string): Promise<OpsRunResult>;
2321
- status(params: OpsStatusOptions | string): Promise<OpsStatusResult>;
2322
- results(params: OpsResultsOptions | string): Promise<OpsResultsResult>;
2323
- proof(params?: OpsProofOptions): Promise<OpsProofResult>;
2324
- debug(params: OpsDebugOptions | string): Promise<OpsDebugResult>;
2325
- quickstartWorkflow(workflowType?: string): Promise<OpsQuickstartWorkflow>;
2326
- approve(params: OpsApproveRequest): Promise<OpsApproveResult>;
2327
- createRoutine(params: CreateRoutineRequest): Promise<OpsRoutine>;
2328
- listRoutines(params?: {
2329
- status?: OpsRoutineStatus;
2330
- limit?: number;
2331
- cursor?: string;
2332
- }): Promise<OpsRoutinesResult>;
2333
- getRoutine(routineId: string): Promise<OpsRoutine>;
2334
- updateRoutine(params: UpdateRoutineRequest): Promise<OpsRoutine>;
2335
- runRoutineNow(params: RunRoutineRequest | string): Promise<OpsRoutineRunResult>;
2336
- deleteRoutine(routineId: string, permanent?: boolean): Promise<OpsRoutineDeleteResult>;
2337
- listOutputSinks(params?: ListOutputSinksOptions): Promise<OpsSink[]>;
2338
- getReadiness(params?: OpsReadinessOptions): Promise<OpsReadinessResult>;
2339
- doctor(params?: OpsReadinessOptions): Promise<OpsReadinessResult>;
2340
- createOutputSink(params: CreateOutputSinkRequest): Promise<OpsSink>;
2341
- attachSinkToRoutine(params: {
2342
- routine_id?: string;
2343
- routineId?: string;
2344
- sink_id?: string;
2345
- sinkId?: string;
2346
- }): Promise<OpsRoutineSinkResult>;
2347
- getRoutineTicks(params: {
2348
- routine_id?: string;
2349
- routineId?: string;
2350
- limit?: number;
2351
- cursor?: string;
2352
- }): Promise<OpsRoutineTicksResult>;
2353
- getLastTickItems(params: {
2354
- routine_id?: string;
2355
- routineId?: string;
2356
- limit?: number;
2357
- cursor?: string;
2358
- state?: string;
2359
- }): Promise<OpsRoutineTickItemsResult>;
2360
- getTriggerRunStatus(params: OpsTriggerRunStatusOptions | string): Promise<OpsTriggerRunStatus | OpsTriggerBatchRunStatus>;
2361
- getQueueStatus(params?: OpsQueueStatusOptions): Promise<OpsQueueStatus>;
2362
- replayFromCheckpoint(executionEventId: string): Promise<OpsReplayResult>;
2363
- normalizeExecutionReference(input: string | ExecutionReferenceInput): ExecutionReference;
2364
- collectExecutionReferences(payload: Record<string, unknown>): ExecutionReference[];
2365
- getDashboard(params?: OpsDashboardOptions): Promise<OpsDashboardResult>;
2366
- private call;
2184
+ interface GtmCampaignLearningStatusResult {
2185
+ workspace_id?: string;
2186
+ learning_stage?: string;
2187
+ ready?: boolean;
2188
+ outcome_learning_ready?: boolean;
2189
+ campaign?: {
2190
+ id?: string;
2191
+ name?: string;
2192
+ status?: string;
2193
+ source?: string;
2194
+ campaign_build_id?: string | null;
2195
+ updated_at?: string;
2196
+ } | null;
2197
+ campaign_build?: {
2198
+ id?: string;
2199
+ name?: string;
2200
+ status?: string;
2201
+ requested_target_count?: number;
2202
+ planned_target_count?: number;
2203
+ completed_at?: string | null;
2204
+ updated_at?: string | null;
2205
+ } | null;
2206
+ evidence_counts?: GtmBrainLearningEvidenceCounts;
2207
+ holdout_lift?: GtmHoldoutLiftProof;
2208
+ predictive_modeling_readiness?: GtmPredictiveModelingReadiness;
2209
+ closed_loop_proof_ready?: boolean;
2210
+ learning_lanes?: GtmBrainLearningLane[];
2211
+ lane_summary?: GtmBrainLearningLaneSummary;
2212
+ feedback_brain_cycle?: UnknownRecord;
2213
+ thresholds?: UnknownRecord;
2214
+ phases?: GtmBrainLearningPhaseStatus[];
2215
+ ready_phases?: Array<GtmBrainLearningCyclePhase | string>;
2216
+ learning_cycle_plan_args?: UnknownRecord;
2217
+ learning_cycle_run_args?: UnknownRecord | null;
2218
+ last_learning_cycle_receipt?: UnknownRecord | null;
2219
+ recent_brain_log?: UnknownRecord[];
2220
+ blockers?: string[];
2221
+ warnings?: string[];
2222
+ next_actions?: GtmBrainLearningAction[];
2223
+ execution_policy?: string;
2224
+ privacy_policy?: string;
2367
2225
  }
2368
-
2369
- declare class Ai {
2370
- private client;
2371
- constructor(client: HttpClient);
2372
- /**
2373
- * Run Custom AI Enrichment - Multi Model.
2374
- *
2375
- * Uses OpenRouter Fusion for multi-model analysis with web search/fetch enabled
2376
- * inside Fusion, then synthesizes the requested structured output fields.
2377
- */
2378
- multiModel(params: CustomAiMultiModelParams): Promise<CustomAiMultiModelResult>;
2226
+ interface GtmBrainLearningCyclePlanResult {
2227
+ cycle?: UnknownRecord;
2228
+ evidence_counts?: GtmBrainLearningEvidenceCounts;
2229
+ holdout_lift?: GtmHoldoutLiftProof;
2230
+ closed_loop_proof_ready?: boolean;
2231
+ readiness?: Record<string, GtmBrainLearningPhaseReadiness>;
2232
+ learning_lanes?: GtmBrainLearningLane[];
2233
+ lane_summary?: GtmBrainLearningLaneSummary;
2234
+ recommended_tool_calls?: GtmBrainLearningRecommendedToolCall[];
2235
+ next_ready_tools?: string[];
2236
+ queued_runner_tool?: string;
2237
+ execution_policy?: string;
2238
+ privacy_policy?: string;
2379
2239
  }
2380
-
2381
- type UnknownRecord = Record<string, unknown>;
2382
- type GtmCampaignStatus = 'draft' | 'building' | 'ready' | 'active' | 'paused' | 'completed' | 'archived' | 'failed';
2383
- type GtmCampaignSource = 'mcp' | 'campaign_builder' | 'routine' | 'manual' | 'import' | 'api' | 'webhook';
2384
- type GtmActorType = 'human' | 'agent' | 'system' | 'provider';
2385
- type GtmPatternType = 'angle' | 'subject_line' | 'opener' | 'sequence_structure' | 'icp' | 'lead_source' | 'provider_chain' | 'verification' | 'failure' | 'default' | 'calibration' | 'other';
2386
- type GtmMemoryType = 'subject_line' | 'opener' | 'sequence_step' | 'icp' | 'lead_source' | 'provider_chain' | 'verification' | 'reply' | 'objection' | 'meeting' | 'failure' | 'campaign_summary' | 'agent_note' | 'other';
2387
- type GtmLayer = 'icp' | 'find_company' | 'find_people' | 'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'company_enrichment' | 'copy_enrichment' | 'qualification' | 'sender' | 'feedback' | 'approval' | 'source_import' | 'destination_export' | 'customer_data' | 'custom';
2388
- type GtmInvocationType = 'signaliz_native' | 'webhook' | 'mcp_tool' | 'airbyte' | 'api' | 'managed_integration' | 'manual';
2389
- type GtmAuthStrategy = 'none' | 'integration_key' | 'mcp_auth' | 'webhook_secret' | 'session_vault' | 'byo_runtime';
2390
- interface GtmWorkspaceContextOptions {
2391
- includeCampaigns?: boolean;
2392
- includeMemory?: boolean;
2393
- includeBrain?: boolean;
2394
- includeConnections?: boolean;
2395
- limit?: number;
2240
+ interface GtmBrainLearningCycleRunInput extends GtmBrainLearningCyclePlanInput {
2241
+ phases?: GtmBrainLearningCyclePhase[];
2242
+ continueOnError?: boolean;
2396
2243
  }
2397
- interface GtmWorkspaceBootstrapStatusOptions {
2244
+ interface GtmBrainExtractPatternsInput {
2398
2245
  campaignId?: string;
2399
2246
  days?: number;
2247
+ patternTypes?: GtmPatternType[];
2400
2248
  minSampleSize?: number;
2401
- includeConnections?: boolean;
2402
- includeSamples?: boolean;
2249
+ includeMemory?: boolean;
2250
+ writePatterns?: boolean;
2251
+ dryRun?: boolean;
2252
+ replaceExisting?: boolean;
2403
2253
  limit?: number;
2404
2254
  }
2405
- interface GtmExistingCampaignDiscoverOptions {
2406
- provider?: string;
2407
- integrationId?: string;
2408
- search?: string;
2409
- limit?: number;
2410
- includeKernelLinked?: boolean;
2411
- includeProviderLive?: boolean;
2255
+ interface GtmBrainAggregatePatternsInput {
2256
+ days?: number;
2257
+ patternTypes?: GtmPatternType[];
2258
+ minWorkspaceCount?: number;
2259
+ minPrivacyK?: number;
2260
+ minConfidence?: number;
2261
+ includeLowConfidence?: boolean;
2262
+ writePatterns?: boolean;
2263
+ dryRun?: boolean;
2264
+ replaceExisting?: boolean;
2265
+ limit?: number;
2412
2266
  }
2413
- interface GtmExistingCampaignAuditOptions {
2414
- campaignId?: string;
2415
- provider?: string;
2416
- providerCampaignId?: string;
2417
- campaignName?: string;
2267
+ interface GtmBrainAggregateCalibrationsInput {
2418
2268
  days?: number;
2419
- includeRoutePreview?: boolean;
2420
- includeMemory?: boolean;
2421
- includeBrain?: boolean;
2269
+ dimensionTypes?: GtmCalibrationDimensionType[];
2270
+ minWorkspaceCount?: number;
2271
+ minPrivacyK?: number;
2272
+ minConfidence?: number;
2273
+ includeLowConfidence?: boolean;
2274
+ writeCalibrations?: boolean;
2275
+ dryRun?: boolean;
2276
+ replaceExisting?: boolean;
2277
+ limit?: number;
2422
2278
  }
2423
- interface GtmExistingCampaignAuditBySearchOptions extends Omit<GtmExistingCampaignAuditOptions, 'campaignId' | 'providerCampaignId' | 'campaignName'> {
2424
- search: string;
2425
- integrationId?: string;
2426
- includeKernelLinked?: boolean;
2427
- includeProviderLive?: boolean;
2279
+ interface GtmBrainCalibrateDeliverabilityInput {
2280
+ campaignId?: string;
2281
+ days?: number;
2282
+ dimensionTypes?: GtmCalibrationDimensionType[];
2283
+ minSampleSize?: number;
2284
+ dryRun?: boolean;
2285
+ writeCalibrations?: boolean;
2286
+ writePatterns?: boolean;
2287
+ replaceExisting?: boolean;
2288
+ limit?: number;
2428
2289
  }
2429
- type GtmExistingCampaignAuditBoundary = 'read_only' | 'dry_run' | 'write_import' | 'route_write' | 'sender_load' | 'export' | 'delivery' | 'approval_decision' | string;
2430
- interface GtmExistingCampaignMcpRequest {
2431
- tool: string;
2432
- arguments: UnknownRecord;
2290
+ interface GtmBrainDeliveryRiskInput {
2291
+ campaignId?: string;
2292
+ providerChain?: string[];
2293
+ leadSource?: string;
2294
+ targetIcp?: UnknownRecord;
2295
+ leadSamples?: UnknownRecord[];
2296
+ includeGlobal?: boolean;
2297
+ minConfidence?: number;
2298
+ limit?: number;
2433
2299
  }
2434
- interface GtmExistingCampaignOption {
2435
- source?: 'kernel_linked' | 'provider_live' | string;
2436
- provider?: string;
2437
- provider_link_id?: string | null;
2438
- provider_campaign_id?: string | null;
2439
- name?: string | null;
2440
- status?: string | number | null;
2441
- integration_id?: string | null;
2442
- integration_label?: string | null;
2443
- linked_kernel_campaign_id?: string | null;
2444
- linked_kernel_campaign_name?: string | null;
2445
- linked_kernel_campaign_status?: string | null;
2446
- audit_request?: GtmExistingCampaignMcpRequest;
2447
- [key: string]: unknown;
2300
+ type GtmCalibrationDimensionType = 'email_domain' | 'email_provider' | 'verification_source' | 'lead_source' | 'provider_chain' | 'icp_shape' | 'copy_pattern' | 'other';
2301
+ type GtmFailurePatternDimension = 'provider_chain' | 'provider' | 'icp_shape' | 'lead_source' | 'copy_pattern' | 'sequence_step' | 'email_domain';
2302
+ interface GtmBrainFailurePatternsOptions {
2303
+ campaignId?: string;
2304
+ days?: number;
2305
+ minSampleSize?: number;
2306
+ dimensions?: GtmFailurePatternDimension[];
2307
+ includeExistingPatterns?: boolean;
2308
+ includeGlobal?: boolean;
2309
+ limit?: number;
2448
2310
  }
2449
- interface GtmExistingCampaignDiscoveryResult {
2450
- provider?: string;
2451
- campaigns?: GtmExistingCampaignOption[];
2452
- counts?: {
2453
- total_returned?: number;
2454
- kernel_linked?: number;
2455
- provider_live?: number;
2456
- [key: string]: unknown;
2457
- };
2458
- integration_summaries?: UnknownRecord[];
2459
- blockers?: string[];
2460
- warnings?: string[];
2461
- next_safe_action?: GtmExistingCampaignMcpRequest | UnknownRecord;
2311
+ interface GtmConnectionsListOptions {
2312
+ kind?: 'all' | 'integrations' | 'mcp_servers' | 'app_connections' | 'nango_connections' | 'integration_recipes' | 'layer_routes';
2313
+ includeDisconnected?: boolean;
2462
2314
  }
2463
- interface GtmExistingCampaignCompletenessStep {
2464
- id: 'provider_history' | 'feedback_events' | 'kernel_memory' | 'brain_evidence' | 'provider_routes' | string;
2465
- label: string;
2466
- ready: boolean;
2467
- count: number;
2468
- approval_boundary: GtmExistingCampaignAuditBoundary;
2469
- detail?: string;
2470
- next_safe_request?: GtmExistingCampaignMcpRequest;
2471
- post_action_verification?: GtmExistingCampaignMcpRequest;
2315
+ interface GtmProviderCatalogOptions {
2316
+ providerId?: string;
2317
+ layer?: GtmLayer;
2318
+ includePlanned?: boolean;
2319
+ includeLayerCatalog?: boolean;
2472
2320
  }
2473
- interface GtmExistingCampaignAuditRecommendation {
2474
- id?: string;
2475
- category?: string;
2476
- title?: string;
2477
- summary?: string;
2478
- confidence?: string;
2479
- approval_boundary?: GtmExistingCampaignAuditBoundary;
2480
- evidence?: string[];
2481
- suggested_tool?: string;
2482
- suggested_action?: string;
2483
- next_safe_request?: GtmExistingCampaignMcpRequest;
2484
- post_action_verification?: GtmExistingCampaignMcpRequest;
2321
+ type GtmAgencyAutopilotCapabilityFamily = 'lead_list' | 'clay_table' | 'gtm_motion' | 'proof_governance';
2322
+ type GtmAgencyAutopilotCapabilityPhase = 'brief' | 'cache_inventory' | 'source_gap' | 'proof_gates' | 'qualification' | 'signals' | 'copy' | 'approval_export' | 'cache_writeback' | 'clay_orchestration' | 'motion_library' | 'learning';
2323
+ interface GtmAgencyAutopilotCapabilityCatalogOptions {
2324
+ query?: string;
2325
+ family?: GtmAgencyAutopilotCapabilityFamily;
2326
+ phase?: GtmAgencyAutopilotCapabilityPhase;
2327
+ accountLabel?: string;
2328
+ workspaceLabel?: string;
2329
+ targetCount?: number;
2330
+ limit?: number;
2331
+ includeAgentPrompts?: boolean;
2485
2332
  }
2486
- interface GtmExistingCampaignAuditResult {
2487
- workspace_id?: string;
2488
- provider?: string;
2489
- provider_campaign_id?: string | null;
2490
- campaign?: UnknownRecord | null;
2491
- audit_score?: number;
2492
- evidence_counts?: UnknownRecord;
2493
- completeness?: GtmExistingCampaignCompletenessStep[];
2494
- aggregate_metrics?: UnknownRecord;
2495
- provider_links?: UnknownRecord[];
2496
- memory_samples?: UnknownRecord[];
2497
- brain_samples?: UnknownRecord;
2498
- route_summary?: UnknownRecord;
2499
- blockers?: string[];
2500
- warnings?: string[];
2501
- recommendations?: GtmExistingCampaignAuditRecommendation[];
2502
- next_safe_actions?: GtmExistingCampaignMcpRequest[];
2503
- execution_policy?: string;
2504
- privacy_policy?: string;
2333
+ type GtmAgencyAutopilotPlaybookOutcomeType = 'lead_list' | 'clay_table' | 'gtm_motion' | 'proof_governance';
2334
+ type GtmAgencyAutopilotPlaybookSlug = 'cache-first-large-list' | 'net-new-suppressed-list' | 'proof-first-vertical-gate' | 'signal-led-copy-approval' | 'domain-first-recovery' | 'table-workflow-handoff';
2335
+ interface GtmAgencyAutopilotPlaybookCatalogOptions {
2336
+ query?: string;
2337
+ playbookSlug?: GtmAgencyAutopilotPlaybookSlug;
2338
+ outcomeType?: GtmAgencyAutopilotPlaybookOutcomeType;
2339
+ limit?: number;
2340
+ includeRequiredFields?: boolean;
2505
2341
  }
2506
- interface GtmProviderLinkInput {
2507
- provider: string;
2508
- providerCampaignId: string;
2509
- integrationId?: string;
2510
- providerWorkspaceId?: string;
2511
- providerAccountId?: string;
2512
- status?: string;
2513
- metadata?: UnknownRecord;
2342
+ interface GtmCampaignStrategyTemplatesOptions {
2343
+ strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
2344
+ query?: string;
2345
+ includeDetails?: boolean;
2514
2346
  }
2515
- interface GtmCampaignCreateInput {
2516
- name: string;
2517
- description?: string;
2518
- source?: GtmCampaignSource;
2519
- status?: GtmCampaignStatus;
2347
+ type GtmCampaignStrategyTemplateSlug = 'industrial-ot-resilience' | 'non-medical-home-care' | 'agency-founder-led' | 'cloud-infrastructure-displacement';
2348
+ interface GtmCampaignStartContextInput {
2349
+ campaignId?: string;
2520
2350
  campaignBuildId?: string;
2521
- campaignBuilderJobId?: string;
2522
- routineId?: string;
2351
+ campaignBrief?: string;
2352
+ strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
2523
2353
  targetIcp?: UnknownRecord;
2524
- sequences?: UnknownRecord[];
2525
- leadListRefs?: UnknownRecord[];
2526
- sendConfig?: UnknownRecord;
2527
- providerLinks?: GtmProviderLinkInput[];
2528
- brainConfig?: UnknownRecord;
2529
- metadata?: UnknownRecord;
2530
- log?: GtmCampaignLogInput;
2354
+ leadCount?: number;
2355
+ layers?: GtmLayer[];
2356
+ preferredProviders?: string[];
2357
+ memoryDimensionFilters?: UnknownRecord;
2358
+ requireMemoryDimensionMatch?: boolean;
2359
+ includeMemory?: boolean;
2360
+ includeBrain?: boolean;
2361
+ includeProviderRoutes?: boolean;
2362
+ includeFailurePatterns?: boolean;
2363
+ includeDeliveryRisk?: boolean;
2364
+ includeGlobalBrain?: boolean;
2365
+ includePlannedProviders?: boolean;
2366
+ days?: number;
2367
+ minConfidence?: number;
2368
+ minSampleSize?: number;
2369
+ limit?: number;
2531
2370
  }
2532
- interface GtmCampaignHistoryMemoryInput {
2533
- idempotencyKey?: string;
2534
- memoryType?: GtmMemoryType;
2535
- title: string;
2536
- content: string;
2537
- keywords?: string[];
2538
- dimensions?: UnknownRecord;
2539
- outcomeType?: string;
2540
- outcomeValue?: number;
2541
- sampleSize?: number;
2542
- confidence?: number;
2543
- shareable?: boolean;
2544
- redactionState?: 'raw' | 'redacted' | 'abstracted';
2545
- metadata?: UnknownRecord;
2546
- recencyAt?: string;
2371
+ interface GtmIntegrationsActivationStatusOptions {
2372
+ campaignId?: string;
2373
+ layer?: GtmLayer;
2374
+ includePlanned?: boolean;
2375
+ includeConnections?: boolean;
2547
2376
  }
2548
- interface GtmCampaignHistoryCampaignInput {
2377
+ interface GtmCampaignBuildPlanInput {
2549
2378
  campaignId?: string;
2550
- idempotencyKey?: string;
2551
- name?: string;
2552
- description?: string;
2553
- source?: GtmCampaignSource;
2554
- status?: GtmCampaignStatus;
2555
2379
  campaignBuildId?: string;
2556
- campaignBuilderJobId?: string;
2557
- routineId?: string;
2380
+ campaignBrief?: string;
2381
+ strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
2558
2382
  targetIcp?: UnknownRecord;
2559
- sequences?: UnknownRecord[];
2560
- leadListRefs?: UnknownRecord[];
2561
- sendConfig?: UnknownRecord;
2562
- performanceMetrics?: UnknownRecord;
2563
- brainConfig?: UnknownRecord;
2564
- memorySummary?: UnknownRecord;
2565
- metadata?: UnknownRecord;
2566
- providerLinks?: GtmProviderLinkInput[];
2567
- feedbackEvents?: UnknownRecord[];
2568
- memoryItems?: GtmCampaignHistoryMemoryInput[];
2569
- startedAt?: string;
2570
- completedAt?: string;
2571
- summary?: string;
2572
- memorySummaryText?: string;
2573
- }
2574
- interface GtmCampaignHistoryImportInput {
2575
- source?: GtmCampaignSource;
2576
- dryRun?: boolean;
2577
- createMemory?: boolean;
2578
- campaigns: GtmCampaignHistoryCampaignInput[];
2579
- }
2580
- interface GtmCampaignHistoryImportBatchInput {
2581
- batchId?: string;
2582
- campaigns: GtmCampaignHistoryCampaignInput[];
2583
- }
2584
- interface GtmCampaignHistoryImportRunInput {
2585
- source?: GtmCampaignSource;
2586
- dryRun?: boolean;
2587
- createMemory?: boolean;
2588
- campaigns?: GtmCampaignHistoryCampaignInput[];
2589
- batches?: GtmCampaignHistoryImportBatchInput[];
2590
- batchSize?: number;
2591
- continueOnError?: boolean;
2592
- runBrainCycle?: boolean;
2593
- brainCycleWriteMode?: 'dry_run' | 'write';
2594
- brainCyclePhases?: GtmBrainLearningCyclePhase[];
2595
- brainCycleDays?: number;
2596
- brainCycleNetworkDays?: number;
2597
- brainCycleMinSampleSize?: number;
2598
- brainCycleLimit?: number;
2599
- }
2600
- interface GtmCampaignBuildBackfillPreviewOptions {
2601
- campaignBuildId: string;
2602
- includeSampleRows?: boolean;
2603
- includeCopySamples?: boolean;
2604
- sampleRowLimit?: number;
2605
- createMemory?: boolean;
2606
- includePayload?: boolean;
2607
- }
2608
- interface GtmCampaignBuildBackfillRunInput {
2609
- campaignBuildIds: string[];
2610
- source?: GtmCampaignSource;
2611
- dryRun?: boolean;
2612
- createMemory?: boolean;
2613
- includeSampleRows?: boolean;
2614
- includeCopySamples?: boolean;
2615
- includePayload?: boolean;
2616
- sampleRowLimit?: number;
2617
- batchSize?: number;
2618
- continueOnError?: boolean;
2619
- runBrainCycle?: boolean;
2620
- brainCycleWriteMode?: 'dry_run' | 'write';
2621
- brainCyclePhases?: GtmBrainLearningCyclePhase[];
2622
- brainCycleDays?: number;
2623
- brainCycleNetworkDays?: number;
2624
- brainCycleMinSampleSize?: number;
2625
- brainCycleLimit?: number;
2626
- }
2627
- interface GtmCampaignBuildBackfillStatusOptions {
2628
- campaignBuildId: string;
2629
- includePhases?: boolean;
2630
- includeLinkedCampaign?: boolean;
2631
- }
2632
- interface GtmCampaignListOptions {
2633
- status?: GtmCampaignStatus;
2634
- provider?: string;
2635
- search?: string;
2383
+ leadCount?: number;
2384
+ layers?: GtmLayer[];
2385
+ preferredProviders?: string[];
2386
+ strategyModel?: 'strategy_template' | 'custom';
2387
+ includeStrategyPatterns?: boolean;
2388
+ includeWorkflowPatterns?: boolean;
2389
+ /** @deprecated Use includeWorkflowPatterns. */
2390
+ includeClayPatterns?: boolean;
2391
+ includeNangoCatalog?: boolean;
2392
+ partnerEcosystem?: string[];
2393
+ memoryDimensionFilters?: UnknownRecord;
2394
+ requireMemoryDimensionMatch?: boolean;
2395
+ includeMemory?: boolean;
2396
+ includeBrain?: boolean;
2397
+ includeProviderRoutes?: boolean;
2398
+ includeFailurePatterns?: boolean;
2399
+ includePlannedProviders?: boolean;
2400
+ days?: number;
2636
2401
  limit?: number;
2637
- includeArchived?: boolean;
2638
- }
2639
- interface GtmCampaignGetOptions {
2640
- logLimit?: number;
2641
- memoryLimit?: number;
2642
2402
  }
2643
- interface GtmCampaignExecutionStatusOptions {
2403
+ interface GtmCampaignAgentPlanInput {
2404
+ goal?: string;
2405
+ campaignBrief?: string;
2406
+ campaignName?: string;
2644
2407
  campaignId?: string;
2645
2408
  campaignBuildId?: string;
2646
- includeProviderReadiness?: boolean;
2647
- includeFeedback?: boolean;
2409
+ strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
2410
+ operatingPlaybooks?: string[];
2411
+ accountContext?: string;
2412
+ targetIcp?: UnknownRecord;
2413
+ targetCount?: number;
2414
+ leadCount?: number;
2415
+ builtIns?: Array<'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'signals' | (string & {})>;
2416
+ useLocalLeads?: boolean;
2417
+ layers?: GtmLayer[];
2418
+ preferredProviders?: string[];
2419
+ customTools?: UnknownRecord[];
2420
+ integrations?: UnknownRecord[];
2421
+ strategyModel?: 'strategy_template' | 'custom';
2422
+ includeStrategyPatterns?: boolean;
2423
+ includeWorkflowPatterns?: boolean;
2424
+ includeNangoCatalog?: boolean;
2425
+ partnerEcosystem?: string[];
2426
+ memoryDimensionFilters?: UnknownRecord;
2427
+ requireMemoryDimensionMatch?: boolean;
2648
2428
  includeMemory?: boolean;
2649
- includeRecentLog?: boolean;
2650
- logLimit?: number;
2651
- memoryLimit?: number;
2429
+ includeBrain?: boolean;
2430
+ includeProviderRoutes?: boolean;
2431
+ includeFailurePatterns?: boolean;
2432
+ includeDeliveryRisk?: boolean;
2433
+ includePlannedProviders?: boolean;
2434
+ days?: number;
2435
+ limit?: number;
2652
2436
  }
2653
- interface GtmCampaignLearningStatusOptions {
2654
- campaignId?: string;
2655
- campaignBuildId?: string;
2437
+ interface GtmCampaignAgentRequestTemplateInput {
2438
+ goal?: string;
2439
+ campaignBrief?: string;
2440
+ campaignName?: string;
2441
+ accountLabel?: string;
2442
+ accountContext?: string;
2443
+ strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
2444
+ operatingPlaybooks?: string[];
2445
+ targetIcp?: UnknownRecord;
2446
+ targetCount?: number;
2447
+ builtIns?: Array<'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'signals' | (string & {})>;
2448
+ includeLocalLeads?: boolean;
2449
+ includeByoPlaceholder?: boolean;
2450
+ includeNangoCatalog?: boolean;
2451
+ preferredProviders?: string[];
2452
+ privacyMode?: 'workspace_only' | 'anonymized_patterns' | 'opt_in_network' | (string & {});
2453
+ destinationType?: 'json' | 'csv' | 'webhook' | (string & {});
2454
+ }
2455
+ interface GtmCampaignStrategyMemoryStatusInput {
2456
+ strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
2457
+ query?: string;
2458
+ campaignBrief?: string;
2459
+ targetIcp?: UnknownRecord;
2460
+ memoryDimensionFilters?: UnknownRecord;
2461
+ requireMemoryDimensionMatch?: boolean;
2462
+ includeSamples?: boolean;
2463
+ includeSources?: boolean;
2656
2464
  days?: number;
2657
- networkDays?: number;
2658
- minSampleSize?: number;
2659
- minWorkspaceCount?: number;
2660
- minPrivacyK?: number;
2661
- includeMemory?: boolean;
2662
- includeNetwork?: boolean;
2663
- writeMode?: 'dry_run' | 'write';
2664
2465
  limit?: number;
2665
2466
  }
2666
- interface GtmCampaignUpdateInput {
2667
- campaignId: string;
2467
+ interface GtmCampaignBuildPlanCommitInput {
2468
+ campaignId?: string;
2469
+ campaignBuildId?: string;
2668
2470
  name?: string;
2669
- description?: string;
2670
- status?: GtmCampaignStatus;
2471
+ campaignBrief?: string;
2671
2472
  targetIcp?: UnknownRecord;
2473
+ leadCount?: number;
2474
+ layers?: GtmLayer[];
2475
+ preferredProviders?: string[];
2476
+ planSnapshot?: UnknownRecord;
2672
2477
  sequences?: UnknownRecord[];
2673
2478
  leadListRefs?: UnknownRecord[];
2674
2479
  sendConfig?: UnknownRecord;
2675
- performanceMetrics?: UnknownRecord;
2676
2480
  brainConfig?: UnknownRecord;
2677
- memorySummary?: UnknownRecord;
2678
2481
  metadata?: UnknownRecord;
2679
- providerLinks?: GtmProviderLinkInput[];
2680
- log?: GtmCampaignLogInput;
2681
- }
2682
- interface GtmCampaignLogInput {
2683
- campaignId?: string;
2482
+ status?: Extract<GtmCampaignStatus, 'draft' | 'building' | 'ready'>;
2483
+ approvalRequired?: boolean;
2684
2484
  actorType?: GtmActorType;
2685
2485
  actorId?: string;
2686
- action?: string;
2687
2486
  rationale?: string;
2688
- payload?: UnknownRecord;
2689
2487
  idempotencyKey?: string;
2488
+ dryRun?: boolean;
2489
+ confirm?: boolean;
2690
2490
  }
2691
- interface GtmFeedbackIngestInput {
2692
- source: string;
2693
- campaignId?: string;
2694
- campaignBuildId?: string;
2695
- providerCampaignId?: string;
2696
- events?: UnknownRecord[];
2697
- providerPayload?: UnknownRecord;
2698
- createMemory?: boolean;
2699
- writeRoutineOutcomes?: boolean;
2491
+ interface GtmCampaignBuildExecutionPrepareInput {
2492
+ campaignId: string;
2493
+ targetCount?: number;
2494
+ allowDownscale?: boolean;
2495
+ dryRun?: boolean;
2496
+ confirmSpend?: boolean;
2497
+ includeBrainContext?: boolean;
2498
+ requireDeliveryRiskClearance?: boolean;
2499
+ /** Output from gtm_brain_delivery_risk. When omitted, the MCP tool returns exact risk-check next-action args unless a stored campaign snapshot is available. */
2500
+ deliveryRisk?: UnknownRecord;
2501
+ dedupKeys?: ('email' | 'linkedin_url' | 'company_domain')[];
2502
+ policy?: UnknownRecord;
2503
+ signals?: UnknownRecord;
2504
+ qualification?: UnknownRecord;
2505
+ copy?: UnknownRecord;
2506
+ delivery?: UnknownRecord;
2507
+ enhancers?: UnknownRecord;
2700
2508
  }
2701
- interface GtmCampaignAuditRunInput {
2702
- provider: 'instantly' | 'heyreach' | 'smartlead' | 'custom';
2703
- providerCampaignId?: string;
2509
+ interface GtmProviderRecipePrepareInput {
2510
+ providerId: string;
2511
+ providerName?: string;
2512
+ description?: string;
2513
+ layerCapabilities?: GtmLayer[];
2514
+ invocationType?: GtmInvocationType;
2515
+ authStrategy?: GtmAuthStrategy;
2516
+ endpointUrl?: string;
2517
+ httpMethod?: string;
2518
+ secretRef?: string;
2519
+ workspaceIntegrationId?: string;
2520
+ workspaceMcpServerId?: string;
2521
+ workspaceConnectionId?: string;
2522
+ requestTemplate?: UnknownRecord;
2523
+ responseMapping?: UnknownRecord;
2524
+ inputSchema?: UnknownRecord;
2525
+ outputSchema?: UnknownRecord;
2526
+ readiness?: UnknownRecord;
2527
+ metadata?: UnknownRecord;
2528
+ layer?: GtmLayer;
2704
2529
  campaignId?: string;
2705
- campaignName?: string;
2706
- lookbackDays?: number;
2707
- limitFindings?: number;
2530
+ useSignalizFallback?: boolean;
2531
+ priority?: number;
2532
+ status?: 'draft' | 'active' | 'needs_setup';
2533
+ sampleRecords?: UnknownRecord[];
2534
+ context?: UnknownRecord;
2708
2535
  }
2709
- interface GtmCampaignAuditGetOptions {
2710
- auditId?: string;
2536
+ interface GtmClayWebhookPrepareInput {
2537
+ endpointUrl?: string;
2538
+ secretRef?: string;
2539
+ layer?: Extract<GtmLayer, 'find_company' | 'find_people' | 'lead_generation' | 'company_enrichment' | 'copy_enrichment' | 'approval' | 'destination_export' | 'custom'>;
2711
2540
  campaignId?: string;
2712
- limitFindings?: number;
2541
+ useSignalizFallback?: boolean;
2542
+ priority?: number;
2543
+ status?: 'draft' | 'active' | 'needs_setup';
2544
+ sampleRecords?: UnknownRecord[];
2545
+ context?: UnknownRecord;
2713
2546
  }
2714
- interface GtmInstantlyFeedbackSyncInput {
2547
+ interface GtmProviderRouteActivateInput {
2548
+ providerId: string;
2549
+ providerName?: string;
2550
+ description?: string;
2551
+ layer?: GtmLayer;
2552
+ layers?: GtmLayer[];
2715
2553
  campaignId?: string;
2716
- campaignBuildId?: string;
2717
- providerCampaignId?: string;
2718
- instantlyCampaignId?: string;
2719
- syncMode?: 'webhook' | 'pull' | 'manual';
2720
- events?: UnknownRecord[];
2721
- providerPayload?: UnknownRecord;
2722
- cursor?: string;
2723
- since?: string;
2724
- until?: string;
2725
- aggregateSnapshot?: UnknownRecord;
2726
- createMemory?: boolean;
2727
- writeRoutineOutcomes?: boolean;
2728
- }
2729
- interface GtmInstantlyFeedbackPullInput {
2730
- campaignId?: string;
2731
- campaignBuildId?: string;
2732
- providerLinkId?: string;
2733
- providerCampaignId?: string;
2734
- instantlyCampaignId?: string;
2735
- integrationId?: string;
2736
- cursor?: string;
2737
- from?: string;
2738
- to?: string;
2739
- limit?: number;
2740
- maxPages?: number;
2741
- createMemory?: boolean;
2742
- writeRoutineOutcomes?: boolean;
2554
+ invocationType?: GtmInvocationType;
2555
+ authStrategy?: GtmAuthStrategy;
2556
+ endpointUrl?: string;
2557
+ httpMethod?: string;
2558
+ secretRef?: string;
2559
+ workspaceIntegrationId?: string;
2560
+ workspaceMcpServerId?: string;
2561
+ workspaceConnectionId?: string;
2562
+ useSignalizFallback?: boolean;
2563
+ priority?: number;
2564
+ routeConfig?: UnknownRecord;
2565
+ requestTemplate?: UnknownRecord;
2566
+ responseMapping?: UnknownRecord;
2567
+ inputSchema?: UnknownRecord;
2568
+ outputSchema?: UnknownRecord;
2569
+ readiness?: UnknownRecord;
2570
+ metadata?: UnknownRecord;
2571
+ status?: 'draft' | 'active' | 'needs_setup' | 'paused' | 'archived' | 'failed';
2572
+ routeStatus?: 'active' | 'paused' | 'archived' | 'failed';
2573
+ replaceExistingRoutes?: boolean;
2743
2574
  dryRun?: boolean;
2744
- runBrainCycle?: boolean;
2745
- brainCycleWriteMode?: 'dry_run' | 'write';
2746
- brainCyclePhases?: GtmBrainLearningCyclePhase[];
2747
- brainCycleMinIngested?: number;
2748
- brainCycleMinIntervalMinutes?: number;
2575
+ confirm?: boolean;
2576
+ sampleRecords?: UnknownRecord[];
2577
+ context?: UnknownRecord;
2749
2578
  }
2750
- interface GtmInstantlyFeedbackWebhookPrepareInput {
2751
- campaignId?: string;
2752
- campaignBuildId?: string;
2753
- providerLinkId?: string;
2754
- providerCampaignId?: string;
2755
- instantlyCampaignId?: string;
2579
+ interface GtmConnectionRegisterInput {
2580
+ connectionKind: 'mcp_server' | 'integration';
2581
+ name: string;
2582
+ serverUrl?: string;
2583
+ authType?: 'none' | 'api_key' | 'bearer' | 'oauth';
2584
+ authConfig?: UnknownRecord;
2585
+ enabledTools?: string[];
2586
+ presetId?: string;
2587
+ vendorId?: string;
2588
+ serviceCategory?: string;
2589
+ connectionType?: string;
2756
2590
  integrationId?: string;
2757
- providerWorkspaceId?: string;
2758
- providerAccountId?: string;
2759
- rotateSecret?: boolean;
2760
- runBrainCycle?: boolean;
2761
- brainCycleWriteMode?: 'dry_run' | 'write';
2762
- brainCyclePhases?: GtmBrainLearningCyclePhase[];
2763
- brainCycleMinIngested?: number;
2764
- brainCycleMinIntervalMinutes?: number;
2591
+ providerConfigKey?: string;
2592
+ allowedIntegrations?: string[];
2593
+ surface?: 'settings_connections' | 'ops_destinations' | 'gtm_kernel';
2594
+ source?: string;
2595
+ userEmail?: string;
2596
+ userDisplayName?: string;
2597
+ status?: string;
2598
+ metadata?: UnknownRecord;
2765
2599
  }
2766
- interface GtmKernelImportPreviewInput {
2767
- sourceIds?: string[];
2768
- includeLeads?: boolean;
2769
- includeReplies?: boolean;
2770
- includePrivateCopy?: boolean;
2771
- maxPages?: number;
2772
- limit?: number;
2600
+ interface GtmIntegrationRecipeCreateInput {
2601
+ providerId: string;
2602
+ providerName: string;
2603
+ description?: string;
2604
+ layerCapabilities?: GtmLayer[];
2605
+ invocationType: GtmInvocationType;
2606
+ authStrategy?: GtmAuthStrategy;
2607
+ workspaceIntegrationId?: string;
2608
+ workspaceMcpServerId?: string;
2609
+ workspaceConnectionId?: string;
2610
+ endpointUrl?: string;
2611
+ httpMethod?: string;
2612
+ requestTemplate?: UnknownRecord;
2613
+ responseMapping?: UnknownRecord;
2614
+ inputSchema?: UnknownRecord;
2615
+ outputSchema?: UnknownRecord;
2616
+ readiness?: UnknownRecord;
2617
+ metadata?: UnknownRecord;
2618
+ status?: 'draft' | 'active' | 'needs_setup' | 'paused' | 'archived' | 'failed';
2773
2619
  }
2774
- interface GtmKernelImportRunInput extends GtmKernelImportPreviewInput {
2775
- dryRun?: boolean;
2776
- writeApproved?: boolean;
2777
- privateCopyApproved?: boolean;
2778
- promoteGlobalPatterns?: boolean;
2779
- minGlobalPrivacyK?: number;
2620
+ interface GtmLayerRouteSetInput {
2621
+ layer: GtmLayer;
2622
+ providerId: string;
2623
+ campaignId?: string;
2624
+ recipeId?: string;
2625
+ priority?: number;
2626
+ useSignalizFallback?: boolean;
2627
+ routeConfig?: UnknownRecord;
2628
+ status?: 'active' | 'paused' | 'archived' | 'failed';
2780
2629
  }
2781
- interface GtmBrainDistillRunInput {
2782
- sourceIds?: string[];
2783
- writeMode?: 'dry_run' | 'write';
2784
- writeApproved?: boolean;
2785
- brainCyclePhases?: GtmBrainLearningCyclePhase[];
2786
- days?: number;
2787
- networkDays?: number;
2788
- minSampleSize?: number;
2789
- minWorkspaceCount?: number;
2790
- minPrivacyK?: number;
2630
+ interface GtmLayerRoutesGetOptions {
2631
+ campaignId?: string;
2632
+ layer?: GtmLayer;
2791
2633
  }
2792
- interface GtmFeedbackWebhookPrepareInput {
2793
- provider: string;
2634
+ interface GtmLayerRoutePreviewInput {
2635
+ layer: GtmLayer;
2794
2636
  campaignId?: string;
2795
- campaignBuildId?: string;
2796
- providerLinkId?: string;
2797
- providerCampaignId?: string;
2637
+ sampleRecords?: UnknownRecord[];
2638
+ context?: UnknownRecord;
2639
+ }
2640
+ interface GtmNangoBaseOptions {
2641
+ workspaceConnectionId?: string;
2642
+ connectionId?: string;
2643
+ providerConfigKey?: string;
2798
2644
  integrationId?: string;
2799
- providerWorkspaceId?: string;
2800
- providerAccountId?: string;
2801
- rotateSecret?: boolean;
2802
- runBrainCycle?: boolean;
2803
- brainCycleWriteMode?: 'dry_run' | 'write';
2804
- brainCyclePhases?: GtmBrainLearningCyclePhase[];
2805
- brainCycleMinIngested?: number;
2806
- brainCycleMinIntervalMinutes?: number;
2645
+ nangoConnectionId?: string;
2807
2646
  }
2808
- interface GtmMemorySearchOptions {
2647
+ interface GtmNangoConnectSessionCreateInput {
2648
+ providerId?: string;
2649
+ integrationId?: string;
2650
+ providerDisplayName?: string;
2651
+ integrationDisplayName?: string;
2652
+ allowedIntegrations?: string[];
2653
+ surface?: 'settings_connections' | 'ops_destinations' | 'gtm_kernel';
2654
+ source?: string;
2655
+ userEmail?: string;
2656
+ userDisplayName?: string;
2657
+ }
2658
+ interface GtmNangoToolsListOptions extends GtmNangoBaseOptions {
2659
+ format?: 'openai' | 'nango';
2660
+ includeRaw?: boolean;
2661
+ }
2662
+ interface GtmNangoIntegrationFlowPrepareInput extends GtmNangoBaseOptions {
2809
2663
  query?: string;
2664
+ search?: string;
2665
+ providerId?: string;
2666
+ provider?: string;
2667
+ intent?: 'auto' | 'search' | 'connect' | 'pull' | 'import' | 'export' | 'send' | 'ops' | 'campaign' | 'route';
2668
+ actionName?: string;
2669
+ toolName?: string;
2670
+ proxyPath?: string;
2671
+ method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
2672
+ input?: UnknownRecord;
2673
+ cadence?: 'hourly' | 'daily' | 'weekly' | string;
2674
+ fieldMap?: UnknownRecord;
2675
+ requiredFields?: string[];
2676
+ confirmSpend?: boolean;
2677
+ writeConfirmed?: boolean;
2678
+ layer?: GtmLayer | string;
2810
2679
  campaignId?: string;
2811
- memoryType?: GtmMemoryType;
2812
- keywords?: string[];
2813
- outcomeType?: string;
2814
- targetIcp?: UnknownRecord;
2815
- layers?: GtmLayer[];
2816
- providerChain?: string[];
2817
- dimensionFilters?: UnknownRecord;
2818
- requireDimensionMatch?: boolean;
2819
- days?: number;
2820
2680
  limit?: number;
2681
+ includeProviderCatalog?: boolean;
2821
2682
  }
2822
- interface GtmBrainPatternsOptions {
2823
- campaignId?: string;
2824
- patternType?: GtmPatternType;
2825
- segmentKey?: string;
2826
- includeGlobal?: boolean;
2827
- minConfidence?: number;
2828
- limit?: number;
2683
+ interface GtmNangoToolCallInput extends GtmNangoBaseOptions {
2684
+ actionName?: string;
2685
+ toolName?: string;
2686
+ deliveryMode?: 'action' | 'proxy' | string;
2687
+ proxyPath?: string;
2688
+ nangoProxyPath?: string;
2689
+ method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | string;
2690
+ httpMethod?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | string;
2691
+ proxyHeaders?: UnknownRecord;
2692
+ input?: UnknownRecord;
2693
+ async?: boolean;
2694
+ maxRetries?: number;
2695
+ dryRun?: boolean;
2696
+ confirm?: boolean;
2697
+ confirmWrite?: boolean;
2829
2698
  }
2830
- interface GtmBrainSeedDefaultsInput {
2831
- campaignId?: string;
2832
- campaignBrief?: string;
2833
- targetIcp?: UnknownRecord;
2834
- layers?: GtmLayer[];
2835
- includeGlobal?: boolean;
2836
- includeMemory?: boolean;
2837
- minConfidence?: number;
2838
- writeCampaign?: boolean;
2839
- limit?: number;
2699
+ interface GtmNangoActionResultGetInput {
2700
+ actionId?: string;
2701
+ statusUrl?: string;
2840
2702
  }
2841
- interface GtmBrainLearningCyclePlanInput {
2703
+ interface GtmWebhookDeliverInput {
2704
+ recipeId: string;
2842
2705
  campaignId?: string;
2843
- campaignBrief?: string;
2844
- targetIcp?: UnknownRecord;
2845
- layers?: GtmLayer[];
2846
- providerChain?: string[];
2847
- leadSource?: string;
2848
- days?: number;
2849
- networkDays?: number;
2850
- minSampleSize?: number;
2851
- minWorkspaceCount?: number;
2852
- minPrivacyK?: number;
2853
- includeMemory?: boolean;
2854
- includeNetwork?: boolean;
2855
- writeMode?: 'dry_run' | 'write';
2856
- limit?: number;
2857
- }
2858
- type GtmBrainLearningCyclePhase = 'workspace_pattern_extraction' | 'deliverability_calibration' | 'failure_pattern_detection' | 'aggregate_patterns' | 'aggregate_calibrations' | 'defaults_seed' | 'delivery_risk';
2859
- type GtmBrainLearningLaneId = 'workspace_patterns' | 'network_patterns' | 'defaults_learning' | 'failure_detection' | 'deliverability_calibration';
2860
- type GtmBrainLearningLaneState = 'ready' | 'attention' | 'blocked' | 'unknown';
2861
- interface GtmBrainLearningLane {
2862
- id: GtmBrainLearningLaneId;
2863
- label: string;
2864
- state: GtmBrainLearningLaneState;
2865
- metric: string;
2866
- detail: string;
2867
- blockers: string[];
2868
- warnings: string[];
2869
- next_mcp_action: string;
2870
- raw_data_policy?: string;
2706
+ layer?: GtmLayer;
2707
+ records: UnknownRecord[];
2708
+ context?: UnknownRecord;
2709
+ idempotencyKey?: string;
2871
2710
  }
2872
- interface GtmBrainLearningLaneSummary {
2873
- total_lanes: number;
2874
- ready_lanes: number;
2875
- blocked_lanes: number;
2876
- attention_lanes: number;
2877
- unknown_lanes: number;
2711
+ declare class GtmKernel {
2712
+ private client;
2713
+ constructor(client: HttpClient);
2714
+ /** Load workspace context for an agent session: campaigns, memory, Brain, connections, and Signaliz primitives. */
2715
+ context(options?: GtmWorkspaceContextOptions): Promise<any>;
2716
+ /** Inspect whether the workspace has the Kernel + Brain substrate pieces needed to build, run, and improve campaigns. */
2717
+ bootstrapStatus(options?: GtmWorkspaceBootstrapStatusOptions): Promise<any>;
2718
+ /** Discover existing provider campaigns, starting with live/Kernel-linked Instantly campaigns, before audit or import preview. */
2719
+ discoverExistingCampaigns(options?: GtmExistingCampaignDiscoverOptions): Promise<GtmExistingCampaignDiscoveryResult>;
2720
+ /** Run a read-only existing campaign audit with completeness, recommendations, safe next MCP JSON, and approval boundaries. */
2721
+ auditExistingCampaign(options: GtmExistingCampaignAuditOptions): Promise<GtmExistingCampaignAuditResult>;
2722
+ /** Discover the first matching existing provider campaign, then run the same read-only audit against that match. */
2723
+ auditExistingCampaignBySearch(options: GtmExistingCampaignAuditBySearchOptions): Promise<GtmExistingCampaignAuditResult>;
2724
+ /** Create a first-class GTM campaign object in the current workspace. */
2725
+ createCampaign(input: GtmCampaignCreateInput): Promise<any>;
2726
+ /** Backfill historical campaigns, provider links, feedback, and memory into the GTM Kernel substrate. */
2727
+ importCampaignHistory(input: GtmCampaignHistoryImportInput): Promise<any>;
2728
+ /** Queue a Trigger-backed campaign history import for larger private campaign backfills. */
2729
+ importCampaignHistoryRun(input: GtmCampaignHistoryImportRunInput): Promise<any>;
2730
+ /** Preview a provider-neutral history import payload derived from an existing campaign build. */
2731
+ previewCampaignBuildBackfill(options: GtmCampaignBuildBackfillPreviewOptions): Promise<any>;
2732
+ /** Queue campaign-build history backfills through the Trigger-backed history import runner. */
2733
+ runCampaignBuildBackfill(input: GtmCampaignBuildBackfillRunInput): Promise<any>;
2734
+ /** Inspect Campaign Builder to Kernel backfill status for one build. */
2735
+ campaignBuildBackfillStatus(options: GtmCampaignBuildBackfillStatusOptions): Promise<any>;
2736
+ /** List first-class GTM campaign objects in the current workspace. */
2737
+ listCampaigns(options?: GtmCampaignListOptions): Promise<any>;
2738
+ /** Get one campaign with provider links, logs, feedback summary, memory, and Brain patterns. */
2739
+ getCampaign(campaignId: string, options?: GtmCampaignGetOptions): Promise<any>;
2740
+ /** Inspect campaign execution state, linked build progress, provider readiness, feedback, memory, and next actions. */
2741
+ campaignExecutionStatus(options: GtmCampaignExecutionStatusOptions): Promise<any>;
2742
+ /** Inspect whether a campaign/build is ready for Brain learning and return exact learning-cycle args. */
2743
+ campaignLearningStatus(options: GtmCampaignLearningStatusOptions): Promise<GtmCampaignLearningStatusResult>;
2744
+ /** Update a first-class GTM campaign and append the associated campaign log entry. */
2745
+ updateCampaign(input: GtmCampaignUpdateInput): Promise<any>;
2746
+ /** Append an auditable campaign action with actor, rationale, payload, and optional idempotency key. */
2747
+ logCampaign(campaignId: string, input: Omit<GtmCampaignLogInput, 'campaignId'>): Promise<any>;
2748
+ /** Ingest provider-neutral feedback from Instantly, Smartlead, HeyReach, webhook, or a custom MCP. */
2749
+ ingestFeedback(input: GtmFeedbackIngestInput): Promise<any>;
2750
+ /** Run a read-only Campaign Audit and persist workspace-scoped failure findings. */
2751
+ runCampaignAudit(input: GtmCampaignAuditRunInput): Promise<any>;
2752
+ /** Read a persisted Campaign Audit by audit id or campaign id. */
2753
+ getCampaignAudit(options: GtmCampaignAuditGetOptions): Promise<any>;
2754
+ /** Normalize Instantly webhook/pull payloads and ingest row-level feedback through the GTM Kernel. */
2755
+ syncInstantlyFeedback(input: GtmInstantlyFeedbackSyncInput): Promise<any>;
2756
+ /** Start a background Instantly webhook-events or email-history pull and route results into the GTM feedback loop. */
2757
+ pullInstantlyFeedback(input: GtmInstantlyFeedbackPullInput): Promise<any>;
2758
+ /** Prepare a secure Instantly feedback webhook URL for a campaign provider link. */
2759
+ prepareInstantlyFeedbackWebhook(input: GtmInstantlyFeedbackWebhookPrepareInput): Promise<any>;
2760
+ /** Preview anonymized Instantly workspace sources registered for Kernel import. */
2761
+ previewKernelImport(input?: GtmKernelImportPreviewInput): Promise<any>;
2762
+ /** Queue the read-only Instantly-to-GTM Kernel import. Live writes require writeApproved. */
2763
+ runKernelImport(input?: GtmKernelImportRunInput): Promise<any>;
2764
+ /** Queue Brain distillation over imported Instantly memory with abstracted-only outputs. */
2765
+ runBrainDistillation(input?: GtmBrainDistillRunInput): Promise<any>;
2766
+ /** Prepare a provider-agnostic feedback webhook URL for Smartlead, HeyReach, Airbyte, or custom sender events. */
2767
+ prepareFeedbackWebhook(input: GtmFeedbackWebhookPrepareInput): Promise<any>;
2768
+ /** Search ranked workspace campaign memory instead of dumping raw history. */
2769
+ searchMemory(options?: GtmMemorySearchOptions): Promise<any>;
2770
+ /** Retrieve evidence-backed workspace and privacy-safe aggregate Brain patterns. */
2771
+ brainPatterns(options?: GtmBrainPatternsOptions): Promise<any>;
2772
+ /** Plan the closed-loop Brain learning sequence without recursively executing Edge Functions. */
2773
+ learningCyclePlan(input?: GtmBrainLearningCyclePlanInput): Promise<GtmBrainLearningCyclePlanResult>;
2774
+ /** Queue the closed-loop Brain learning sequence in Trigger. */
2775
+ learningCycleRun(input?: GtmBrainLearningCycleRunInput): Promise<any>;
2776
+ /** Seed campaign defaults from active Brain patterns and ranked workspace memory. */
2777
+ seedBrainDefaults(input?: GtmBrainSeedDefaultsInput): Promise<any>;
2778
+ /** Extract within-workspace Brain V1 patterns from feedback, provider links, campaigns, and memory. */
2779
+ extractBrainPatterns(input?: GtmBrainExtractPatternsInput): Promise<any>;
2780
+ /** Aggregate opted-in workspace Brain patterns into privacy-safe global defaults. */
2781
+ aggregateBrainPatterns(input?: GtmBrainAggregatePatternsInput): Promise<any>;
2782
+ /** Aggregate opted-in workspace deliverability calibrations into privacy-safe global calibration rows. */
2783
+ aggregateBrainCalibrations(input?: GtmBrainAggregateCalibrationsInput): Promise<any>;
2784
+ /** Calibrate workspace deliverability predictions against actual bounce feedback. */
2785
+ calibrateDeliverability(input?: GtmBrainCalibrateDeliverabilityInput): Promise<any>;
2786
+ /** Estimate pre-send delivery risk from campaign context, lead samples, and Brain calibrations. */
2787
+ deliveryRisk(input?: GtmBrainDeliveryRiskInput): Promise<any>;
2788
+ /** Rank provider-chain, ICP, source, copy, and sequence failure patterns without writing raw lead data. */
2789
+ failurePatterns(options?: GtmBrainFailurePatternsOptions): Promise<any>;
2790
+ /** List provider presets agents can wire into GTM campaign layers, including BYO and Signaliz fallback options. */
2791
+ providerCatalog(options?: GtmProviderCatalogOptions): Promise<any>;
2792
+ /** List private-safe campaign strategy templates agents can merge into campaign build plans. */
2793
+ campaignStrategyTemplates(options?: GtmCampaignStrategyTemplatesOptions): Promise<any>;
2794
+ /** Search the Agency Autopilot safe-action catalog for agency-style lead lists, Clay tables, and GTM motions. */
2795
+ agencyAutopilotCapabilityCatalog(options?: GtmAgencyAutopilotCapabilityCatalogOptions): Promise<unknown>;
2796
+ /** Search agency operating playbooks Agency Autopilot can use for lead lists, Clay tables, GTM motions, and proof gates. */
2797
+ agencyAutopilotPlaybookCatalog(options?: GtmAgencyAutopilotPlaybookCatalogOptions): Promise<unknown>;
2798
+ /** Build the read-only Memory, Brain, risk, and provider-route runbook needed before planning a campaign. */
2799
+ campaignStartContext(input?: GtmCampaignStartContextInput): Promise<any>;
2800
+ /** Inspect GTM integration activation cards for UI and agent routing without writing state. */
2801
+ integrationsActivationStatus(options?: GtmIntegrationsActivationStatusOptions): Promise<any>;
2802
+ /** Compose Memory, Brain defaults, failure intelligence, and provider routes into a read-only campaign build plan. */
2803
+ campaignBuildPlan(input?: GtmCampaignBuildPlanInput): Promise<any>;
2804
+ /** Emit reusable CampaignBuilderAgentRequest JSON from hosted MCP strategy-template defaults without spending credits. */
2805
+ campaignAgentRequestTemplate(input?: GtmCampaignAgentRequestTemplateInput): Promise<any>;
2806
+ /** Compose a one-call read-only strategy-template campaign-agent runbook across built-ins, Memory, Brain, Nango, and BYO routes. */
2807
+ campaignAgentPlan(input?: GtmCampaignAgentPlanInput): Promise<any>;
2808
+ /** Inspect private-safe strategy-template/workflow memory readiness before campaign planning. */
2809
+ campaignStrategyMemoryStatus(input?: GtmCampaignStrategyMemoryStatusInput): Promise<any>;
2810
+ /** Persist a reviewed campaign build plan into a campaign object and audit log. Dry-run first by default. */
2811
+ commitCampaignBuildPlan(input?: GtmCampaignBuildPlanCommitInput): Promise<any>;
2812
+ /** Derive exact build_campaign arguments from a committed campaign object without creating a build. */
2813
+ prepareCampaignBuildExecution(input: GtmCampaignBuildExecutionPrepareInput): Promise<any>;
2814
+ /** Prepare exact recipe, route, preview, and delivery arguments for a provider without writing state. */
2815
+ prepareProviderRecipe(input: GtmProviderRecipePrepareInput): Promise<any>;
2816
+ /** Prepare exact Clay webhook recipe, route, preview, and delivery arguments without writing state. */
2817
+ prepareClayWebhook(input?: GtmClayWebhookPrepareInput): Promise<any>;
2818
+ /** Dry-run or confirm a one-call provider route activation across one or more GTM layers. */
2819
+ activateProviderRoute(input: GtmProviderRouteActivateInput): Promise<any>;
2820
+ /** List Signaliz-managed integrations, external MCP servers, app connections, recipes, and layer routes. */
2821
+ listConnections(options?: GtmConnectionsListOptions): Promise<any>;
2822
+ /** Register a workspace connection for the Kernel connection layer. */
2823
+ registerConnection(input: GtmConnectionRegisterInput): Promise<any>;
2824
+ /** Create a reusable integration recipe for BYO providers such as Clay webhooks, Apollo, AI Ark, Octave, or Airbyte. */
2825
+ createIntegrationRecipe(input: GtmIntegrationRecipeCreateInput): Promise<any>;
2826
+ /** Set a workspace or campaign provider route for one GTM layer. */
2827
+ setLayerRoute(input: GtmLayerRouteSetInput): Promise<any>;
2828
+ /** Get effective layer routes, including Signaliz fallback availability. */
2829
+ getLayerRoutes(options?: GtmLayerRoutesGetOptions): Promise<any>;
2830
+ /** Preview one effective layer route before external delivery or provider execution. */
2831
+ previewLayerRoute(input: GtmLayerRoutePreviewInput): Promise<any>;
2832
+ /** Create a short-lived Nango Connect session so a user can authorize a vendor API. */
2833
+ createNangoConnectSession(input: GtmNangoConnectSessionCreateInput): Promise<any>;
2834
+ /** Prepare the full Nango provider search, connect, pull/export, Ops, and campaign-route flow. */
2835
+ prepareNangoIntegrationFlow(input?: GtmNangoIntegrationFlowPrepareInput): Promise<any>;
2836
+ /** List Nango-backed action tools for a workspace connection without executing them. */
2837
+ listNangoTools(options?: GtmNangoToolsListOptions): Promise<any>;
2838
+ /** Dry-run or execute a Nango-backed action tool through the approval-aware MCP bridge. */
2839
+ callNangoTool(input: GtmNangoToolCallInput): Promise<any>;
2840
+ /** Poll an async Nango action result by action id or status URL. */
2841
+ getNangoActionResult(input: GtmNangoActionResultGetInput): Promise<any>;
2842
+ /** Deliver approved campaign-layer records to a webhook recipe, starting with Clay-style webhooks. */
2843
+ deliverWebhook(input: GtmWebhookDeliverInput): Promise<any>;
2844
+ private callMcp;
2845
+ }
2846
+
2847
+ type ExecutionReferenceKind = 'op' | 'routine' | 'routine_tick' | 'trigger_run' | 'dataplane_run' | 'queue_job' | 'execution_event' | 'replay_run' | 'unknown';
2848
+ interface ExecutionReference {
2849
+ kind: ExecutionReferenceKind;
2850
+ id: string;
2851
+ original: string;
2852
+ label: string;
2853
+ query_field: string;
2854
+ status_command?: string;
2855
+ replay_command?: string;
2856
+ }
2857
+ interface ExecutionReferenceInput {
2858
+ id: string;
2859
+ kind?: ExecutionReferenceKind;
2860
+ source_field?: string;
2861
+ }
2862
+ declare function normalizeExecutionReference(input: string | ExecutionReferenceInput): ExecutionReference;
2863
+ declare function collectExecutionReferences(payload: Record<string, unknown>): ExecutionReference[];
2864
+
2865
+ type OpsCadence = 'hourly' | 'daily' | 'weekly' | 'manual';
2866
+ type OpsRoutineStatus = 'draft' | 'active' | 'paused' | 'archived' | 'failed';
2867
+ type OpsSinkType = 'csv' | 'webhook' | 'airbyte' | 'nango' | 'slack' | 'google_sheets' | 'notion' | 'instantly' | 'routine';
2868
+ type OpsBlueprint = 'monitor_companies' | 'build_leads' | 'enrich_list' | 'route_signals' | 'launch_campaign';
2869
+ type SimpleOpStatus = 'draft' | 'ready' | 'running' | 'blocked' | 'needs_approval' | 'completed' | 'failed';
2870
+ type OpsPrimitivePermissionLevel = 'read' | 'write' | 'spend' | 'admin';
2871
+ type OpsPrimitiveWorkspaceScope = 'required';
2872
+ interface OpsPrimitiveRetryPolicy {
2873
+ max_retries: number;
2874
+ maxRetries?: number;
2875
+ initial_delay_ms: number;
2876
+ initialDelayMs?: number;
2877
+ max_delay_ms: number;
2878
+ maxDelayMs?: number;
2879
+ backoff_multiplier: number;
2880
+ backoffMultiplier?: number;
2881
+ jitter: boolean;
2882
+ retryable_errors: string[];
2883
+ retryableErrors?: string[];
2884
+ respect_retry_after: boolean;
2885
+ respectRetryAfter?: boolean;
2886
+ }
2887
+ interface OpsPrimitiveConcurrencyPolicy {
2888
+ workspace_key: string;
2889
+ workspaceKey?: string;
2890
+ provider_key?: string;
2891
+ providerKey?: string;
2892
+ max_concurrency: number;
2893
+ maxConcurrency?: number;
2894
+ }
2895
+ interface OpsPrimitiveDeadLetterPolicy {
2896
+ enabled: boolean;
2897
+ queue: string;
2898
+ include_input_hash: boolean;
2899
+ includeInputHash?: boolean;
2900
+ include_execution_refs: boolean;
2901
+ includeExecutionRefs?: boolean;
2902
+ }
2903
+ interface OpsPrimitiveObservabilityPolicy {
2904
+ emits_execution_refs: boolean;
2905
+ emitsExecutionRefs?: boolean;
2906
+ emits_progress_events: boolean;
2907
+ emitsProgressEvents?: boolean;
2908
+ event_fields: string[];
2909
+ eventFields?: string[];
2910
+ }
2911
+ interface OpsPrimitive {
2912
+ id: string;
2913
+ version: string;
2914
+ capability: string;
2915
+ permission_level: OpsPrimitivePermissionLevel;
2916
+ permissionLevel?: OpsPrimitivePermissionLevel;
2917
+ workspace_scope: OpsPrimitiveWorkspaceScope;
2918
+ workspaceScope?: OpsPrimitiveWorkspaceScope;
2919
+ input_schema: Record<string, unknown>;
2920
+ inputSchema?: Record<string, unknown>;
2921
+ output_schema: Record<string, unknown>;
2922
+ outputSchema?: Record<string, unknown>;
2923
+ retry_policy: OpsPrimitiveRetryPolicy;
2924
+ retryPolicy?: OpsPrimitiveRetryPolicy;
2925
+ concurrency_policy: OpsPrimitiveConcurrencyPolicy;
2926
+ concurrencyPolicy?: OpsPrimitiveConcurrencyPolicy;
2927
+ rate_limit_key?: string;
2928
+ rateLimitKey?: string;
2929
+ idempotency_key_fields: string[];
2930
+ idempotencyKeyFields?: string[];
2931
+ dead_letter_policy: OpsPrimitiveDeadLetterPolicy;
2932
+ deadLetterPolicy?: OpsPrimitiveDeadLetterPolicy;
2933
+ observability: OpsPrimitiveObservabilityPolicy;
2934
+ }
2935
+ interface OpsSink {
2936
+ id?: string;
2937
+ sinkId?: string;
2938
+ sink_id?: string;
2939
+ connectionId?: string;
2940
+ connection_id?: string;
2941
+ type: OpsSinkType;
2942
+ name?: string;
2943
+ connectorId?: string;
2944
+ connector_id?: string;
2945
+ connectorName?: string;
2946
+ connector_name?: string;
2947
+ category?: string;
2948
+ status?: string;
2949
+ syncStatus?: string | null;
2950
+ sync_status?: string | null;
2951
+ lastSyncedAt?: string | null;
2952
+ last_synced_at?: string | null;
2953
+ config?: Record<string, unknown>;
2954
+ deliveryMode?: string;
2955
+ delivery_mode?: string;
2956
+ providerConfigKey?: string;
2957
+ provider_config_key?: string;
2958
+ integrationId?: string;
2959
+ integration_id?: string;
2960
+ nangoConnectionId?: string;
2961
+ nango_connection_id?: string;
2962
+ actionName?: string;
2963
+ action_name?: string;
2964
+ nangoAction?: string;
2965
+ nango_action?: string;
2966
+ proxyPath?: string;
2967
+ proxy_path?: string;
2968
+ nangoProxyPath?: string;
2969
+ nango_proxy_path?: string;
2970
+ method?: string;
2971
+ httpMethod?: string;
2972
+ http_method?: string;
2973
+ fieldMap?: Record<string, unknown>;
2974
+ field_map?: Record<string, unknown>;
2975
+ requiredFields?: string[];
2976
+ required_fields?: string[];
2977
+ writeConfirmed?: boolean;
2978
+ write_confirmed?: boolean;
2979
+ agentWriteConfirmed?: boolean;
2980
+ agent_write_confirmed?: boolean;
2981
+ enabled?: boolean;
2982
+ }
2983
+ interface OpsRoutine {
2984
+ id?: string;
2985
+ routine_id?: string;
2986
+ routineId?: string;
2987
+ name?: string;
2988
+ goal?: string;
2989
+ cadence?: OpsCadence | string;
2990
+ status?: OpsRoutineStatus | string;
2991
+ lastTickAt?: string | null;
2992
+ last_tick_at?: string | null;
2993
+ nextTickAt?: string | null;
2994
+ next_tick_at?: string | null;
2995
+ outputSinks?: OpsSink[];
2996
+ output_sinks?: OpsSink[];
2997
+ execution_refs?: ExecutionReference[];
2998
+ [key: string]: unknown;
2999
+ }
3000
+ interface OpsRoutinesResult {
3001
+ routines: OpsRoutine[];
3002
+ total?: number;
3003
+ next_cursor?: string | null;
3004
+ nextCursor?: string | null;
3005
+ has_more?: boolean;
3006
+ hasMore?: boolean;
3007
+ }
3008
+ interface OpsRoutineTick {
3009
+ id?: string;
3010
+ tick_id?: string;
3011
+ tickId?: string;
3012
+ routine_id?: string;
3013
+ routineId?: string;
3014
+ status?: string;
3015
+ state?: string;
3016
+ started_at?: string | null;
3017
+ startedAt?: string | null;
3018
+ completed_at?: string | null;
3019
+ completedAt?: string | null;
3020
+ error_message?: string | null;
3021
+ errorMessage?: string | null;
3022
+ execution_refs?: ExecutionReference[];
3023
+ [key: string]: unknown;
3024
+ }
3025
+ interface OpsRoutineTicksResult {
3026
+ ticks: OpsRoutineTick[];
3027
+ items?: OpsRoutineTick[];
3028
+ next_cursor?: string | null;
3029
+ nextCursor?: string | null;
3030
+ has_more?: boolean;
3031
+ hasMore?: boolean;
3032
+ [key: string]: unknown;
3033
+ }
3034
+ interface OpsRoutineTickItem {
3035
+ id?: string;
3036
+ item_id?: string;
3037
+ itemId?: string;
3038
+ tick_id?: string;
3039
+ tickId?: string;
3040
+ routine_id?: string;
3041
+ routineId?: string;
3042
+ state?: string;
3043
+ status?: string;
3044
+ error_message?: string | null;
3045
+ errorMessage?: string | null;
3046
+ payload?: Record<string, unknown>;
3047
+ row?: Record<string, unknown>;
3048
+ execution_refs?: ExecutionReference[];
3049
+ [key: string]: unknown;
3050
+ }
3051
+ interface OpsRoutineTickItemsResult {
3052
+ items: OpsRoutineTickItem[];
3053
+ rows?: OpsRoutineTickItem[];
3054
+ next_cursor?: string | null;
3055
+ nextCursor?: string | null;
3056
+ has_more?: boolean;
3057
+ hasMore?: boolean;
3058
+ [key: string]: unknown;
3059
+ }
3060
+ interface OpsReadinessOptions {
3061
+ windowHours?: number;
3062
+ includeDetails?: boolean;
3063
+ runAcquisitionProbe?: boolean;
3064
+ }
3065
+ interface OpsReadinessCheck {
3066
+ id: string;
3067
+ label: string;
3068
+ status: 'pass' | 'warn' | 'fail';
3069
+ detail: string;
3070
+ next_action?: string;
3071
+ nextAction?: string;
3072
+ }
3073
+ interface OpsReadinessResult {
3074
+ status: 'ready' | 'degraded' | 'blocked';
3075
+ checked_at?: string;
3076
+ checkedAt: string;
3077
+ credits_used?: 0;
3078
+ creditsUsed: 0;
3079
+ credits_charged?: 0;
3080
+ creditsCharged: 0;
3081
+ summary: {
3082
+ active_connections?: number;
3083
+ activeConnections: number;
3084
+ failing_connections?: number;
3085
+ failingConnections: number;
3086
+ active_routines?: number;
3087
+ activeRoutines: number;
3088
+ recent_failed_ticks?: number;
3089
+ recentFailedTicks: number;
3090
+ queued_deliveries?: number;
3091
+ queuedDeliveries: number;
3092
+ pending_approvals?: number;
3093
+ pendingApprovals: number;
3094
+ lead_records?: number;
3095
+ leadRecords: number;
3096
+ recent_acquisition_failures?: number;
3097
+ recentAcquisitionFailures: number;
3098
+ acquisition_probe_status?: string;
3099
+ acquisitionProbeStatus?: string;
3100
+ };
3101
+ checks: OpsReadinessCheck[];
3102
+ next_actions?: string[];
3103
+ nextActions: string[];
3104
+ raw?: Record<string, unknown>;
3105
+ }
3106
+ interface OpsProofOptions {
3107
+ windowHours?: number;
3108
+ }
3109
+ interface OpsProofDestination {
3110
+ type: string;
3111
+ label: string;
3112
+ connected: boolean;
3113
+ healthy: boolean;
3114
+ delivered: number;
3115
+ failed: number;
3116
+ proof: 'verified' | 'connected' | 'needs_attention' | 'not_connected' | string;
3117
+ }
3118
+ interface OpsProofResult {
3119
+ success?: boolean;
3120
+ status: 'ready' | 'partial' | 'unproven' | 'blocked' | string;
3121
+ proof_state?: string;
3122
+ proofState?: string;
3123
+ phase?: string;
3124
+ checked_at?: string;
3125
+ checkedAt?: string;
3126
+ window_hours?: number;
3127
+ windowHours?: number;
3128
+ label: string;
3129
+ ui_summary?: string;
3130
+ uiSummary?: string;
3131
+ founder_verdict?: string;
3132
+ founderVerdict?: string;
3133
+ description?: string;
3134
+ summary: {
3135
+ connected_destinations?: number;
3136
+ connectedDestinations: number;
3137
+ healthy_destinations?: number;
3138
+ healthyDestinations: number;
3139
+ failing_destinations?: number;
3140
+ failingDestinations: number;
3141
+ deliveries_30d?: number;
3142
+ deliveries30d: number;
3143
+ delivered_30d?: number;
3144
+ delivered30d: number;
3145
+ failed_30d?: number;
3146
+ failed30d: number;
3147
+ external_delivered_30d?: number;
3148
+ externalDelivered30d: number;
3149
+ nango_proofs_30d?: number;
3150
+ nangoProofs30d: number;
3151
+ nango_failures_30d?: number;
3152
+ nangoFailures30d: number;
3153
+ airbyte_configured?: number;
3154
+ airbyteConfigured: number;
3155
+ airbyte_proofs_30d?: number;
3156
+ airbyteProofs30d: number;
3157
+ airbyte_failures_30d?: number;
3158
+ airbyteFailures30d: number;
3159
+ };
3160
+ destinations: OpsProofDestination[];
3161
+ blockers?: string[];
3162
+ next_action?: string;
3163
+ nextAction?: string;
3164
+ next_actions?: string[];
3165
+ nextActions?: string[];
3166
+ estimated_credits?: number;
3167
+ estimatedCredits?: number;
3168
+ approval_required?: boolean;
3169
+ approvalRequired?: boolean;
3170
+ credits_charged?: 0;
3171
+ creditsCharged?: 0;
3172
+ proof_mode?: boolean;
3173
+ proofMode?: boolean;
3174
+ query_errors?: string[];
3175
+ queryErrors?: string[];
3176
+ raw?: Record<string, unknown>;
3177
+ }
3178
+ interface OpsAutopilotOptions {
3179
+ windowHours?: number;
3180
+ }
3181
+ interface OpsAutopilotStep {
3182
+ tool: string;
3183
+ purpose?: string;
3184
+ arguments?: Record<string, unknown>;
3185
+ }
3186
+ interface OpsAutopilotSchedulePacket {
3187
+ cadence: OpsCadence | string;
3188
+ recurrence: string;
3189
+ activate_with: string;
3190
+ activateWith?: string;
3191
+ run_now_with: string;
3192
+ runNowWith?: string;
3193
+ monitor_with: string;
3194
+ monitorWith?: string;
3195
+ retrieve_with: string;
3196
+ retrieveWith?: string;
3197
+ }
3198
+ interface OpsAutopilotNangoRoutePacket {
3199
+ enabled: boolean;
3200
+ route_label: string;
3201
+ routeLabel?: string;
3202
+ connect_tool: string;
3203
+ connectTool?: string;
3204
+ discover_tool: string;
3205
+ discoverTool?: string;
3206
+ dry_run_tool: string;
3207
+ dryRunTool?: string;
3208
+ execute_tool: string;
3209
+ executeTool?: string;
3210
+ execute_and_wait_tool?: string;
3211
+ executeAndWaitTool?: string;
3212
+ schedule_tool?: string;
3213
+ scheduleTool?: string;
3214
+ schedule_and_wait_tool?: string;
3215
+ scheduleAndWaitTool?: string;
3216
+ result_tool: string;
3217
+ resultTool?: string;
3218
+ write_gate: string;
3219
+ writeGate?: string;
3220
+ required_fields: string[];
3221
+ requiredFields?: string[];
3222
+ placeholders: Record<string, string>;
3223
+ dry_run_arguments: Record<string, unknown>;
3224
+ dryRunArguments?: Record<string, unknown>;
3225
+ execute_arguments: Record<string, unknown>;
3226
+ executeArguments?: Record<string, unknown>;
3227
+ execute_and_wait_arguments?: Record<string, unknown>;
3228
+ executeAndWaitArguments?: Record<string, unknown>;
3229
+ schedule_arguments?: Record<string, unknown>;
3230
+ scheduleArguments?: Record<string, unknown>;
3231
+ schedule_and_wait_arguments?: Record<string, unknown>;
3232
+ scheduleAndWaitArguments?: Record<string, unknown>;
3233
+ result_arguments: Record<string, unknown>;
3234
+ resultArguments?: Record<string, unknown>;
3235
+ }
3236
+ interface OpsAutopilotResultPacket {
3237
+ retrieve_tool: string;
3238
+ retrieveTool?: string;
3239
+ result_shape: string[];
3240
+ resultShape?: string[];
3241
+ delivery_receipts: string[];
3242
+ deliveryReceipts?: string[];
3243
+ empty_result_recovery: string;
3244
+ emptyResultRecovery?: string;
3245
+ }
3246
+ interface OpsAutopilotOperatingPacket {
3247
+ north_star: string;
3248
+ northStar?: string;
3249
+ schedule: OpsAutopilotSchedulePacket;
3250
+ nango_route?: OpsAutopilotNangoRoutePacket;
3251
+ nangoRoute?: OpsAutopilotNangoRoutePacket;
3252
+ result_contract: OpsAutopilotResultPacket;
3253
+ resultContract?: OpsAutopilotResultPacket;
3254
+ approval_boundaries: string[];
3255
+ approvalBoundaries?: string[];
3256
+ saved_command_hint: string;
3257
+ savedCommandHint?: string;
3258
+ }
3259
+ interface OpsAutopilotMotion {
3260
+ id: string;
3261
+ blueprint: OpsBlueprint;
3262
+ title: string;
3263
+ outcome: string;
3264
+ prompt: string;
3265
+ target_count: number;
3266
+ targetCount?: number;
3267
+ cadence: OpsCadence | string;
3268
+ destinations: OpsSinkType[];
3269
+ estimated_credits: number;
3270
+ estimatedCredits?: number;
3271
+ proof_gate?: string;
3272
+ proofGate?: string;
3273
+ why_now?: string;
3274
+ whyNow?: string;
3275
+ agent_prompt?: string;
3276
+ agentPrompt?: string;
3277
+ cli_command?: string;
3278
+ cliCommand?: string;
3279
+ mcp_sequence?: OpsAutopilotStep[];
3280
+ mcpSequence?: OpsAutopilotStep[];
3281
+ operating_packet?: OpsAutopilotOperatingPacket;
3282
+ operatingPacket?: OpsAutopilotOperatingPacket;
3283
+ }
3284
+ interface OpsAutopilotResult {
3285
+ success?: boolean;
3286
+ status?: string;
3287
+ phase?: string;
3288
+ stage: string;
3289
+ headline: string;
3290
+ verdict: string;
3291
+ next_action: string;
3292
+ nextAction?: string;
3293
+ primary_motion: OpsAutopilotMotion;
3294
+ primaryMotion?: OpsAutopilotMotion;
3295
+ motions: OpsAutopilotMotion[];
3296
+ scale_rule?: string;
3297
+ scaleRule?: string;
3298
+ agent_handoff?: string;
3299
+ agentHandoff?: string;
3300
+ operating_packet?: OpsAutopilotOperatingPacket;
3301
+ operatingPacket?: OpsAutopilotOperatingPacket;
3302
+ proof_state?: string;
3303
+ proofState?: string;
3304
+ proof_summary?: Record<string, unknown>;
3305
+ proofSummary?: Record<string, unknown>;
3306
+ next_step?: Record<string, unknown>;
3307
+ nextStep?: Record<string, unknown>;
3308
+ query_errors?: string[];
3309
+ queryErrors?: string[];
3310
+ credits_charged?: 0;
3311
+ creditsCharged?: 0;
2878
3312
  }
2879
- interface GtmBrainLearningEvidenceCounts {
2880
- feedback_events?: number;
2881
- deliverability_events?: number;
2882
- failure_events?: number;
2883
- positive_events?: number;
2884
- event_type_counts?: UnknownRecord;
2885
- classification_counts?: UnknownRecord;
2886
- memory_items?: number;
2887
- memory_sample_size?: number;
2888
- workspace_patterns?: number;
2889
- workspace_calibrations?: number;
2890
- global_patterns?: number;
2891
- global_calibrations?: number;
2892
- opted_in_workspaces?: number;
3313
+ interface CreateRoutineRequest {
3314
+ name: string;
3315
+ goal: string;
3316
+ description?: string;
3317
+ cadence?: OpsCadence;
3318
+ timezone?: string;
3319
+ status?: Extract<OpsRoutineStatus, 'draft' | 'active' | 'paused'>;
3320
+ policy?: Record<string, unknown>;
3321
+ output_sinks?: OpsSink[];
3322
+ outputSinks?: OpsSink[];
3323
+ wake_on_events?: string[];
3324
+ wakeOnEvents?: string[];
2893
3325
  }
2894
- interface GtmBrainLearningPhaseStatus {
2895
- phase: GtmBrainLearningCyclePhase | string;
2896
- ready: boolean;
2897
- blocked_by?: string[];
3326
+ interface UpdateRoutineRequest extends Partial<CreateRoutineRequest> {
3327
+ routine_id?: string;
3328
+ routineId?: string;
2898
3329
  }
2899
- interface GtmBrainLearningPhaseReadiness {
2900
- ready: boolean;
2901
- blocked_by: string[];
3330
+ interface RunRoutineRequest {
3331
+ routine_id?: string;
3332
+ routineId?: string;
3333
+ instruction?: string;
3334
+ force?: boolean;
3335
+ }
3336
+ interface OpsRoutineRunResult {
3337
+ success?: boolean;
3338
+ routine_id?: string;
3339
+ routineId?: string;
3340
+ tick_id?: string;
3341
+ tickId?: string;
3342
+ run_id?: string | null;
3343
+ runId?: string | null;
3344
+ status?: string;
3345
+ state?: string;
3346
+ next_action?: string;
3347
+ nextAction?: string;
3348
+ execution_refs?: ExecutionReference[];
3349
+ [key: string]: unknown;
3350
+ }
3351
+ interface OpsRoutineDeleteResult {
3352
+ success?: boolean;
3353
+ routine_id?: string;
3354
+ routineId?: string;
3355
+ deleted?: boolean;
3356
+ permanent?: boolean;
3357
+ status?: string;
3358
+ next_action?: string;
3359
+ nextAction?: string;
3360
+ execution_refs?: ExecutionReference[];
3361
+ [key: string]: unknown;
3362
+ }
3363
+ interface OpsRoutineSinkResult {
3364
+ success?: boolean;
3365
+ routine_id?: string;
3366
+ routineId?: string;
3367
+ sink_id?: string;
3368
+ sinkId?: string;
3369
+ status?: string;
3370
+ next_action?: string;
3371
+ nextAction?: string;
3372
+ routine?: OpsRoutine;
3373
+ sink?: OpsSink;
3374
+ execution_refs?: ExecutionReference[];
3375
+ [key: string]: unknown;
3376
+ }
3377
+ interface ListOutputSinksOptions {
3378
+ status?: string;
3379
+ category?: string;
3380
+ include_inactive?: boolean;
3381
+ includeInactive?: boolean;
3382
+ }
3383
+ interface CreateOutputSinkRequest {
3384
+ type: Exclude<OpsSinkType, 'routine'>;
3385
+ name?: string;
3386
+ connection_id?: string;
3387
+ connectionId?: string;
3388
+ config?: Record<string, unknown>;
3389
+ webhook_url?: string;
3390
+ webhookUrl?: string;
3391
+ }
3392
+ interface OpsApproveRequest {
3393
+ token_id?: string;
3394
+ tokenId?: string;
3395
+ token_ids?: string[];
3396
+ tokenIds?: string[];
3397
+ decision?: 'approved' | 'rejected';
3398
+ reviewer_notes?: string;
3399
+ reviewerNotes?: string;
3400
+ }
3401
+ interface OpsApproveResult {
3402
+ success: boolean;
3403
+ decision?: 'approved' | 'rejected' | string;
3404
+ token_id?: string;
3405
+ tokenId?: string;
3406
+ token_ids?: string[];
3407
+ tokenIds?: string[];
3408
+ reviewer_notes?: string;
3409
+ reviewerNotes?: string;
3410
+ [key: string]: unknown;
3411
+ }
3412
+ interface OpsExecutionToolCall {
3413
+ tool: string;
3414
+ arguments: Record<string, unknown>;
3415
+ purpose: string;
3416
+ }
3417
+ interface OpsExecutionScheduleContract {
3418
+ create_tool: string;
3419
+ createTool?: string;
3420
+ activate_tool: string;
3421
+ activateTool?: string;
3422
+ cadence: OpsCadence | string;
3423
+ recurrence: string;
3424
+ wake_on_events: string[];
3425
+ wakeOnEvents?: string[];
3426
+ }
3427
+ interface OpsExecutionApprovalContract {
3428
+ required: boolean;
3429
+ tool: string;
3430
+ reason: string;
3431
+ }
3432
+ interface OpsExecutionMonitorContract {
3433
+ status_tool: string;
3434
+ statusTool?: string;
3435
+ wait_tool?: string;
3436
+ waitTool?: string;
3437
+ results_tool: string;
3438
+ resultsTool?: string;
3439
+ poll_after_ms: number;
3440
+ pollAfterMs?: number;
3441
+ }
3442
+ interface OpsExecutionResultContract {
3443
+ tool: string;
3444
+ wait_tool?: string;
3445
+ waitTool?: string;
3446
+ shape: string[];
3447
+ empty_result_recovery: string;
3448
+ emptyResultRecovery?: string;
3449
+ }
3450
+ interface OpsExecutionNangoRouteContract {
3451
+ enabled: boolean;
3452
+ connect_tool: string;
3453
+ connectTool?: string;
3454
+ discover_tool: string;
3455
+ discoverTool?: string;
3456
+ dry_run_tool: string;
3457
+ dryRunTool?: string;
3458
+ execute_tool: string;
3459
+ executeTool?: string;
3460
+ execute_and_wait_tool?: string;
3461
+ executeAndWaitTool?: string;
3462
+ schedule_tool?: string;
3463
+ scheduleTool?: string;
3464
+ schedule_and_wait_tool?: string;
3465
+ scheduleAndWaitTool?: string;
3466
+ result_tool: string;
3467
+ resultTool?: string;
3468
+ write_gate: string;
3469
+ writeGate?: string;
3470
+ required_fields: string[];
3471
+ requiredFields?: string[];
3472
+ schedule_arguments?: Record<string, unknown>;
3473
+ scheduleArguments?: Record<string, unknown>;
3474
+ schedule_and_wait_arguments?: Record<string, unknown>;
3475
+ scheduleAndWaitArguments?: Record<string, unknown>;
3476
+ }
3477
+ interface OpsExecutionContract {
3478
+ mode: 'run_once' | 'recurring' | 'event_driven' | string;
3479
+ run_now: OpsExecutionToolCall;
3480
+ runNow?: OpsExecutionToolCall;
3481
+ schedule: OpsExecutionScheduleContract;
3482
+ approval: OpsExecutionApprovalContract;
3483
+ monitor: OpsExecutionMonitorContract;
3484
+ result_contract: OpsExecutionResultContract;
3485
+ resultContract?: OpsExecutionResultContract;
3486
+ nango_route?: OpsExecutionNangoRouteContract;
3487
+ nangoRoute?: OpsExecutionNangoRouteContract;
3488
+ sequence: OpsExecutionToolCall[];
3489
+ }
3490
+ interface OpsPlanRequest {
3491
+ prompt: string;
3492
+ blueprint?: OpsBlueprint;
3493
+ target_count?: number;
3494
+ targetCount?: number;
3495
+ cadence?: OpsCadence;
3496
+ wake_on_events?: string[];
3497
+ wakeOnEvents?: string[];
3498
+ destinations?: Array<Record<string, unknown>>;
3499
+ company_domains?: string[];
3500
+ companyDomains?: string[];
3501
+ custom_ai_prompt?: string;
3502
+ customAiPrompt?: string;
3503
+ signal_prompt?: string;
3504
+ signalPrompt?: string;
3505
+ output_prompt?: string;
3506
+ outputPrompt?: string;
3507
+ }
3508
+ interface OpsPlanResult {
3509
+ plan_id: string;
3510
+ planId?: string;
3511
+ blueprint: OpsBlueprint;
3512
+ title: string;
3513
+ goal: string;
3514
+ target_count: number;
3515
+ targetCount?: number;
3516
+ cadence: OpsCadence;
3517
+ status: SimpleOpStatus | string;
3518
+ estimated_credits: number;
3519
+ estimatedCredits?: number;
3520
+ approval_required: boolean;
3521
+ approvalRequired?: boolean;
3522
+ destinations: Array<Record<string, unknown>>;
3523
+ blockers: string[];
3524
+ expected_output?: string;
3525
+ expectedOutput?: string;
3526
+ next_action: string;
3527
+ nextAction?: string;
3528
+ ui_summary?: string;
3529
+ uiSummary?: string;
3530
+ review_steps?: Array<{
3531
+ label: string;
3532
+ value: string;
3533
+ status?: string;
3534
+ }>;
3535
+ reviewSteps?: Array<{
3536
+ label: string;
3537
+ value: string;
3538
+ status?: string;
3539
+ }>;
3540
+ fix_actions?: string[];
3541
+ fixActions?: string[];
3542
+ destination_status?: string;
3543
+ destinationStatus?: string;
3544
+ customization?: {
3545
+ custom_ai_prompt?: string;
3546
+ signal_prompt?: string;
3547
+ output_prompt?: string;
3548
+ [key: string]: unknown;
3549
+ };
3550
+ primitive_graph?: OpsPrimitive[];
3551
+ primitiveGraph?: OpsPrimitive[];
3552
+ execution_contract?: OpsExecutionContract;
3553
+ executionContract?: OpsExecutionContract;
3554
+ advanced?: Record<string, unknown>;
3555
+ }
3556
+ interface OpsCreateRequest extends OpsPlanRequest {
3557
+ name?: string;
3558
+ description?: string;
3559
+ policy?: Record<string, unknown>;
3560
+ timezone?: string;
3561
+ activate?: boolean;
3562
+ confirm_spend?: boolean;
3563
+ confirmSpend?: boolean;
3564
+ }
3565
+ interface OpsExecuteRequest extends OpsCreateRequest {
3566
+ auto_run?: boolean;
3567
+ autoRun?: boolean;
3568
+ dry_run?: boolean;
3569
+ dryRun?: boolean;
3570
+ output_format?: 'markdown' | 'json';
3571
+ outputFormat?: 'markdown' | 'json';
3572
+ }
3573
+ interface OpsCreateResult {
3574
+ success: boolean;
3575
+ op_id: string;
3576
+ opId?: string;
3577
+ routine_id?: string;
3578
+ routineId?: string;
3579
+ run_id?: string | null;
3580
+ runId?: string | null;
3581
+ status: SimpleOpStatus | string;
3582
+ phase: string;
3583
+ next_action: string;
3584
+ nextAction?: string;
3585
+ results_count: number;
3586
+ resultsCount?: number;
3587
+ results_url?: string;
3588
+ resultsUrl?: string;
3589
+ delivery_status?: string;
3590
+ deliveryStatus?: string;
3591
+ estimated_credits?: number;
3592
+ estimatedCredits?: number;
3593
+ error_code?: string;
3594
+ errorCode?: string;
3595
+ approval?: Record<string, unknown>;
3596
+ approval_required?: boolean;
3597
+ approvalRequired?: boolean;
3598
+ retry_arguments?: Record<string, unknown>;
3599
+ retryArguments?: Record<string, unknown>;
3600
+ blockers?: string[];
3601
+ plan?: OpsPlanResult;
3602
+ next_step?: Record<string, unknown>;
3603
+ nextStep?: Record<string, unknown>;
3604
+ next_steps?: Array<Record<string, unknown>>;
3605
+ nextSteps?: Array<Record<string, unknown>>;
3606
+ execution_refs?: ExecutionReference[];
2902
3607
  }
2903
- interface GtmBrainLearningAction {
2904
- tool: string;
2905
- arguments?: UnknownRecord;
2906
- reason?: string;
3608
+ interface OpsExecuteResult extends OpsCreateResult {
3609
+ error_code?: string;
3610
+ errorCode?: string;
3611
+ approval?: Record<string, unknown>;
3612
+ approval_required?: boolean;
3613
+ approvalRequired?: boolean;
3614
+ retry_arguments?: Record<string, unknown>;
3615
+ retryArguments?: Record<string, unknown>;
3616
+ next_step?: Record<string, unknown>;
3617
+ nextStep?: Record<string, unknown>;
3618
+ next_steps?: Array<Record<string, unknown>>;
3619
+ nextSteps?: Array<Record<string, unknown>>;
3620
+ blockers?: string[];
2907
3621
  }
2908
- interface GtmBrainLearningRecommendedToolCall extends GtmBrainLearningAction {
2909
- step?: number;
2910
- phase?: GtmBrainLearningCyclePhase | string;
2911
- ready?: boolean;
2912
- blocked_by?: string[];
3622
+ interface OpsRunOptions {
3623
+ op_id?: string;
3624
+ opId?: string;
3625
+ instruction?: string;
3626
+ force?: boolean;
2913
3627
  }
2914
- interface GtmCampaignLearningStatusResult {
2915
- workspace_id?: string;
2916
- learning_stage?: string;
2917
- ready?: boolean;
2918
- outcome_learning_ready?: boolean;
2919
- campaign?: {
2920
- id?: string;
2921
- name?: string;
2922
- status?: string;
2923
- source?: string;
2924
- campaign_build_id?: string | null;
2925
- updated_at?: string;
2926
- } | null;
2927
- campaign_build?: {
2928
- id?: string;
2929
- name?: string;
2930
- status?: string;
2931
- requested_target_count?: number;
2932
- planned_target_count?: number;
2933
- completed_at?: string | null;
2934
- updated_at?: string | null;
2935
- } | null;
2936
- evidence_counts?: GtmBrainLearningEvidenceCounts;
2937
- learning_lanes?: GtmBrainLearningLane[];
2938
- lane_summary?: GtmBrainLearningLaneSummary;
2939
- feedback_brain_cycle?: UnknownRecord;
2940
- thresholds?: UnknownRecord;
2941
- phases?: GtmBrainLearningPhaseStatus[];
2942
- ready_phases?: Array<GtmBrainLearningCyclePhase | string>;
2943
- learning_cycle_plan_args?: UnknownRecord;
2944
- learning_cycle_run_args?: UnknownRecord | null;
2945
- last_learning_cycle_receipt?: UnknownRecord | null;
2946
- recent_brain_log?: UnknownRecord[];
2947
- blockers?: string[];
2948
- warnings?: string[];
2949
- next_actions?: GtmBrainLearningAction[];
2950
- execution_policy?: string;
2951
- privacy_policy?: string;
3628
+ interface OpsRunResult {
3629
+ success: boolean;
3630
+ op_id: string;
3631
+ opId?: string;
3632
+ routine_id?: string;
3633
+ routineId?: string;
3634
+ run_id?: string | null;
3635
+ runId?: string | null;
3636
+ status: SimpleOpStatus | string;
3637
+ phase: string;
3638
+ next_action: string;
3639
+ nextAction?: string;
3640
+ results_count?: number;
3641
+ resultsCount?: number;
3642
+ results_url?: string;
3643
+ resultsUrl?: string;
3644
+ delivery_status?: string;
3645
+ deliveryStatus?: string;
3646
+ execution_refs?: ExecutionReference[];
2952
3647
  }
2953
- interface GtmBrainLearningCyclePlanResult {
2954
- cycle?: UnknownRecord;
2955
- evidence_counts?: GtmBrainLearningEvidenceCounts;
2956
- readiness?: Record<string, GtmBrainLearningPhaseReadiness>;
2957
- learning_lanes?: GtmBrainLearningLane[];
2958
- lane_summary?: GtmBrainLearningLaneSummary;
2959
- recommended_tool_calls?: GtmBrainLearningRecommendedToolCall[];
2960
- next_ready_tools?: string[];
2961
- queued_runner_tool?: string;
2962
- execution_policy?: string;
2963
- privacy_policy?: string;
3648
+ interface OpsStatusOptions {
3649
+ op_id?: string;
3650
+ opId?: string;
2964
3651
  }
2965
- interface GtmBrainLearningCycleRunInput extends GtmBrainLearningCyclePlanInput {
2966
- phases?: GtmBrainLearningCyclePhase[];
2967
- continueOnError?: boolean;
3652
+ interface OpsStatusResult extends OpsRunResult {
3653
+ estimated_credits?: number | null;
3654
+ estimatedCredits?: number | null;
3655
+ latest_run?: Record<string, unknown> | null;
3656
+ latestRun?: Record<string, unknown> | null;
3657
+ diagnosis?: OpsDebugDiagnosis;
2968
3658
  }
2969
- interface GtmBrainExtractPatternsInput {
2970
- campaignId?: string;
2971
- days?: number;
2972
- patternTypes?: GtmPatternType[];
2973
- minSampleSize?: number;
2974
- includeMemory?: boolean;
2975
- writePatterns?: boolean;
2976
- dryRun?: boolean;
2977
- replaceExisting?: boolean;
3659
+ interface OpsResultsOptions {
3660
+ op_id?: string;
3661
+ opId?: string;
2978
3662
  limit?: number;
3663
+ cursor?: string;
3664
+ nextCursor?: string;
3665
+ state?: string;
3666
+ include_failed_runs?: boolean;
3667
+ includeFailedRuns?: boolean;
2979
3668
  }
2980
- interface GtmBrainAggregatePatternsInput {
2981
- days?: number;
2982
- patternTypes?: GtmPatternType[];
2983
- minWorkspaceCount?: number;
2984
- minPrivacyK?: number;
2985
- minConfidence?: number;
2986
- includeLowConfidence?: boolean;
2987
- writePatterns?: boolean;
2988
- dryRun?: boolean;
2989
- replaceExisting?: boolean;
2990
- limit?: number;
3669
+ interface OpsResultsSummary {
3670
+ label?: string;
3671
+ status?: string;
3672
+ phase?: string;
3673
+ results_count?: number;
3674
+ resultsCount?: number;
3675
+ results_total?: number | null;
3676
+ resultsTotal?: number | null;
3677
+ delivery_status?: string;
3678
+ deliveryStatus?: string;
3679
+ has_more?: boolean;
3680
+ hasMore?: boolean;
3681
+ next_cursor?: string | null;
3682
+ nextCursor?: string | null;
3683
+ results_url?: string;
3684
+ resultsUrl?: string;
3685
+ next_action?: string;
3686
+ nextAction?: string;
3687
+ run_id?: string | null;
3688
+ runId?: string | null;
3689
+ credits_used?: number;
3690
+ creditsUsed?: number;
3691
+ [key: string]: unknown;
2991
3692
  }
2992
- interface GtmBrainAggregateCalibrationsInput {
2993
- days?: number;
2994
- dimensionTypes?: GtmCalibrationDimensionType[];
2995
- minWorkspaceCount?: number;
2996
- minPrivacyK?: number;
2997
- minConfidence?: number;
2998
- includeLowConfidence?: boolean;
2999
- writeCalibrations?: boolean;
3000
- dryRun?: boolean;
3001
- replaceExisting?: boolean;
3002
- limit?: number;
3693
+ interface OpsResultsResult {
3694
+ success: boolean;
3695
+ op_id: string;
3696
+ opId?: string;
3697
+ routine_id?: string;
3698
+ routineId?: string;
3699
+ run_id?: string | null;
3700
+ runId?: string | null;
3701
+ status: SimpleOpStatus | string;
3702
+ phase: string;
3703
+ results_count: number;
3704
+ resultsCount?: number;
3705
+ results_total?: number | null;
3706
+ resultsTotal?: number | null;
3707
+ results: Array<Record<string, unknown>>;
3708
+ next_cursor?: string | null;
3709
+ nextCursor?: string | null;
3710
+ has_more: boolean;
3711
+ hasMore?: boolean;
3712
+ next_action: string;
3713
+ nextAction?: string;
3714
+ results_url?: string;
3715
+ resultsUrl?: string;
3716
+ delivery_status?: string;
3717
+ deliveryStatus?: string;
3718
+ summary?: OpsResultsSummary;
3719
+ execution_refs?: ExecutionReference[];
3003
3720
  }
3004
- interface GtmBrainCalibrateDeliverabilityInput {
3005
- campaignId?: string;
3006
- days?: number;
3007
- dimensionTypes?: GtmCalibrationDimensionType[];
3008
- minSampleSize?: number;
3009
- dryRun?: boolean;
3010
- writeCalibrations?: boolean;
3011
- writePatterns?: boolean;
3012
- replaceExisting?: boolean;
3013
- limit?: number;
3721
+ interface OpsWaitForResultsOptions extends OpsResultsOptions {
3722
+ interval_ms?: number;
3723
+ intervalMs?: number;
3724
+ max_polls?: number;
3725
+ maxPolls?: number;
3726
+ timeout_ms?: number;
3727
+ timeoutMs?: number;
3728
+ include_results?: boolean;
3729
+ includeResults?: boolean;
3014
3730
  }
3015
- interface GtmBrainDeliveryRiskInput {
3016
- campaignId?: string;
3017
- providerChain?: string[];
3018
- leadSource?: string;
3019
- targetIcp?: UnknownRecord;
3020
- leadSamples?: UnknownRecord[];
3021
- includeGlobal?: boolean;
3022
- minConfidence?: number;
3023
- limit?: number;
3731
+ interface OpsWaitForResultsPoll {
3732
+ poll: number;
3733
+ checked_at: string;
3734
+ checkedAt?: string;
3735
+ status: string;
3736
+ phase?: string;
3737
+ results_count?: number;
3738
+ resultsCount?: number;
3739
+ run_id?: string | null;
3740
+ runId?: string | null;
3741
+ next_action?: string;
3742
+ nextAction?: string;
3024
3743
  }
3025
- type GtmCalibrationDimensionType = 'email_domain' | 'email_provider' | 'verification_source' | 'lead_source' | 'provider_chain' | 'icp_shape' | 'copy_pattern' | 'other';
3026
- type GtmFailurePatternDimension = 'provider_chain' | 'provider' | 'icp_shape' | 'lead_source' | 'copy_pattern' | 'sequence_step' | 'email_domain';
3027
- interface GtmBrainFailurePatternsOptions {
3028
- campaignId?: string;
3029
- days?: number;
3030
- minSampleSize?: number;
3031
- dimensions?: GtmFailurePatternDimension[];
3032
- includeExistingPatterns?: boolean;
3033
- includeGlobal?: boolean;
3034
- limit?: number;
3744
+ interface OpsWaitForResultsResult {
3745
+ success: boolean;
3746
+ op_id: string;
3747
+ opId?: string;
3748
+ routine_id?: string;
3749
+ routineId?: string;
3750
+ run_id?: string | null;
3751
+ runId?: string | null;
3752
+ status: OpsStatusResult;
3753
+ results?: OpsResultsResult;
3754
+ timed_out: boolean;
3755
+ timedOut?: boolean;
3756
+ polls: number;
3757
+ max_polls?: number;
3758
+ maxPolls?: number;
3759
+ interval_ms?: number;
3760
+ intervalMs?: number;
3761
+ timeout_ms?: number;
3762
+ timeoutMs?: number;
3763
+ stop_reason?: string;
3764
+ stopReason?: string;
3765
+ history: OpsWaitForResultsPoll[];
3766
+ next_action?: string;
3767
+ nextAction?: string;
3768
+ execution_refs?: ExecutionReference[];
3769
+ [key: string]: unknown;
3035
3770
  }
3036
- interface GtmConnectionsListOptions {
3037
- kind?: 'all' | 'integrations' | 'mcp_servers';
3038
- includeDisconnected?: boolean;
3771
+ interface OpsRunAndWaitOptions extends OpsRunOptions, Omit<OpsWaitForResultsOptions, 'op_id' | 'opId'> {
3039
3772
  }
3040
- interface GtmProviderCatalogOptions {
3041
- providerId?: string;
3042
- layer?: GtmLayer;
3043
- includePlanned?: boolean;
3044
- includeLayerCatalog?: boolean;
3773
+ interface OpsRunAndWaitResult extends OpsWaitForResultsResult {
3774
+ run: OpsRunResult;
3775
+ execution_refs: ExecutionReference[];
3045
3776
  }
3046
- interface GtmCampaignStrategyTemplatesOptions {
3047
- strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
3048
- query?: string;
3049
- includeDetails?: boolean;
3777
+ interface OpsExecuteAndWaitOptions extends OpsExecuteRequest, Omit<OpsWaitForResultsOptions, 'op_id' | 'opId'> {
3050
3778
  }
3051
- type GtmCampaignStrategyTemplateSlug = 'industrial-ot-resilience' | 'non-medical-home-care' | 'agency-founder-led' | 'cloud-infrastructure-displacement';
3052
- interface GtmCampaignStartContextInput {
3053
- campaignId?: string;
3054
- campaignBuildId?: string;
3055
- campaignBrief?: string;
3056
- strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
3057
- targetIcp?: UnknownRecord;
3058
- leadCount?: number;
3059
- layers?: GtmLayer[];
3060
- preferredProviders?: string[];
3061
- memoryDimensionFilters?: UnknownRecord;
3062
- requireMemoryDimensionMatch?: boolean;
3063
- includeMemory?: boolean;
3064
- includeBrain?: boolean;
3065
- includeProviderRoutes?: boolean;
3066
- includeFailurePatterns?: boolean;
3067
- includeDeliveryRisk?: boolean;
3068
- includeGlobalBrain?: boolean;
3069
- includePlannedProviders?: boolean;
3070
- days?: number;
3071
- minConfidence?: number;
3072
- minSampleSize?: number;
3073
- limit?: number;
3779
+ interface OpsExecuteAndWaitResult extends OpsWaitForResultsResult {
3780
+ execute: OpsExecuteResult;
3781
+ run_id?: string | null;
3782
+ runId?: string | null;
3783
+ execution_refs: ExecutionReference[];
3074
3784
  }
3075
- interface GtmIntegrationsActivationStatusOptions {
3076
- campaignId?: string;
3077
- layer?: GtmLayer;
3078
- includePlanned?: boolean;
3079
- includeConnections?: boolean;
3785
+ interface OpsScheduleAndWaitOptions extends OpsCreateRequest, Omit<OpsRunAndWaitOptions, 'op_id' | 'opId'> {
3080
3786
  }
3081
- interface GtmCampaignBuildPlanInput {
3082
- campaignId?: string;
3083
- campaignBuildId?: string;
3084
- campaignBrief?: string;
3085
- strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
3086
- targetIcp?: UnknownRecord;
3087
- leadCount?: number;
3088
- layers?: GtmLayer[];
3089
- preferredProviders?: string[];
3090
- strategyModel?: 'strategy_template' | 'custom';
3091
- includeStrategyPatterns?: boolean;
3092
- includeWorkflowPatterns?: boolean;
3093
- /** @deprecated Use includeWorkflowPatterns. */
3094
- includeClayPatterns?: boolean;
3095
- includeNangoCatalog?: boolean;
3096
- partnerEcosystem?: string[];
3097
- memoryDimensionFilters?: UnknownRecord;
3098
- requireMemoryDimensionMatch?: boolean;
3099
- includeMemory?: boolean;
3100
- includeBrain?: boolean;
3101
- includeProviderRoutes?: boolean;
3102
- includeFailurePatterns?: boolean;
3103
- includePlannedProviders?: boolean;
3104
- days?: number;
3105
- limit?: number;
3787
+ interface OpsScheduleAndWaitResult extends OpsRunAndWaitResult {
3788
+ schedule: OpsCreateResult;
3789
+ run_id?: string | null;
3790
+ runId?: string | null;
3791
+ execution_refs: ExecutionReference[];
3106
3792
  }
3107
- interface GtmCampaignAgentPlanInput {
3108
- goal?: string;
3109
- campaignBrief?: string;
3110
- campaignName?: string;
3111
- campaignId?: string;
3112
- campaignBuildId?: string;
3113
- strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
3114
- operatingPlaybooks?: string[];
3115
- accountContext?: string;
3116
- targetIcp?: UnknownRecord;
3117
- targetCount?: number;
3118
- leadCount?: number;
3119
- builtIns?: Array<'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'signals' | (string & {})>;
3120
- useLocalLeads?: boolean;
3121
- layers?: GtmLayer[];
3122
- preferredProviders?: string[];
3123
- customTools?: UnknownRecord[];
3124
- integrations?: UnknownRecord[];
3125
- strategyModel?: 'strategy_template' | 'custom';
3126
- includeStrategyPatterns?: boolean;
3127
- includeWorkflowPatterns?: boolean;
3128
- includeNangoCatalog?: boolean;
3129
- partnerEcosystem?: string[];
3130
- memoryDimensionFilters?: UnknownRecord;
3131
- requireMemoryDimensionMatch?: boolean;
3132
- includeMemory?: boolean;
3133
- includeBrain?: boolean;
3134
- includeProviderRoutes?: boolean;
3135
- includeFailurePatterns?: boolean;
3136
- includeDeliveryRisk?: boolean;
3137
- includePlannedProviders?: boolean;
3138
- days?: number;
3139
- limit?: number;
3793
+ interface OpsTriggerRunStatus {
3794
+ success: boolean;
3795
+ run_id: string;
3796
+ runId?: string;
3797
+ status: string;
3798
+ output?: unknown;
3799
+ error?: unknown;
3800
+ costInCents?: number;
3801
+ baseCostInCents?: number;
3802
+ durationMs?: number;
3803
+ _note?: string;
3804
+ diagnosis?: OpsDebugDiagnosis;
3805
+ execution_refs?: ExecutionReference[];
3140
3806
  }
3141
- interface GtmCampaignAgentRequestTemplateInput {
3142
- goal?: string;
3143
- campaignBrief?: string;
3144
- campaignName?: string;
3145
- accountLabel?: string;
3146
- accountContext?: string;
3147
- strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
3148
- operatingPlaybooks?: string[];
3149
- targetIcp?: UnknownRecord;
3150
- targetCount?: number;
3151
- builtIns?: Array<'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'signals' | (string & {})>;
3152
- includeLocalLeads?: boolean;
3153
- includeByoPlaceholder?: boolean;
3154
- includeNangoCatalog?: boolean;
3155
- preferredProviders?: string[];
3156
- privacyMode?: 'workspace_only' | 'anonymized_patterns' | 'opt_in_network' | (string & {});
3157
- destinationType?: 'json' | 'csv' | 'webhook' | (string & {});
3807
+ interface OpsTriggerBatchRunStatus {
3808
+ success: boolean;
3809
+ runs: OpsTriggerRunStatus[];
3158
3810
  }
3159
- interface GtmCampaignStrategyMemoryStatusInput {
3160
- strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
3161
- query?: string;
3162
- campaignBrief?: string;
3163
- targetIcp?: UnknownRecord;
3164
- memoryDimensionFilters?: UnknownRecord;
3165
- requireMemoryDimensionMatch?: boolean;
3166
- includeSamples?: boolean;
3167
- includeSources?: boolean;
3168
- days?: number;
3811
+ type OpsTriggerRunStatusOptions = {
3812
+ run_id: string;
3813
+ runId?: never;
3814
+ run_ids?: never;
3815
+ runIds?: never;
3816
+ } | {
3817
+ runId: string;
3818
+ run_id?: never;
3819
+ run_ids?: never;
3820
+ runIds?: never;
3821
+ } | {
3822
+ run_ids: string[];
3823
+ run_id?: never;
3824
+ runId?: never;
3825
+ runIds?: never;
3826
+ } | {
3827
+ runIds: string[];
3828
+ run_id?: never;
3829
+ runId?: never;
3830
+ run_ids?: never;
3831
+ };
3832
+ interface OpsQueueStatusOptions {
3833
+ job_id?: string;
3834
+ jobId?: string;
3835
+ idempotency_key?: string;
3836
+ idempotencyKey?: string;
3837
+ summary?: boolean;
3838
+ }
3839
+ interface OpsQueueStatus {
3840
+ success: boolean;
3841
+ producer_envelope?: OpsQueueProducerEnvelope;
3842
+ producerEnvelope?: OpsQueueProducerEnvelope;
3843
+ queue?: {
3844
+ pending?: number;
3845
+ processing?: number;
3846
+ };
3847
+ summary?: {
3848
+ queue?: {
3849
+ pending?: number;
3850
+ processing?: number;
3851
+ completed_last_hour?: number;
3852
+ completedLastHour?: number;
3853
+ failed_last_hour?: number;
3854
+ failedLastHour?: number;
3855
+ pending_by_function?: Record<string, number>;
3856
+ pendingByFunction?: Record<string, number>;
3857
+ };
3858
+ providers?: Record<string, unknown>;
3859
+ provider_stats?: Record<string, unknown>;
3860
+ providerStats?: Record<string, unknown>;
3861
+ redis_status?: Record<string, unknown>;
3862
+ redisStatus?: Record<string, unknown>;
3863
+ recent_events?: Array<Record<string, unknown>>;
3864
+ recentEvents?: Array<Record<string, unknown>>;
3865
+ };
3866
+ job?: {
3867
+ id?: string;
3868
+ jobId?: string;
3869
+ status?: string;
3870
+ function_name?: string;
3871
+ functionName?: string;
3872
+ estimated_wait_ms?: number;
3873
+ estimatedWaitMs?: number;
3874
+ error_message?: string;
3875
+ errorMessage?: string;
3876
+ [key: string]: unknown;
3877
+ };
3878
+ error?: string;
3879
+ diagnosis?: OpsDebugDiagnosis;
3880
+ execution_refs?: ExecutionReference[];
3881
+ }
3882
+ interface OpsQueueProducerEnvelope {
3883
+ schema_version?: string;
3884
+ schemaVersion?: string;
3885
+ producer?: string;
3886
+ queue_name?: string;
3887
+ queueName?: string;
3888
+ status_source?: string;
3889
+ statusSource?: string;
3890
+ idempotency_key?: string | null;
3891
+ idempotencyKey?: string | null;
3892
+ job_id?: string | null;
3893
+ jobId?: string | null;
3894
+ summary_requested?: boolean;
3895
+ summaryRequested?: boolean;
3896
+ retry_after_ms?: number;
3897
+ retryAfterMs?: number;
3898
+ poll_after_seconds?: number;
3899
+ pollAfterSeconds?: number;
3900
+ emitted_at?: string;
3901
+ emittedAt?: string;
3902
+ [key: string]: unknown;
3903
+ }
3904
+ interface OpsReplayResult {
3905
+ success: boolean;
3906
+ replay_run_id: string;
3907
+ replayRunId?: string;
3908
+ original_run_id: string;
3909
+ originalRunId?: string;
3910
+ start_from_node: number;
3911
+ startFromNode?: number;
3912
+ total_nodes: number;
3913
+ totalNodes?: number;
3914
+ diagnosis?: OpsDebugDiagnosis;
3915
+ execution_refs?: ExecutionReference[];
3916
+ }
3917
+ interface OpsDashboardOptions {
3918
+ section?: 'summary' | 'functions' | 'workspaces' | 'timeseries' | 'sources' | 'recent';
3919
+ timeRangeDays?: number;
3920
+ granularity?: 'hour' | 'day' | 'week' | 'month';
3169
3921
  limit?: number;
3170
3922
  }
3171
- interface GtmCampaignBuildPlanCommitInput {
3172
- campaignId?: string;
3173
- campaignBuildId?: string;
3174
- name?: string;
3175
- campaignBrief?: string;
3176
- targetIcp?: UnknownRecord;
3177
- leadCount?: number;
3178
- layers?: GtmLayer[];
3179
- preferredProviders?: string[];
3180
- planSnapshot?: UnknownRecord;
3181
- sequences?: UnknownRecord[];
3182
- leadListRefs?: UnknownRecord[];
3183
- sendConfig?: UnknownRecord;
3184
- brainConfig?: UnknownRecord;
3185
- metadata?: UnknownRecord;
3186
- status?: Extract<GtmCampaignStatus, 'draft' | 'building' | 'ready'>;
3187
- approvalRequired?: boolean;
3188
- actorType?: GtmActorType;
3189
- actorId?: string;
3190
- rationale?: string;
3191
- idempotencyKey?: string;
3192
- dryRun?: boolean;
3193
- confirm?: boolean;
3194
- }
3195
- interface GtmCampaignBuildExecutionPrepareInput {
3196
- campaignId: string;
3197
- targetCount?: number;
3198
- allowDownscale?: boolean;
3199
- dryRun?: boolean;
3200
- confirmSpend?: boolean;
3201
- includeBrainContext?: boolean;
3202
- requireDeliveryRiskClearance?: boolean;
3203
- /** Output from gtm_brain_delivery_risk. When omitted, the MCP tool returns exact risk-check next-action args unless a stored campaign snapshot is available. */
3204
- deliveryRisk?: UnknownRecord;
3205
- dedupKeys?: ('email' | 'linkedin_url' | 'company_domain')[];
3206
- policy?: UnknownRecord;
3207
- signals?: UnknownRecord;
3208
- qualification?: UnknownRecord;
3209
- copy?: UnknownRecord;
3210
- delivery?: UnknownRecord;
3211
- enhancers?: UnknownRecord;
3923
+ interface OpsDashboardResult {
3924
+ today_executions?: number;
3925
+ todayExecutions?: number;
3926
+ today_credits?: number;
3927
+ todayCredits?: number;
3928
+ month_executions?: number;
3929
+ monthExecutions?: number;
3930
+ month_credits?: number;
3931
+ monthCredits?: number;
3932
+ avg_execution_time_ms?: number;
3933
+ avgExecutionTimeMs?: number;
3934
+ [key: string]: unknown;
3212
3935
  }
3213
- interface GtmProviderRecipePrepareInput {
3214
- providerId: string;
3215
- providerName?: string;
3216
- description?: string;
3217
- layerCapabilities?: GtmLayer[];
3218
- invocationType?: GtmInvocationType;
3219
- authStrategy?: GtmAuthStrategy;
3220
- endpointUrl?: string;
3221
- httpMethod?: string;
3222
- secretRef?: string;
3223
- workspaceIntegrationId?: string;
3224
- workspaceMcpServerId?: string;
3225
- workspaceConnectionId?: string;
3226
- requestTemplate?: UnknownRecord;
3227
- responseMapping?: UnknownRecord;
3228
- inputSchema?: UnknownRecord;
3229
- outputSchema?: UnknownRecord;
3230
- readiness?: UnknownRecord;
3231
- metadata?: UnknownRecord;
3232
- layer?: GtmLayer;
3233
- campaignId?: string;
3234
- useSignalizFallback?: boolean;
3235
- priority?: number;
3236
- status?: 'draft' | 'active' | 'needs_setup';
3237
- sampleRecords?: UnknownRecord[];
3238
- context?: UnknownRecord;
3936
+ interface OpsDebugOptions {
3937
+ op_id?: string;
3938
+ opId?: string;
3939
+ include_results?: boolean;
3940
+ includeResults?: boolean;
3941
+ results_limit?: number;
3942
+ resultsLimit?: number;
3943
+ include_queue?: boolean;
3944
+ includeQueue?: boolean;
3945
+ include_dashboard?: boolean;
3946
+ includeDashboard?: boolean;
3947
+ dashboard_limit?: number;
3948
+ dashboardLimit?: number;
3949
+ time_range_days?: number;
3950
+ timeRangeDays?: number;
3239
3951
  }
3240
- interface GtmClayWebhookPrepareInput {
3241
- endpointUrl?: string;
3242
- secretRef?: string;
3243
- layer?: Extract<GtmLayer, 'find_company' | 'find_people' | 'lead_generation' | 'company_enrichment' | 'copy_enrichment' | 'approval' | 'destination_export' | 'custom'>;
3244
- campaignId?: string;
3245
- useSignalizFallback?: boolean;
3246
- priority?: number;
3247
- status?: 'draft' | 'active' | 'needs_setup';
3248
- sampleRecords?: UnknownRecord[];
3249
- context?: UnknownRecord;
3952
+ interface OpsDebugDiagnosticError {
3953
+ step: string;
3954
+ message: string;
3250
3955
  }
3251
- interface GtmProviderRouteActivateInput {
3252
- providerId: string;
3253
- providerName?: string;
3254
- description?: string;
3255
- layer?: GtmLayer;
3256
- layers?: GtmLayer[];
3257
- campaignId?: string;
3258
- invocationType?: GtmInvocationType;
3259
- authStrategy?: GtmAuthStrategy;
3260
- endpointUrl?: string;
3261
- httpMethod?: string;
3262
- secretRef?: string;
3263
- workspaceIntegrationId?: string;
3264
- workspaceMcpServerId?: string;
3265
- workspaceConnectionId?: string;
3266
- useSignalizFallback?: boolean;
3267
- priority?: number;
3268
- routeConfig?: UnknownRecord;
3269
- requestTemplate?: UnknownRecord;
3270
- responseMapping?: UnknownRecord;
3271
- inputSchema?: UnknownRecord;
3272
- outputSchema?: UnknownRecord;
3273
- readiness?: UnknownRecord;
3274
- metadata?: UnknownRecord;
3275
- status?: 'draft' | 'active' | 'needs_setup' | 'paused' | 'archived' | 'failed';
3276
- routeStatus?: 'active' | 'paused' | 'archived' | 'failed';
3277
- replaceExistingRoutes?: boolean;
3278
- dryRun?: boolean;
3279
- confirm?: boolean;
3280
- sampleRecords?: UnknownRecord[];
3281
- context?: UnknownRecord;
3956
+ interface OpsDebugDiagnosis {
3957
+ state: 'healthy' | 'running' | 'failed' | 'degraded' | 'unknown';
3958
+ retryable: boolean;
3959
+ queue_pending: number;
3960
+ queuePending?: number;
3961
+ queue_processing: number;
3962
+ queueProcessing?: number;
3963
+ queue_failed_last_hour: number;
3964
+ queueFailedLastHour?: number;
3965
+ provider_pressure: 'none' | 'low' | 'medium' | 'high';
3966
+ providerPressure?: 'none' | 'low' | 'medium' | 'high';
3967
+ failed_run_count: number;
3968
+ failedRunCount?: number;
3969
+ primary_error?: string;
3970
+ primaryError?: string;
3971
+ summary: string;
3282
3972
  }
3283
- interface GtmConnectionRegisterInput {
3284
- connectionKind: 'mcp_server' | 'integration';
3285
- name: string;
3286
- serverUrl?: string;
3287
- authType?: 'none' | 'api_key' | 'bearer' | 'oauth';
3288
- authConfig?: UnknownRecord;
3289
- enabledTools?: string[];
3290
- presetId?: string;
3291
- vendorId?: string;
3292
- serviceCategory?: string;
3293
- connectionType?: string;
3294
- integrationId?: string;
3295
- providerConfigKey?: string;
3296
- allowedIntegrations?: string[];
3297
- surface?: 'settings_connections' | 'ops_destinations' | 'gtm_kernel';
3298
- source?: string;
3299
- userEmail?: string;
3300
- userDisplayName?: string;
3301
- status?: string;
3302
- metadata?: UnknownRecord;
3973
+ interface OpsDebugResult {
3974
+ success: boolean;
3975
+ op_id: string;
3976
+ opId?: string;
3977
+ checked_at: string;
3978
+ checkedAt?: string;
3979
+ diagnosis: OpsDebugDiagnosis;
3980
+ status: OpsStatusResult;
3981
+ execution_refs: ExecutionReference[];
3982
+ executionRefs?: ExecutionReference[];
3983
+ run_statuses: OpsTriggerRunStatus[];
3984
+ runStatuses?: OpsTriggerRunStatus[];
3985
+ queue?: OpsQueueStatus;
3986
+ dashboard_recent?: unknown;
3987
+ dashboardRecent?: unknown;
3988
+ results?: OpsResultsResult;
3989
+ replay_candidates: ExecutionReference[];
3990
+ replayCandidates?: ExecutionReference[];
3991
+ next_actions: string[];
3992
+ nextActions?: string[];
3993
+ diagnostic_errors: OpsDebugDiagnosticError[];
3994
+ diagnosticErrors?: OpsDebugDiagnosticError[];
3303
3995
  }
3304
- interface GtmIntegrationRecipeCreateInput {
3305
- providerId: string;
3306
- providerName: string;
3307
- description?: string;
3308
- layerCapabilities?: GtmLayer[];
3309
- invocationType: GtmInvocationType;
3310
- authStrategy?: GtmAuthStrategy;
3311
- workspaceIntegrationId?: string;
3312
- workspaceMcpServerId?: string;
3313
- workspaceConnectionId?: string;
3314
- endpointUrl?: string;
3315
- httpMethod?: string;
3316
- requestTemplate?: UnknownRecord;
3317
- responseMapping?: UnknownRecord;
3318
- inputSchema?: UnknownRecord;
3319
- outputSchema?: UnknownRecord;
3320
- readiness?: UnknownRecord;
3321
- metadata?: UnknownRecord;
3322
- status?: 'draft' | 'active' | 'needs_setup' | 'paused' | 'archived' | 'failed';
3996
+ interface OpsQuickstartStep {
3997
+ step: number;
3998
+ tool?: string;
3999
+ action?: string;
4000
+ arguments?: Record<string, unknown>;
4001
+ description: string;
4002
+ primitive_id?: string;
4003
+ primitiveId?: string;
4004
+ primitive_version?: string;
4005
+ primitiveVersion?: string;
3323
4006
  }
3324
- interface GtmLayerRouteSetInput {
3325
- layer: GtmLayer;
3326
- providerId: string;
3327
- campaignId?: string;
3328
- recipeId?: string;
3329
- priority?: number;
3330
- useSignalizFallback?: boolean;
3331
- routeConfig?: UnknownRecord;
3332
- status?: 'active' | 'paused' | 'archived' | 'failed';
4007
+ interface OpsQuickstartWorkflow {
4008
+ workflow_type: string;
4009
+ workflowType?: string;
4010
+ requested_workflow_type?: string;
4011
+ requestedWorkflowType?: string;
4012
+ name: string;
4013
+ description: string;
4014
+ credits_required: number;
4015
+ creditsRequired?: number;
4016
+ steps: OpsQuickstartStep[];
4017
+ primitive_graph?: OpsPrimitive[];
4018
+ primitiveGraph?: OpsPrimitive[];
4019
+ available_types: string[];
4020
+ availableTypes?: string[];
3333
4021
  }
3334
- interface GtmLayerRoutesGetOptions {
3335
- campaignId?: string;
3336
- layer?: GtmLayer;
4022
+ type OpsNangoConnectSessionCreateInput = GtmNangoConnectSessionCreateInput;
4023
+ type OpsNangoIntegrationFlowPrepareInput = GtmNangoIntegrationFlowPrepareInput;
4024
+ type OpsNangoToolsListOptions = GtmNangoToolsListOptions;
4025
+ type OpsNangoToolCallInput = GtmNangoToolCallInput;
4026
+ interface OpsNangoReadWriteProofOptions extends OpsNangoToolsListOptions {
4027
+ limit?: number;
4028
+ readProxyPath?: string;
4029
+ writeProxyPath?: string;
4030
+ method?: string;
4031
+ executeReadProbe?: boolean;
4032
+ executeWriteProbe?: boolean;
4033
+ confirm?: boolean;
4034
+ confirmWrite?: boolean;
4035
+ input?: Record<string, unknown>;
4036
+ writeInput?: Record<string, unknown>;
3337
4037
  }
3338
- interface GtmLayerRoutePreviewInput {
3339
- layer: GtmLayer;
3340
- campaignId?: string;
3341
- sampleRecords?: UnknownRecord[];
3342
- context?: UnknownRecord;
4038
+ type OpsNangoActionResultGetInput = GtmNangoActionResultGetInput;
4039
+ interface OpsNangoToolCallAndWaitInput extends OpsNangoToolCallInput {
4040
+ intervalMs?: number;
4041
+ maxPolls?: number;
4042
+ timeoutMs?: number;
3343
4043
  }
3344
- interface GtmNangoBaseOptions {
4044
+ interface OpsNangoToolCallAndWaitResult {
4045
+ success?: boolean;
4046
+ call: unknown;
4047
+ result?: unknown;
4048
+ status?: string;
4049
+ action_id?: string;
4050
+ actionId?: string;
4051
+ status_url?: string;
4052
+ statusUrl?: string;
4053
+ polls: number;
4054
+ max_polls: number;
4055
+ maxPolls: number;
4056
+ interval_ms: number;
4057
+ intervalMs: number;
4058
+ timeout_ms: number;
4059
+ timeoutMs: number;
4060
+ timed_out: boolean;
4061
+ timedOut: boolean;
4062
+ }
4063
+ interface OpsNangoDestinationInput {
3345
4064
  workspaceConnectionId?: string;
4065
+ workspace_connection_id?: string;
3346
4066
  connectionId?: string;
4067
+ connection_id?: string;
3347
4068
  providerConfigKey?: string;
4069
+ provider_config_key?: string;
3348
4070
  integrationId?: string;
4071
+ integration_id?: string;
3349
4072
  nangoConnectionId?: string;
3350
- }
3351
- interface GtmNangoConnectSessionCreateInput {
3352
- providerId?: string;
3353
- integrationId?: string;
3354
- providerDisplayName?: string;
3355
- integrationDisplayName?: string;
3356
- allowedIntegrations?: string[];
3357
- surface?: 'settings_connections' | 'ops_destinations' | 'gtm_kernel';
3358
- source?: string;
3359
- userEmail?: string;
3360
- userDisplayName?: string;
3361
- }
3362
- interface GtmNangoToolsListOptions extends GtmNangoBaseOptions {
3363
- format?: 'openai' | 'nango';
3364
- includeRaw?: boolean;
3365
- }
3366
- interface GtmNangoToolCallInput extends GtmNangoBaseOptions {
4073
+ nango_connection_id?: string;
3367
4074
  actionName?: string;
4075
+ action_name?: string;
3368
4076
  toolName?: string;
3369
- input?: UnknownRecord;
3370
- async?: boolean;
3371
- maxRetries?: number;
3372
- dryRun?: boolean;
3373
- confirm?: boolean;
3374
- confirmWrite?: boolean;
4077
+ tool_name?: string;
4078
+ proxyPath?: string;
4079
+ proxy_path?: string;
4080
+ nangoProxyPath?: string;
4081
+ nango_proxy_path?: string;
4082
+ method?: string;
4083
+ httpMethod?: string;
4084
+ http_method?: string;
4085
+ input?: Record<string, unknown>;
4086
+ arguments?: Record<string, unknown>;
4087
+ fieldMap?: Record<string, unknown>;
4088
+ field_map?: Record<string, unknown>;
4089
+ requiredFields?: string[];
4090
+ required_fields?: string[];
4091
+ writeConfirmed?: boolean;
4092
+ write_confirmed?: boolean;
4093
+ agentWriteConfirmed?: boolean;
4094
+ agent_write_confirmed?: boolean;
4095
+ config?: Record<string, unknown>;
3375
4096
  }
3376
- interface GtmNangoActionResultGetInput {
3377
- actionId?: string;
3378
- statusUrl?: string;
4097
+ interface OpsNangoScheduleOptions extends Omit<OpsCreateRequest, 'destinations'>, OpsNangoDestinationInput {
4098
+ destinations?: Array<Record<string, unknown>>;
3379
4099
  }
3380
- interface GtmWebhookDeliverInput {
3381
- recipeId: string;
3382
- campaignId?: string;
3383
- layer?: GtmLayer;
3384
- records: UnknownRecord[];
3385
- context?: UnknownRecord;
3386
- idempotencyKey?: string;
4100
+ interface OpsNangoScheduleAndWaitOptions extends Omit<OpsScheduleAndWaitOptions, 'destinations'>, OpsNangoDestinationInput {
4101
+ destinations?: Array<Record<string, unknown>>;
3387
4102
  }
3388
- declare class GtmKernel {
4103
+ declare class Ops {
3389
4104
  private client;
3390
4105
  constructor(client: HttpClient);
3391
- /** Load workspace context for an agent session: campaigns, memory, Brain, connections, and Signaliz primitives. */
3392
- context(options?: GtmWorkspaceContextOptions): Promise<any>;
3393
- /** Inspect whether the workspace has the Kernel + Brain substrate pieces needed to build, run, and improve campaigns. */
3394
- bootstrapStatus(options?: GtmWorkspaceBootstrapStatusOptions): Promise<any>;
3395
- /** Discover existing provider campaigns, starting with live/Kernel-linked Instantly campaigns, before audit or import preview. */
3396
- discoverExistingCampaigns(options?: GtmExistingCampaignDiscoverOptions): Promise<GtmExistingCampaignDiscoveryResult>;
3397
- /** Run a read-only existing campaign audit with completeness, recommendations, safe next MCP JSON, and approval boundaries. */
3398
- auditExistingCampaign(options: GtmExistingCampaignAuditOptions): Promise<GtmExistingCampaignAuditResult>;
3399
- /** Discover the first matching existing provider campaign, then run the same read-only audit against that match. */
3400
- auditExistingCampaignBySearch(options: GtmExistingCampaignAuditBySearchOptions): Promise<GtmExistingCampaignAuditResult>;
3401
- /** Create a first-class GTM campaign object in the current workspace. */
3402
- createCampaign(input: GtmCampaignCreateInput): Promise<any>;
3403
- /** Backfill historical campaigns, provider links, feedback, and memory into the GTM Kernel substrate. */
3404
- importCampaignHistory(input: GtmCampaignHistoryImportInput): Promise<any>;
3405
- /** Queue a Trigger-backed campaign history import for larger private campaign backfills. */
3406
- importCampaignHistoryRun(input: GtmCampaignHistoryImportRunInput): Promise<any>;
3407
- /** Preview a provider-neutral history import payload derived from an existing campaign build. */
3408
- previewCampaignBuildBackfill(options: GtmCampaignBuildBackfillPreviewOptions): Promise<any>;
3409
- /** Queue campaign-build history backfills through the Trigger-backed history import runner. */
3410
- runCampaignBuildBackfill(input: GtmCampaignBuildBackfillRunInput): Promise<any>;
3411
- /** Inspect Campaign Builder to Kernel backfill status for one build. */
3412
- campaignBuildBackfillStatus(options: GtmCampaignBuildBackfillStatusOptions): Promise<any>;
3413
- /** List first-class GTM campaign objects in the current workspace. */
3414
- listCampaigns(options?: GtmCampaignListOptions): Promise<any>;
3415
- /** Get one campaign with provider links, logs, feedback summary, memory, and Brain patterns. */
3416
- getCampaign(campaignId: string, options?: GtmCampaignGetOptions): Promise<any>;
3417
- /** Inspect campaign execution state, linked build progress, provider readiness, feedback, memory, and next actions. */
3418
- campaignExecutionStatus(options: GtmCampaignExecutionStatusOptions): Promise<any>;
3419
- /** Inspect whether a campaign/build is ready for Brain learning and return exact learning-cycle args. */
3420
- campaignLearningStatus(options: GtmCampaignLearningStatusOptions): Promise<GtmCampaignLearningStatusResult>;
3421
- /** Update a first-class GTM campaign and append the associated campaign log entry. */
3422
- updateCampaign(input: GtmCampaignUpdateInput): Promise<any>;
3423
- /** Append an auditable campaign action with actor, rationale, payload, and optional idempotency key. */
3424
- logCampaign(campaignId: string, input: Omit<GtmCampaignLogInput, 'campaignId'>): Promise<any>;
3425
- /** Ingest provider-neutral feedback from Instantly, Smartlead, HeyReach, webhook, or a custom MCP. */
3426
- ingestFeedback(input: GtmFeedbackIngestInput): Promise<any>;
3427
- /** Run a read-only Campaign Audit and persist workspace-scoped failure findings. */
3428
- runCampaignAudit(input: GtmCampaignAuditRunInput): Promise<any>;
3429
- /** Read a persisted Campaign Audit by audit id or campaign id. */
3430
- getCampaignAudit(options: GtmCampaignAuditGetOptions): Promise<any>;
3431
- /** Normalize Instantly webhook/pull payloads and ingest row-level feedback through the GTM Kernel. */
3432
- syncInstantlyFeedback(input: GtmInstantlyFeedbackSyncInput): Promise<any>;
3433
- /** Start a background Instantly webhook-events pull and route results into the GTM feedback loop. */
3434
- pullInstantlyFeedback(input: GtmInstantlyFeedbackPullInput): Promise<any>;
3435
- /** Prepare a secure Instantly feedback webhook URL for a campaign provider link. */
3436
- prepareInstantlyFeedbackWebhook(input: GtmInstantlyFeedbackWebhookPrepareInput): Promise<any>;
3437
- /** Preview anonymized Instantly workspace sources registered for Kernel import. */
3438
- previewKernelImport(input?: GtmKernelImportPreviewInput): Promise<any>;
3439
- /** Queue the read-only Instantly-to-GTM Kernel import. Live writes require writeApproved. */
3440
- runKernelImport(input?: GtmKernelImportRunInput): Promise<any>;
3441
- /** Queue Brain distillation over imported Instantly memory with abstracted-only outputs. */
3442
- runBrainDistillation(input?: GtmBrainDistillRunInput): Promise<any>;
3443
- /** Prepare a provider-agnostic feedback webhook URL for Smartlead, HeyReach, Airbyte, or custom sender events. */
3444
- prepareFeedbackWebhook(input: GtmFeedbackWebhookPrepareInput): Promise<any>;
3445
- /** Search ranked workspace campaign memory instead of dumping raw history. */
3446
- searchMemory(options?: GtmMemorySearchOptions): Promise<any>;
3447
- /** Retrieve evidence-backed workspace and privacy-safe aggregate Brain patterns. */
3448
- brainPatterns(options?: GtmBrainPatternsOptions): Promise<any>;
3449
- /** Plan the closed-loop Brain learning sequence without recursively executing Edge Functions. */
3450
- learningCyclePlan(input?: GtmBrainLearningCyclePlanInput): Promise<GtmBrainLearningCyclePlanResult>;
3451
- /** Queue the closed-loop Brain learning sequence in Trigger. */
3452
- learningCycleRun(input?: GtmBrainLearningCycleRunInput): Promise<any>;
3453
- /** Seed campaign defaults from active Brain patterns and ranked workspace memory. */
3454
- seedBrainDefaults(input?: GtmBrainSeedDefaultsInput): Promise<any>;
3455
- /** Extract within-workspace Brain V1 patterns from feedback, provider links, campaigns, and memory. */
3456
- extractBrainPatterns(input?: GtmBrainExtractPatternsInput): Promise<any>;
3457
- /** Aggregate opted-in workspace Brain patterns into privacy-safe global defaults. */
3458
- aggregateBrainPatterns(input?: GtmBrainAggregatePatternsInput): Promise<any>;
3459
- /** Aggregate opted-in workspace deliverability calibrations into privacy-safe global calibration rows. */
3460
- aggregateBrainCalibrations(input?: GtmBrainAggregateCalibrationsInput): Promise<any>;
3461
- /** Calibrate workspace deliverability predictions against actual bounce feedback. */
3462
- calibrateDeliverability(input?: GtmBrainCalibrateDeliverabilityInput): Promise<any>;
3463
- /** Estimate pre-send delivery risk from campaign context, lead samples, and Brain calibrations. */
3464
- deliveryRisk(input?: GtmBrainDeliveryRiskInput): Promise<any>;
3465
- /** Rank provider-chain, ICP, source, copy, and sequence failure patterns without writing raw lead data. */
3466
- failurePatterns(options?: GtmBrainFailurePatternsOptions): Promise<any>;
3467
- /** List provider presets agents can wire into GTM campaign layers, including BYO and Signaliz fallback options. */
3468
- providerCatalog(options?: GtmProviderCatalogOptions): Promise<any>;
3469
- /** List private-safe campaign strategy templates agents can merge into campaign build plans. */
3470
- campaignStrategyTemplates(options?: GtmCampaignStrategyTemplatesOptions): Promise<any>;
3471
- /** Build the read-only Memory, Brain, risk, and provider-route runbook needed before planning a campaign. */
3472
- campaignStartContext(input?: GtmCampaignStartContextInput): Promise<any>;
3473
- /** Inspect GTM integration activation cards for UI and agent routing without writing state. */
3474
- integrationsActivationStatus(options?: GtmIntegrationsActivationStatusOptions): Promise<any>;
3475
- /** Compose Memory, Brain defaults, failure intelligence, and provider routes into a read-only campaign build plan. */
3476
- campaignBuildPlan(input?: GtmCampaignBuildPlanInput): Promise<any>;
3477
- /** Emit reusable CampaignBuilderAgentRequest JSON from hosted MCP strategy-template defaults without spending credits. */
3478
- campaignAgentRequestTemplate(input?: GtmCampaignAgentRequestTemplateInput): Promise<any>;
3479
- /** Compose a one-call read-only strategy-template campaign-agent runbook across built-ins, Memory, Brain, Nango, and BYO routes. */
3480
- campaignAgentPlan(input?: GtmCampaignAgentPlanInput): Promise<any>;
3481
- /** Inspect private-safe strategy-template/workflow memory readiness before campaign planning. */
3482
- campaignStrategyMemoryStatus(input?: GtmCampaignStrategyMemoryStatusInput): Promise<any>;
3483
- /** Persist a reviewed campaign build plan into a campaign object and audit log. Dry-run first by default. */
3484
- commitCampaignBuildPlan(input?: GtmCampaignBuildPlanCommitInput): Promise<any>;
3485
- /** Derive exact build_campaign arguments from a committed campaign object without creating a build. */
3486
- prepareCampaignBuildExecution(input: GtmCampaignBuildExecutionPrepareInput): Promise<any>;
3487
- /** Prepare exact recipe, route, preview, and delivery arguments for a provider without writing state. */
3488
- prepareProviderRecipe(input: GtmProviderRecipePrepareInput): Promise<any>;
3489
- /** Prepare exact Clay webhook recipe, route, preview, and delivery arguments without writing state. */
3490
- prepareClayWebhook(input?: GtmClayWebhookPrepareInput): Promise<any>;
3491
- /** Dry-run or confirm a one-call provider route activation across one or more GTM layers. */
3492
- activateProviderRoute(input: GtmProviderRouteActivateInput): Promise<any>;
3493
- /** List Signaliz-managed integrations, external MCP servers, app connections, recipes, and layer routes. */
3494
- listConnections(options?: GtmConnectionsListOptions): Promise<any>;
3495
- /** Register a workspace connection for the Kernel connection layer. */
3496
- registerConnection(input: GtmConnectionRegisterInput): Promise<any>;
3497
- /** Create a reusable integration recipe for BYO providers such as Clay webhooks, Apollo, AI Ark, Octave, or Airbyte. */
3498
- createIntegrationRecipe(input: GtmIntegrationRecipeCreateInput): Promise<any>;
3499
- /** Set a workspace or campaign provider route for one GTM layer. */
3500
- setLayerRoute(input: GtmLayerRouteSetInput): Promise<any>;
3501
- /** Get effective layer routes, including Signaliz fallback availability. */
3502
- getLayerRoutes(options?: GtmLayerRoutesGetOptions): Promise<any>;
3503
- /** Preview one effective layer route before external delivery or provider execution. */
3504
- previewLayerRoute(input: GtmLayerRoutePreviewInput): Promise<any>;
3505
- /** Create a short-lived Nango Connect session so a user can authorize a vendor API. */
3506
- createNangoConnectSession(input: GtmNangoConnectSessionCreateInput): Promise<any>;
4106
+ plan(params: OpsPlanRequest | string): Promise<OpsPlanResult>;
4107
+ autopilot(params?: OpsAutopilotOptions): Promise<OpsAutopilotResult>;
4108
+ create(params: OpsCreateRequest | string): Promise<OpsCreateResult>;
4109
+ schedule(params: OpsCreateRequest | string): Promise<OpsCreateResult>;
4110
+ scheduleAndWait(params: OpsScheduleAndWaitOptions | string): Promise<OpsScheduleAndWaitResult>;
4111
+ /** Schedule a recurring Op that delivers through a customer-owned Nango API connection. */
4112
+ scheduleNangoAction(input: OpsNangoScheduleOptions): Promise<OpsCreateResult>;
4113
+ /** Schedule a recurring Nango-backed Op, run the first tick, and return result readback. */
4114
+ scheduleNangoActionAndWait(input: OpsNangoScheduleAndWaitOptions): Promise<OpsScheduleAndWaitResult>;
4115
+ execute(params: OpsExecuteRequest | string): Promise<OpsExecuteResult>;
4116
+ executeAndWait(params: OpsExecuteAndWaitOptions | string): Promise<OpsExecuteAndWaitResult>;
4117
+ run(params: OpsRunOptions | string): Promise<OpsRunResult>;
4118
+ runAndWait(params: OpsRunAndWaitOptions | string): Promise<OpsRunAndWaitResult>;
4119
+ status(params: OpsStatusOptions | string): Promise<OpsStatusResult>;
4120
+ results(params: OpsResultsOptions | string): Promise<OpsResultsResult>;
4121
+ waitForResults(params: OpsWaitForResultsOptions | string): Promise<OpsWaitForResultsResult>;
4122
+ /** Create a short-lived Nango Connect session from the Ops namespace. */
4123
+ createNangoConnectSession(input: OpsNangoConnectSessionCreateInput): Promise<any>;
4124
+ /** Prepare the full Nango provider search, connect, pull/export, Ops, and route flow. */
4125
+ prepareNangoIntegrationFlow(input?: OpsNangoIntegrationFlowPrepareInput): Promise<any>;
3507
4126
  /** List Nango-backed action tools for a workspace connection without executing them. */
3508
- listNangoTools(options?: GtmNangoToolsListOptions): Promise<any>;
4127
+ listNangoTools(options?: OpsNangoToolsListOptions): Promise<any>;
4128
+ /** Audit connected Nango rows, action/proxy readiness, and read/write proof gaps. */
4129
+ proveNangoReadWrite(options?: OpsNangoReadWriteProofOptions): Promise<any>;
3509
4130
  /** Dry-run or execute a Nango-backed action tool through the approval-aware MCP bridge. */
3510
- callNangoTool(input: GtmNangoToolCallInput): Promise<any>;
4131
+ callNangoTool(input: OpsNangoToolCallInput): Promise<any>;
4132
+ /** Execute a Nango action and poll its async result when a status URL/action id is returned. */
4133
+ callNangoToolAndWait(input: OpsNangoToolCallAndWaitInput): Promise<OpsNangoToolCallAndWaitResult>;
3511
4134
  /** Poll an async Nango action result by action id or status URL. */
3512
- getNangoActionResult(input: GtmNangoActionResultGetInput): Promise<any>;
3513
- /** Deliver approved campaign-layer records to a webhook recipe, starting with Clay-style webhooks. */
3514
- deliverWebhook(input: GtmWebhookDeliverInput): Promise<any>;
3515
- private callMcp;
4135
+ getNangoActionResult(input: OpsNangoActionResultGetInput): Promise<any>;
4136
+ proof(params?: OpsProofOptions): Promise<OpsProofResult>;
4137
+ debug(params: OpsDebugOptions | string): Promise<OpsDebugResult>;
4138
+ quickstartWorkflow(workflowType?: string): Promise<OpsQuickstartWorkflow>;
4139
+ approve(params: OpsApproveRequest): Promise<OpsApproveResult>;
4140
+ createRoutine(params: CreateRoutineRequest): Promise<OpsRoutine>;
4141
+ listRoutines(params?: {
4142
+ status?: OpsRoutineStatus;
4143
+ limit?: number;
4144
+ cursor?: string;
4145
+ }): Promise<OpsRoutinesResult>;
4146
+ getRoutine(routineId: string): Promise<OpsRoutine>;
4147
+ updateRoutine(params: UpdateRoutineRequest): Promise<OpsRoutine>;
4148
+ runRoutineNow(params: RunRoutineRequest | string): Promise<OpsRoutineRunResult>;
4149
+ deleteRoutine(routineId: string, permanent?: boolean): Promise<OpsRoutineDeleteResult>;
4150
+ listOutputSinks(params?: ListOutputSinksOptions): Promise<OpsSink[]>;
4151
+ getReadiness(params?: OpsReadinessOptions): Promise<OpsReadinessResult>;
4152
+ doctor(params?: OpsReadinessOptions): Promise<OpsReadinessResult>;
4153
+ createOutputSink(params: CreateOutputSinkRequest): Promise<OpsSink>;
4154
+ attachSinkToRoutine(params: {
4155
+ routine_id?: string;
4156
+ routineId?: string;
4157
+ sink_id?: string;
4158
+ sinkId?: string;
4159
+ }): Promise<OpsRoutineSinkResult>;
4160
+ getRoutineTicks(params: {
4161
+ routine_id?: string;
4162
+ routineId?: string;
4163
+ limit?: number;
4164
+ cursor?: string;
4165
+ }): Promise<OpsRoutineTicksResult>;
4166
+ getLastTickItems(params: {
4167
+ routine_id?: string;
4168
+ routineId?: string;
4169
+ limit?: number;
4170
+ cursor?: string;
4171
+ state?: string;
4172
+ }): Promise<OpsRoutineTickItemsResult>;
4173
+ getTriggerRunStatus(params: OpsTriggerRunStatusOptions | string): Promise<OpsTriggerRunStatus | OpsTriggerBatchRunStatus>;
4174
+ getQueueStatus(params?: OpsQueueStatusOptions): Promise<OpsQueueStatus>;
4175
+ replayFromCheckpoint(executionEventId: string): Promise<OpsReplayResult>;
4176
+ normalizeExecutionReference(input: string | ExecutionReferenceInput): ExecutionReference;
4177
+ collectExecutionReferences(payload: Record<string, unknown>): ExecutionReference[];
4178
+ getDashboard(params?: OpsDashboardOptions): Promise<OpsDashboardResult>;
4179
+ private call;
4180
+ }
4181
+
4182
+ declare class Ai {
4183
+ private client;
4184
+ constructor(client: HttpClient);
4185
+ /**
4186
+ * Run Custom AI Enrichment - Multi Model.
4187
+ *
4188
+ * Uses the hosted default model with bounded synthesis, then returns the
4189
+ * requested structured output fields.
4190
+ */
4191
+ multiModel(params: CustomAiMultiModelParams): Promise<CustomAiMultiModelResult>;
3516
4192
  }
3517
4193
 
3518
4194
  declare class SignalizError extends Error {
@@ -3538,6 +4214,7 @@ declare class Signaliz {
3538
4214
  readonly ai: Ai;
3539
4215
  readonly gtm: GtmKernel;
3540
4216
  private client;
4217
+ private toolListCache?;
3541
4218
  constructor(config: SignalizConfig);
3542
4219
  /** Get current workspace info including credits */
3543
4220
  getWorkspace(): Promise<WorkspaceInfo>;
@@ -3547,8 +4224,9 @@ declare class Signaliz {
3547
4224
  health(): Promise<PlatformHealth>;
3548
4225
  /** List all available MCP tools */
3549
4226
  listTools(): Promise<MCPToolInfo[]>;
4227
+ private fetchTools;
3550
4228
  /** Discover tools by natural language query */
3551
4229
  discover(query: string, category?: string): Promise<MCPToolInfo[]>;
3552
4230
  }
3553
4231
 
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 };
4232
+ export { Ai, type ApproveDeliveryResult, type BuildOptions, CAMPAIGN_BUILDER_OPERATING_PLAYBOOKS, CAMPAIGN_BUILDER_STRATEGY_TEMPLATES, type CampaignAcquisitionMode, type CampaignArtifact, type CampaignArtifactDownload, type CampaignArtifactDownloadOptions, type CampaignArtifactDownloadPart, type CampaignArtifactDownloadResult, 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 CampaignBuilderMemoryKit, type CampaignBuilderMemoryKitOptions, type CampaignBuilderMemoryKitSource, 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 CampaignBuilderSourceRouting, type CampaignBuilderStrategyTemplate, type CampaignBuilderStrategyTemplateSlug, type CampaignBuilderWorkspaceContext, type CampaignDeliveryMode, type CampaignLearningHoldoutPolicy, type CampaignLearningHoldoutPrimaryMetric, 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 GtmAgencyAutopilotCapabilityCatalogOptions, type GtmAgencyAutopilotCapabilityFamily, type GtmAgencyAutopilotCapabilityPhase, type GtmAgencyAutopilotPlaybookCatalogOptions, type GtmAgencyAutopilotPlaybookOutcomeType, type GtmAgencyAutopilotPlaybookSlug, 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 GtmHoldoutLiftProof, type GtmInstantlyFeedbackPullInput, type GtmInstantlyFeedbackWebhookPrepareInput, 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 OpsExecuteAndWaitOptions, type OpsExecuteAndWaitResult, type OpsNangoActionResultGetInput, type OpsNangoConnectSessionCreateInput, type OpsNangoDestinationInput, type OpsNangoIntegrationFlowPrepareInput, type OpsNangoScheduleAndWaitOptions, type OpsNangoScheduleOptions, type OpsNangoToolCallAndWaitInput, type OpsNangoToolCallAndWaitResult, type OpsNangoToolCallInput, type OpsNangoToolsListOptions, 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 OpsRunAndWaitOptions, type OpsRunAndWaitResult, type OpsRunOptions, type OpsRunResult, type OpsSink, type OpsSinkType, type OpsStatusOptions, type OpsStatusResult, type OpsTriggerBatchRunStatus, type OpsTriggerRunStatus, type OpsTriggerRunStatusOptions, type OpsWaitForResultsOptions, type OpsWaitForResultsPoll, type OpsWaitForResultsResult, 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, createCampaignBuilderMemoryKit, createCampaignBuilderProofReceipt, createCampaignBuilderReadiness, createCampaignBuilderToolRoute, getCampaignBuilderOperatingPlaybook, getCampaignBuilderOperatingPlaybooksForRequest, getCampaignBuilderStrategyTemplate, getMissingCampaignBuilderApprovals, normalizeExecutionReference };