@signaliz/sdk 1.0.16 → 1.0.17

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