@cloudfleet/sdk 0.0.1-d4c7bbc → 0.0.1-d5822b9

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.
Files changed (36) hide show
  1. package/README.md +26 -2
  2. package/dist/@tanstack/react-query.gen.d.ts +1159 -0
  3. package/dist/@tanstack/react-query.gen.d.ts.map +1 -0
  4. package/dist/@tanstack/react-query.gen.js +1175 -0
  5. package/dist/@tanstack/react-query.gen.js.map +1 -0
  6. package/dist/client/client.gen.d.ts.map +1 -1
  7. package/dist/client/client.gen.js +104 -123
  8. package/dist/client/client.gen.js.map +1 -1
  9. package/dist/client/types.gen.d.ts +6 -3
  10. package/dist/client/types.gen.d.ts.map +1 -1
  11. package/dist/client/utils.gen.d.ts +7 -3
  12. package/dist/client/utils.gen.d.ts.map +1 -1
  13. package/dist/client/utils.gen.js +3 -3
  14. package/dist/client/utils.gen.js.map +1 -1
  15. package/dist/core/params.gen.js +4 -4
  16. package/dist/core/params.gen.js.map +1 -1
  17. package/dist/core/serverSentEvents.gen.d.ts +1 -1
  18. package/dist/core/serverSentEvents.gen.d.ts.map +1 -1
  19. package/dist/core/serverSentEvents.gen.js +3 -4
  20. package/dist/core/serverSentEvents.gen.js.map +1 -1
  21. package/dist/schemas.gen.d.ts +1020 -136
  22. package/dist/schemas.gen.d.ts.map +1 -1
  23. package/dist/schemas.gen.js +1937 -205
  24. package/dist/schemas.gen.js.map +1 -1
  25. package/dist/sdk.gen.d.ts +250 -190
  26. package/dist/sdk.gen.d.ts.map +1 -1
  27. package/dist/sdk.gen.js +358 -265
  28. package/dist/sdk.gen.js.map +1 -1
  29. package/dist/services/kubernetes/api.d.ts +8 -8
  30. package/dist/types.gen.d.ts +1527 -766
  31. package/dist/types.gen.d.ts.map +1 -1
  32. package/dist/zod.gen.d.ts +3353 -1204
  33. package/dist/zod.gen.d.ts.map +1 -1
  34. package/dist/zod.gen.js +1255 -289
  35. package/dist/zod.gen.js.map +1 -1
  36. package/package.json +27 -11
