@cloudfleet/sdk 0.0.1-28564af → 0.0.1-289b770

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 (46) hide show
  1. package/README.md +56 -2
  2. package/dist/@tanstack/react-query.gen.d.ts +432 -614
  3. package/dist/@tanstack/react-query.gen.d.ts.map +1 -1
  4. package/dist/@tanstack/react-query.gen.js +431 -404
  5. package/dist/@tanstack/react-query.gen.js.map +1 -1
  6. package/dist/client/client.gen.d.ts.map +1 -1
  7. package/dist/client/client.gen.js +1 -4
  8. package/dist/client/client.gen.js.map +1 -1
  9. package/dist/client/types.gen.d.ts +1 -1
  10. package/dist/client/types.gen.d.ts.map +1 -1
  11. package/dist/client/utils.gen.d.ts +2 -2
  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/errors.d.ts +42 -0
  18. package/dist/errors.d.ts.map +1 -0
  19. package/dist/errors.js +83 -0
  20. package/dist/errors.js.map +1 -0
  21. package/dist/index.d.ts +1 -0
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index.js +4 -0
  24. package/dist/index.js.map +1 -1
  25. package/dist/schemas.gen.d.ts +971 -514
  26. package/dist/schemas.gen.d.ts.map +1 -1
  27. package/dist/schemas.gen.js +1961 -664
  28. package/dist/schemas.gen.js.map +1 -1
  29. package/dist/sdk.gen.d.ts +226 -221
  30. package/dist/sdk.gen.d.ts.map +1 -1
  31. package/dist/sdk.gen.js +340 -324
  32. package/dist/sdk.gen.js.map +1 -1
  33. package/dist/services/kubernetes/api.d.ts +18 -55
  34. package/dist/services/kubernetes/api.d.ts.map +1 -1
  35. package/dist/services/kubernetes/api.js +36 -75
  36. package/dist/services/kubernetes/api.js.map +1 -1
  37. package/dist/services/kubernetes/index.d.ts.map +1 -1
  38. package/dist/services/kubernetes/index.js +36 -37
  39. package/dist/services/kubernetes/index.js.map +1 -1
  40. package/dist/types.gen.d.ts +1334 -994
  41. package/dist/types.gen.d.ts.map +1 -1
  42. package/dist/zod.gen.d.ts +3539 -1498
  43. package/dist/zod.gen.d.ts.map +1 -1
  44. package/dist/zod.gen.js +1289 -399
  45. package/dist/zod.gen.js.map +1 -1
  46. package/package.json +10 -15
