@signaliz/sdk 1.0.16 → 1.0.18

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