@@ -2,6 +2,15 @@
2
2
  export const BillingContactSchema = {
3
3
  type: 'object',
4
4
  properties: {
5
+ type: {
6
+ type: 'string',
7
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
8
+ example: 'business',
9
+ enum: [
10
+ 'business',
11
+ 'personal'
12
+ ]
13
+ },
5
14
  company: {
6
15
  type: 'string',
7
16
  maxLength: 120,
@@ -207,6 +216,7 @@ export const BillingContactSchema = {
207
216
  }
208
217
  },
209
218
  required: [
219
+ 'type',
210
220
  'email',
211
221
  'individual_name'
212
222
  ],
@@ -358,24 +368,8 @@ export const ChartSchema = {
358
368
  },
359
369
  status: {
360
370
  type: 'string',
361
- description: 'Status of the chart deployment.',
362
- example: 'active',
363
- enum: [
364
- 'InstallSucceeded',
365
- 'InstallFailed',
366
- 'UpgradeSucceeded',
367
- 'UpgradeFailed',
368
- 'TestSucceeded',
369
- 'TestFailed',
370
- 'RollbackSucceeded',
371
- 'RollbackFailed',
372
- 'UninstallSucceeded',
373
- 'UninstallFailed',
374
- 'ArtifactFailed',
375
- 'DependencyNotReady',
376
- 'Progressing',
377
- 'SourceNotReady'
378
- ]
371
+ description: 'Status of the chart deployment (Flux HelmRelease Ready condition reason, e.g. InstallSucceeded, UpgradeFailed, Progressing).',
372
+ example: 'InstallSucceeded'
379
373
  },
380
374
  version_current: {
381
375
  type: 'string',
@@ -446,22 +440,12 @@ export const ClusterCreateInputSchema = {
446
440
  tier: {
447
441
  type: 'string',
448
442
  description: 'Tier of the cluster.',
443
+ default: 'basic',
449
444
  example: 'pro',
450
445
  enum: [
451
446
  'basic',
452
- 'pro'
453
- ]
454
- },
455
- region: {
456
- type: 'string',
457
- description: 'Cloudfleet control plane region. One of "staging-1a", "northamerica-central-1", "europe-central-1a", "northamerica-central-1a". This field can not be updated after creation.',
458
- default: 'staging-1a',
459
- example: 'northamerica-central-1a',
460
- enum: [
461
- 'staging-1a',
462
- 'northamerica-central-1',
463
- 'europe-central-1a',
464
- 'northamerica-central-1a'
447
+ 'pro',
448
+ 'enterprise'
465
449
  ]
466
450
  },
467
451
  version_channel: {
@@ -469,20 +453,105 @@ export const ClusterCreateInputSchema = {
469
453
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
470
454
  description: 'Version of the kubernetes cluster.',
471
455
  default: '1.x.x-cfke.x',
472
- example: '1.x.x-cfke.x',
456
+ example: '1.x.x-cfke.x'
457
+ },
458
+ release_channel: {
459
+ type: 'string',
460
+ description: 'Release channel for the cluster\'s control plane.',
461
+ default: 'rapid',
462
+ example: 'rapid',
473
463
  enum: [
474
- '1.x.x-cfke.x',
475
- '1.31.x-cfke.x',
476
- '1.32.x-cfke.x',
477
- '1.33.x-cfke.x'
464
+ 'rapid',
465
+ 'stable',
466
+ 'extended'
478
467
  ]
468
+ },
469
+ features: {
470
+ type: 'object',
471
+ properties: {
472
+ gpu_sharing_strategy: {
473
+ type: 'string',
474
+ description: 'GPU sharing strategy.',
475
+ default: 'none',
476
+ example: 'none',
477
+ enum: [
478
+ 'none',
479
+ 'mps',
480
+ 'time_slicing'
481
+ ]
482
+ },
483
+ gpu_max_shared_clients_per_gpu: {
484
+ type: 'integer',
485
+ minimum: 2,
486
+ maximum: 48,
487
+ description: 'Maximum number of pods that may share a single GPU.',
488
+ default: 4,
489
+ example: 10
490
+ },
491
+ cilium_socket_lb_host_namespace_only: {
492
+ type: 'boolean',
493
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
494
+ example: false
495
+ }
496
+ },
497
+ additionalProperties: false,
498
+ description: 'Cluster feature toggles.',
499
+ default: {
500
+ gpu_sharing_strategy: 'none',
501
+ gpu_max_shared_clients_per_gpu: 4,
502
+ cilium_socket_lb_host_namespace_only: false
503
+ }
504
+ },
505
+ region: {
506
+ type: 'string',
507
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
508
+ example: 'europe-central-1a'
509
+ },
510
+ networking: {
511
+ type: 'object',
512
+ properties: {
513
+ pod_cidr: {
514
+ type: 'string',
515
+ description: 'CIDR block for pod IPs.',
516
+ default: '10.244.0.0/16'
517
+ },
518
+ service_cidr: {
519
+ type: 'string',
520
+ description: 'CIDR block for service IPs.',
521
+ default: '10.96.0.0/12'
522
+ },
523
+ dual_stack: {
524
+ type: 'boolean',
525
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
526
+ },
527
+ pod_cidr_v6: {
528
+ type: 'string',
529
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
530
+ default: '2001:db8:1:2::/48'
531
+ },
532
+ service_cidr_v6: {
533
+ type: 'string',
534
+ description: 'IPv6 service CIDR. Requires dual_stack.',
535
+ default: '2001:db8:1:1::/112'
536
+ }
537
+ },
538
+ additionalProperties: false,
539
+ description: 'Cluster networking configuration. Immutable after creation.',
540
+ default: {
541
+ pod_cidr: '10.244.0.0/16',
542
+ service_cidr: '10.96.0.0/12',
543
+ dual_stack: false,
544
+ pod_cidr_v6: '2001:db8:1:2::/48',
545
+ service_cidr_v6: '2001:db8:1:1::/112'
546
+ }
479
547
  }
480
548
  },
481
549
  required: [
482
550
  'name',
483
- 'tier'
551
+ 'region'
484
552
  ],
485
- additionalProperties: false
553
+ additionalProperties: false,
554
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
486
555
  };
487
556
  export const ClusterJoinInformationSchema = {
488
557
  type: 'object',
@@ -503,6 +572,11 @@ export const ClusterJoinInformationSchema = {
503
572
  description: 'Cluster DNS IP address. This is the IP address of the kube-dns service in the cluster.',
504
573
  example: '10.96.0.10'
505
574
  },
575
+ pod_cidr: {
576
+ type: 'string',
577
+ description: 'Pod CIDR for the cluster. Used to configure iptables rules on nodes to prevent Tailscale routing loops.',
578
+ example: '10.244.0.0/16'
579
+ },
506
580
  auth_key: {
507
581
  type: 'string',
508
582
  description: 'Authentication key for the cluster.',
@@ -578,6 +652,7 @@ export const ClusterJoinInformationSchema = {
578
652
  'certificate_authority',
579
653
  'endpoint',
580
654
  'cluster_dns',
655
+ 'pod_cidr',
581
656
  'auth_key',
582
657
  'bootstrap_token',
583
658
  'versions',
@@ -599,24 +674,123 @@ export const ClusterSchema = {
599
674
  tier: {
600
675
  type: 'string',
601
676
  description: 'Tier of the cluster.',
677
+ default: 'basic',
602
678
  example: 'pro',
603
679
  enum: [
604
680
  'basic',
605
- 'pro'
681
+ 'pro',
682
+ 'enterprise'
606
683
  ]
607
684
  },
608
- region: {
685
+ version_channel: {
686
+ type: 'string',
687
+ pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
688
+ description: 'Version of the kubernetes cluster.',
689
+ default: '1.x.x-cfke.x',
690
+ example: '1.x.x-cfke.x'
691
+ },
692
+ release_channel: {
609
693
  type: 'string',
610
- description: 'Cloudfleet control plane region. One of "staging-1a", "northamerica-central-1", "europe-central-1a", "northamerica-central-1a". This field can not be updated after creation.',
611
- default: 'staging-1a',
612
- example: 'northamerica-central-1a',
694
+ description: 'Release channel for the cluster\'s control plane.',
695
+ default: 'rapid',
696
+ example: 'rapid',
613
697
  enum: [
614
- 'staging-1a',
615
- 'northamerica-central-1',
616
- 'europe-central-1a',
617
- 'northamerica-central-1a'
698
+ 'rapid',
699
+ 'stable',
700
+ 'extended'
618
701
  ]
619
702
  },
703
+ features: {
704
+ type: 'object',
705
+ properties: {
706
+ gpu_sharing_strategy: {
707
+ type: 'string',
708
+ description: 'GPU sharing strategy.',
709
+ default: 'none',
710
+ example: 'none',
711
+ enum: [
712
+ 'none',
713
+ 'mps',
714
+ 'time_slicing'
715
+ ]
716
+ },
717
+ gpu_max_shared_clients_per_gpu: {
718
+ type: 'integer',
719
+ minimum: 2,
720
+ maximum: 48,
721
+ description: 'Maximum number of pods that may share a single GPU.',
722
+ default: 4,
723
+ example: 10
724
+ },
725
+ cilium_socket_lb_host_namespace_only: {
726
+ type: 'boolean',
727
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
728
+ example: false
729
+ }
730
+ },
731
+ required: [
732
+ 'gpu_sharing_strategy',
733
+ 'gpu_max_shared_clients_per_gpu',
734
+ 'cilium_socket_lb_host_namespace_only'
735
+ ],
736
+ additionalProperties: false,
737
+ description: 'Cluster feature toggles.',
738
+ default: {
739
+ gpu_sharing_strategy: 'none',
740
+ gpu_max_shared_clients_per_gpu: 4,
741
+ cilium_socket_lb_host_namespace_only: false
742
+ }
743
+ },
744
+ region: {
745
+ type: 'string',
746
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
747
+ example: 'europe-central-1a'
748
+ },
749
+ networking: {
750
+ type: 'object',
751
+ properties: {
752
+ pod_cidr: {
753
+ type: 'string',
754
+ description: 'CIDR block for pod IPs.',
755
+ default: '10.244.0.0/16'
756
+ },
757
+ service_cidr: {
758
+ type: 'string',
759
+ description: 'CIDR block for service IPs.',
760
+ default: '10.96.0.0/12'
761
+ },
762
+ dual_stack: {
763
+ type: 'boolean',
764
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
765
+ },
766
+ pod_cidr_v6: {
767
+ type: 'string',
768
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
769
+ default: '2001:db8:1:2::/48'
770
+ },
771
+ service_cidr_v6: {
772
+ type: 'string',
773
+ description: 'IPv6 service CIDR. Requires dual_stack.',
774
+ default: '2001:db8:1:1::/112'
775
+ }
776
+ },
777
+ required: [
778
+ 'pod_cidr',
779
+ 'service_cidr',
780
+ 'dual_stack',
781
+ 'pod_cidr_v6',
782
+ 'service_cidr_v6'
783
+ ],
784
+ additionalProperties: false,
785
+ description: 'Cluster networking configuration. Immutable after creation.',
786
+ default: {
787
+ pod_cidr: '10.244.0.0/16',
788
+ service_cidr: '10.96.0.0/12',
789
+ dual_stack: false,
790
+ pod_cidr_v6: '2001:db8:1:2::/48',
791
+ service_cidr_v6: '2001:db8:1:1::/112'
792
+ }
793
+ },
620
794
  id: {
621
795
  type: 'string',
622
796
  format: 'uuid',
@@ -625,16 +799,13 @@ export const ClusterSchema = {
625
799
  },
626
800
  status: {
627
801
  type: 'string',
628
- description: 'Status of the cluster. When creating a new cluster, set to `active`. When deleting a clusters, set to `deleted`.',
629
- example: 'active',
802
+ description: 'Status of the cluster.',
803
+ example: 'deployed',
630
804
  enum: [
631
- 'active',
632
- 'disabled',
633
- 'deleted',
634
805
  'creating',
635
806
  'deployed',
636
- 'failed',
637
- 'updating'
807
+ 'updating',
808
+ 'disabled'
638
809
  ]
639
810
  },
640
811
  endpoint: {
@@ -642,8 +813,24 @@ export const ClusterSchema = {
642
813
  {
643
814
  type: 'string',
644
815
  format: 'uri',
645
- description: 'URL of the Kubernetes cluster control plane. This is the endpoint that kubectl uses to connect to the cluster.',
646
- example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.cloudfleet.dev:6443'
816
+ description: 'URL signed by a public CA of the Kubernetes cluster control plane. This is the endpoint that kubectl uses to connect to the cluster.',
817
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
818
+ },
819
+ {
820
+ type: 'string',
821
+ enum: [
822
+ ''
823
+ ]
824
+ }
825
+ ]
826
+ },
827
+ endpoint_public: {
828
+ anyOf: [
829
+ {
830
+ type: 'string',
831
+ format: 'uri',
832
+ description: 'Deprecated alias of `endpoint`; retained for backward compatibility.',
833
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
647
834
  },
648
835
  {
649
836
  type: 'string',
@@ -677,21 +864,22 @@ export const ClusterSchema = {
677
864
  type: 'boolean',
678
865
  description: 'Indicates if the cluster is ready to be used.',
679
866
  example: true
680
- },
681
- version_channel: {
682
- type: 'string',
683
- pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
684
- description: 'Version of the kubernetes cluster.',
685
- example: '1.x.x-cfke.x'
686
867
  }
687
868
  },
688
869
  required: [
689
870
  'name',
690
871
  'tier',
872
+ 'version_channel',
873
+ 'release_channel',
874
+ 'features',
875
+ 'region',
876
+ 'networking',
691
877
  'id',
692
- 'status'
878
+ 'status',
879
+ 'ready'
693
880
  ],
694
- additionalProperties: false
881
+ additionalProperties: false,
882
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
695
883
  };
696
884
  export const ClusterUpdateInputSchema = {
697
885
  type: 'object',
@@ -707,23 +895,74 @@ export const ClusterUpdateInputSchema = {
707
895
  tier: {
708
896
  type: 'string',
709
897
  description: 'Tier of the cluster.',
898
+ default: 'basic',
710
899
  example: 'pro',
711
900
  enum: [
712
901
  'basic',
713
- 'pro'
902
+ 'pro',
903
+ 'enterprise'
714
904
  ]
715
905
  },
716
906
  version_channel: {
717
907
  type: 'string',
718
908
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
719
909
  description: 'Version of the kubernetes cluster.',
910
+ default: '1.x.x-cfke.x',
720
911
  example: '1.x.x-cfke.x'
912
+ },
913
+ release_channel: {
914
+ type: 'string',
915
+ description: 'Release channel for the cluster\'s control plane.',
916
+ default: 'rapid',
917
+ example: 'rapid',
918
+ enum: [
919
+ 'rapid',
920
+ 'stable',
921
+ 'extended'
922
+ ]
923
+ },
924
+ features: {
925
+ type: 'object',
926
+ properties: {
927
+ gpu_sharing_strategy: {
928
+ type: 'string',
929
+ description: 'GPU sharing strategy.',
930
+ default: 'none',
931
+ example: 'none',
932
+ enum: [
933
+ 'none',
934
+ 'mps',
935
+ 'time_slicing'
936
+ ]
937
+ },
938
+ gpu_max_shared_clients_per_gpu: {
939
+ type: 'integer',
940
+ minimum: 2,
941
+ maximum: 48,
942
+ description: 'Maximum number of pods that may share a single GPU.',
943
+ default: 4,
944
+ example: 10
945
+ },
946
+ cilium_socket_lb_host_namespace_only: {
947
+ type: 'boolean',
948
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
949
+ example: false
950
+ }
951
+ },
952
+ additionalProperties: false,
953
+ description: 'Cluster feature toggles.',
954
+ default: {
955
+ gpu_sharing_strategy: 'none',
956
+ gpu_max_shared_clients_per_gpu: 4,
957
+ cilium_socket_lb_host_namespace_only: false
958
+ }
721
959
  }
722
960
  },
723
961
  required: [
724
- 'tier'
962
+ 'name'
725
963
  ],
726
- additionalProperties: false
964
+ additionalProperties: false,
965
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
727
966
  };
728
967
  export const FleetCreateInputSchema = {
729
968
  type: 'object',
@@ -732,15 +971,12 @@ export const FleetCreateInputSchema = {
732
971
  type: 'object',
733
972
  properties: {
734
973
  cpu: {
735
- type: 'number',
736
- format: 'float',
974
+ type: 'integer',
737
975
  minimum: 0,
738
- description: 'CPU limit in cores.'
976
+ maximum: 100000,
977
+ description: 'CPU limit in cores. Maximum 100,000.'
739
978
  }
740
979
  },
741
- required: [
742
- 'cpu'
743
- ],
744
980
  additionalProperties: false,
745
981
  description: 'Limits define a set of bounds for provisioning capacity.'
746
982
  },
@@ -748,16 +984,17 @@ export const FleetCreateInputSchema = {
748
984
  type: 'object',
749
985
  properties: {
750
986
  enabled: {
751
- type: 'boolean',
752
- default: true
987
+ type: 'boolean'
753
988
  },
754
989
  project: {
755
990
  type: 'string',
756
- description: 'Project GCP Project id to deploy instances into'
991
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
992
+ description: 'GCP project ID to deploy instances into. 6-30 chars, lowercase letters/digits/hyphens, must start with a letter and not end with a hyphen. Omit when GCP is disabled.',
993
+ example: 'my-cloudfleet-project'
757
994
  }
758
995
  },
759
996
  required: [
760
- 'project'
997
+ 'enabled'
761
998
  ],
762
999
  additionalProperties: false
763
1000
  },
@@ -765,16 +1002,18 @@ export const FleetCreateInputSchema = {
765
1002
  type: 'object',
766
1003
  properties: {
767
1004
  enabled: {
768
- type: 'boolean',
769
- default: true
1005
+ type: 'boolean'
770
1006
  },
771
1007
  apiKey: {
772
1008
  type: 'string',
773
- description: 'Hetzner Cloud API key with read / write access'
1009
+ maxLength: 64,
1010
+ minLength: 64,
1011
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1012
+ description: 'Hetzner Cloud API token with read/write access (64 alphanumeric characters). Write-only: reads return a redacted placeholder, never the token. Omit the field, or send the placeholder back unchanged, to keep the existing key. Send a new value to rotate it.'
774
1013
  }
775
1014
  },
776
1015
  required: [
777
- 'apiKey'
1016
+ 'enabled'
778
1017
  ],
779
1018
  additionalProperties: false
780
1019
  },
@@ -782,19 +1021,321 @@ export const FleetCreateInputSchema = {
782
1021
  type: 'object',
783
1022
  properties: {
784
1023
  enabled: {
785
- type: 'boolean',
786
- default: true
1024
+ type: 'boolean'
787
1025
  },
788
1026
  controllerRoleArn: {
789
1027
  type: 'string',
790
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1028
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1029
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1030
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
791
1031
  }
792
1032
  },
793
1033
  required: [
794
- 'controllerRoleArn'
1034
+ 'enabled'
795
1035
  ],
796
1036
  additionalProperties: false
797
1037
  },
1038
+ constraints: {
1039
+ type: 'object',
1040
+ properties: {
1041
+ 'karpenter.sh/capacity-type': {
1042
+ type: 'array',
1043
+ items: {
1044
+ type: 'string',
1045
+ enum: [
1046
+ 'on-demand',
1047
+ 'spot'
1048
+ ]
1049
+ },
1050
+ minItems: 1,
1051
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1052
+ default: [
1053
+ 'on-demand',
1054
+ 'spot'
1055
+ ]
1056
+ },
1057
+ 'kubernetes.io/arch': {
1058
+ type: 'array',
1059
+ items: {
1060
+ type: 'string',
1061
+ enum: [
1062
+ 'amd64',
1063
+ 'arm64'
1064
+ ]
1065
+ },
1066
+ minItems: 1,
1067
+ description: 'Allowed values for `kubernetes.io/arch`.',
1068
+ default: [
1069
+ 'amd64'
1070
+ ]
1071
+ },
1072
+ 'cfke.io/instance-family': {
1073
+ type: 'array',
1074
+ items: {
1075
+ type: 'string',
1076
+ enum: [
1077
+ 'a1',
1078
+ 'a2',
1079
+ 'a3',
1080
+ 'a4',
1081
+ 'c1',
1082
+ 'c2',
1083
+ 'c2d',
1084
+ 'c3',
1085
+ 'c3d',
1086
+ 'c4',
1087
+ 'c4a',
1088
+ 'c4d',
1089
+ 'c5',
1090
+ 'c5a',
1091
+ 'c5ad',
1092
+ 'c5d',
1093
+ 'c5n',
1094
+ 'c6a',
1095
+ 'c6g',
1096
+ 'c6gd',
1097
+ 'c6gn',
1098
+ 'c6i',
1099
+ 'c6id',
1100
+ 'c6in',
1101
+ 'c7a',
1102
+ 'c7g',
1103
+ 'c7gd',
1104
+ 'c7gn',
1105
+ 'c7i',
1106
+ 'c7i-flex',
1107
+ 'c8g',
1108
+ 'c8gd',
1109
+ 'cax',
1110
+ 'ccx',
1111
+ 'cpx',
1112
+ 'cx',
1113
+ 'd2',
1114
+ 'd3',
1115
+ 'd3en',
1116
+ 'dl1',
1117
+ 'dl2q',
1118
+ 'e2',
1119
+ 'f1',
1120
+ 'f2',
1121
+ 'g1',
1122
+ 'g2',
1123
+ 'g4ad',
1124
+ 'g4dn',
1125
+ 'g5',
1126
+ 'g5g',
1127
+ 'g6',
1128
+ 'g6e',
1129
+ 'gr6',
1130
+ 'h1',
1131
+ 'h3',
1132
+ 'hpc6a',
1133
+ 'hpc6id',
1134
+ 'hpc7a',
1135
+ 'hpc7g',
1136
+ 'i2',
1137
+ 'i3',
1138
+ 'i3en',
1139
+ 'i4g',
1140
+ 'i4i',
1141
+ 'i7i',
1142
+ 'i7ie',
1143
+ 'i8g',
1144
+ 'im4gn',
1145
+ 'inf1',
1146
+ 'inf2',
1147
+ 'is4gen',
1148
+ 'm1',
1149
+ 'm2',
1150
+ 'm3',
1151
+ 'm4',
1152
+ 'm5',
1153
+ 'm5a',
1154
+ 'm5ad',
1155
+ 'm5d',
1156
+ 'm5dn',
1157
+ 'm5n',
1158
+ 'm5zn',
1159
+ 'm6a',
1160
+ 'm6g',
1161
+ 'm6gd',
1162
+ 'm6i',
1163
+ 'm6id',
1164
+ 'm6idn',
1165
+ 'm6in',
1166
+ 'm7a',
1167
+ 'm7g',
1168
+ 'm7gd',
1169
+ 'm7i',
1170
+ 'm7i-flex',
1171
+ 'm8g',
1172
+ 'm8gd',
1173
+ 'n1',
1174
+ 'n2',
1175
+ 'n2d',
1176
+ 'n4',
1177
+ 'p3',
1178
+ 'p3dn',
1179
+ 'p4d',
1180
+ 'p4de',
1181
+ 'p5',
1182
+ 'p5e',
1183
+ 'p5en',
1184
+ 'p6-b200',
1185
+ 'r3',
1186
+ 'r4',
1187
+ 'r5',
1188
+ 'r5a',
1189
+ 'r5ad',
1190
+ 'r5b',
1191
+ 'r5d',
1192
+ 'r5dn',
1193
+ 'r5n',
1194
+ 'r6a',
1195
+ 'r6g',
1196
+ 'r6gd',
1197
+ 'r6i',
1198
+ 'r6id',
1199
+ 'r6idn',
1200
+ 'r6in',
1201
+ 'r7a',
1202
+ 'r7g',
1203
+ 'r7gd',
1204
+ 'r7i',
1205
+ 'r7iz',
1206
+ 'r8g',
1207
+ 'r8gd',
1208
+ 't2',
1209
+ 't2a',
1210
+ 't2d',
1211
+ 't3',
1212
+ 't3a',
1213
+ 't4g',
1214
+ 'trn1',
1215
+ 'trn1n',
1216
+ 'u-3tb1',
1217
+ 'u-6tb1',
1218
+ 'u7i-12tb',
1219
+ 'u7i-6tb',
1220
+ 'u7i-8tb',
1221
+ 'u7in-16tb',
1222
+ 'u7in-24tb',
1223
+ 'u7in-32tb',
1224
+ 'vt1',
1225
+ 'x1',
1226
+ 'x1e',
1227
+ 'x2gd',
1228
+ 'x2idn',
1229
+ 'x2iedn',
1230
+ 'x2iezn',
1231
+ 'x4',
1232
+ 'x8g',
1233
+ 'z1d',
1234
+ 'z3'
1235
+ ]
1236
+ },
1237
+ description: 'Allowed values for `cfke.io/instance-family`.',
1238
+ default: []
1239
+ },
1240
+ 'topology.kubernetes.io/region': {
1241
+ type: 'array',
1242
+ items: {
1243
+ type: 'string',
1244
+ enum: [
1245
+ 'africa-south1',
1246
+ 'ap-northeast-1',
1247
+ 'ap-northeast-2',
1248
+ 'ap-northeast-3',
1249
+ 'ap-south-1',
1250
+ 'ap-southeast-1',
1251
+ 'ap-southeast-2',
1252
+ 'ash',
1253
+ 'asia-east1',
1254
+ 'asia-east2',
1255
+ 'asia-northeast1',
1256
+ 'asia-northeast2',
1257
+ 'asia-northeast3',
1258
+ 'asia-south1',
1259
+ 'asia-south2',
1260
+ 'asia-southeast1',
1261
+ 'asia-southeast2',
1262
+ 'australia-southeast1',
1263
+ 'australia-southeast2',
1264
+ 'ca-central-1',
1265
+ 'eu-central-1',
1266
+ 'eu-central-2',
1267
+ 'eu-north-1',
1268
+ 'eu-west-1',
1269
+ 'eu-west-2',
1270
+ 'eu-west-3',
1271
+ 'europe-central2',
1272
+ 'europe-north1',
1273
+ 'europe-southwest1',
1274
+ 'europe-west1',
1275
+ 'europe-west10',
1276
+ 'europe-west12',
1277
+ 'europe-west2',
1278
+ 'europe-west3',
1279
+ 'europe-west4',
1280
+ 'europe-west6',
1281
+ 'europe-west8',
1282
+ 'europe-west9',
1283
+ 'fsn1',
1284
+ 'hel1',
1285
+ 'hil',
1286
+ 'me-central1',
1287
+ 'me-central2',
1288
+ 'me-west1',
1289
+ 'nbg1',
1290
+ 'northamerica-northeast1',
1291
+ 'northamerica-northeast2',
1292
+ 'sa-east-1',
1293
+ 'sin',
1294
+ 'southamerica-east1',
1295
+ 'southamerica-west1',
1296
+ 'us-central1',
1297
+ 'us-east-1',
1298
+ 'us-east-2',
1299
+ 'us-east1',
1300
+ 'us-east4',
1301
+ 'us-east5',
1302
+ 'us-south1',
1303
+ 'us-west-1',
1304
+ 'us-west-2',
1305
+ 'us-west1',
1306
+ 'us-west2',
1307
+ 'us-west3',
1308
+ 'us-west4'
1309
+ ]
1310
+ },
1311
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1312
+ default: []
1313
+ }
1314
+ },
1315
+ additionalProperties: false,
1316
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
1317
+ default: {
1318
+ 'karpenter.sh/capacity-type': [
1319
+ 'on-demand',
1320
+ 'spot'
1321
+ ],
1322
+ 'kubernetes.io/arch': [
1323
+ 'amd64'
1324
+ ],
1325
+ 'cfke.io/instance-family': [],
1326
+ 'topology.kubernetes.io/region': []
1327
+ }
1328
+ },
1329
+ scalingProfile: {
1330
+ type: 'string',
1331
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet. Full-overwrite: omit to reset to the default (`conservative`).',
1332
+ default: 'conservative',
1333
+ example: 'conservative',
1334
+ enum: [
1335
+ 'aggressive',
1336
+ 'conservative'
1337
+ ]
1338
+ },
798
1339
  id: {
799
1340
  type: 'string',
800
1341
  maxLength: 63,
@@ -807,7 +1348,8 @@ export const FleetCreateInputSchema = {
807
1348
  required: [
808
1349
  'id'
809
1350
  ],
810
- additionalProperties: false
1351
+ additionalProperties: false,
1352
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
811
1353
  };
812
1354
  export const FleetSchema = {
813
1355
  type: 'object',
@@ -816,15 +1358,12 @@ export const FleetSchema = {
816
1358
  type: 'object',
817
1359
  properties: {
818
1360
  cpu: {
819
- type: 'number',
820
- format: 'float',
1361
+ type: 'integer',
821
1362
  minimum: 0,
822
- description: 'CPU limit in cores.'
1363
+ maximum: 100000,
1364
+ description: 'CPU limit in cores. Maximum 100,000.'
823
1365
  }
824
1366
  },
825
- required: [
826
- 'cpu'
827
- ],
828
1367
  additionalProperties: false,
829
1368
  description: 'Limits define a set of bounds for provisioning capacity.'
830
1369
  },
@@ -832,16 +1371,17 @@ export const FleetSchema = {
832
1371
  type: 'object',
833
1372
  properties: {
834
1373
  enabled: {
835
- type: 'boolean',
836
- default: true
1374
+ type: 'boolean'
837
1375
  },
838
1376
  project: {
839
1377
  type: 'string',
840
- description: 'Project GCP Project id to deploy instances into'
1378
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1379
+ description: 'GCP project ID to deploy instances into. 6-30 chars, lowercase letters/digits/hyphens, must start with a letter and not end with a hyphen. Omit when GCP is disabled.',
1380
+ example: 'my-cloudfleet-project'
841
1381
  }
842
1382
  },
843
1383
  required: [
844
- 'project'
1384
+ 'enabled'
845
1385
  ],
846
1386
  additionalProperties: false
847
1387
  },
@@ -849,16 +1389,16 @@ export const FleetSchema = {
849
1389
  type: 'object',
850
1390
  properties: {
851
1391
  enabled: {
852
- type: 'boolean',
853
- default: true
1392
+ type: 'boolean'
854
1393
  },
855
1394
  apiKey: {
856
1395
  type: 'string',
857
- description: 'Hetzner Cloud API key with read / write access'
1396
+ pattern: '^\\*{64}$',
1397
+ description: 'Redacted Hetzner API token. Returned as 64 asterisks when a token is configured; omitted otherwise. The real value is never echoed by the API.'
858
1398
  }
859
1399
  },
860
1400
  required: [
861
- 'apiKey'
1401
+ 'enabled'
862
1402
  ],
863
1403
  additionalProperties: false
864
1404
  },
@@ -866,19 +1406,325 @@ export const FleetSchema = {
866
1406
  type: 'object',
867
1407
  properties: {
868
1408
  enabled: {
869
- type: 'boolean',
870
- default: true
1409
+ type: 'boolean'
871
1410
  },
872
1411
  controllerRoleArn: {
873
1412
  type: 'string',
874
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1413
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1414
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1415
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
875
1416
  }
876
1417
  },
877
1418
  required: [
878
- 'controllerRoleArn'
1419
+ 'enabled'
879
1420
  ],
880
1421
  additionalProperties: false
881
1422
  },
1423
+ constraints: {
1424
+ type: 'object',
1425
+ properties: {
1426
+ 'karpenter.sh/capacity-type': {
1427
+ type: 'array',
1428
+ items: {
1429
+ type: 'string',
1430
+ enum: [
1431
+ 'on-demand',
1432
+ 'spot'
1433
+ ]
1434
+ },
1435
+ minItems: 1,
1436
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1437
+ default: [
1438
+ 'on-demand',
1439
+ 'spot'
1440
+ ]
1441
+ },
1442
+ 'kubernetes.io/arch': {
1443
+ type: 'array',
1444
+ items: {
1445
+ type: 'string',
1446
+ enum: [
1447
+ 'amd64',
1448
+ 'arm64'
1449
+ ]
1450
+ },
1451
+ minItems: 1,
1452
+ description: 'Allowed values for `kubernetes.io/arch`.',
1453
+ default: [
1454
+ 'amd64'
1455
+ ]
1456
+ },
1457
+ 'cfke.io/instance-family': {
1458
+ type: 'array',
1459
+ items: {
1460
+ type: 'string',
1461
+ enum: [
1462
+ 'a1',
1463
+ 'a2',
1464
+ 'a3',
1465
+ 'a4',
1466
+ 'c1',
1467
+ 'c2',
1468
+ 'c2d',
1469
+ 'c3',
1470
+ 'c3d',
1471
+ 'c4',
1472
+ 'c4a',
1473
+ 'c4d',
1474
+ 'c5',
1475
+ 'c5a',
1476
+ 'c5ad',
1477
+ 'c5d',
1478
+ 'c5n',
1479
+ 'c6a',
1480
+ 'c6g',
1481
+ 'c6gd',
1482
+ 'c6gn',
1483
+ 'c6i',
1484
+ 'c6id',
1485
+ 'c6in',
1486
+ 'c7a',
1487
+ 'c7g',
1488
+ 'c7gd',
1489
+ 'c7gn',
1490
+ 'c7i',
1491
+ 'c7i-flex',
1492
+ 'c8g',
1493
+ 'c8gd',
1494
+ 'cax',
1495
+ 'ccx',
1496
+ 'cpx',
1497
+ 'cx',
1498
+ 'd2',
1499
+ 'd3',
1500
+ 'd3en',
1501
+ 'dl1',
1502
+ 'dl2q',
1503
+ 'e2',
1504
+ 'f1',
1505
+ 'f2',
1506
+ 'g1',
1507
+ 'g2',
1508
+ 'g4ad',
1509
+ 'g4dn',
1510
+ 'g5',
1511
+ 'g5g',
1512
+ 'g6',
1513
+ 'g6e',
1514
+ 'gr6',
1515
+ 'h1',
1516
+ 'h3',
1517
+ 'hpc6a',
1518
+ 'hpc6id',
1519
+ 'hpc7a',
1520
+ 'hpc7g',
1521
+ 'i2',
1522
+ 'i3',
1523
+ 'i3en',
1524
+ 'i4g',
1525
+ 'i4i',
1526
+ 'i7i',
1527
+ 'i7ie',
1528
+ 'i8g',
1529
+ 'im4gn',
1530
+ 'inf1',
1531
+ 'inf2',
1532
+ 'is4gen',
1533
+ 'm1',
1534
+ 'm2',
1535
+ 'm3',
1536
+ 'm4',
1537
+ 'm5',
1538
+ 'm5a',
1539
+ 'm5ad',
1540
+ 'm5d',
1541
+ 'm5dn',
1542
+ 'm5n',
1543
+ 'm5zn',
1544
+ 'm6a',
1545
+ 'm6g',
1546
+ 'm6gd',
1547
+ 'm6i',
1548
+ 'm6id',
1549
+ 'm6idn',
1550
+ 'm6in',
1551
+ 'm7a',
1552
+ 'm7g',
1553
+ 'm7gd',
1554
+ 'm7i',
1555
+ 'm7i-flex',
1556
+ 'm8g',
1557
+ 'm8gd',
1558
+ 'n1',
1559
+ 'n2',
1560
+ 'n2d',
1561
+ 'n4',
1562
+ 'p3',
1563
+ 'p3dn',
1564
+ 'p4d',
1565
+ 'p4de',
1566
+ 'p5',
1567
+ 'p5e',
1568
+ 'p5en',
1569
+ 'p6-b200',
1570
+ 'r3',
1571
+ 'r4',
1572
+ 'r5',
1573
+ 'r5a',
1574
+ 'r5ad',
1575
+ 'r5b',
1576
+ 'r5d',
1577
+ 'r5dn',
1578
+ 'r5n',
1579
+ 'r6a',
1580
+ 'r6g',
1581
+ 'r6gd',
1582
+ 'r6i',
1583
+ 'r6id',
1584
+ 'r6idn',
1585
+ 'r6in',
1586
+ 'r7a',
1587
+ 'r7g',
1588
+ 'r7gd',
1589
+ 'r7i',
1590
+ 'r7iz',
1591
+ 'r8g',
1592
+ 'r8gd',
1593
+ 't2',
1594
+ 't2a',
1595
+ 't2d',
1596
+ 't3',
1597
+ 't3a',
1598
+ 't4g',
1599
+ 'trn1',
1600
+ 'trn1n',
1601
+ 'u-3tb1',
1602
+ 'u-6tb1',
1603
+ 'u7i-12tb',
1604
+ 'u7i-6tb',
1605
+ 'u7i-8tb',
1606
+ 'u7in-16tb',
1607
+ 'u7in-24tb',
1608
+ 'u7in-32tb',
1609
+ 'vt1',
1610
+ 'x1',
1611
+ 'x1e',
1612
+ 'x2gd',
1613
+ 'x2idn',
1614
+ 'x2iedn',
1615
+ 'x2iezn',
1616
+ 'x4',
1617
+ 'x8g',
1618
+ 'z1d',
1619
+ 'z3'
1620
+ ]
1621
+ },
1622
+ description: 'Allowed values for `cfke.io/instance-family`.',
1623
+ default: []
1624
+ },
1625
+ 'topology.kubernetes.io/region': {
1626
+ type: 'array',
1627
+ items: {
1628
+ type: 'string',
1629
+ enum: [
1630
+ 'africa-south1',
1631
+ 'ap-northeast-1',
1632
+ 'ap-northeast-2',
1633
+ 'ap-northeast-3',
1634
+ 'ap-south-1',
1635
+ 'ap-southeast-1',
1636
+ 'ap-southeast-2',
1637
+ 'ash',
1638
+ 'asia-east1',
1639
+ 'asia-east2',
1640
+ 'asia-northeast1',
1641
+ 'asia-northeast2',
1642
+ 'asia-northeast3',
1643
+ 'asia-south1',
1644
+ 'asia-south2',
1645
+ 'asia-southeast1',
1646
+ 'asia-southeast2',
1647
+ 'australia-southeast1',
1648
+ 'australia-southeast2',
1649
+ 'ca-central-1',
1650
+ 'eu-central-1',
1651
+ 'eu-central-2',
1652
+ 'eu-north-1',
1653
+ 'eu-west-1',
1654
+ 'eu-west-2',
1655
+ 'eu-west-3',
1656
+ 'europe-central2',
1657
+ 'europe-north1',
1658
+ 'europe-southwest1',
1659
+ 'europe-west1',
1660
+ 'europe-west10',
1661
+ 'europe-west12',
1662
+ 'europe-west2',
1663
+ 'europe-west3',
1664
+ 'europe-west4',
1665
+ 'europe-west6',
1666
+ 'europe-west8',
1667
+ 'europe-west9',
1668
+ 'fsn1',
1669
+ 'hel1',
1670
+ 'hil',
1671
+ 'me-central1',
1672
+ 'me-central2',
1673
+ 'me-west1',
1674
+ 'nbg1',
1675
+ 'northamerica-northeast1',
1676
+ 'northamerica-northeast2',
1677
+ 'sa-east-1',
1678
+ 'sin',
1679
+ 'southamerica-east1',
1680
+ 'southamerica-west1',
1681
+ 'us-central1',
1682
+ 'us-east-1',
1683
+ 'us-east-2',
1684
+ 'us-east1',
1685
+ 'us-east4',
1686
+ 'us-east5',
1687
+ 'us-south1',
1688
+ 'us-west-1',
1689
+ 'us-west-2',
1690
+ 'us-west1',
1691
+ 'us-west2',
1692
+ 'us-west3',
1693
+ 'us-west4'
1694
+ ]
1695
+ },
1696
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1697
+ default: []
1698
+ }
1699
+ },
1700
+ required: [
1701
+ 'karpenter.sh/capacity-type',
1702
+ 'kubernetes.io/arch'
1703
+ ],
1704
+ additionalProperties: false,
1705
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
1706
+ default: {
1707
+ 'karpenter.sh/capacity-type': [
1708
+ 'on-demand',
1709
+ 'spot'
1710
+ ],
1711
+ 'kubernetes.io/arch': [
1712
+ 'amd64'
1713
+ ],
1714
+ 'cfke.io/instance-family': [],
1715
+ 'topology.kubernetes.io/region': []
1716
+ }
1717
+ },
1718
+ scalingProfile: {
1719
+ type: 'string',
1720
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet. Full-overwrite: omit to reset to the default (`conservative`).',
1721
+ default: 'conservative',
1722
+ example: 'conservative',
1723
+ enum: [
1724
+ 'aggressive',
1725
+ 'conservative'
1726
+ ]
1727
+ },
882
1728
  id: {
883
1729
  type: 'string',
884
1730
  maxLength: 63,
@@ -886,12 +1732,38 @@ export const FleetSchema = {
886
1732
  pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
887
1733
  description: 'Unique identifier of the kubernetes fleet.',
888
1734
  example: 'new-clouds-fleet'
1735
+ },
1736
+ ready: {
1737
+ type: 'boolean',
1738
+ description: 'Indicates whether the fleet configuration is healthy.',
1739
+ example: true
1740
+ },
1741
+ status_message: {
1742
+ type: 'string',
1743
+ description: 'Human-readable reason the fleet is not ready. Present only when `ready` is false.',
1744
+ example: 'Invalid provider permissions.'
1745
+ },
1746
+ created_at: {
1747
+ type: 'string',
1748
+ description: 'Creation date and time of the fleet.',
1749
+ example: '2024-09-12T09:11:27Z'
1750
+ },
1751
+ updated_at: {
1752
+ type: 'string',
1753
+ description: 'Date and time the fleet was last updated.',
1754
+ example: '2024-09-12T09:11:27Z'
889
1755
  }
890
1756
  },
891
1757
  required: [
892
- 'id'
1758
+ 'constraints',
1759
+ 'scalingProfile',
1760
+ 'id',
1761
+ 'ready',
1762
+ 'created_at',
1763
+ 'updated_at'
893
1764
  ],
894
- additionalProperties: false
1765
+ additionalProperties: false,
1766
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
895
1767
  };
896
1768
  export const FleetUpdateInputSchema = {
897
1769
  type: 'object',
@@ -900,15 +1772,12 @@ export const FleetUpdateInputSchema = {
900
1772
  type: 'object',
901
1773
  properties: {
902
1774
  cpu: {
903
- type: 'number',
904
- format: 'float',
1775
+ type: 'integer',
905
1776
  minimum: 0,
906
- description: 'CPU limit in cores.'
1777
+ maximum: 100000,
1778
+ description: 'CPU limit in cores. Maximum 100,000.'
907
1779
  }
908
1780
  },
909
- required: [
910
- 'cpu'
911
- ],
912
1781
  additionalProperties: false,
913
1782
  description: 'Limits define a set of bounds for provisioning capacity.'
914
1783
  },
@@ -916,16 +1785,17 @@ export const FleetUpdateInputSchema = {
916
1785
  type: 'object',
917
1786
  properties: {
918
1787
  enabled: {
919
- type: 'boolean',
920
- default: true
1788
+ type: 'boolean'
921
1789
  },
922
1790
  project: {
923
1791
  type: 'string',
924
- description: 'Project GCP Project id to deploy instances into'
1792
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1793
+ description: 'GCP project ID to deploy instances into. 6-30 chars, lowercase letters/digits/hyphens, must start with a letter and not end with a hyphen. Omit when GCP is disabled.',
1794
+ example: 'my-cloudfleet-project'
925
1795
  }
926
1796
  },
927
1797
  required: [
928
- 'project'
1798
+ 'enabled'
929
1799
  ],
930
1800
  additionalProperties: false
931
1801
  },
@@ -933,16 +1803,18 @@ export const FleetUpdateInputSchema = {
933
1803
  type: 'object',
934
1804
  properties: {
935
1805
  enabled: {
936
- type: 'boolean',
937
- default: true
1806
+ type: 'boolean'
938
1807
  },
939
1808
  apiKey: {
940
1809
  type: 'string',
941
- description: 'Hetzner Cloud API key with read / write access'
1810
+ maxLength: 64,
1811
+ minLength: 64,
1812
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1813
+ description: 'Hetzner Cloud API token with read/write access (64 alphanumeric characters). Write-only: reads return a redacted placeholder, never the token. Omit the field, or send the placeholder back unchanged, to keep the existing key. Send a new value to rotate it.'
942
1814
  }
943
1815
  },
944
1816
  required: [
945
- 'apiKey'
1817
+ 'enabled'
946
1818
  ],
947
1819
  additionalProperties: false
948
1820
  },
@@ -950,20 +1822,348 @@ export const FleetUpdateInputSchema = {
950
1822
  type: 'object',
951
1823
  properties: {
952
1824
  enabled: {
953
- type: 'boolean',
954
- default: true
1825
+ type: 'boolean'
955
1826
  },
956
1827
  controllerRoleArn: {
957
1828
  type: 'string',
958
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1829
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1830
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1831
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
959
1832
  }
960
1833
  },
961
1834
  required: [
962
- 'controllerRoleArn'
1835
+ 'enabled'
963
1836
  ],
964
1837
  additionalProperties: false
1838
+ },
1839
+ constraints: {
1840
+ type: 'object',
1841
+ properties: {
1842
+ 'karpenter.sh/capacity-type': {
1843
+ type: 'array',
1844
+ items: {
1845
+ type: 'string',
1846
+ enum: [
1847
+ 'on-demand',
1848
+ 'spot'
1849
+ ]
1850
+ },
1851
+ minItems: 1,
1852
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1853
+ default: [
1854
+ 'on-demand',
1855
+ 'spot'
1856
+ ]
1857
+ },
1858
+ 'kubernetes.io/arch': {
1859
+ type: 'array',
1860
+ items: {
1861
+ type: 'string',
1862
+ enum: [
1863
+ 'amd64',
1864
+ 'arm64'
1865
+ ]
1866
+ },
1867
+ minItems: 1,
1868
+ description: 'Allowed values for `kubernetes.io/arch`.',
1869
+ default: [
1870
+ 'amd64'
1871
+ ]
1872
+ },
1873
+ 'cfke.io/instance-family': {
1874
+ type: 'array',
1875
+ items: {
1876
+ type: 'string',
1877
+ enum: [
1878
+ 'a1',
1879
+ 'a2',
1880
+ 'a3',
1881
+ 'a4',
1882
+ 'c1',
1883
+ 'c2',
1884
+ 'c2d',
1885
+ 'c3',
1886
+ 'c3d',
1887
+ 'c4',
1888
+ 'c4a',
1889
+ 'c4d',
1890
+ 'c5',
1891
+ 'c5a',
1892
+ 'c5ad',
1893
+ 'c5d',
1894
+ 'c5n',
1895
+ 'c6a',
1896
+ 'c6g',
1897
+ 'c6gd',
1898
+ 'c6gn',
1899
+ 'c6i',
1900
+ 'c6id',
1901
+ 'c6in',
1902
+ 'c7a',
1903
+ 'c7g',
1904
+ 'c7gd',
1905
+ 'c7gn',
1906
+ 'c7i',
1907
+ 'c7i-flex',
1908
+ 'c8g',
1909
+ 'c8gd',
1910
+ 'cax',
1911
+ 'ccx',
1912
+ 'cpx',
1913
+ 'cx',
1914
+ 'd2',
1915
+ 'd3',
1916
+ 'd3en',
1917
+ 'dl1',
1918
+ 'dl2q',
1919
+ 'e2',
1920
+ 'f1',
1921
+ 'f2',
1922
+ 'g1',
1923
+ 'g2',
1924
+ 'g4ad',
1925
+ 'g4dn',
1926
+ 'g5',
1927
+ 'g5g',
1928
+ 'g6',
1929
+ 'g6e',
1930
+ 'gr6',
1931
+ 'h1',
1932
+ 'h3',
1933
+ 'hpc6a',
1934
+ 'hpc6id',
1935
+ 'hpc7a',
1936
+ 'hpc7g',
1937
+ 'i2',
1938
+ 'i3',
1939
+ 'i3en',
1940
+ 'i4g',
1941
+ 'i4i',
1942
+ 'i7i',
1943
+ 'i7ie',
1944
+ 'i8g',
1945
+ 'im4gn',
1946
+ 'inf1',
1947
+ 'inf2',
1948
+ 'is4gen',
1949
+ 'm1',
1950
+ 'm2',
1951
+ 'm3',
1952
+ 'm4',
1953
+ 'm5',
1954
+ 'm5a',
1955
+ 'm5ad',
1956
+ 'm5d',
1957
+ 'm5dn',
1958
+ 'm5n',
1959
+ 'm5zn',
1960
+ 'm6a',
1961
+ 'm6g',
1962
+ 'm6gd',
1963
+ 'm6i',
1964
+ 'm6id',
1965
+ 'm6idn',
1966
+ 'm6in',
1967
+ 'm7a',
1968
+ 'm7g',
1969
+ 'm7gd',
1970
+ 'm7i',
1971
+ 'm7i-flex',
1972
+ 'm8g',
1973
+ 'm8gd',
1974
+ 'n1',
1975
+ 'n2',
1976
+ 'n2d',
1977
+ 'n4',
1978
+ 'p3',
1979
+ 'p3dn',
1980
+ 'p4d',
1981
+ 'p4de',
1982
+ 'p5',
1983
+ 'p5e',
1984
+ 'p5en',
1985
+ 'p6-b200',
1986
+ 'r3',
1987
+ 'r4',
1988
+ 'r5',
1989
+ 'r5a',
1990
+ 'r5ad',
1991
+ 'r5b',
1992
+ 'r5d',
1993
+ 'r5dn',
1994
+ 'r5n',
1995
+ 'r6a',
1996
+ 'r6g',
1997
+ 'r6gd',
1998
+ 'r6i',
1999
+ 'r6id',
2000
+ 'r6idn',
2001
+ 'r6in',
2002
+ 'r7a',
2003
+ 'r7g',
2004
+ 'r7gd',
2005
+ 'r7i',
2006
+ 'r7iz',
2007
+ 'r8g',
2008
+ 'r8gd',
2009
+ 't2',
2010
+ 't2a',
2011
+ 't2d',
2012
+ 't3',
2013
+ 't3a',
2014
+ 't4g',
2015
+ 'trn1',
2016
+ 'trn1n',
2017
+ 'u-3tb1',
2018
+ 'u-6tb1',
2019
+ 'u7i-12tb',
2020
+ 'u7i-6tb',
2021
+ 'u7i-8tb',
2022
+ 'u7in-16tb',
2023
+ 'u7in-24tb',
2024
+ 'u7in-32tb',
2025
+ 'vt1',
2026
+ 'x1',
2027
+ 'x1e',
2028
+ 'x2gd',
2029
+ 'x2idn',
2030
+ 'x2iedn',
2031
+ 'x2iezn',
2032
+ 'x4',
2033
+ 'x8g',
2034
+ 'z1d',
2035
+ 'z3'
2036
+ ]
2037
+ },
2038
+ description: 'Allowed values for `cfke.io/instance-family`.',
2039
+ default: []
2040
+ },
2041
+ 'topology.kubernetes.io/region': {
2042
+ type: 'array',
2043
+ items: {
2044
+ type: 'string',
2045
+ enum: [
2046
+ 'africa-south1',
2047
+ 'ap-northeast-1',
2048
+ 'ap-northeast-2',
2049
+ 'ap-northeast-3',
2050
+ 'ap-south-1',
2051
+ 'ap-southeast-1',
2052
+ 'ap-southeast-2',
2053
+ 'ash',
2054
+ 'asia-east1',
2055
+ 'asia-east2',
2056
+ 'asia-northeast1',
2057
+ 'asia-northeast2',
2058
+ 'asia-northeast3',
2059
+ 'asia-south1',
2060
+ 'asia-south2',
2061
+ 'asia-southeast1',
2062
+ 'asia-southeast2',
2063
+ 'australia-southeast1',
2064
+ 'australia-southeast2',
2065
+ 'ca-central-1',
2066
+ 'eu-central-1',
2067
+ 'eu-central-2',
2068
+ 'eu-north-1',
2069
+ 'eu-west-1',
2070
+ 'eu-west-2',
2071
+ 'eu-west-3',
2072
+ 'europe-central2',
2073
+ 'europe-north1',
2074
+ 'europe-southwest1',
2075
+ 'europe-west1',
2076
+ 'europe-west10',
2077
+ 'europe-west12',
2078
+ 'europe-west2',
2079
+ 'europe-west3',
2080
+ 'europe-west4',
2081
+ 'europe-west6',
2082
+ 'europe-west8',
2083
+ 'europe-west9',
2084
+ 'fsn1',
2085
+ 'hel1',
2086
+ 'hil',
2087
+ 'me-central1',
2088
+ 'me-central2',
2089
+ 'me-west1',
2090
+ 'nbg1',
2091
+ 'northamerica-northeast1',
2092
+ 'northamerica-northeast2',
2093
+ 'sa-east-1',
2094
+ 'sin',
2095
+ 'southamerica-east1',
2096
+ 'southamerica-west1',
2097
+ 'us-central1',
2098
+ 'us-east-1',
2099
+ 'us-east-2',
2100
+ 'us-east1',
2101
+ 'us-east4',
2102
+ 'us-east5',
2103
+ 'us-south1',
2104
+ 'us-west-1',
2105
+ 'us-west-2',
2106
+ 'us-west1',
2107
+ 'us-west2',
2108
+ 'us-west3',
2109
+ 'us-west4'
2110
+ ]
2111
+ },
2112
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
2113
+ default: []
2114
+ }
2115
+ },
2116
+ additionalProperties: false,
2117
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
2118
+ default: {
2119
+ 'karpenter.sh/capacity-type': [
2120
+ 'on-demand',
2121
+ 'spot'
2122
+ ],
2123
+ 'kubernetes.io/arch': [
2124
+ 'amd64'
2125
+ ],
2126
+ 'cfke.io/instance-family': [],
2127
+ 'topology.kubernetes.io/region': []
2128
+ }
2129
+ },
2130
+ scalingProfile: {
2131
+ type: 'string',
2132
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet. Full-overwrite: omit to reset to the default (`conservative`).',
2133
+ default: 'conservative',
2134
+ example: 'conservative',
2135
+ enum: [
2136
+ 'aggressive',
2137
+ 'conservative'
2138
+ ]
965
2139
  }
966
2140
  },
2141
+ additionalProperties: false,
2142
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
2143
+ };
2144
+ export const InviteCreateInputSchema = {
2145
+ type: 'object',
2146
+ properties: {
2147
+ email: {
2148
+ type: 'string',
2149
+ format: 'email',
2150
+ description: 'Email address of the user to invite.',
2151
+ example: 'email@example.com'
2152
+ },
2153
+ role: {
2154
+ type: 'string',
2155
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2156
+ default: 'User',
2157
+ example: 'User',
2158
+ enum: [
2159
+ 'Administrator',
2160
+ 'User'
2161
+ ]
2162
+ }
2163
+ },
2164
+ required: [
2165
+ 'email'
2166
+ ],
967
2167
  additionalProperties: false
968
2168
  };
969
2169
  export const InviteSchema = {
@@ -996,6 +2196,16 @@ export const InviteSchema = {
996
2196
  type: 'string',
997
2197
  description: 'Generated unique invite code.',
998
2198
  example: '7kUZnH7nnKUFfvc4NK2KQF'
2199
+ },
2200
+ role: {
2201
+ type: 'string',
2202
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2203
+ default: 'User',
2204
+ example: 'User',
2205
+ enum: [
2206
+ 'Administrator',
2207
+ 'User'
2208
+ ]
999
2209
  }
1000
2210
  },
1001
2211
  required: [
@@ -1216,6 +2426,15 @@ export const MarketplaceListingSchema = {
1216
2426
  export const OrganizationCreateInputSchema = {
1217
2427
  type: 'object',
1218
2428
  properties: {
2429
+ type: {
2430
+ type: 'string',
2431
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2432
+ example: 'business',
2433
+ enum: [
2434
+ 'business',
2435
+ 'personal'
2436
+ ]
2437
+ },
1219
2438
  email: {
1220
2439
  type: 'string',
1221
2440
  format: 'email',
@@ -1224,11 +2443,13 @@ export const OrganizationCreateInputSchema = {
1224
2443
  },
1225
2444
  first_name: {
1226
2445
  type: 'string',
2446
+ minLength: 1,
1227
2447
  description: 'First name of the billing contact person.',
1228
2448
  example: 'John'
1229
2449
  },
1230
2450
  last_name: {
1231
2451
  type: 'string',
2452
+ minLength: 1,
1232
2453
  description: 'Last name of the billing contact person.',
1233
2454
  example: 'Doe'
1234
2455
  },
@@ -1247,6 +2468,7 @@ export const OrganizationCreateInputSchema = {
1247
2468
  }
1248
2469
  },
1249
2470
  required: [
2471
+ 'type',
1250
2472
  'email',
1251
2473
  'first_name',
1252
2474
  'last_name',
@@ -1255,6 +2477,20 @@ export const OrganizationCreateInputSchema = {
1255
2477
  ],
1256
2478
  additionalProperties: false
1257
2479
  };
2480
+ export const OrganizationCreateOutputSchema = {
2481
+ type: 'object',
2482
+ properties: {
2483
+ id: {
2484
+ type: 'string',
2485
+ description: 'Unique identifier of the newly created organization. Generated by the API and safe to use for client-side tracking immediately.',
2486
+ example: 'organization-id'
2487
+ }
2488
+ },
2489
+ required: [
2490
+ 'id'
2491
+ ],
2492
+ additionalProperties: false
2493
+ };
1258
2494
  export const OrganizationSchema = {
1259
2495
  type: 'object',
1260
2496
  properties: {
@@ -1271,6 +2507,15 @@ export const OrganizationSchema = {
1271
2507
  description: 'Name of the legal entity. This name will be used in invoices. Use your first and last name for individual accounts.',
1272
2508
  example: 'ACME Corp.'
1273
2509
  },
2510
+ type: {
2511
+ type: 'string',
2512
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2513
+ example: 'business',
2514
+ enum: [
2515
+ 'business',
2516
+ 'personal'
2517
+ ]
2518
+ },
1274
2519
  date_created: {
1275
2520
  type: 'string',
1276
2521
  format: 'date-time',
@@ -1302,6 +2547,17 @@ export const OrganizationSchema = {
1302
2547
  description: 'Available number of Pro clusters that can be created.',
1303
2548
  example: 999
1304
2549
  },
2550
+ enterprise_clusters_max: {
2551
+ type: 'integer',
2552
+ minimum: 0,
2553
+ description: 'Maximum number of Enterprise clusters that can be created.',
2554
+ example: 999
2555
+ },
2556
+ enterprise_clusters_available: {
2557
+ type: 'integer',
2558
+ description: 'Available number of Enterprise clusters that can be created.',
2559
+ example: 999
2560
+ },
1305
2561
  fleets_max: {
1306
2562
  type: 'integer',
1307
2563
  minimum: 0,
@@ -1321,7 +2577,7 @@ export const OrganizationSchema = {
1321
2577
  type: 'array',
1322
2578
  items: {
1323
2579
  type: 'string',
1324
- example: 'northamerica-central-1'
2580
+ example: 'northamerica-central-1a'
1325
2581
  },
1326
2582
  minItems: 1,
1327
2583
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -1351,18 +2607,6 @@ export const OrganizationSchema = {
1351
2607
  minItems: 1,
1352
2608
  description: 'List of CFKE control plane versions available for the organization.'
1353
2609
  },
1354
- copilot_user_hourly_tokens: {
1355
- type: 'integer',
1356
- minimum: 0,
1357
- description: 'User-level maximum number of tokens Cloudfleet Copilot can process per hour.',
1358
- example: 42000
1359
- },
1360
- copilot_organization_hourly_tokens: {
1361
- type: 'integer',
1362
- minimum: 0,
1363
- description: 'Organization-level maximum number of tokens Cloudfleet Copilot can process per hour.',
1364
- example: 242000
1365
- },
1366
2610
  cfcr_storage_gb: {
1367
2611
  type: 'integer',
1368
2612
  minimum: -1,
@@ -1375,12 +2619,12 @@ export const OrganizationSchema = {
1375
2619
  'basic_clusters_available',
1376
2620
  'pro_clusters_max',
1377
2621
  'pro_clusters_available',
2622
+ 'enterprise_clusters_max',
2623
+ 'enterprise_clusters_available',
1378
2624
  'fleets_max',
1379
2625
  'cluster_tiers',
1380
2626
  'regions',
1381
2627
  'versions',
1382
- 'copilot_user_hourly_tokens',
1383
- 'copilot_organization_hourly_tokens',
1384
2628
  'cfcr_storage_gb'
1385
2629
  ],
1386
2630
  additionalProperties: false,
@@ -1394,13 +2638,25 @@ export const OrganizationSchema = {
1394
2638
  'closed',
1395
2639
  'suspended'
1396
2640
  ]
2641
+ },
2642
+ verification: {
2643
+ type: 'string',
2644
+ description: 'Verification status of the organization, which determines the assigned quota. `none` when billing information is incomplete, `submitted` when billing information is complete but the organization is not yet verified, `verified` when the organization is verified.',
2645
+ example: 'verified',
2646
+ enum: [
2647
+ 'none',
2648
+ 'submitted',
2649
+ 'verified'
2650
+ ]
1397
2651
  }
1398
2652
  },
1399
2653
  required: [
1400
2654
  'id',
2655
+ 'type',
1401
2656
  'date_created',
1402
2657
  'quota',
1403
- 'status'
2658
+ 'status',
2659
+ 'verification'
1404
2660
  ],
1405
2661
  additionalProperties: false
1406
2662
  };
@@ -1409,28 +2665,23 @@ export const PaymentMethodSchema = {
1409
2665
  properties: {
1410
2666
  id: {
1411
2667
  type: 'string',
1412
- format: 'uuid',
1413
- description: 'Unique identifier of the organization. UUID v4 string in canonical form.',
1414
- example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
1415
- },
1416
- setup: {
1417
- type: 'boolean',
1418
- description: 'Whether organization payment method was set up and ready to use for payments.',
1419
- example: true
2668
+ description: 'Payment method identifier. Stripe payment method id for cards/SEPA; the constant `bank_transfer` for the invoice/bank-transfer method. Used to set as default or delete the payment method.',
2669
+ example: 'pm_1MtwBwLkdIwHu7ix28a3tqPa'
1420
2670
  },
1421
2671
  type: {
1422
2672
  type: 'string',
1423
- nullable: true,
1424
- description: 'Payment method type type. Only `card` payments supported at the moment.',
2673
+ description: 'Payment method type. `card`, `sepa_debit` for SEPA Direct Debit (business accounts only), or `bank_transfer` for paying invoices by bank transfer.',
1425
2674
  example: 'card',
1426
2675
  enum: [
1427
- 'card'
2676
+ 'card',
2677
+ 'sepa_debit',
2678
+ 'bank_transfer'
1428
2679
  ]
1429
2680
  },
1430
2681
  last4: {
1431
2682
  type: 'string',
1432
2683
  nullable: true,
1433
- description: 'Last 4 digits of the payment card number.',
2684
+ description: 'Last 4 digits of the payment card number, of the bank account (IBAN) for SEPA Direct Debit, or of the destination IBAN for bank transfer.',
1434
2685
  example: '4242'
1435
2686
  },
1436
2687
  exp_month: {
@@ -1438,42 +2689,56 @@ export const PaymentMethodSchema = {
1438
2689
  minimum: 1,
1439
2690
  maximum: 12,
1440
2691
  nullable: true,
1441
- description: 'Two-digit number representing the card\'s expiration month.',
1442
- example: '12'
2692
+ description: 'Two-digit number representing the card\'s expiration month. Null for SEPA Direct Debit and bank transfer.',
2693
+ example: 12
1443
2694
  },
1444
2695
  exp_year: {
1445
2696
  type: 'integer',
1446
- minimum: 2024,
1447
2697
  nullable: true,
1448
- description: 'Four-digit number representing the card\'s expiration year.',
1449
- example: '2028'
2698
+ description: 'Four-digit number representing the card\'s expiration year. May be in the past for an expired card still on file. Null for SEPA Direct Debit and bank transfer.',
2699
+ example: 2028
1450
2700
  },
1451
2701
  brand: {
1452
2702
  type: 'string',
1453
2703
  nullable: true,
1454
- description: 'Payment card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.',
1455
- example: 'visa',
1456
- enum: [
1457
- 'amex',
1458
- 'diners',
1459
- 'discover',
1460
- 'eftpos_au',
1461
- 'jcb',
1462
- 'mastercard',
1463
- 'unionpay',
1464
- 'visa',
1465
- 'unknown'
1466
- ]
2704
+ description: 'Payment card brand as reported by Stripe, e.g. `visa`, `mastercard`, `amex`, `cartes_bancaires`, or `unknown`. Null for SEPA Direct Debit and bank transfer.',
2705
+ example: 'visa'
2706
+ },
2707
+ iban: {
2708
+ type: 'string',
2709
+ nullable: true,
2710
+ description: 'Full destination IBAN to send bank transfers to. Set only for `bank_transfer`; null otherwise. This is Cloudfleet\'s virtual receiving account, shown in full so the customer can pay into it.',
2711
+ example: 'DE11243015658023127510'
2712
+ },
2713
+ bic: {
2714
+ type: 'string',
2715
+ nullable: true,
2716
+ description: 'BIC/SWIFT of the destination bank for bank transfers. Set only for `bank_transfer`; null otherwise.',
2717
+ example: 'SOGEDEFFXXX'
2718
+ },
2719
+ account_holder_name: {
2720
+ type: 'string',
2721
+ nullable: true,
2722
+ description: 'Account holder name of the destination bank account for bank transfers. Set only for `bank_transfer`; null otherwise.',
2723
+ example: 'Cloudfleet GmbH'
2724
+ },
2725
+ is_default: {
2726
+ type: 'boolean',
2727
+ description: 'Whether this payment method is the default used for invoices and active subscriptions. Always false for `bank_transfer` (it cannot be a Stripe default payment method).',
2728
+ example: true
1467
2729
  }
1468
2730
  },
1469
2731
  required: [
1470
2732
  'id',
1471
- 'setup',
1472
2733
  'type',
1473
2734
  'last4',
1474
2735
  'exp_month',
1475
2736
  'exp_year',
1476
- 'brand'
2737
+ 'brand',
2738
+ 'iban',
2739
+ 'bic',
2740
+ 'account_holder_name',
2741
+ 'is_default'
1477
2742
  ],
1478
2743
  additionalProperties: false
1479
2744
  };
@@ -1502,6 +2767,17 @@ export const PlatformQuotaSchema = {
1502
2767
  description: 'Available number of Pro clusters that can be created.',
1503
2768
  example: 999
1504
2769
  },
2770
+ enterprise_clusters_max: {
2771
+ type: 'integer',
2772
+ minimum: 0,
2773
+ description: 'Maximum number of Enterprise clusters that can be created.',
2774
+ example: 999
2775
+ },
2776
+ enterprise_clusters_available: {
2777
+ type: 'integer',
2778
+ description: 'Available number of Enterprise clusters that can be created.',
2779
+ example: 999
2780
+ },
1505
2781
  fleets_max: {
1506
2782
  type: 'integer',
1507
2783
  minimum: 0,
@@ -1521,7 +2797,7 @@ export const PlatformQuotaSchema = {
1521
2797
  type: 'array',
1522
2798
  items: {
1523
2799
  type: 'string',
1524
- example: 'northamerica-central-1'
2800
+ example: 'northamerica-central-1a'
1525
2801
  },
1526
2802
  minItems: 1,
1527
2803
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -1551,18 +2827,6 @@ export const PlatformQuotaSchema = {
1551
2827
  minItems: 1,
1552
2828
  description: 'List of CFKE control plane versions available for the organization.'
1553
2829
  },
1554
- copilot_user_hourly_tokens: {
1555
- type: 'integer',
1556
- minimum: 0,
1557
- description: 'User-level maximum number of tokens Cloudfleet Copilot can process per hour.',
1558
- example: 42000
1559
- },
1560
- copilot_organization_hourly_tokens: {
1561
- type: 'integer',
1562
- minimum: 0,
1563
- description: 'Organization-level maximum number of tokens Cloudfleet Copilot can process per hour.',
1564
- example: 242000
1565
- },
1566
2830
  cfcr_storage_gb: {
1567
2831
  type: 'integer',
1568
2832
  minimum: -1,
@@ -1575,12 +2839,12 @@ export const PlatformQuotaSchema = {
1575
2839
  'basic_clusters_available',
1576
2840
  'pro_clusters_max',
1577
2841
  'pro_clusters_available',
2842
+ 'enterprise_clusters_max',
2843
+ 'enterprise_clusters_available',
1578
2844
  'fleets_max',
1579
2845
  'cluster_tiers',
1580
2846
  'regions',
1581
2847
  'versions',
1582
- 'copilot_user_hourly_tokens',
1583
- 'copilot_organization_hourly_tokens',
1584
2848
  'cfcr_storage_gb'
1585
2849
  ],
1586
2850
  additionalProperties: false
@@ -1850,6 +3114,492 @@ export const RegistryTagSchema = {
1850
3114
  ],
1851
3115
  additionalProperties: false
1852
3116
  };
3117
+ export const TicketAttachmentSchema = {
3118
+ type: 'object',
3119
+ properties: {
3120
+ id: {
3121
+ type: 'string',
3122
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3123
+ example: '60c72b2f9f1b2c001f8e4d3c'
3124
+ },
3125
+ filename: {
3126
+ type: 'string',
3127
+ description: 'Original filename as uploaded.',
3128
+ example: 'debug.log'
3129
+ },
3130
+ content_type: {
3131
+ type: 'string',
3132
+ description: 'MIME content type of the attachment.',
3133
+ example: 'text/plain'
3134
+ },
3135
+ size: {
3136
+ type: 'integer',
3137
+ description: 'Size of the attachment in bytes.',
3138
+ example: 12345
3139
+ }
3140
+ },
3141
+ required: [
3142
+ 'id',
3143
+ 'filename',
3144
+ 'content_type',
3145
+ 'size'
3146
+ ],
3147
+ additionalProperties: false
3148
+ };
3149
+ export const TicketCreateInputSchema = {
3150
+ type: 'object',
3151
+ properties: {
3152
+ category: {
3153
+ type: 'string',
3154
+ description: 'Ticket category. Drives auto-assignment and may carry a subcategory in `properties`.',
3155
+ example: 'technical',
3156
+ enum: [
3157
+ 'billing',
3158
+ 'technical',
3159
+ 'general'
3160
+ ]
3161
+ },
3162
+ body: {
3163
+ type: 'string',
3164
+ maxLength: 50000,
3165
+ minLength: 1,
3166
+ pattern: '\\S',
3167
+ description: 'Initial message body in markdown. There is no separate subject — the first message body is the description.',
3168
+ example: 'My cluster cannot reach the registry. Logs attached.'
3169
+ },
3170
+ properties: {
3171
+ type: 'object',
3172
+ additionalProperties: true,
3173
+ description: 'Free-form key/value bag set by the UI (e.g. `subcategory`, `cluster_id`, `cluster_name`, `region`).',
3174
+ example: {
3175
+ subcategory: 'cluster-question',
3176
+ cluster_id: '60c72b2f9f1b2c001f8e4d3a'
3177
+ }
3178
+ }
3179
+ },
3180
+ required: [
3181
+ 'category',
3182
+ 'body'
3183
+ ],
3184
+ additionalProperties: false
3185
+ };
3186
+ export const TicketListResponseSchema = {
3187
+ type: 'object',
3188
+ properties: {
3189
+ items: {
3190
+ type: 'array',
3191
+ items: {
3192
+ type: 'object',
3193
+ properties: {
3194
+ id: {
3195
+ type: 'string',
3196
+ description: 'Unique identifier of the ticket (Mongo ObjectId).',
3197
+ example: '60c72b2f9f1b2c001f8e4d3a'
3198
+ },
3199
+ status: {
3200
+ type: 'string',
3201
+ description: 'Current state of the ticket.',
3202
+ example: 'waiting_on_us',
3203
+ enum: [
3204
+ 'waiting_on_us',
3205
+ 'waiting_on_user',
3206
+ 'closed'
3207
+ ]
3208
+ },
3209
+ category: {
3210
+ type: 'string',
3211
+ description: 'Ticket category.',
3212
+ example: 'technical',
3213
+ enum: [
3214
+ 'billing',
3215
+ 'technical',
3216
+ 'general'
3217
+ ]
3218
+ },
3219
+ summary: {
3220
+ type: 'string',
3221
+ description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
3222
+ example: 'My cluster cannot reach the registry. Logs attached.'
3223
+ },
3224
+ closed_at: {
3225
+ type: 'string',
3226
+ format: 'date-time',
3227
+ nullable: true,
3228
+ description: 'Closure timestamp. Null while the ticket is open.',
3229
+ example: '2026-05-18T16:08:14.338Z'
3230
+ },
3231
+ date_created: {
3232
+ type: 'string',
3233
+ format: 'date-time',
3234
+ description: 'Creation date of the ticket. ISO 8601 UTC.',
3235
+ example: '2026-05-11T16:08:14.338Z'
3236
+ },
3237
+ date_updated: {
3238
+ type: 'string',
3239
+ format: 'date-time',
3240
+ description: 'Last update date of the ticket. ISO 8601 UTC.',
3241
+ example: '2026-05-11T16:08:14.338Z'
3242
+ },
3243
+ messages: {
3244
+ type: 'array',
3245
+ items: {
3246
+ type: 'object',
3247
+ properties: {
3248
+ id: {
3249
+ type: 'string',
3250
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3251
+ example: '60c72b2f9f1b2c001f8e4d3b'
3252
+ },
3253
+ type: {
3254
+ type: 'string',
3255
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3256
+ example: 'customer_reply',
3257
+ enum: [
3258
+ 'customer_reply',
3259
+ 'agent_reply'
3260
+ ]
3261
+ },
3262
+ body: {
3263
+ type: 'string',
3264
+ description: 'Message body in markdown.',
3265
+ example: 'Thanks — that resolved it on my side.'
3266
+ },
3267
+ author_first_name: {
3268
+ type: 'string',
3269
+ nullable: true,
3270
+ description: 'First name of the author. Null when not provided.',
3271
+ example: 'Jane'
3272
+ },
3273
+ author_last_name: {
3274
+ type: 'string',
3275
+ nullable: true,
3276
+ description: 'Last name of the author. Null when not provided.',
3277
+ example: 'Doe'
3278
+ },
3279
+ attachments: {
3280
+ type: 'array',
3281
+ items: {
3282
+ type: 'object',
3283
+ properties: {
3284
+ id: {
3285
+ type: 'string',
3286
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3287
+ example: '60c72b2f9f1b2c001f8e4d3c'
3288
+ },
3289
+ filename: {
3290
+ type: 'string',
3291
+ description: 'Original filename as uploaded.',
3292
+ example: 'debug.log'
3293
+ },
3294
+ content_type: {
3295
+ type: 'string',
3296
+ description: 'MIME content type of the attachment.',
3297
+ example: 'text/plain'
3298
+ },
3299
+ size: {
3300
+ type: 'integer',
3301
+ description: 'Size of the attachment in bytes.',
3302
+ example: 12345
3303
+ }
3304
+ },
3305
+ required: [
3306
+ 'id',
3307
+ 'filename',
3308
+ 'content_type',
3309
+ 'size'
3310
+ ],
3311
+ additionalProperties: false
3312
+ },
3313
+ description: 'Attachments associated with this message.',
3314
+ example: []
3315
+ },
3316
+ date_created: {
3317
+ type: 'string',
3318
+ format: 'date-time',
3319
+ description: 'Creation date of the message. ISO 8601 UTC.',
3320
+ example: '2026-05-11T16:08:14.338Z'
3321
+ }
3322
+ },
3323
+ required: [
3324
+ 'id',
3325
+ 'type',
3326
+ 'body',
3327
+ 'date_created'
3328
+ ],
3329
+ additionalProperties: false
3330
+ },
3331
+ description: 'Messages on the ticket in chronological order. Internal notes are excluded. Returned by the detail endpoint only.'
3332
+ }
3333
+ },
3334
+ required: [
3335
+ 'id',
3336
+ 'status',
3337
+ 'category',
3338
+ 'summary',
3339
+ 'date_created',
3340
+ 'date_updated'
3341
+ ],
3342
+ additionalProperties: false
3343
+ },
3344
+ description: 'Tickets for the organization, ordered newest first. Messages are omitted from list responses.'
3345
+ }
3346
+ },
3347
+ required: [
3348
+ 'items'
3349
+ ],
3350
+ additionalProperties: false
3351
+ };
3352
+ export const TicketMessageInputSchema = {
3353
+ type: 'object',
3354
+ properties: {
3355
+ body: {
3356
+ type: 'string',
3357
+ maxLength: 50000,
3358
+ minLength: 1,
3359
+ pattern: '\\S',
3360
+ description: 'Reply body in markdown.',
3361
+ example: 'Thanks — that resolved it on my side.'
3362
+ }
3363
+ },
3364
+ required: [
3365
+ 'body'
3366
+ ],
3367
+ additionalProperties: false
3368
+ };
3369
+ export const TicketMessageSchema = {
3370
+ type: 'object',
3371
+ properties: {
3372
+ id: {
3373
+ type: 'string',
3374
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3375
+ example: '60c72b2f9f1b2c001f8e4d3b'
3376
+ },
3377
+ type: {
3378
+ type: 'string',
3379
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3380
+ example: 'customer_reply',
3381
+ enum: [
3382
+ 'customer_reply',
3383
+ 'agent_reply'
3384
+ ]
3385
+ },
3386
+ body: {
3387
+ type: 'string',
3388
+ description: 'Message body in markdown.',
3389
+ example: 'Thanks — that resolved it on my side.'
3390
+ },
3391
+ author_first_name: {
3392
+ type: 'string',
3393
+ description: 'First name of the author. Null when not provided.',
3394
+ example: 'Jane'
3395
+ },
3396
+ author_last_name: {
3397
+ type: 'string',
3398
+ description: 'Last name of the author. Null when not provided.',
3399
+ example: 'Doe'
3400
+ },
3401
+ attachments: {
3402
+ type: 'array',
3403
+ items: {
3404
+ type: 'object',
3405
+ properties: {
3406
+ id: {
3407
+ type: 'string',
3408
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3409
+ example: '60c72b2f9f1b2c001f8e4d3c'
3410
+ },
3411
+ filename: {
3412
+ type: 'string',
3413
+ description: 'Original filename as uploaded.',
3414
+ example: 'debug.log'
3415
+ },
3416
+ content_type: {
3417
+ type: 'string',
3418
+ description: 'MIME content type of the attachment.',
3419
+ example: 'text/plain'
3420
+ },
3421
+ size: {
3422
+ type: 'integer',
3423
+ description: 'Size of the attachment in bytes.',
3424
+ example: 12345
3425
+ }
3426
+ },
3427
+ required: [
3428
+ 'id',
3429
+ 'filename',
3430
+ 'content_type',
3431
+ 'size'
3432
+ ],
3433
+ additionalProperties: false
3434
+ },
3435
+ description: 'Attachments associated with this message.',
3436
+ example: []
3437
+ },
3438
+ date_created: {
3439
+ type: 'string',
3440
+ format: 'date-time',
3441
+ description: 'Creation date of the message. ISO 8601 UTC.',
3442
+ example: '2026-05-11T16:08:14.338Z'
3443
+ }
3444
+ },
3445
+ required: [
3446
+ 'id',
3447
+ 'type',
3448
+ 'body',
3449
+ 'date_created'
3450
+ ],
3451
+ additionalProperties: false
3452
+ };
3453
+ export const TicketSchema = {
3454
+ type: 'object',
3455
+ properties: {
3456
+ id: {
3457
+ type: 'string',
3458
+ description: 'Unique identifier of the ticket (Mongo ObjectId).',
3459
+ example: '60c72b2f9f1b2c001f8e4d3a'
3460
+ },
3461
+ status: {
3462
+ type: 'string',
3463
+ description: 'Current state of the ticket.',
3464
+ example: 'waiting_on_us',
3465
+ enum: [
3466
+ 'waiting_on_us',
3467
+ 'waiting_on_user',
3468
+ 'closed'
3469
+ ]
3470
+ },
3471
+ category: {
3472
+ type: 'string',
3473
+ description: 'Ticket category.',
3474
+ example: 'technical',
3475
+ enum: [
3476
+ 'billing',
3477
+ 'technical',
3478
+ 'general'
3479
+ ]
3480
+ },
3481
+ summary: {
3482
+ type: 'string',
3483
+ description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
3484
+ example: 'My cluster cannot reach the registry. Logs attached.'
3485
+ },
3486
+ closed_at: {
3487
+ type: 'string',
3488
+ format: 'date-time',
3489
+ description: 'Closure timestamp. Null while the ticket is open.',
3490
+ example: '2026-05-18T16:08:14.338Z'
3491
+ },
3492
+ date_created: {
3493
+ type: 'string',
3494
+ format: 'date-time',
3495
+ description: 'Creation date of the ticket. ISO 8601 UTC.',
3496
+ example: '2026-05-11T16:08:14.338Z'
3497
+ },
3498
+ date_updated: {
3499
+ type: 'string',
3500
+ format: 'date-time',
3501
+ description: 'Last update date of the ticket. ISO 8601 UTC.',
3502
+ example: '2026-05-11T16:08:14.338Z'
3503
+ },
3504
+ messages: {
3505
+ type: 'array',
3506
+ items: {
3507
+ type: 'object',
3508
+ properties: {
3509
+ id: {
3510
+ type: 'string',
3511
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3512
+ example: '60c72b2f9f1b2c001f8e4d3b'
3513
+ },
3514
+ type: {
3515
+ type: 'string',
3516
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3517
+ example: 'customer_reply',
3518
+ enum: [
3519
+ 'customer_reply',
3520
+ 'agent_reply'
3521
+ ]
3522
+ },
3523
+ body: {
3524
+ type: 'string',
3525
+ description: 'Message body in markdown.',
3526
+ example: 'Thanks — that resolved it on my side.'
3527
+ },
3528
+ author_first_name: {
3529
+ type: 'string',
3530
+ description: 'First name of the author. Null when not provided.',
3531
+ example: 'Jane'
3532
+ },
3533
+ author_last_name: {
3534
+ type: 'string',
3535
+ description: 'Last name of the author. Null when not provided.',
3536
+ example: 'Doe'
3537
+ },
3538
+ attachments: {
3539
+ type: 'array',
3540
+ items: {
3541
+ type: 'object',
3542
+ properties: {
3543
+ id: {
3544
+ type: 'string',
3545
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3546
+ example: '60c72b2f9f1b2c001f8e4d3c'
3547
+ },
3548
+ filename: {
3549
+ type: 'string',
3550
+ description: 'Original filename as uploaded.',
3551
+ example: 'debug.log'
3552
+ },
3553
+ content_type: {
3554
+ type: 'string',
3555
+ description: 'MIME content type of the attachment.',
3556
+ example: 'text/plain'
3557
+ },
3558
+ size: {
3559
+ type: 'integer',
3560
+ description: 'Size of the attachment in bytes.',
3561
+ example: 12345
3562
+ }
3563
+ },
3564
+ required: [
3565
+ 'id',
3566
+ 'filename',
3567
+ 'content_type',
3568
+ 'size'
3569
+ ],
3570
+ additionalProperties: false
3571
+ },
3572
+ description: 'Attachments associated with this message.',
3573
+ example: []
3574
+ },
3575
+ date_created: {
3576
+ type: 'string',
3577
+ format: 'date-time',
3578
+ description: 'Creation date of the message. ISO 8601 UTC.',
3579
+ example: '2026-05-11T16:08:14.338Z'
3580
+ }
3581
+ },
3582
+ required: [
3583
+ 'id',
3584
+ 'type',
3585
+ 'body',
3586
+ 'date_created'
3587
+ ],
3588
+ additionalProperties: false
3589
+ },
3590
+ description: 'Messages on the ticket in chronological order. Internal notes are excluded. Returned by the detail endpoint only.'
3591
+ }
3592
+ },
3593
+ required: [
3594
+ 'id',
3595
+ 'status',
3596
+ 'category',
3597
+ 'summary',
3598
+ 'date_created',
3599
+ 'date_updated'
3600
+ ],
3601
+ additionalProperties: false
3602
+ };
1853
3603
  export const TokenCreateInputSchema = {
1854
3604
  type: 'object',
1855
3605
  properties: {
@@ -2138,24 +3888,6 @@ export const UserCreateInputSchema = {
2138
3888
  type: 'string',
2139
3889
  minLength: 8,
2140
3890
  description: 'User password. Must be at least 8 characters long.'
2141
- },
2142
- status: {
2143
- type: 'string',
2144
- description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
2145
- example: 'active',
2146
- enum: [
2147
- 'active',
2148
- 'inactive'
2149
- ]
2150
- },
2151
- role: {
2152
- type: 'string',
2153
- description: 'User role. Can be \'Administrator\', \'User\'.',
2154
- example: 'User',
2155
- enum: [
2156
- 'Administrator',
2157
- 'User'
2158
- ]
2159
3891
  }
2160
3892
  },
2161
3893
  required: [