@@ -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,
@@ -84,12 +93,17 @@ export const BillingContactSchema = {
84
93
  'at_vat',
85
94
  'au_abn',
86
95
  'au_arn',
96
+ 'aw_tin',
97
+ 'az_tin',
87
98
  'ba_tin',
88
99
  'bb_tin',
100
+ 'bd_bin',
89
101
  'be_vat',
102
+ 'bf_ifu',
90
103
  'bg_uic',
91
104
  'bg_vat',
92
105
  'bh_vat',
106
+ 'bj_ifu',
93
107
  'bo_tin',
94
108
  'br_cnpj',
95
109
  'br_cpf',
@@ -105,9 +119,11 @@ export const BillingContactSchema = {
105
119
  'ch_uid',
106
120
  'ch_vat',
107
121
  'cl_tin',
122
+ 'cm_niu',
108
123
  'cn_tin',
109
124
  'co_nit',
110
125
  'cr_tin',
126
+ 'cv_nif',
111
127
  'cy_vat',
112
128
  'cz_vat',
113
129
  'de_stn',
@@ -119,6 +135,7 @@ export const BillingContactSchema = {
119
135
  'eg_tin',
120
136
  'es_cif',
121
137
  'es_vat',
138
+ 'et_tin',
122
139
  'eu_oss_vat',
123
140
  'fi_vat',
124
141
  'fr_vat',
@@ -141,11 +158,14 @@ export const BillingContactSchema = {
141
158
  'jp_rn',
142
159
  'jp_trn',
143
160
  'ke_pin',
161
+ 'kg_tin',
144
162
  'kh_tin',
145
163
  'kr_brn',
146
164
  'kz_bin',
165
+ 'la_tin',
147
166
  'li_uid',
148
167
  'li_vat',
168
+ 'lk_vat',
149
169
  'lt_vat',
150
170
  'lu_vat',
151
171
  'lv_vat',
@@ -207,6 +227,7 @@ export const BillingContactSchema = {
207
227
  }
208
228
  },
209
229
  required: [
230
+ 'type',
210
231
  'email',
211
232
  'individual_name'
212
233
  ],
@@ -272,166 +293,6 @@ export const BillingCreditsSchema = {
272
293
  ],
273
294
  additionalProperties: false
274
295
  };
275
- export const ChartCreateInputSchema = {
276
- type: 'object',
277
- properties: {
278
- values: {
279
- type: 'string',
280
- description: 'Values to be used in the chart encoded as a JSON string.'
281
- },
282
- version_channel: {
283
- type: 'string',
284
- 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-]+)*))?$',
285
- description: 'Desired version range or channel for the chart.',
286
- example: '2.x.x-cfke.x'
287
- },
288
- name: {
289
- type: 'string',
290
- maxLength: 63,
291
- minLength: 1,
292
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
293
- description: 'Unique identifier of the chart deployment aka name of the helm release.',
294
- example: 'postgresql-0'
295
- },
296
- namespace: {
297
- type: 'string',
298
- maxLength: 63,
299
- minLength: 1,
300
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
301
- description: 'Namespace of the chart deployment',
302
- example: 'default'
303
- },
304
- chart: {
305
- type: 'string',
306
- maxLength: 63,
307
- minLength: 1,
308
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
309
- description: 'Name of the chart listing',
310
- example: 'postgresql'
311
- }
312
- },
313
- required: [
314
- 'values',
315
- 'version_channel',
316
- 'name',
317
- 'namespace',
318
- 'chart'
319
- ],
320
- additionalProperties: false
321
- };
322
- export const ChartSchema = {
323
- type: 'object',
324
- properties: {
325
- values: {
326
- type: 'string',
327
- description: 'Values to be used in the chart encoded as a JSON string.'
328
- },
329
- version_channel: {
330
- type: 'string',
331
- 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-]+)*))?$',
332
- description: 'Desired version range or channel for the chart.',
333
- example: '2.x.x-cfke.x'
334
- },
335
- name: {
336
- type: 'string',
337
- maxLength: 63,
338
- minLength: 1,
339
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
340
- description: 'Unique identifier of the chart deployment aka name of the helm release.',
341
- example: 'postgresql-0'
342
- },
343
- namespace: {
344
- type: 'string',
345
- maxLength: 63,
346
- minLength: 1,
347
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
348
- description: 'Namespace of the chart deployment',
349
- example: 'default'
350
- },
351
- chart: {
352
- type: 'string',
353
- maxLength: 63,
354
- minLength: 1,
355
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
356
- description: 'Name of the chart listing',
357
- example: 'postgresql'
358
- },
359
- status: {
360
- 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
- ]
379
- },
380
- version_current: {
381
- type: 'string',
382
- description: 'Current version of the chart deployment.',
383
- example: '2.1.33-cfke.11'
384
- },
385
- created_at: {
386
- type: 'string',
387
- description: 'Creation date and time of the chart deployment.',
388
- example: '2024-09-12T09:11:27Z'
389
- },
390
- updated_at: {
391
- type: 'string',
392
- description: 'Last update date and time of the chart deployment.',
393
- example: '2024-09-12T09:11:27Z'
394
- },
395
- ready: {
396
- type: 'boolean',
397
- description: 'Indicates if the chart deployment is ready to be used.',
398
- example: true
399
- }
400
- },
401
- required: [
402
- 'values',
403
- 'version_channel',
404
- 'name',
405
- 'namespace',
406
- 'chart',
407
- 'status',
408
- 'version_current',
409
- 'created_at',
410
- 'updated_at',
411
- 'ready'
412
- ],
413
- additionalProperties: false
414
- };
415
- export const ChartUpdateInputSchema = {
416
- type: 'object',
417
- properties: {
418
- values: {
419
- type: 'string',
420
- description: 'Values to be used in the chart encoded as a JSON string.'
421
- },
422
- version_channel: {
423
- type: 'string',
424
- 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-]+)*))?$',
425
- description: 'Desired version range or channel for the chart.',
426
- example: '2.x.x-cfke.x'
427
- }
428
- },
429
- required: [
430
- 'values',
431
- 'version_channel'
432
- ],
433
- additionalProperties: false
434
- };
435
296
  export const ClusterCreateInputSchema = {
436
297
  type: 'object',
437
298
  properties: {
@@ -446,22 +307,12 @@ export const ClusterCreateInputSchema = {
446
307
  tier: {
447
308
  type: 'string',
448
309
  description: 'Tier of the cluster.',
310
+ default: 'basic',
449
311
  example: 'pro',
450
312
  enum: [
451
313
  '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'
314
+ 'pro',
315
+ 'enterprise'
465
316
  ]
466
317
  },
467
318
  version_channel: {
@@ -469,20 +320,105 @@ export const ClusterCreateInputSchema = {
469
320
  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
321
  description: 'Version of the kubernetes cluster.',
471
322
  default: '1.x.x-cfke.x',
472
- example: '1.x.x-cfke.x',
323
+ example: '1.x.x-cfke.x'
324
+ },
325
+ release_channel: {
326
+ type: 'string',
327
+ description: 'Release channel for the cluster\'s control plane.',
328
+ default: 'rapid',
329
+ example: 'rapid',
473
330
  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'
331
+ 'rapid',
332
+ 'stable',
333
+ 'extended'
478
334
  ]
335
+ },
336
+ features: {
337
+ type: 'object',
338
+ properties: {
339
+ gpu_sharing_strategy: {
340
+ type: 'string',
341
+ description: 'GPU sharing strategy.',
342
+ default: 'none',
343
+ example: 'none',
344
+ enum: [
345
+ 'none',
346
+ 'mps',
347
+ 'time_slicing'
348
+ ]
349
+ },
350
+ gpu_max_shared_clients_per_gpu: {
351
+ type: 'integer',
352
+ minimum: 2,
353
+ maximum: 48,
354
+ description: 'Maximum number of pods that may share a single GPU.',
355
+ default: 4,
356
+ example: 10
357
+ },
358
+ cilium_socket_lb_host_namespace_only: {
359
+ type: 'boolean',
360
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
361
+ example: false
362
+ }
363
+ },
364
+ additionalProperties: false,
365
+ description: 'Cluster feature toggles.',
366
+ default: {
367
+ gpu_sharing_strategy: 'none',
368
+ gpu_max_shared_clients_per_gpu: 4,
369
+ cilium_socket_lb_host_namespace_only: false
370
+ }
371
+ },
372
+ region: {
373
+ type: 'string',
374
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
375
+ example: 'europe-central-1a'
376
+ },
377
+ networking: {
378
+ type: 'object',
379
+ properties: {
380
+ pod_cidr: {
381
+ type: 'string',
382
+ description: 'CIDR block for pod IPs.',
383
+ default: '10.244.0.0/16'
384
+ },
385
+ service_cidr: {
386
+ type: 'string',
387
+ description: 'CIDR block for service IPs.',
388
+ default: '10.96.0.0/12'
389
+ },
390
+ dual_stack: {
391
+ type: 'boolean',
392
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
393
+ },
394
+ pod_cidr_v6: {
395
+ type: 'string',
396
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
397
+ default: '2001:db8:1:2::/48'
398
+ },
399
+ service_cidr_v6: {
400
+ type: 'string',
401
+ description: 'IPv6 service CIDR. Requires dual_stack.',
402
+ default: '2001:db8:1:1::/112'
403
+ }
404
+ },
405
+ additionalProperties: false,
406
+ description: 'Cluster networking configuration. Immutable after creation.',
407
+ default: {
408
+ pod_cidr: '10.244.0.0/16',
409
+ service_cidr: '10.96.0.0/12',
410
+ dual_stack: false,
411
+ pod_cidr_v6: '2001:db8:1:2::/48',
412
+ service_cidr_v6: '2001:db8:1:1::/112'
413
+ }
479
414
  }
480
415
  },
481
416
  required: [
482
417
  'name',
483
- 'tier'
418
+ 'region'
484
419
  ],
485
- additionalProperties: false
420
+ additionalProperties: false,
421
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
486
422
  };
487
423
  export const ClusterJoinInformationSchema = {
488
424
  type: 'object',
@@ -503,11 +439,21 @@ export const ClusterJoinInformationSchema = {
503
439
  description: 'Cluster DNS IP address. This is the IP address of the kube-dns service in the cluster.',
504
440
  example: '10.96.0.10'
505
441
  },
442
+ pod_cidr: {
443
+ type: 'string',
444
+ description: 'Pod CIDR for the cluster. Used to configure iptables rules on nodes to prevent Tailscale routing loops.',
445
+ example: '10.244.0.0/16'
446
+ },
506
447
  auth_key: {
507
448
  type: 'string',
508
449
  description: 'Authentication key for the cluster.',
509
450
  example: 'tskey-auth-kBV8wr1dk911CNTRL-...'
510
451
  },
452
+ login_server: {
453
+ type: 'string',
454
+ description: 'Coordination server the node registers against. Empty on data plane v1 clusters, where the node advertises its own tag instead. A non-empty value requires a client that declares the dataplane-v2 capability.',
455
+ example: 'https://415026b6-f00f-44f8-968d-fc6ef4d0fc6d.fabric.europe-central-1a.cfke.io'
456
+ },
511
457
  bootstrap_token: {
512
458
  type: 'string',
513
459
  description: 'Bootstrap token for the cluster.',
@@ -578,7 +524,9 @@ export const ClusterJoinInformationSchema = {
578
524
  'certificate_authority',
579
525
  'endpoint',
580
526
  'cluster_dns',
527
+ 'pod_cidr',
581
528
  'auth_key',
529
+ 'login_server',
582
530
  'bootstrap_token',
583
531
  'versions',
584
532
  'third_party_api_access_config'
@@ -599,24 +547,123 @@ export const ClusterSchema = {
599
547
  tier: {
600
548
  type: 'string',
601
549
  description: 'Tier of the cluster.',
550
+ default: 'basic',
602
551
  example: 'pro',
603
552
  enum: [
604
553
  'basic',
605
- 'pro'
554
+ 'pro',
555
+ 'enterprise'
606
556
  ]
607
557
  },
608
- region: {
558
+ version_channel: {
559
+ type: 'string',
560
+ 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-]+)*))?$',
561
+ description: 'Version of the kubernetes cluster.',
562
+ default: '1.x.x-cfke.x',
563
+ example: '1.x.x-cfke.x'
564
+ },
565
+ release_channel: {
609
566
  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',
567
+ description: 'Release channel for the cluster\'s control plane.',
568
+ default: 'rapid',
569
+ example: 'rapid',
613
570
  enum: [
614
- 'staging-1a',
615
- 'northamerica-central-1',
616
- 'europe-central-1a',
617
- 'northamerica-central-1a'
571
+ 'rapid',
572
+ 'stable',
573
+ 'extended'
618
574
  ]
619
575
  },
576
+ features: {
577
+ type: 'object',
578
+ properties: {
579
+ gpu_sharing_strategy: {
580
+ type: 'string',
581
+ description: 'GPU sharing strategy.',
582
+ default: 'none',
583
+ example: 'none',
584
+ enum: [
585
+ 'none',
586
+ 'mps',
587
+ 'time_slicing'
588
+ ]
589
+ },
590
+ gpu_max_shared_clients_per_gpu: {
591
+ type: 'integer',
592
+ minimum: 2,
593
+ maximum: 48,
594
+ description: 'Maximum number of pods that may share a single GPU.',
595
+ default: 4,
596
+ example: 10
597
+ },
598
+ cilium_socket_lb_host_namespace_only: {
599
+ type: 'boolean',
600
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
601
+ example: false
602
+ }
603
+ },
604
+ required: [
605
+ 'gpu_sharing_strategy',
606
+ 'gpu_max_shared_clients_per_gpu',
607
+ 'cilium_socket_lb_host_namespace_only'
608
+ ],
609
+ additionalProperties: false,
610
+ description: 'Cluster feature toggles.',
611
+ default: {
612
+ gpu_sharing_strategy: 'none',
613
+ gpu_max_shared_clients_per_gpu: 4,
614
+ cilium_socket_lb_host_namespace_only: false
615
+ }
616
+ },
617
+ region: {
618
+ type: 'string',
619
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
620
+ example: 'europe-central-1a'
621
+ },
622
+ networking: {
623
+ type: 'object',
624
+ properties: {
625
+ pod_cidr: {
626
+ type: 'string',
627
+ description: 'CIDR block for pod IPs.',
628
+ default: '10.244.0.0/16'
629
+ },
630
+ service_cidr: {
631
+ type: 'string',
632
+ description: 'CIDR block for service IPs.',
633
+ default: '10.96.0.0/12'
634
+ },
635
+ dual_stack: {
636
+ type: 'boolean',
637
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
638
+ },
639
+ pod_cidr_v6: {
640
+ type: 'string',
641
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
642
+ default: '2001:db8:1:2::/48'
643
+ },
644
+ service_cidr_v6: {
645
+ type: 'string',
646
+ description: 'IPv6 service CIDR. Requires dual_stack.',
647
+ default: '2001:db8:1:1::/112'
648
+ }
649
+ },
650
+ required: [
651
+ 'pod_cidr',
652
+ 'service_cidr',
653
+ 'dual_stack',
654
+ 'pod_cidr_v6',
655
+ 'service_cidr_v6'
656
+ ],
657
+ additionalProperties: false,
658
+ description: 'Cluster networking configuration. Immutable after creation.',
659
+ default: {
660
+ pod_cidr: '10.244.0.0/16',
661
+ service_cidr: '10.96.0.0/12',
662
+ dual_stack: false,
663
+ pod_cidr_v6: '2001:db8:1:2::/48',
664
+ service_cidr_v6: '2001:db8:1:1::/112'
665
+ }
666
+ },
620
667
  id: {
621
668
  type: 'string',
622
669
  format: 'uuid',
@@ -625,16 +672,13 @@ export const ClusterSchema = {
625
672
  },
626
673
  status: {
627
674
  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',
675
+ description: 'Status of the cluster.',
676
+ example: 'deployed',
630
677
  enum: [
631
- 'active',
632
- 'disabled',
633
- 'deleted',
634
678
  'creating',
635
679
  'deployed',
636
- 'failed',
637
- 'updating'
680
+ 'updating',
681
+ 'disabled'
638
682
  ]
639
683
  },
640
684
  endpoint: {
@@ -642,8 +686,24 @@ export const ClusterSchema = {
642
686
  {
643
687
  type: 'string',
644
688
  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'
689
+ 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.',
690
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
691
+ },
692
+ {
693
+ type: 'string',
694
+ enum: [
695
+ ''
696
+ ]
697
+ }
698
+ ]
699
+ },
700
+ endpoint_public: {
701
+ anyOf: [
702
+ {
703
+ type: 'string',
704
+ format: 'uri',
705
+ description: 'Deprecated alias of `endpoint`; retained for backward compatibility.',
706
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
647
707
  },
648
708
  {
649
709
  type: 'string',
@@ -677,21 +737,22 @@ export const ClusterSchema = {
677
737
  type: 'boolean',
678
738
  description: 'Indicates if the cluster is ready to be used.',
679
739
  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
740
  }
687
741
  },
688
742
  required: [
689
743
  'name',
690
744
  'tier',
745
+ 'version_channel',
746
+ 'release_channel',
747
+ 'features',
748
+ 'region',
749
+ 'networking',
691
750
  'id',
692
- 'status'
751
+ 'status',
752
+ 'ready'
693
753
  ],
694
- additionalProperties: false
754
+ additionalProperties: false,
755
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
695
756
  };
696
757
  export const ClusterUpdateInputSchema = {
697
758
  type: 'object',
@@ -707,57 +768,172 @@ export const ClusterUpdateInputSchema = {
707
768
  tier: {
708
769
  type: 'string',
709
770
  description: 'Tier of the cluster.',
771
+ default: 'basic',
710
772
  example: 'pro',
711
773
  enum: [
712
774
  'basic',
713
- 'pro'
775
+ 'pro',
776
+ 'enterprise'
714
777
  ]
715
778
  },
716
779
  version_channel: {
717
780
  type: 'string',
718
781
  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
782
  description: 'Version of the kubernetes cluster.',
783
+ default: '1.x.x-cfke.x',
720
784
  example: '1.x.x-cfke.x'
785
+ },
786
+ release_channel: {
787
+ type: 'string',
788
+ description: 'Release channel for the cluster\'s control plane.',
789
+ default: 'rapid',
790
+ example: 'rapid',
791
+ enum: [
792
+ 'rapid',
793
+ 'stable',
794
+ 'extended'
795
+ ]
796
+ },
797
+ features: {
798
+ type: 'object',
799
+ properties: {
800
+ gpu_sharing_strategy: {
801
+ type: 'string',
802
+ description: 'GPU sharing strategy.',
803
+ default: 'none',
804
+ example: 'none',
805
+ enum: [
806
+ 'none',
807
+ 'mps',
808
+ 'time_slicing'
809
+ ]
810
+ },
811
+ gpu_max_shared_clients_per_gpu: {
812
+ type: 'integer',
813
+ minimum: 2,
814
+ maximum: 48,
815
+ description: 'Maximum number of pods that may share a single GPU.',
816
+ default: 4,
817
+ example: 10
818
+ },
819
+ cilium_socket_lb_host_namespace_only: {
820
+ type: 'boolean',
821
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
822
+ example: false
823
+ }
824
+ },
825
+ additionalProperties: false,
826
+ description: 'Cluster feature toggles.',
827
+ default: {
828
+ gpu_sharing_strategy: 'none',
829
+ gpu_max_shared_clients_per_gpu: 4,
830
+ cilium_socket_lb_host_namespace_only: false
831
+ }
721
832
  }
722
833
  },
723
834
  required: [
724
- 'tier'
835
+ 'name'
725
836
  ],
726
- additionalProperties: false
837
+ additionalProperties: false,
838
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
727
839
  };
728
- export const FleetCreateInputSchema = {
840
+ export const FeedbackCreateInputSchema = {
729
841
  type: 'object',
730
842
  properties: {
731
- limits: {
732
- type: 'object',
733
- properties: {
734
- cpu: {
735
- type: 'number',
736
- format: 'float',
737
- minimum: 0,
738
- description: 'CPU limit in cores.'
739
- }
740
- },
741
- required: [
742
- 'cpu'
743
- ],
744
- additionalProperties: false,
843
+ sentiment: {
844
+ type: 'string',
845
+ description: 'Overall sentiment: positive, neutral or negative.',
846
+ example: 'negative',
847
+ enum: [
848
+ 'positive',
849
+ 'neutral',
850
+ 'negative'
851
+ ]
852
+ },
853
+ message: {
854
+ type: 'string',
855
+ maxLength: 2000,
856
+ minLength: 1,
857
+ description: 'What was useful, confusing, wrong or missing.',
858
+ example: 'The error for a missing kubeconfig does not say which path it looked in.'
859
+ },
860
+ context: {
861
+ type: 'string',
862
+ maxLength: 2000,
863
+ description: 'What you were trying to do when it happened.',
864
+ example: 'Connecting kubectl to a new cluster.'
865
+ },
866
+ source: {
867
+ type: 'string',
868
+ description: 'Where the feedback was sent from: cli, mcp, plugin, console or api. Defaults to api.',
869
+ default: 'api',
870
+ example: 'cli',
871
+ enum: [
872
+ 'cli',
873
+ 'mcp',
874
+ 'plugin',
875
+ 'console',
876
+ 'api'
877
+ ]
878
+ },
879
+ client: {
880
+ type: 'string',
881
+ maxLength: 100,
882
+ description: 'Name and version of the sending client.',
883
+ example: 'cloudfleet-plugin-claude/0.5.0'
884
+ }
885
+ },
886
+ required: [
887
+ 'sentiment',
888
+ 'message'
889
+ ],
890
+ additionalProperties: false
891
+ };
892
+ export const FeedbackSchema = {
893
+ type: 'object',
894
+ properties: {
895
+ id: {
896
+ type: 'string',
897
+ description: 'Unique identifier of the feedback entry (Mongo ObjectId).',
898
+ example: '60c72b2f9f1b2c001f8e4d3a'
899
+ }
900
+ },
901
+ required: [
902
+ 'id'
903
+ ],
904
+ additionalProperties: false
905
+ };
906
+ export const FleetCreateInputSchema = {
907
+ type: 'object',
908
+ properties: {
909
+ limits: {
910
+ type: 'object',
911
+ properties: {
912
+ cpu: {
913
+ type: 'integer',
914
+ minimum: 0,
915
+ maximum: 100000,
916
+ description: 'CPU limit in cores. Maximum 100,000.'
917
+ }
918
+ },
919
+ additionalProperties: false,
745
920
  description: 'Limits define a set of bounds for provisioning capacity.'
746
921
  },
747
922
  gcp: {
748
923
  type: 'object',
749
924
  properties: {
750
925
  enabled: {
751
- type: 'boolean',
752
- default: true
926
+ type: 'boolean'
753
927
  },
754
928
  project: {
755
929
  type: 'string',
756
- description: 'Project GCP Project id to deploy instances into'
930
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
931
+ 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.',
932
+ example: 'my-cloudfleet-project'
757
933
  }
758
934
  },
759
935
  required: [
760
- 'project'
936
+ 'enabled'
761
937
  ],
762
938
  additionalProperties: false
763
939
  },
@@ -765,16 +941,18 @@ export const FleetCreateInputSchema = {
765
941
  type: 'object',
766
942
  properties: {
767
943
  enabled: {
768
- type: 'boolean',
769
- default: true
944
+ type: 'boolean'
770
945
  },
771
946
  apiKey: {
772
947
  type: 'string',
773
- description: 'Hetzner Cloud API key with read / write access'
948
+ maxLength: 64,
949
+ minLength: 64,
950
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
951
+ 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
952
  }
775
953
  },
776
954
  required: [
777
- 'apiKey'
955
+ 'enabled'
778
956
  ],
779
957
  additionalProperties: false
780
958
  },
@@ -782,19 +960,359 @@ export const FleetCreateInputSchema = {
782
960
  type: 'object',
783
961
  properties: {
784
962
  enabled: {
785
- type: 'boolean',
786
- default: true
963
+ type: 'boolean'
787
964
  },
788
965
  controllerRoleArn: {
789
966
  type: 'string',
790
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
967
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
968
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
969
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
791
970
  }
792
971
  },
793
972
  required: [
794
- 'controllerRoleArn'
973
+ 'enabled'
795
974
  ],
796
975
  additionalProperties: false
797
976
  },
977
+ constraints: {
978
+ type: 'object',
979
+ properties: {
980
+ 'karpenter.sh/capacity-type': {
981
+ type: 'array',
982
+ items: {
983
+ type: 'string',
984
+ enum: [
985
+ 'on-demand',
986
+ 'spot'
987
+ ]
988
+ },
989
+ minItems: 1,
990
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
991
+ default: [
992
+ 'on-demand',
993
+ 'spot'
994
+ ]
995
+ },
996
+ 'kubernetes.io/arch': {
997
+ type: 'array',
998
+ items: {
999
+ type: 'string',
1000
+ enum: [
1001
+ 'amd64',
1002
+ 'arm64'
1003
+ ]
1004
+ },
1005
+ minItems: 1,
1006
+ description: 'Allowed values for `kubernetes.io/arch`.',
1007
+ default: [
1008
+ 'amd64'
1009
+ ]
1010
+ },
1011
+ 'cfke.io/instance-family': {
1012
+ type: 'array',
1013
+ items: {
1014
+ type: 'string',
1015
+ enum: [
1016
+ 'a1',
1017
+ 'a2',
1018
+ 'a3',
1019
+ 'a4',
1020
+ 'c1',
1021
+ 'c2',
1022
+ 'c2d',
1023
+ 'c3',
1024
+ 'c3d',
1025
+ 'c4',
1026
+ 'c4a',
1027
+ 'c4d',
1028
+ 'c5',
1029
+ 'c5a',
1030
+ 'c5ad',
1031
+ 'c5d',
1032
+ 'c5n',
1033
+ 'c6a',
1034
+ 'c6g',
1035
+ 'c6gd',
1036
+ 'c6gn',
1037
+ 'c6i',
1038
+ 'c6id',
1039
+ 'c6in',
1040
+ 'c7a',
1041
+ 'c7g',
1042
+ 'c7gd',
1043
+ 'c7gn',
1044
+ 'c7i',
1045
+ 'c7i-flex',
1046
+ 'c8g',
1047
+ 'c8gd',
1048
+ 'cax',
1049
+ 'ccx',
1050
+ 'cpx',
1051
+ 'cx',
1052
+ 'd2',
1053
+ 'd3',
1054
+ 'd3en',
1055
+ 'dl1',
1056
+ 'dl2q',
1057
+ 'e2',
1058
+ 'f1',
1059
+ 'f2',
1060
+ 'g1',
1061
+ 'g2',
1062
+ 'g4ad',
1063
+ 'g4dn',
1064
+ 'g5',
1065
+ 'g5g',
1066
+ 'g6',
1067
+ 'g6e',
1068
+ 'gr6',
1069
+ 'h1',
1070
+ 'h3',
1071
+ 'hpc6a',
1072
+ 'hpc6id',
1073
+ 'hpc7a',
1074
+ 'hpc7g',
1075
+ 'i2',
1076
+ 'i3',
1077
+ 'i3en',
1078
+ 'i4g',
1079
+ 'i4i',
1080
+ 'i7i',
1081
+ 'i7ie',
1082
+ 'i8g',
1083
+ 'im4gn',
1084
+ 'inf1',
1085
+ 'inf2',
1086
+ 'is4gen',
1087
+ 'm1',
1088
+ 'm2',
1089
+ 'm3',
1090
+ 'm4',
1091
+ 'm5',
1092
+ 'm5a',
1093
+ 'm5ad',
1094
+ 'm5d',
1095
+ 'm5dn',
1096
+ 'm5n',
1097
+ 'm5zn',
1098
+ 'm6a',
1099
+ 'm6g',
1100
+ 'm6gd',
1101
+ 'm6i',
1102
+ 'm6id',
1103
+ 'm6idn',
1104
+ 'm6in',
1105
+ 'm7a',
1106
+ 'm7g',
1107
+ 'm7gd',
1108
+ 'm7i',
1109
+ 'm7i-flex',
1110
+ 'm8g',
1111
+ 'm8gd',
1112
+ 'n1',
1113
+ 'n2',
1114
+ 'n2d',
1115
+ 'n4',
1116
+ 'p3',
1117
+ 'p3dn',
1118
+ 'p4d',
1119
+ 'p4de',
1120
+ 'p5',
1121
+ 'p5e',
1122
+ 'p5en',
1123
+ 'p6-b200',
1124
+ 'r3',
1125
+ 'r4',
1126
+ 'r5',
1127
+ 'r5a',
1128
+ 'r5ad',
1129
+ 'r5b',
1130
+ 'r5d',
1131
+ 'r5dn',
1132
+ 'r5n',
1133
+ 'r6a',
1134
+ 'r6g',
1135
+ 'r6gd',
1136
+ 'r6i',
1137
+ 'r6id',
1138
+ 'r6idn',
1139
+ 'r6in',
1140
+ 'r7a',
1141
+ 'r7g',
1142
+ 'r7gd',
1143
+ 'r7i',
1144
+ 'r7iz',
1145
+ 'r8g',
1146
+ 'r8gd',
1147
+ 't2',
1148
+ 't2a',
1149
+ 't2d',
1150
+ 't3',
1151
+ 't3a',
1152
+ 't4g',
1153
+ 'trn1',
1154
+ 'trn1n',
1155
+ 'u-3tb1',
1156
+ 'u-6tb1',
1157
+ 'u7i-12tb',
1158
+ 'u7i-6tb',
1159
+ 'u7i-8tb',
1160
+ 'u7in-16tb',
1161
+ 'u7in-24tb',
1162
+ 'u7in-32tb',
1163
+ 'vt1',
1164
+ 'x1',
1165
+ 'x1e',
1166
+ 'x2gd',
1167
+ 'x2idn',
1168
+ 'x2iedn',
1169
+ 'x2iezn',
1170
+ 'x4',
1171
+ 'x8g',
1172
+ 'z1d',
1173
+ 'z3'
1174
+ ]
1175
+ },
1176
+ description: 'Allowed values for `cfke.io/instance-family`.',
1177
+ default: []
1178
+ },
1179
+ 'topology.kubernetes.io/region': {
1180
+ type: 'array',
1181
+ items: {
1182
+ type: 'string',
1183
+ enum: [
1184
+ 'africa-south1',
1185
+ 'ap-northeast-1',
1186
+ 'ap-northeast-2',
1187
+ 'ap-northeast-3',
1188
+ 'ap-south-1',
1189
+ 'ap-southeast-1',
1190
+ 'ap-southeast-2',
1191
+ 'ash',
1192
+ 'asia-east1',
1193
+ 'asia-east2',
1194
+ 'asia-northeast1',
1195
+ 'asia-northeast2',
1196
+ 'asia-northeast3',
1197
+ 'asia-south1',
1198
+ 'asia-south2',
1199
+ 'asia-southeast1',
1200
+ 'asia-southeast2',
1201
+ 'australia-southeast1',
1202
+ 'australia-southeast2',
1203
+ 'ca-central-1',
1204
+ 'eu-central-1',
1205
+ 'eu-central-2',
1206
+ 'eu-north-1',
1207
+ 'eu-west-1',
1208
+ 'eu-west-2',
1209
+ 'eu-west-3',
1210
+ 'europe-central2',
1211
+ 'europe-north1',
1212
+ 'europe-southwest1',
1213
+ 'europe-west1',
1214
+ 'europe-west10',
1215
+ 'europe-west12',
1216
+ 'europe-west2',
1217
+ 'europe-west3',
1218
+ 'europe-west4',
1219
+ 'europe-west6',
1220
+ 'europe-west8',
1221
+ 'europe-west9',
1222
+ 'fsn1',
1223
+ 'hel1',
1224
+ 'hil',
1225
+ 'me-central1',
1226
+ 'me-central2',
1227
+ 'me-west1',
1228
+ 'nbg1',
1229
+ 'northamerica-northeast1',
1230
+ 'northamerica-northeast2',
1231
+ 'sa-east-1',
1232
+ 'sin',
1233
+ 'southamerica-east1',
1234
+ 'southamerica-west1',
1235
+ 'us-central1',
1236
+ 'us-east-1',
1237
+ 'us-east-2',
1238
+ 'us-east1',
1239
+ 'us-east4',
1240
+ 'us-east5',
1241
+ 'us-south1',
1242
+ 'us-west-1',
1243
+ 'us-west-2',
1244
+ 'us-west1',
1245
+ 'us-west2',
1246
+ 'us-west3',
1247
+ 'us-west4'
1248
+ ]
1249
+ },
1250
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1251
+ default: []
1252
+ }
1253
+ },
1254
+ additionalProperties: false,
1255
+ 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.',
1256
+ default: {
1257
+ 'karpenter.sh/capacity-type': [
1258
+ 'on-demand',
1259
+ 'spot'
1260
+ ],
1261
+ 'kubernetes.io/arch': [
1262
+ 'amd64'
1263
+ ],
1264
+ 'cfke.io/instance-family': [],
1265
+ 'topology.kubernetes.io/region': []
1266
+ }
1267
+ },
1268
+ scalingProfile: {
1269
+ type: 'string',
1270
+ 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`).',
1271
+ default: 'conservative',
1272
+ example: 'conservative',
1273
+ enum: [
1274
+ 'aggressive',
1275
+ 'conservative'
1276
+ ]
1277
+ },
1278
+ taints: {
1279
+ type: 'array',
1280
+ items: {
1281
+ type: 'object',
1282
+ properties: {
1283
+ key: {
1284
+ type: 'string',
1285
+ description: 'Taint key: a Kubernetes qualified name with an optional DNS subdomain prefix. Keys under `node.kubernetes.io`, `node.cloudprovider.kubernetes.io`, `node.cilium.io`, `karpenter.sh` and `cfke.io` (and their subdomains) are reserved.',
1286
+ example: 'dedicated'
1287
+ },
1288
+ value: {
1289
+ type: 'string',
1290
+ maxLength: 63,
1291
+ pattern: '^([A-Za-z0-9]([-A-Za-z0-9_.]*[A-Za-z0-9])?)?$',
1292
+ description: 'Taint value. Optional.',
1293
+ example: 'ci'
1294
+ },
1295
+ effect: {
1296
+ type: 'string',
1297
+ description: 'Taint effect.',
1298
+ example: 'NoSchedule',
1299
+ enum: [
1300
+ 'NoSchedule',
1301
+ 'PreferNoSchedule',
1302
+ 'NoExecute'
1303
+ ]
1304
+ }
1305
+ },
1306
+ required: [
1307
+ 'key',
1308
+ 'effect'
1309
+ ],
1310
+ additionalProperties: false
1311
+ },
1312
+ maxItems: 50,
1313
+ description: 'Taints applied to every node the fleet provisions, so only pods that tolerate them schedule there. Each key and effect pair may appear once. Full-overwrite: omit to remove all taints.',
1314
+ default: []
1315
+ },
798
1316
  id: {
799
1317
  type: 'string',
800
1318
  maxLength: 63,
@@ -807,7 +1325,8 @@ export const FleetCreateInputSchema = {
807
1325
  required: [
808
1326
  'id'
809
1327
  ],
810
- additionalProperties: false
1328
+ additionalProperties: false,
1329
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
811
1330
  };
812
1331
  export const FleetSchema = {
813
1332
  type: 'object',
@@ -816,15 +1335,12 @@ export const FleetSchema = {
816
1335
  type: 'object',
817
1336
  properties: {
818
1337
  cpu: {
819
- type: 'number',
820
- format: 'float',
1338
+ type: 'integer',
821
1339
  minimum: 0,
822
- description: 'CPU limit in cores.'
1340
+ maximum: 100000,
1341
+ description: 'CPU limit in cores. Maximum 100,000.'
823
1342
  }
824
1343
  },
825
- required: [
826
- 'cpu'
827
- ],
828
1344
  additionalProperties: false,
829
1345
  description: 'Limits define a set of bounds for provisioning capacity.'
830
1346
  },
@@ -832,16 +1348,17 @@ export const FleetSchema = {
832
1348
  type: 'object',
833
1349
  properties: {
834
1350
  enabled: {
835
- type: 'boolean',
836
- default: true
1351
+ type: 'boolean'
837
1352
  },
838
1353
  project: {
839
1354
  type: 'string',
840
- description: 'Project GCP Project id to deploy instances into'
1355
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1356
+ 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.',
1357
+ example: 'my-cloudfleet-project'
841
1358
  }
842
1359
  },
843
1360
  required: [
844
- 'project'
1361
+ 'enabled'
845
1362
  ],
846
1363
  additionalProperties: false
847
1364
  },
@@ -849,16 +1366,16 @@ export const FleetSchema = {
849
1366
  type: 'object',
850
1367
  properties: {
851
1368
  enabled: {
852
- type: 'boolean',
853
- default: true
1369
+ type: 'boolean'
854
1370
  },
855
1371
  apiKey: {
856
1372
  type: 'string',
857
- description: 'Hetzner Cloud API key with read / write access'
1373
+ pattern: '^\\*{64}$',
1374
+ 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
1375
  }
859
1376
  },
860
1377
  required: [
861
- 'apiKey'
1378
+ 'enabled'
862
1379
  ],
863
1380
  additionalProperties: false
864
1381
  },
@@ -866,19 +1383,363 @@ export const FleetSchema = {
866
1383
  type: 'object',
867
1384
  properties: {
868
1385
  enabled: {
869
- type: 'boolean',
870
- default: true
1386
+ type: 'boolean'
871
1387
  },
872
1388
  controllerRoleArn: {
873
1389
  type: 'string',
874
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1390
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1391
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1392
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
875
1393
  }
876
1394
  },
877
1395
  required: [
878
- 'controllerRoleArn'
1396
+ 'enabled'
879
1397
  ],
880
1398
  additionalProperties: false
881
1399
  },
1400
+ constraints: {
1401
+ type: 'object',
1402
+ properties: {
1403
+ 'karpenter.sh/capacity-type': {
1404
+ type: 'array',
1405
+ items: {
1406
+ type: 'string',
1407
+ enum: [
1408
+ 'on-demand',
1409
+ 'spot'
1410
+ ]
1411
+ },
1412
+ minItems: 1,
1413
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1414
+ default: [
1415
+ 'on-demand',
1416
+ 'spot'
1417
+ ]
1418
+ },
1419
+ 'kubernetes.io/arch': {
1420
+ type: 'array',
1421
+ items: {
1422
+ type: 'string',
1423
+ enum: [
1424
+ 'amd64',
1425
+ 'arm64'
1426
+ ]
1427
+ },
1428
+ minItems: 1,
1429
+ description: 'Allowed values for `kubernetes.io/arch`.',
1430
+ default: [
1431
+ 'amd64'
1432
+ ]
1433
+ },
1434
+ 'cfke.io/instance-family': {
1435
+ type: 'array',
1436
+ items: {
1437
+ type: 'string',
1438
+ enum: [
1439
+ 'a1',
1440
+ 'a2',
1441
+ 'a3',
1442
+ 'a4',
1443
+ 'c1',
1444
+ 'c2',
1445
+ 'c2d',
1446
+ 'c3',
1447
+ 'c3d',
1448
+ 'c4',
1449
+ 'c4a',
1450
+ 'c4d',
1451
+ 'c5',
1452
+ 'c5a',
1453
+ 'c5ad',
1454
+ 'c5d',
1455
+ 'c5n',
1456
+ 'c6a',
1457
+ 'c6g',
1458
+ 'c6gd',
1459
+ 'c6gn',
1460
+ 'c6i',
1461
+ 'c6id',
1462
+ 'c6in',
1463
+ 'c7a',
1464
+ 'c7g',
1465
+ 'c7gd',
1466
+ 'c7gn',
1467
+ 'c7i',
1468
+ 'c7i-flex',
1469
+ 'c8g',
1470
+ 'c8gd',
1471
+ 'cax',
1472
+ 'ccx',
1473
+ 'cpx',
1474
+ 'cx',
1475
+ 'd2',
1476
+ 'd3',
1477
+ 'd3en',
1478
+ 'dl1',
1479
+ 'dl2q',
1480
+ 'e2',
1481
+ 'f1',
1482
+ 'f2',
1483
+ 'g1',
1484
+ 'g2',
1485
+ 'g4ad',
1486
+ 'g4dn',
1487
+ 'g5',
1488
+ 'g5g',
1489
+ 'g6',
1490
+ 'g6e',
1491
+ 'gr6',
1492
+ 'h1',
1493
+ 'h3',
1494
+ 'hpc6a',
1495
+ 'hpc6id',
1496
+ 'hpc7a',
1497
+ 'hpc7g',
1498
+ 'i2',
1499
+ 'i3',
1500
+ 'i3en',
1501
+ 'i4g',
1502
+ 'i4i',
1503
+ 'i7i',
1504
+ 'i7ie',
1505
+ 'i8g',
1506
+ 'im4gn',
1507
+ 'inf1',
1508
+ 'inf2',
1509
+ 'is4gen',
1510
+ 'm1',
1511
+ 'm2',
1512
+ 'm3',
1513
+ 'm4',
1514
+ 'm5',
1515
+ 'm5a',
1516
+ 'm5ad',
1517
+ 'm5d',
1518
+ 'm5dn',
1519
+ 'm5n',
1520
+ 'm5zn',
1521
+ 'm6a',
1522
+ 'm6g',
1523
+ 'm6gd',
1524
+ 'm6i',
1525
+ 'm6id',
1526
+ 'm6idn',
1527
+ 'm6in',
1528
+ 'm7a',
1529
+ 'm7g',
1530
+ 'm7gd',
1531
+ 'm7i',
1532
+ 'm7i-flex',
1533
+ 'm8g',
1534
+ 'm8gd',
1535
+ 'n1',
1536
+ 'n2',
1537
+ 'n2d',
1538
+ 'n4',
1539
+ 'p3',
1540
+ 'p3dn',
1541
+ 'p4d',
1542
+ 'p4de',
1543
+ 'p5',
1544
+ 'p5e',
1545
+ 'p5en',
1546
+ 'p6-b200',
1547
+ 'r3',
1548
+ 'r4',
1549
+ 'r5',
1550
+ 'r5a',
1551
+ 'r5ad',
1552
+ 'r5b',
1553
+ 'r5d',
1554
+ 'r5dn',
1555
+ 'r5n',
1556
+ 'r6a',
1557
+ 'r6g',
1558
+ 'r6gd',
1559
+ 'r6i',
1560
+ 'r6id',
1561
+ 'r6idn',
1562
+ 'r6in',
1563
+ 'r7a',
1564
+ 'r7g',
1565
+ 'r7gd',
1566
+ 'r7i',
1567
+ 'r7iz',
1568
+ 'r8g',
1569
+ 'r8gd',
1570
+ 't2',
1571
+ 't2a',
1572
+ 't2d',
1573
+ 't3',
1574
+ 't3a',
1575
+ 't4g',
1576
+ 'trn1',
1577
+ 'trn1n',
1578
+ 'u-3tb1',
1579
+ 'u-6tb1',
1580
+ 'u7i-12tb',
1581
+ 'u7i-6tb',
1582
+ 'u7i-8tb',
1583
+ 'u7in-16tb',
1584
+ 'u7in-24tb',
1585
+ 'u7in-32tb',
1586
+ 'vt1',
1587
+ 'x1',
1588
+ 'x1e',
1589
+ 'x2gd',
1590
+ 'x2idn',
1591
+ 'x2iedn',
1592
+ 'x2iezn',
1593
+ 'x4',
1594
+ 'x8g',
1595
+ 'z1d',
1596
+ 'z3'
1597
+ ]
1598
+ },
1599
+ description: 'Allowed values for `cfke.io/instance-family`.',
1600
+ default: []
1601
+ },
1602
+ 'topology.kubernetes.io/region': {
1603
+ type: 'array',
1604
+ items: {
1605
+ type: 'string',
1606
+ enum: [
1607
+ 'africa-south1',
1608
+ 'ap-northeast-1',
1609
+ 'ap-northeast-2',
1610
+ 'ap-northeast-3',
1611
+ 'ap-south-1',
1612
+ 'ap-southeast-1',
1613
+ 'ap-southeast-2',
1614
+ 'ash',
1615
+ 'asia-east1',
1616
+ 'asia-east2',
1617
+ 'asia-northeast1',
1618
+ 'asia-northeast2',
1619
+ 'asia-northeast3',
1620
+ 'asia-south1',
1621
+ 'asia-south2',
1622
+ 'asia-southeast1',
1623
+ 'asia-southeast2',
1624
+ 'australia-southeast1',
1625
+ 'australia-southeast2',
1626
+ 'ca-central-1',
1627
+ 'eu-central-1',
1628
+ 'eu-central-2',
1629
+ 'eu-north-1',
1630
+ 'eu-west-1',
1631
+ 'eu-west-2',
1632
+ 'eu-west-3',
1633
+ 'europe-central2',
1634
+ 'europe-north1',
1635
+ 'europe-southwest1',
1636
+ 'europe-west1',
1637
+ 'europe-west10',
1638
+ 'europe-west12',
1639
+ 'europe-west2',
1640
+ 'europe-west3',
1641
+ 'europe-west4',
1642
+ 'europe-west6',
1643
+ 'europe-west8',
1644
+ 'europe-west9',
1645
+ 'fsn1',
1646
+ 'hel1',
1647
+ 'hil',
1648
+ 'me-central1',
1649
+ 'me-central2',
1650
+ 'me-west1',
1651
+ 'nbg1',
1652
+ 'northamerica-northeast1',
1653
+ 'northamerica-northeast2',
1654
+ 'sa-east-1',
1655
+ 'sin',
1656
+ 'southamerica-east1',
1657
+ 'southamerica-west1',
1658
+ 'us-central1',
1659
+ 'us-east-1',
1660
+ 'us-east-2',
1661
+ 'us-east1',
1662
+ 'us-east4',
1663
+ 'us-east5',
1664
+ 'us-south1',
1665
+ 'us-west-1',
1666
+ 'us-west-2',
1667
+ 'us-west1',
1668
+ 'us-west2',
1669
+ 'us-west3',
1670
+ 'us-west4'
1671
+ ]
1672
+ },
1673
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1674
+ default: []
1675
+ }
1676
+ },
1677
+ required: [
1678
+ 'karpenter.sh/capacity-type',
1679
+ 'kubernetes.io/arch'
1680
+ ],
1681
+ additionalProperties: false,
1682
+ 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.',
1683
+ default: {
1684
+ 'karpenter.sh/capacity-type': [
1685
+ 'on-demand',
1686
+ 'spot'
1687
+ ],
1688
+ 'kubernetes.io/arch': [
1689
+ 'amd64'
1690
+ ],
1691
+ 'cfke.io/instance-family': [],
1692
+ 'topology.kubernetes.io/region': []
1693
+ }
1694
+ },
1695
+ scalingProfile: {
1696
+ type: 'string',
1697
+ 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`).',
1698
+ default: 'conservative',
1699
+ example: 'conservative',
1700
+ enum: [
1701
+ 'aggressive',
1702
+ 'conservative'
1703
+ ]
1704
+ },
1705
+ taints: {
1706
+ type: 'array',
1707
+ items: {
1708
+ type: 'object',
1709
+ properties: {
1710
+ key: {
1711
+ type: 'string',
1712
+ description: 'Taint key: a Kubernetes qualified name with an optional DNS subdomain prefix. Keys under `node.kubernetes.io`, `node.cloudprovider.kubernetes.io`, `node.cilium.io`, `karpenter.sh` and `cfke.io` (and their subdomains) are reserved.',
1713
+ example: 'dedicated'
1714
+ },
1715
+ value: {
1716
+ type: 'string',
1717
+ maxLength: 63,
1718
+ pattern: '^([A-Za-z0-9]([-A-Za-z0-9_.]*[A-Za-z0-9])?)?$',
1719
+ description: 'Taint value. Optional.',
1720
+ example: 'ci'
1721
+ },
1722
+ effect: {
1723
+ type: 'string',
1724
+ description: 'Taint effect.',
1725
+ example: 'NoSchedule',
1726
+ enum: [
1727
+ 'NoSchedule',
1728
+ 'PreferNoSchedule',
1729
+ 'NoExecute'
1730
+ ]
1731
+ }
1732
+ },
1733
+ required: [
1734
+ 'key',
1735
+ 'effect'
1736
+ ],
1737
+ additionalProperties: false
1738
+ },
1739
+ maxItems: 50,
1740
+ description: 'Taints applied to every node the fleet provisions, so only pods that tolerate them schedule there. Each key and effect pair may appear once. Full-overwrite: omit to remove all taints.',
1741
+ default: []
1742
+ },
882
1743
  id: {
883
1744
  type: 'string',
884
1745
  maxLength: 63,
@@ -886,12 +1747,39 @@ export const FleetSchema = {
886
1747
  pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
887
1748
  description: 'Unique identifier of the kubernetes fleet.',
888
1749
  example: 'new-clouds-fleet'
1750
+ },
1751
+ ready: {
1752
+ type: 'boolean',
1753
+ description: 'Indicates whether the fleet configuration is healthy.',
1754
+ example: true
1755
+ },
1756
+ status_message: {
1757
+ type: 'string',
1758
+ description: 'Human-readable reason the fleet is not ready. Present only when `ready` is false.',
1759
+ example: 'Invalid provider permissions.'
1760
+ },
1761
+ created_at: {
1762
+ type: 'string',
1763
+ description: 'Creation date and time of the fleet.',
1764
+ example: '2024-09-12T09:11:27Z'
1765
+ },
1766
+ updated_at: {
1767
+ type: 'string',
1768
+ description: 'Date and time the fleet was last updated.',
1769
+ example: '2024-09-12T09:11:27Z'
889
1770
  }
890
1771
  },
891
1772
  required: [
892
- 'id'
1773
+ 'constraints',
1774
+ 'scalingProfile',
1775
+ 'taints',
1776
+ 'id',
1777
+ 'ready',
1778
+ 'created_at',
1779
+ 'updated_at'
893
1780
  ],
894
- additionalProperties: false
1781
+ additionalProperties: false,
1782
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
895
1783
  };
896
1784
  export const FleetUpdateInputSchema = {
897
1785
  type: 'object',
@@ -900,15 +1788,12 @@ export const FleetUpdateInputSchema = {
900
1788
  type: 'object',
901
1789
  properties: {
902
1790
  cpu: {
903
- type: 'number',
904
- format: 'float',
1791
+ type: 'integer',
905
1792
  minimum: 0,
906
- description: 'CPU limit in cores.'
1793
+ maximum: 100000,
1794
+ description: 'CPU limit in cores. Maximum 100,000.'
907
1795
  }
908
1796
  },
909
- required: [
910
- 'cpu'
911
- ],
912
1797
  additionalProperties: false,
913
1798
  description: 'Limits define a set of bounds for provisioning capacity.'
914
1799
  },
@@ -916,16 +1801,17 @@ export const FleetUpdateInputSchema = {
916
1801
  type: 'object',
917
1802
  properties: {
918
1803
  enabled: {
919
- type: 'boolean',
920
- default: true
1804
+ type: 'boolean'
921
1805
  },
922
1806
  project: {
923
1807
  type: 'string',
924
- description: 'Project GCP Project id to deploy instances into'
1808
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1809
+ 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.',
1810
+ example: 'my-cloudfleet-project'
925
1811
  }
926
1812
  },
927
1813
  required: [
928
- 'project'
1814
+ 'enabled'
929
1815
  ],
930
1816
  additionalProperties: false
931
1817
  },
@@ -933,16 +1819,18 @@ export const FleetUpdateInputSchema = {
933
1819
  type: 'object',
934
1820
  properties: {
935
1821
  enabled: {
936
- type: 'boolean',
937
- default: true
1822
+ type: 'boolean'
938
1823
  },
939
1824
  apiKey: {
940
1825
  type: 'string',
941
- description: 'Hetzner Cloud API key with read / write access'
1826
+ maxLength: 64,
1827
+ minLength: 64,
1828
+ pattern: '^([A-Za-z0-9]{64}|\\*{64})$',
1829
+ 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
1830
  }
943
1831
  },
944
1832
  required: [
945
- 'apiKey'
1833
+ 'enabled'
946
1834
  ],
947
1835
  additionalProperties: false
948
1836
  },
@@ -950,20 +1838,386 @@ export const FleetUpdateInputSchema = {
950
1838
  type: 'object',
951
1839
  properties: {
952
1840
  enabled: {
953
- type: 'boolean',
954
- default: true
1841
+ type: 'boolean'
955
1842
  },
956
1843
  controllerRoleArn: {
957
1844
  type: 'string',
958
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1845
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1846
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1847
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
959
1848
  }
960
1849
  },
961
1850
  required: [
962
- 'controllerRoleArn'
1851
+ 'enabled'
963
1852
  ],
964
1853
  additionalProperties: false
1854
+ },
1855
+ constraints: {
1856
+ type: 'object',
1857
+ properties: {
1858
+ 'karpenter.sh/capacity-type': {
1859
+ type: 'array',
1860
+ items: {
1861
+ type: 'string',
1862
+ enum: [
1863
+ 'on-demand',
1864
+ 'spot'
1865
+ ]
1866
+ },
1867
+ minItems: 1,
1868
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1869
+ default: [
1870
+ 'on-demand',
1871
+ 'spot'
1872
+ ]
1873
+ },
1874
+ 'kubernetes.io/arch': {
1875
+ type: 'array',
1876
+ items: {
1877
+ type: 'string',
1878
+ enum: [
1879
+ 'amd64',
1880
+ 'arm64'
1881
+ ]
1882
+ },
1883
+ minItems: 1,
1884
+ description: 'Allowed values for `kubernetes.io/arch`.',
1885
+ default: [
1886
+ 'amd64'
1887
+ ]
1888
+ },
1889
+ 'cfke.io/instance-family': {
1890
+ type: 'array',
1891
+ items: {
1892
+ type: 'string',
1893
+ enum: [
1894
+ 'a1',
1895
+ 'a2',
1896
+ 'a3',
1897
+ 'a4',
1898
+ 'c1',
1899
+ 'c2',
1900
+ 'c2d',
1901
+ 'c3',
1902
+ 'c3d',
1903
+ 'c4',
1904
+ 'c4a',
1905
+ 'c4d',
1906
+ 'c5',
1907
+ 'c5a',
1908
+ 'c5ad',
1909
+ 'c5d',
1910
+ 'c5n',
1911
+ 'c6a',
1912
+ 'c6g',
1913
+ 'c6gd',
1914
+ 'c6gn',
1915
+ 'c6i',
1916
+ 'c6id',
1917
+ 'c6in',
1918
+ 'c7a',
1919
+ 'c7g',
1920
+ 'c7gd',
1921
+ 'c7gn',
1922
+ 'c7i',
1923
+ 'c7i-flex',
1924
+ 'c8g',
1925
+ 'c8gd',
1926
+ 'cax',
1927
+ 'ccx',
1928
+ 'cpx',
1929
+ 'cx',
1930
+ 'd2',
1931
+ 'd3',
1932
+ 'd3en',
1933
+ 'dl1',
1934
+ 'dl2q',
1935
+ 'e2',
1936
+ 'f1',
1937
+ 'f2',
1938
+ 'g1',
1939
+ 'g2',
1940
+ 'g4ad',
1941
+ 'g4dn',
1942
+ 'g5',
1943
+ 'g5g',
1944
+ 'g6',
1945
+ 'g6e',
1946
+ 'gr6',
1947
+ 'h1',
1948
+ 'h3',
1949
+ 'hpc6a',
1950
+ 'hpc6id',
1951
+ 'hpc7a',
1952
+ 'hpc7g',
1953
+ 'i2',
1954
+ 'i3',
1955
+ 'i3en',
1956
+ 'i4g',
1957
+ 'i4i',
1958
+ 'i7i',
1959
+ 'i7ie',
1960
+ 'i8g',
1961
+ 'im4gn',
1962
+ 'inf1',
1963
+ 'inf2',
1964
+ 'is4gen',
1965
+ 'm1',
1966
+ 'm2',
1967
+ 'm3',
1968
+ 'm4',
1969
+ 'm5',
1970
+ 'm5a',
1971
+ 'm5ad',
1972
+ 'm5d',
1973
+ 'm5dn',
1974
+ 'm5n',
1975
+ 'm5zn',
1976
+ 'm6a',
1977
+ 'm6g',
1978
+ 'm6gd',
1979
+ 'm6i',
1980
+ 'm6id',
1981
+ 'm6idn',
1982
+ 'm6in',
1983
+ 'm7a',
1984
+ 'm7g',
1985
+ 'm7gd',
1986
+ 'm7i',
1987
+ 'm7i-flex',
1988
+ 'm8g',
1989
+ 'm8gd',
1990
+ 'n1',
1991
+ 'n2',
1992
+ 'n2d',
1993
+ 'n4',
1994
+ 'p3',
1995
+ 'p3dn',
1996
+ 'p4d',
1997
+ 'p4de',
1998
+ 'p5',
1999
+ 'p5e',
2000
+ 'p5en',
2001
+ 'p6-b200',
2002
+ 'r3',
2003
+ 'r4',
2004
+ 'r5',
2005
+ 'r5a',
2006
+ 'r5ad',
2007
+ 'r5b',
2008
+ 'r5d',
2009
+ 'r5dn',
2010
+ 'r5n',
2011
+ 'r6a',
2012
+ 'r6g',
2013
+ 'r6gd',
2014
+ 'r6i',
2015
+ 'r6id',
2016
+ 'r6idn',
2017
+ 'r6in',
2018
+ 'r7a',
2019
+ 'r7g',
2020
+ 'r7gd',
2021
+ 'r7i',
2022
+ 'r7iz',
2023
+ 'r8g',
2024
+ 'r8gd',
2025
+ 't2',
2026
+ 't2a',
2027
+ 't2d',
2028
+ 't3',
2029
+ 't3a',
2030
+ 't4g',
2031
+ 'trn1',
2032
+ 'trn1n',
2033
+ 'u-3tb1',
2034
+ 'u-6tb1',
2035
+ 'u7i-12tb',
2036
+ 'u7i-6tb',
2037
+ 'u7i-8tb',
2038
+ 'u7in-16tb',
2039
+ 'u7in-24tb',
2040
+ 'u7in-32tb',
2041
+ 'vt1',
2042
+ 'x1',
2043
+ 'x1e',
2044
+ 'x2gd',
2045
+ 'x2idn',
2046
+ 'x2iedn',
2047
+ 'x2iezn',
2048
+ 'x4',
2049
+ 'x8g',
2050
+ 'z1d',
2051
+ 'z3'
2052
+ ]
2053
+ },
2054
+ description: 'Allowed values for `cfke.io/instance-family`.',
2055
+ default: []
2056
+ },
2057
+ 'topology.kubernetes.io/region': {
2058
+ type: 'array',
2059
+ items: {
2060
+ type: 'string',
2061
+ enum: [
2062
+ 'africa-south1',
2063
+ 'ap-northeast-1',
2064
+ 'ap-northeast-2',
2065
+ 'ap-northeast-3',
2066
+ 'ap-south-1',
2067
+ 'ap-southeast-1',
2068
+ 'ap-southeast-2',
2069
+ 'ash',
2070
+ 'asia-east1',
2071
+ 'asia-east2',
2072
+ 'asia-northeast1',
2073
+ 'asia-northeast2',
2074
+ 'asia-northeast3',
2075
+ 'asia-south1',
2076
+ 'asia-south2',
2077
+ 'asia-southeast1',
2078
+ 'asia-southeast2',
2079
+ 'australia-southeast1',
2080
+ 'australia-southeast2',
2081
+ 'ca-central-1',
2082
+ 'eu-central-1',
2083
+ 'eu-central-2',
2084
+ 'eu-north-1',
2085
+ 'eu-west-1',
2086
+ 'eu-west-2',
2087
+ 'eu-west-3',
2088
+ 'europe-central2',
2089
+ 'europe-north1',
2090
+ 'europe-southwest1',
2091
+ 'europe-west1',
2092
+ 'europe-west10',
2093
+ 'europe-west12',
2094
+ 'europe-west2',
2095
+ 'europe-west3',
2096
+ 'europe-west4',
2097
+ 'europe-west6',
2098
+ 'europe-west8',
2099
+ 'europe-west9',
2100
+ 'fsn1',
2101
+ 'hel1',
2102
+ 'hil',
2103
+ 'me-central1',
2104
+ 'me-central2',
2105
+ 'me-west1',
2106
+ 'nbg1',
2107
+ 'northamerica-northeast1',
2108
+ 'northamerica-northeast2',
2109
+ 'sa-east-1',
2110
+ 'sin',
2111
+ 'southamerica-east1',
2112
+ 'southamerica-west1',
2113
+ 'us-central1',
2114
+ 'us-east-1',
2115
+ 'us-east-2',
2116
+ 'us-east1',
2117
+ 'us-east4',
2118
+ 'us-east5',
2119
+ 'us-south1',
2120
+ 'us-west-1',
2121
+ 'us-west-2',
2122
+ 'us-west1',
2123
+ 'us-west2',
2124
+ 'us-west3',
2125
+ 'us-west4'
2126
+ ]
2127
+ },
2128
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
2129
+ default: []
2130
+ }
2131
+ },
2132
+ additionalProperties: false,
2133
+ 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.',
2134
+ default: {
2135
+ 'karpenter.sh/capacity-type': [
2136
+ 'on-demand',
2137
+ 'spot'
2138
+ ],
2139
+ 'kubernetes.io/arch': [
2140
+ 'amd64'
2141
+ ],
2142
+ 'cfke.io/instance-family': [],
2143
+ 'topology.kubernetes.io/region': []
2144
+ }
2145
+ },
2146
+ scalingProfile: {
2147
+ type: 'string',
2148
+ 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`).',
2149
+ default: 'conservative',
2150
+ example: 'conservative',
2151
+ enum: [
2152
+ 'aggressive',
2153
+ 'conservative'
2154
+ ]
2155
+ },
2156
+ taints: {
2157
+ type: 'array',
2158
+ items: {
2159
+ type: 'object',
2160
+ properties: {
2161
+ key: {
2162
+ type: 'string',
2163
+ description: 'Taint key: a Kubernetes qualified name with an optional DNS subdomain prefix. Keys under `node.kubernetes.io`, `node.cloudprovider.kubernetes.io`, `node.cilium.io`, `karpenter.sh` and `cfke.io` (and their subdomains) are reserved.',
2164
+ example: 'dedicated'
2165
+ },
2166
+ value: {
2167
+ type: 'string',
2168
+ maxLength: 63,
2169
+ pattern: '^([A-Za-z0-9]([-A-Za-z0-9_.]*[A-Za-z0-9])?)?$',
2170
+ description: 'Taint value. Optional.',
2171
+ example: 'ci'
2172
+ },
2173
+ effect: {
2174
+ type: 'string',
2175
+ description: 'Taint effect.',
2176
+ example: 'NoSchedule',
2177
+ enum: [
2178
+ 'NoSchedule',
2179
+ 'PreferNoSchedule',
2180
+ 'NoExecute'
2181
+ ]
2182
+ }
2183
+ },
2184
+ required: [
2185
+ 'key',
2186
+ 'effect'
2187
+ ],
2188
+ additionalProperties: false
2189
+ },
2190
+ maxItems: 50,
2191
+ description: 'Taints applied to every node the fleet provisions, so only pods that tolerate them schedule there. Each key and effect pair may appear once. Full-overwrite: omit to remove all taints.',
2192
+ default: []
965
2193
  }
966
2194
  },
2195
+ additionalProperties: false,
2196
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
2197
+ };
2198
+ export const InviteCreateInputSchema = {
2199
+ type: 'object',
2200
+ properties: {
2201
+ email: {
2202
+ type: 'string',
2203
+ format: 'email',
2204
+ description: 'Email address of the user to invite.',
2205
+ example: 'email@example.com'
2206
+ },
2207
+ role: {
2208
+ type: 'string',
2209
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2210
+ default: 'User',
2211
+ example: 'User',
2212
+ enum: [
2213
+ 'Administrator',
2214
+ 'User'
2215
+ ]
2216
+ }
2217
+ },
2218
+ required: [
2219
+ 'email'
2220
+ ],
967
2221
  additionalProperties: false
968
2222
  };
969
2223
  export const InviteSchema = {
@@ -996,6 +2250,16 @@ export const InviteSchema = {
996
2250
  type: 'string',
997
2251
  description: 'Generated unique invite code.',
998
2252
  example: '7kUZnH7nnKUFfvc4NK2KQF'
2253
+ },
2254
+ role: {
2255
+ type: 'string',
2256
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2257
+ default: 'User',
2258
+ example: 'User',
2259
+ enum: [
2260
+ 'Administrator',
2261
+ 'User'
2262
+ ]
999
2263
  }
1000
2264
  },
1001
2265
  required: [
@@ -1003,219 +2267,238 @@ export const InviteSchema = {
1003
2267
  ],
1004
2268
  additionalProperties: false
1005
2269
  };
1006
- export const InvoiceSchema = {
2270
+ export const InvoicePaymentAttemptSchema = {
1007
2271
  type: 'object',
1008
2272
  properties: {
1009
- id: {
2273
+ invoice_id: {
1010
2274
  type: 'string',
1011
- description: 'Unique identifier of the invoice.',
2275
+ description: 'Identifier of the invoice.',
1012
2276
  example: 'in_1234567890xCrwxghOTj1234'
1013
2277
  },
1014
2278
  number: {
1015
- type: 'string'
1016
- },
1017
- status: {
1018
2279
  type: 'string',
1019
- description: 'Status of the invoice',
1020
- example: 'paid'
2280
+ nullable: true,
2281
+ description: 'Invoice number. Null if the invoice has no number.',
2282
+ example: 'CF-0042'
1021
2283
  },
1022
- total: {
2284
+ amount: {
1023
2285
  type: 'number',
1024
2286
  format: 'float',
1025
- description: 'Total amount of the invoice',
1026
- example: 100
2287
+ description: 'Amount outstanding when the charge was attempted, in the smallest currency unit.',
2288
+ example: 4200
1027
2289
  },
1028
2290
  currency: {
1029
2291
  type: 'string',
1030
- description: 'Currency of the invoice',
1031
- example: 'usd'
2292
+ description: 'Currency of the invoice.',
2293
+ example: 'eur'
1032
2294
  },
1033
- created: {
2295
+ status: {
1034
2296
  type: 'string',
1035
- format: 'date-time',
1036
- description: 'Timestamp when the invoice was issued. ISO 8601 date string in the UTC timezone.',
1037
- example: '2023-12-20T13:53:32.000Z'
2297
+ description: 'Outcome for this invoice: `paid`, `processing` (accepted, not yet settled), `requires_action` (awaiting customer authentication), or `failed` (declined).',
2298
+ example: 'paid',
2299
+ enum: [
2300
+ 'paid',
2301
+ 'processing',
2302
+ 'requires_action',
2303
+ 'failed'
2304
+ ]
1038
2305
  },
1039
- period_start: {
2306
+ client_secret: {
1040
2307
  type: 'string',
1041
- format: 'date-time',
1042
- description: 'Billing period start timestamp. ISO 8601 date string in the UTC timezone.',
1043
- example: '2023-12-20T13:53:32.000Z'
2308
+ nullable: true,
2309
+ description: 'Client secret used to complete customer authentication. Set only when `status` is `requires_action`.',
2310
+ example: 'pi_3MtwBwLkdIwHu7ix28a3tqPa_secret_YrKJUKribcBjcG8HVhfZluoGH'
1044
2311
  },
1045
- period_end: {
2312
+ failure_code: {
1046
2313
  type: 'string',
1047
- format: 'date-time',
1048
- description: 'Billing period end timestamp. ISO 8601 date string in the UTC timezone.',
1049
- example: '2023-12-20T13:53:32.000Z'
2314
+ nullable: true,
2315
+ description: 'Decline code. Set only when `status` is `failed`.',
2316
+ example: 'insufficient_funds'
1050
2317
  },
1051
- invoice_pdf: {
1052
- type: 'string'
2318
+ failure_message: {
2319
+ type: 'string',
2320
+ nullable: true,
2321
+ description: 'Explanation of the decline, suitable for display. Set only when `status` is `failed`.',
2322
+ example: 'Your card has insufficient funds.'
1053
2323
  }
1054
2324
  },
1055
2325
  required: [
1056
- 'created',
1057
- 'period_start',
1058
- 'period_end'
2326
+ 'invoice_id',
2327
+ 'number',
2328
+ 'amount',
2329
+ 'currency',
2330
+ 'status',
2331
+ 'client_secret',
2332
+ 'failure_code',
2333
+ 'failure_message'
1059
2334
  ],
1060
2335
  additionalProperties: false
1061
2336
  };
1062
- export const MarketplaceListingFilesSchema = {
2337
+ export const InvoicePaymentResultSchema = {
1063
2338
  type: 'object',
1064
2339
  properties: {
1065
- chartYaml: {
2340
+ code: {
1066
2341
  type: 'string',
1067
- description: 'Raw Chart.yaml content from the Helm chart',
1068
- example: 'apiVersion: v2\nname: nginx-ingress\nversion: 1.18.2-cfke.45\nappVersion: 1.9.4'
2342
+ description: 'Overall outcome: `paid` (nothing outstanding), `processing` (all accepted, not yet settled), `action_required` (one or more await customer authentication), `partially_paid`, `failed`, `nothing_due`, or `bank_transfer_due` (the organization pays by bank transfer; nothing was charged).',
2343
+ example: 'partially_paid',
2344
+ enum: [
2345
+ 'paid',
2346
+ 'processing',
2347
+ 'action_required',
2348
+ 'partially_paid',
2349
+ 'failed',
2350
+ 'nothing_due',
2351
+ 'bank_transfer_due'
2352
+ ]
1069
2353
  },
1070
- valuesYaml: {
2354
+ message: {
1071
2355
  type: 'string',
1072
- description: 'Raw values.yaml content from the Helm chart',
1073
- example: 'replicaCount: 1\nimage:\n repository: nginx\n tag: latest'
2356
+ description: 'Summary of the outcome, suitable for display.',
2357
+ example: '1 of 2 open invoices was paid. Invoice CF-0043 was declined: Your card has insufficient funds.'
1074
2358
  },
1075
- valuesSchemaJson: {
1076
- type: 'string',
1077
- description: 'JSON schema for values.yaml as a string',
1078
- example: '{"type":"object","properties":{"replicaCount":{"type":"number"}}}'
2359
+ results: {
2360
+ type: 'array',
2361
+ items: {
2362
+ type: 'object',
2363
+ properties: {
2364
+ invoice_id: {
2365
+ type: 'string',
2366
+ description: 'Identifier of the invoice.',
2367
+ example: 'in_1234567890xCrwxghOTj1234'
2368
+ },
2369
+ number: {
2370
+ type: 'string',
2371
+ description: 'Invoice number. Null if the invoice has no number.',
2372
+ example: 'CF-0042'
2373
+ },
2374
+ amount: {
2375
+ type: 'number',
2376
+ format: 'float',
2377
+ description: 'Amount outstanding when the charge was attempted, in the smallest currency unit.',
2378
+ example: 4200
2379
+ },
2380
+ currency: {
2381
+ type: 'string',
2382
+ description: 'Currency of the invoice.',
2383
+ example: 'eur'
2384
+ },
2385
+ status: {
2386
+ type: 'string',
2387
+ description: 'Outcome for this invoice: `paid`, `processing` (accepted, not yet settled), `requires_action` (awaiting customer authentication), or `failed` (declined).',
2388
+ example: 'paid',
2389
+ enum: [
2390
+ 'paid',
2391
+ 'processing',
2392
+ 'requires_action',
2393
+ 'failed'
2394
+ ]
2395
+ },
2396
+ client_secret: {
2397
+ type: 'string',
2398
+ description: 'Client secret used to complete customer authentication. Set only when `status` is `requires_action`.',
2399
+ example: 'pi_3MtwBwLkdIwHu7ix28a3tqPa_secret_YrKJUKribcBjcG8HVhfZluoGH'
2400
+ },
2401
+ failure_code: {
2402
+ type: 'string',
2403
+ description: 'Decline code. Set only when `status` is `failed`.',
2404
+ example: 'insufficient_funds'
2405
+ },
2406
+ failure_message: {
2407
+ type: 'string',
2408
+ description: 'Explanation of the decline, suitable for display. Set only when `status` is `failed`.',
2409
+ example: 'Your card has insufficient funds.'
2410
+ }
2411
+ },
2412
+ required: [
2413
+ 'invoice_id',
2414
+ 'number',
2415
+ 'amount',
2416
+ 'currency',
2417
+ 'status',
2418
+ 'client_secret',
2419
+ 'failure_code',
2420
+ 'failure_message'
2421
+ ],
2422
+ additionalProperties: false
2423
+ },
2424
+ description: 'One entry per invoice charged, oldest first.'
1079
2425
  }
1080
2426
  },
2427
+ required: [
2428
+ 'code',
2429
+ 'message',
2430
+ 'results'
2431
+ ],
1081
2432
  additionalProperties: false
1082
2433
  };
1083
- export const MarketplaceListingSchema = {
2434
+ export const InvoiceSchema = {
1084
2435
  type: 'object',
1085
2436
  properties: {
1086
- name: {
2437
+ id: {
1087
2438
  type: 'string',
1088
- description: 'Name of the chart',
1089
- example: 'nginx-ingress'
1090
- },
1091
- versions: {
1092
- type: 'array',
1093
- items: {
1094
- type: 'string',
1095
- pattern: '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(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-]+)*))?$',
1096
- description: 'Specific version of the chart',
1097
- example: '1.18.2-cfke.45'
1098
- },
1099
- description: 'Available versions of the chart'
2439
+ description: 'Unique identifier of the invoice.',
2440
+ example: 'in_1234567890xCrwxghOTj1234'
1100
2441
  },
1101
- version_channels: {
1102
- type: 'array',
1103
- items: {
1104
- type: 'string',
1105
- 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-]+)*))?$',
1106
- description: 'Version channel pattern',
1107
- example: '1.18.x-cfke.x'
1108
- },
1109
- description: 'Version channels for the chart'
2442
+ number: {
2443
+ type: 'string'
1110
2444
  },
1111
- latestVersion: {
2445
+ status: {
1112
2446
  type: 'string',
1113
- description: 'Latest version of the chart',
1114
- example: '1.18.2-cfke.45'
1115
- },
1116
- metadata: {
1117
- type: 'object',
1118
- properties: {
1119
- name: {
1120
- type: 'string',
1121
- description: 'Chart name from metadata',
1122
- example: 'nginx-ingress'
1123
- },
1124
- version: {
1125
- type: 'string',
1126
- description: 'Chart version from metadata',
1127
- example: '1.18.2-cfke.45'
1128
- },
1129
- description: {
1130
- type: 'string',
1131
- description: 'Chart description',
1132
- example: 'NGINX Ingress Controller for Kubernetes'
1133
- },
1134
- appVersion: {
1135
- type: 'string',
1136
- description: 'Application version',
1137
- example: '1.9.4'
1138
- },
1139
- apiVersion: {
1140
- type: 'string',
1141
- description: 'Helm API version',
1142
- example: 'v2'
1143
- },
1144
- keywords: {
1145
- type: 'array',
1146
- items: {
1147
- type: 'string'
1148
- },
1149
- description: 'Chart keywords',
1150
- example: [
1151
- 'ingress',
1152
- 'nginx',
1153
- 'load-balancer'
1154
- ]
1155
- },
1156
- home: {
1157
- type: 'string',
1158
- description: 'Chart home URL',
1159
- example: 'https://kubernetes.github.io/ingress-nginx/'
1160
- },
1161
- icon: {
1162
- type: 'string',
1163
- description: 'A URL to an SVG or PNG image to be used as an icon',
1164
- example: 'https://cloudfleet.ai/images/marketplace/icons/ingress-nginx.png'
1165
- },
1166
- sources: {
1167
- type: 'array',
1168
- items: {
1169
- type: 'string'
1170
- },
1171
- description: 'Chart source URLs',
1172
- example: [
1173
- 'https://github.com/kubernetes/ingress-nginx'
1174
- ]
1175
- },
1176
- maintainers: {
1177
- type: 'array',
1178
- items: {
1179
- type: 'object',
1180
- properties: {
1181
- name: {
1182
- type: 'string',
1183
- description: 'Maintainer name',
1184
- example: 'NGINX Team'
1185
- },
1186
- email: {
1187
- type: 'string',
1188
- description: 'Maintainer email',
1189
- example: 'support@nginx.org'
1190
- }
1191
- },
1192
- required: [
1193
- 'name'
1194
- ],
1195
- additionalProperties: false
1196
- },
1197
- description: 'Chart maintainers'
1198
- }
1199
- },
1200
- required: [
1201
- 'name',
1202
- 'version'
1203
- ],
1204
- additionalProperties: false,
1205
- description: 'Chart metadata'
2447
+ description: 'Status of the invoice',
2448
+ example: 'paid'
2449
+ },
2450
+ total: {
2451
+ type: 'number',
2452
+ format: 'float',
2453
+ description: 'Total amount of the invoice',
2454
+ example: 100
2455
+ },
2456
+ currency: {
2457
+ type: 'string',
2458
+ description: 'Currency of the invoice',
2459
+ example: 'usd'
2460
+ },
2461
+ created: {
2462
+ type: 'string',
2463
+ format: 'date-time',
2464
+ description: 'Timestamp when the invoice was issued. ISO 8601 date string in the UTC timezone.',
2465
+ example: '2023-12-20T13:53:32.000Z'
2466
+ },
2467
+ period_start: {
2468
+ type: 'string',
2469
+ format: 'date-time',
2470
+ description: 'Billing period start timestamp. ISO 8601 date string in the UTC timezone.',
2471
+ example: '2023-12-20T13:53:32.000Z'
2472
+ },
2473
+ period_end: {
2474
+ type: 'string',
2475
+ format: 'date-time',
2476
+ description: 'Billing period end timestamp. ISO 8601 date string in the UTC timezone.',
2477
+ example: '2023-12-20T13:53:32.000Z'
2478
+ },
2479
+ invoice_pdf: {
2480
+ type: 'string'
1206
2481
  }
1207
2482
  },
1208
2483
  required: [
1209
- 'name',
1210
- 'versions',
1211
- 'version_channels',
1212
- 'latestVersion'
2484
+ 'created',
2485
+ 'period_start',
2486
+ 'period_end'
1213
2487
  ],
1214
2488
  additionalProperties: false
1215
2489
  };
1216
2490
  export const OrganizationCreateInputSchema = {
1217
2491
  type: 'object',
1218
2492
  properties: {
2493
+ type: {
2494
+ type: 'string',
2495
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2496
+ example: 'business',
2497
+ enum: [
2498
+ 'business',
2499
+ 'personal'
2500
+ ]
2501
+ },
1219
2502
  email: {
1220
2503
  type: 'string',
1221
2504
  format: 'email',
@@ -1224,11 +2507,13 @@ export const OrganizationCreateInputSchema = {
1224
2507
  },
1225
2508
  first_name: {
1226
2509
  type: 'string',
2510
+ minLength: 1,
1227
2511
  description: 'First name of the billing contact person.',
1228
2512
  example: 'John'
1229
2513
  },
1230
2514
  last_name: {
1231
2515
  type: 'string',
2516
+ minLength: 1,
1232
2517
  description: 'Last name of the billing contact person.',
1233
2518
  example: 'Doe'
1234
2519
  },
@@ -1247,6 +2532,7 @@ export const OrganizationCreateInputSchema = {
1247
2532
  }
1248
2533
  },
1249
2534
  required: [
2535
+ 'type',
1250
2536
  'email',
1251
2537
  'first_name',
1252
2538
  'last_name',
@@ -1255,6 +2541,20 @@ export const OrganizationCreateInputSchema = {
1255
2541
  ],
1256
2542
  additionalProperties: false
1257
2543
  };
2544
+ export const OrganizationCreateOutputSchema = {
2545
+ type: 'object',
2546
+ properties: {
2547
+ id: {
2548
+ type: 'string',
2549
+ description: 'Unique identifier of the newly created organization. Generated by the API and safe to use for client-side tracking immediately.',
2550
+ example: 'organization-id'
2551
+ }
2552
+ },
2553
+ required: [
2554
+ 'id'
2555
+ ],
2556
+ additionalProperties: false
2557
+ };
1258
2558
  export const OrganizationSchema = {
1259
2559
  type: 'object',
1260
2560
  properties: {
@@ -1271,6 +2571,15 @@ export const OrganizationSchema = {
1271
2571
  description: 'Name of the legal entity. This name will be used in invoices. Use your first and last name for individual accounts.',
1272
2572
  example: 'ACME Corp.'
1273
2573
  },
2574
+ type: {
2575
+ type: 'string',
2576
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2577
+ example: 'business',
2578
+ enum: [
2579
+ 'business',
2580
+ 'personal'
2581
+ ]
2582
+ },
1274
2583
  date_created: {
1275
2584
  type: 'string',
1276
2585
  format: 'date-time',
@@ -1302,6 +2611,17 @@ export const OrganizationSchema = {
1302
2611
  description: 'Available number of Pro clusters that can be created.',
1303
2612
  example: 999
1304
2613
  },
2614
+ enterprise_clusters_max: {
2615
+ type: 'integer',
2616
+ minimum: 0,
2617
+ description: 'Maximum number of Enterprise clusters that can be created.',
2618
+ example: 999
2619
+ },
2620
+ enterprise_clusters_available: {
2621
+ type: 'integer',
2622
+ description: 'Available number of Enterprise clusters that can be created.',
2623
+ example: 999
2624
+ },
1305
2625
  fleets_max: {
1306
2626
  type: 'integer',
1307
2627
  minimum: 0,
@@ -1321,7 +2641,7 @@ export const OrganizationSchema = {
1321
2641
  type: 'array',
1322
2642
  items: {
1323
2643
  type: 'string',
1324
- example: 'northamerica-central-1'
2644
+ example: 'northamerica-central-1a'
1325
2645
  },
1326
2646
  minItems: 1,
1327
2647
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -1363,6 +2683,8 @@ export const OrganizationSchema = {
1363
2683
  'basic_clusters_available',
1364
2684
  'pro_clusters_max',
1365
2685
  'pro_clusters_available',
2686
+ 'enterprise_clusters_max',
2687
+ 'enterprise_clusters_available',
1366
2688
  'fleets_max',
1367
2689
  'cluster_tiers',
1368
2690
  'regions',
@@ -1380,13 +2702,25 @@ export const OrganizationSchema = {
1380
2702
  'closed',
1381
2703
  'suspended'
1382
2704
  ]
2705
+ },
2706
+ verification: {
2707
+ type: 'string',
2708
+ 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.',
2709
+ example: 'verified',
2710
+ enum: [
2711
+ 'none',
2712
+ 'submitted',
2713
+ 'verified'
2714
+ ]
1383
2715
  }
1384
2716
  },
1385
2717
  required: [
1386
2718
  'id',
2719
+ 'type',
1387
2720
  'date_created',
1388
2721
  'quota',
1389
- 'status'
2722
+ 'status',
2723
+ 'verification'
1390
2724
  ],
1391
2725
  additionalProperties: false
1392
2726
  };
@@ -1395,28 +2729,23 @@ export const PaymentMethodSchema = {
1395
2729
  properties: {
1396
2730
  id: {
1397
2731
  type: 'string',
1398
- format: 'uuid',
1399
- description: 'Unique identifier of the organization. UUID v4 string in canonical form.',
1400
- example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
1401
- },
1402
- setup: {
1403
- type: 'boolean',
1404
- description: 'Whether organization payment method was set up and ready to use for payments.',
1405
- example: true
2732
+ 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.',
2733
+ example: 'pm_1MtwBwLkdIwHu7ix28a3tqPa'
1406
2734
  },
1407
2735
  type: {
1408
2736
  type: 'string',
1409
- nullable: true,
1410
- description: 'Payment method type type. Only `card` payments supported at the moment.',
2737
+ description: 'Payment method type. `card`, `sepa_debit` for SEPA Direct Debit (business accounts only), or `bank_transfer` for paying invoices by bank transfer.',
1411
2738
  example: 'card',
1412
2739
  enum: [
1413
- 'card'
2740
+ 'card',
2741
+ 'sepa_debit',
2742
+ 'bank_transfer'
1414
2743
  ]
1415
2744
  },
1416
2745
  last4: {
1417
2746
  type: 'string',
1418
2747
  nullable: true,
1419
- description: 'Last 4 digits of the payment card number.',
2748
+ 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.',
1420
2749
  example: '4242'
1421
2750
  },
1422
2751
  exp_month: {
@@ -1424,42 +2753,56 @@ export const PaymentMethodSchema = {
1424
2753
  minimum: 1,
1425
2754
  maximum: 12,
1426
2755
  nullable: true,
1427
- description: 'Two-digit number representing the card\'s expiration month.',
1428
- example: '12'
2756
+ description: 'Two-digit number representing the card\'s expiration month. Null for SEPA Direct Debit and bank transfer.',
2757
+ example: 12
1429
2758
  },
1430
2759
  exp_year: {
1431
2760
  type: 'integer',
1432
- minimum: 2024,
1433
2761
  nullable: true,
1434
- description: 'Four-digit number representing the card\'s expiration year.',
1435
- example: '2028'
2762
+ 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.',
2763
+ example: 2028
1436
2764
  },
1437
2765
  brand: {
1438
2766
  type: 'string',
1439
2767
  nullable: true,
1440
- description: 'Payment card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.',
1441
- example: 'visa',
1442
- enum: [
1443
- 'amex',
1444
- 'diners',
1445
- 'discover',
1446
- 'eftpos_au',
1447
- 'jcb',
1448
- 'mastercard',
1449
- 'unionpay',
1450
- 'visa',
1451
- 'unknown'
1452
- ]
2768
+ 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.',
2769
+ example: 'visa'
2770
+ },
2771
+ iban: {
2772
+ type: 'string',
2773
+ nullable: true,
2774
+ 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.',
2775
+ example: 'DE11243015658023127510'
2776
+ },
2777
+ bic: {
2778
+ type: 'string',
2779
+ nullable: true,
2780
+ description: 'BIC/SWIFT of the destination bank for bank transfers. Set only for `bank_transfer`; null otherwise.',
2781
+ example: 'SOGEDEFFXXX'
2782
+ },
2783
+ account_holder_name: {
2784
+ type: 'string',
2785
+ nullable: true,
2786
+ description: 'Account holder name of the destination bank account for bank transfers. Set only for `bank_transfer`; null otherwise.',
2787
+ example: 'Cloudfleet GmbH'
2788
+ },
2789
+ is_default: {
2790
+ type: 'boolean',
2791
+ 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).',
2792
+ example: true
1453
2793
  }
1454
2794
  },
1455
2795
  required: [
1456
2796
  'id',
1457
- 'setup',
1458
2797
  'type',
1459
2798
  'last4',
1460
2799
  'exp_month',
1461
2800
  'exp_year',
1462
- 'brand'
2801
+ 'brand',
2802
+ 'iban',
2803
+ 'bic',
2804
+ 'account_holder_name',
2805
+ 'is_default'
1463
2806
  ],
1464
2807
  additionalProperties: false
1465
2808
  };
@@ -1488,6 +2831,17 @@ export const PlatformQuotaSchema = {
1488
2831
  description: 'Available number of Pro clusters that can be created.',
1489
2832
  example: 999
1490
2833
  },
2834
+ enterprise_clusters_max: {
2835
+ type: 'integer',
2836
+ minimum: 0,
2837
+ description: 'Maximum number of Enterprise clusters that can be created.',
2838
+ example: 999
2839
+ },
2840
+ enterprise_clusters_available: {
2841
+ type: 'integer',
2842
+ description: 'Available number of Enterprise clusters that can be created.',
2843
+ example: 999
2844
+ },
1491
2845
  fleets_max: {
1492
2846
  type: 'integer',
1493
2847
  minimum: 0,
@@ -1507,7 +2861,7 @@ export const PlatformQuotaSchema = {
1507
2861
  type: 'array',
1508
2862
  items: {
1509
2863
  type: 'string',
1510
- example: 'northamerica-central-1'
2864
+ example: 'northamerica-central-1a'
1511
2865
  },
1512
2866
  minItems: 1,
1513
2867
  description: 'List of Cloudfleet control plane regions available for the organization.'
@@ -1549,6 +2903,8 @@ export const PlatformQuotaSchema = {
1549
2903
  'basic_clusters_available',
1550
2904
  'pro_clusters_max',
1551
2905
  'pro_clusters_available',
2906
+ 'enterprise_clusters_max',
2907
+ 'enterprise_clusters_available',
1552
2908
  'fleets_max',
1553
2909
  'cluster_tiers',
1554
2910
  'regions',
@@ -1822,6 +3178,73 @@ export const RegistryTagSchema = {
1822
3178
  ],
1823
3179
  additionalProperties: false
1824
3180
  };
3181
+ export const RoadmapItemCreateInputSchema = {
3182
+ type: 'object',
3183
+ properties: {
3184
+ text: {
3185
+ type: 'string',
3186
+ maxLength: 500,
3187
+ minLength: 1,
3188
+ description: 'Your suggestion in one or two sentences. It is reviewed before it appears on the roadmap.',
3189
+ example: 'Support for ARM nodes on Hetzner.'
3190
+ }
3191
+ },
3192
+ required: [
3193
+ 'text'
3194
+ ],
3195
+ additionalProperties: false
3196
+ };
3197
+ export const RoadmapItemSchema = {
3198
+ type: 'object',
3199
+ properties: {
3200
+ id: {
3201
+ type: 'string',
3202
+ description: 'Unique identifier of the roadmap item (Mongo ObjectId).',
3203
+ example: '60c72b2f9f1b2c001f8e4d3a'
3204
+ },
3205
+ text: {
3206
+ type: 'string',
3207
+ description: 'Short description of the roadmap item.',
3208
+ example: 'Support for ARM nodes on Hetzner.'
3209
+ },
3210
+ vote: {
3211
+ type: 'integer',
3212
+ nullable: true,
3213
+ description: 'The caller\'s vote on this item: -1 (down), 1 (up), 2 (double up), or null if the caller has not voted.',
3214
+ example: 1,
3215
+ enum: [
3216
+ -1,
3217
+ 1,
3218
+ 2
3219
+ ]
3220
+ }
3221
+ },
3222
+ required: [
3223
+ 'id',
3224
+ 'text',
3225
+ 'vote'
3226
+ ],
3227
+ additionalProperties: false
3228
+ };
3229
+ export const RoadmapVoteInputSchema = {
3230
+ type: 'object',
3231
+ properties: {
3232
+ value: {
3233
+ type: 'integer',
3234
+ description: 'Vote value: -1 (down), 1 (up), or 2 (double up).',
3235
+ example: 1,
3236
+ enum: [
3237
+ -1,
3238
+ 1,
3239
+ 2
3240
+ ]
3241
+ }
3242
+ },
3243
+ required: [
3244
+ 'value'
3245
+ ],
3246
+ additionalProperties: false
3247
+ };
1825
3248
  export const TicketAttachmentSchema = {
1826
3249
  type: 'object',
1827
3250
  properties: {
@@ -1883,6 +3306,11 @@ export const TicketCreateInputSchema = {
1883
3306
  subcategory: 'cluster-question',
1884
3307
  cluster_id: '60c72b2f9f1b2c001f8e4d3a'
1885
3308
  }
3309
+ },
3310
+ grant_support_access: {
3311
+ type: 'boolean',
3312
+ description: 'Grant Cloudfleet support staff access to the organization\'s resources while the ticket is open. Access cannot be revoked; it ends when the ticket is closed.',
3313
+ example: true
1886
3314
  }
1887
3315
  },
1888
3316
  required: [
@@ -1891,172 +3319,6 @@ export const TicketCreateInputSchema = {
1891
3319
  ],
1892
3320
  additionalProperties: false
1893
3321
  };
1894
- export const TicketListResponseSchema = {
1895
- type: 'object',
1896
- properties: {
1897
- items: {
1898
- type: 'array',
1899
- items: {
1900
- type: 'object',
1901
- properties: {
1902
- id: {
1903
- type: 'string',
1904
- description: 'Unique identifier of the ticket (Mongo ObjectId).',
1905
- example: '60c72b2f9f1b2c001f8e4d3a'
1906
- },
1907
- status: {
1908
- type: 'string',
1909
- description: 'Current state of the ticket.',
1910
- example: 'waiting_on_us',
1911
- enum: [
1912
- 'waiting_on_us',
1913
- 'waiting_on_user',
1914
- 'closed'
1915
- ]
1916
- },
1917
- category: {
1918
- type: 'string',
1919
- description: 'Ticket category.',
1920
- example: 'technical',
1921
- enum: [
1922
- 'billing',
1923
- 'technical',
1924
- 'general'
1925
- ]
1926
- },
1927
- summary: {
1928
- type: 'string',
1929
- description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
1930
- example: 'My cluster cannot reach the registry. Logs attached.'
1931
- },
1932
- closed_at: {
1933
- type: 'string',
1934
- format: 'date-time',
1935
- nullable: true,
1936
- description: 'Closure timestamp. Null while the ticket is open.',
1937
- example: '2026-05-18T16:08:14.338Z'
1938
- },
1939
- date_created: {
1940
- type: 'string',
1941
- format: 'date-time',
1942
- description: 'Creation date of the ticket. ISO 8601 UTC.',
1943
- example: '2026-05-11T16:08:14.338Z'
1944
- },
1945
- date_updated: {
1946
- type: 'string',
1947
- format: 'date-time',
1948
- description: 'Last update date of the ticket. ISO 8601 UTC.',
1949
- example: '2026-05-11T16:08:14.338Z'
1950
- },
1951
- messages: {
1952
- type: 'array',
1953
- items: {
1954
- type: 'object',
1955
- properties: {
1956
- id: {
1957
- type: 'string',
1958
- description: 'Unique identifier of the message (Mongo ObjectId).',
1959
- example: '60c72b2f9f1b2c001f8e4d3b'
1960
- },
1961
- type: {
1962
- type: 'string',
1963
- description: 'Message type. Internal notes are filtered out of customer-facing responses.',
1964
- example: 'customer_reply',
1965
- enum: [
1966
- 'customer_reply',
1967
- 'agent_reply'
1968
- ]
1969
- },
1970
- body: {
1971
- type: 'string',
1972
- description: 'Message body in markdown.',
1973
- example: 'Thanks — that resolved it on my side.'
1974
- },
1975
- author_first_name: {
1976
- type: 'string',
1977
- nullable: true,
1978
- description: 'First name of the author. Null when not provided.',
1979
- example: 'Jane'
1980
- },
1981
- author_last_name: {
1982
- type: 'string',
1983
- nullable: true,
1984
- description: 'Last name of the author. Null when not provided.',
1985
- example: 'Doe'
1986
- },
1987
- attachments: {
1988
- type: 'array',
1989
- items: {
1990
- type: 'object',
1991
- properties: {
1992
- id: {
1993
- type: 'string',
1994
- description: 'Unique identifier of the attachment (Mongo ObjectId).',
1995
- example: '60c72b2f9f1b2c001f8e4d3c'
1996
- },
1997
- filename: {
1998
- type: 'string',
1999
- description: 'Original filename as uploaded.',
2000
- example: 'debug.log'
2001
- },
2002
- content_type: {
2003
- type: 'string',
2004
- description: 'MIME content type of the attachment.',
2005
- example: 'text/plain'
2006
- },
2007
- size: {
2008
- type: 'integer',
2009
- description: 'Size of the attachment in bytes.',
2010
- example: 12345
2011
- }
2012
- },
2013
- required: [
2014
- 'id',
2015
- 'filename',
2016
- 'content_type',
2017
- 'size'
2018
- ],
2019
- additionalProperties: false
2020
- },
2021
- description: 'Attachments associated with this message.',
2022
- example: []
2023
- },
2024
- date_created: {
2025
- type: 'string',
2026
- format: 'date-time',
2027
- description: 'Creation date of the message. ISO 8601 UTC.',
2028
- example: '2026-05-11T16:08:14.338Z'
2029
- }
2030
- },
2031
- required: [
2032
- 'id',
2033
- 'type',
2034
- 'body',
2035
- 'date_created'
2036
- ],
2037
- additionalProperties: false
2038
- },
2039
- description: 'Messages on the ticket in chronological order. Internal notes are excluded. Returned by the detail endpoint only.'
2040
- }
2041
- },
2042
- required: [
2043
- 'id',
2044
- 'status',
2045
- 'category',
2046
- 'summary',
2047
- 'date_created',
2048
- 'date_updated'
2049
- ],
2050
- additionalProperties: false
2051
- },
2052
- description: 'Tickets for the organization, ordered newest first. Messages are omitted from list responses.'
2053
- }
2054
- },
2055
- required: [
2056
- 'items'
2057
- ],
2058
- additionalProperties: false
2059
- };
2060
3322
  export const TicketMessageInputSchema = {
2061
3323
  type: 'object',
2062
3324
  properties: {
@@ -2098,11 +3360,13 @@ export const TicketMessageSchema = {
2098
3360
  },
2099
3361
  author_first_name: {
2100
3362
  type: 'string',
3363
+ nullable: true,
2101
3364
  description: 'First name of the author. Null when not provided.',
2102
3365
  example: 'Jane'
2103
3366
  },
2104
3367
  author_last_name: {
2105
3368
  type: 'string',
3369
+ nullable: true,
2106
3370
  description: 'Last name of the author. Null when not provided.',
2107
3371
  example: 'Doe'
2108
3372
  },
@@ -2191,9 +3455,22 @@ export const TicketSchema = {
2191
3455
  description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
2192
3456
  example: 'My cluster cannot reach the registry. Logs attached.'
2193
3457
  },
3458
+ support_access_granted: {
3459
+ type: 'boolean',
3460
+ description: 'Whether Cloudfleet support staff currently have access to the organization\'s resources. True once access is granted and until the ticket is closed.',
3461
+ example: true
3462
+ },
3463
+ support_access_granted_at: {
3464
+ type: 'string',
3465
+ format: 'date-time',
3466
+ nullable: true,
3467
+ description: 'When support access was granted. Null if it never was. Kept after the ticket is closed.',
3468
+ example: '2026-05-11T16:08:14.338Z'
3469
+ },
2194
3470
  closed_at: {
2195
3471
  type: 'string',
2196
3472
  format: 'date-time',
3473
+ nullable: true,
2197
3474
  description: 'Closure timestamp. Null while the ticket is open.',
2198
3475
  example: '2026-05-18T16:08:14.338Z'
2199
3476
  },
@@ -2303,6 +3580,8 @@ export const TicketSchema = {
2303
3580
  'status',
2304
3581
  'category',
2305
3582
  'summary',
3583
+ 'support_access_granted',
3584
+ 'support_access_granted_at',
2306
3585
  'date_created',
2307
3586
  'date_updated'
2308
3587
  ],
@@ -2418,12 +3697,21 @@ export const UsageFacetsSchema = {
2418
3697
  product: {
2419
3698
  type: 'array',
2420
3699
  items: {
2421
- type: 'string'
3700
+ type: 'string',
3701
+ enum: [
3702
+ 'cfke_controlplane_basic',
3703
+ 'cfke_controlplane_pro',
3704
+ 'cfke_controlplane_enterprise',
3705
+ 'cfke_connected_nodes_basic',
3706
+ 'cfke_connected_nodes_pro',
3707
+ 'cfke_connected_nodes_enterprise',
3708
+ 'cfcr_storage'
3709
+ ]
2422
3710
  },
2423
3711
  description: 'List of unique products',
2424
3712
  example: [
2425
- 'cfke_controlplane',
2426
- 'cfke_connected_nodes'
3713
+ 'cfke_controlplane_pro',
3714
+ 'cfke_connected_nodes_pro'
2427
3715
  ]
2428
3716
  }
2429
3717
  },
@@ -2450,7 +3738,16 @@ export const UsageResponseSchema = {
2450
3738
  product: {
2451
3739
  type: 'string',
2452
3740
  description: 'The product the usage is associated with',
2453
- example: 'cfke_controlplane'
3741
+ example: 'cfke_controlplane_pro',
3742
+ enum: [
3743
+ 'cfke_controlplane_basic',
3744
+ 'cfke_controlplane_pro',
3745
+ 'cfke_controlplane_enterprise',
3746
+ 'cfke_connected_nodes_basic',
3747
+ 'cfke_connected_nodes_pro',
3748
+ 'cfke_connected_nodes_enterprise',
3749
+ 'cfcr_storage'
3750
+ ]
2454
3751
  },
2455
3752
  value: {
2456
3753
  type: 'number',
@@ -2498,12 +3795,21 @@ export const UsageResponseSchema = {
2498
3795
  product: {
2499
3796
  type: 'array',
2500
3797
  items: {
2501
- type: 'string'
3798
+ type: 'string',
3799
+ enum: [
3800
+ 'cfke_controlplane_basic',
3801
+ 'cfke_controlplane_pro',
3802
+ 'cfke_controlplane_enterprise',
3803
+ 'cfke_connected_nodes_basic',
3804
+ 'cfke_connected_nodes_pro',
3805
+ 'cfke_connected_nodes_enterprise',
3806
+ 'cfcr_storage'
3807
+ ]
2502
3808
  },
2503
3809
  description: 'List of unique products',
2504
3810
  example: [
2505
- 'cfke_controlplane',
2506
- 'cfke_connected_nodes'
3811
+ 'cfke_controlplane_pro',
3812
+ 'cfke_connected_nodes_pro'
2507
3813
  ]
2508
3814
  }
2509
3815
  },
@@ -2533,7 +3839,16 @@ export const UsageSchema = {
2533
3839
  product: {
2534
3840
  type: 'string',
2535
3841
  description: 'The product the usage is associated with',
2536
- example: 'cfke_controlplane'
3842
+ example: 'cfke_controlplane_pro',
3843
+ enum: [
3844
+ 'cfke_controlplane_basic',
3845
+ 'cfke_controlplane_pro',
3846
+ 'cfke_controlplane_enterprise',
3847
+ 'cfke_connected_nodes_basic',
3848
+ 'cfke_connected_nodes_pro',
3849
+ 'cfke_connected_nodes_enterprise',
3850
+ 'cfcr_storage'
3851
+ ]
2537
3852
  },
2538
3853
  value: {
2539
3854
  type: 'number',
@@ -2596,24 +3911,6 @@ export const UserCreateInputSchema = {
2596
3911
  type: 'string',
2597
3912
  minLength: 8,
2598
3913
  description: 'User password. Must be at least 8 characters long.'
2599
- },
2600
- status: {
2601
- type: 'string',
2602
- description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
2603
- example: 'active',
2604
- enum: [
2605
- 'active',
2606
- 'inactive'
2607
- ]
2608
- },
2609
- role: {
2610
- type: 'string',
2611
- description: 'User role. Can be \'Administrator\', \'User\'.',
2612
- example: 'User',
2613
- enum: [
2614
- 'Administrator',
2615
- 'User'
2616
- ]
2617
3914
  }
2618
3915
  },
2619
3916
  required: [