@cloudfleet/sdk 0.0.1-bbca6e3 → 0.0.1-bd45f1a

package/dist/schemas.gen.js

@@ -440,31 +440,117 @@ export const ClusterCreateInputSchema = {
         tier: {
             type: 'string',
             description: 'Tier of the cluster.',
+            default: 'basic',
             example: 'pro',
             enum: [
                 'basic',
                 'pro'
             ]
         },
-        region: {
-            type: 'string',
-            description: 'Cloudfleet control plane region. This field can not be updated after creation.',
-            example: 'europe-central-1a'
-        },
         version_channel: {
             type: 'string',
             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-]+)*))?$',
             description: 'Version of the kubernetes cluster.',
             default: '1.x.x-cfke.x',
             example: '1.x.x-cfke.x'
+        },
+        release_channel: {
+            type: 'string',
+            description: 'Release channel for the cluster\'s control plane.',
+            default: 'rapid',
+            example: 'rapid',
+            enum: [
+                'rapid',
+                'stable',
+                'extended'
+            ]
+        },
+        features: {
+            type: 'object',
+            properties: {
+                gpu_sharing_strategy: {
+                    type: 'string',
+                    description: 'GPU sharing strategy.',
+                    default: 'none',
+                    example: 'none',
+                    enum: [
+                        'none',
+                        'mps',
+                        'time_slicing'
+                    ]
+                },
+                gpu_max_shared_clients_per_gpu: {
+                    type: 'integer',
+                    minimum: 2,
+                    maximum: 48,
+                    description: 'Maximum number of pods that may share a single GPU.',
+                    default: 4,
+                    example: 10
+                },
+                cilium_socket_lb_host_namespace_only: {
+                    type: 'boolean',
+                    description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
+                    example: false
+                }
+            },
+            additionalProperties: false,
+            description: 'Cluster feature toggles.',
+            default: {
+                gpu_sharing_strategy: 'none',
+                gpu_max_shared_clients_per_gpu: 4,
+                cilium_socket_lb_host_namespace_only: false
+            }
+        },
+        region: {
+            type: 'string',
+            description: 'Cloudfleet control plane region. This field can not be updated after creation.',
+            example: 'europe-central-1a'
+        },
+        networking: {
+            type: 'object',
+            properties: {
+                pod_cidr: {
+                    type: 'string',
+                    description: 'CIDR block for pod IPs.',
+                    default: '10.244.0.0/16'
+                },
+                service_cidr: {
+                    type: 'string',
+                    description: 'CIDR block for service IPs.',
+                    default: '10.96.0.0/12'
+                },
+                dual_stack: {
+                    type: 'boolean',
+                    description: 'Enable IPv4+IPv6 dual-stack networking.'
+                },
+                pod_cidr_v6: {
+                    type: 'string',
+                    description: 'IPv6 pod CIDR. Requires dual_stack.',
+                    default: '2001:db8:1:2::/48'
+                },
+                service_cidr_v6: {
+                    type: 'string',
+                    description: 'IPv6 service CIDR. Requires dual_stack.',
+                    default: '2001:db8:1:1::/112'
+                }
+            },
+            additionalProperties: false,
+            description: 'Cluster networking configuration. Immutable after creation.',
+            default: {
+                pod_cidr: '10.244.0.0/16',
+                service_cidr: '10.96.0.0/12',
+                dual_stack: false,
+                pod_cidr_v6: '2001:db8:1:2::/48',
+                service_cidr_v6: '2001:db8:1:1::/112'
+            }
         }
     },
     required: [
         'name',
-        'tier',
         'region'
     ],
-    additionalProperties: false
+    additionalProperties: false,
+    description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
 };
 export const ClusterJoinInformationSchema = {
     type: 'object',
@@ -587,17 +673,122 @@ export const ClusterSchema = {
         tier: {
             type: 'string',
             description: 'Tier of the cluster.',
+            default: 'basic',
             example: 'pro',
             enum: [
                 'basic',
                 'pro'
             ]
         },
+        version_channel: {
+            type: 'string',
+            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-]+)*))?$',
+            description: 'Version of the kubernetes cluster.',
+            default: '1.x.x-cfke.x',
+            example: '1.x.x-cfke.x'
+        },
+        release_channel: {
+            type: 'string',
+            description: 'Release channel for the cluster\'s control plane.',
+            default: 'rapid',
+            example: 'rapid',
+            enum: [
+                'rapid',
+                'stable',
+                'extended'
+            ]
+        },
+        features: {
+            type: 'object',
+            properties: {
+                gpu_sharing_strategy: {
+                    type: 'string',
+                    description: 'GPU sharing strategy.',
+                    default: 'none',
+                    example: 'none',
+                    enum: [
+                        'none',
+                        'mps',
+                        'time_slicing'
+                    ]
+                },
+                gpu_max_shared_clients_per_gpu: {
+                    type: 'integer',
+                    minimum: 2,
+                    maximum: 48,
+                    description: 'Maximum number of pods that may share a single GPU.',
+                    default: 4,
+                    example: 10
+                },
+                cilium_socket_lb_host_namespace_only: {
+                    type: 'boolean',
+                    description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
+                    example: false
+                }
+            },
+            required: [
+                'gpu_sharing_strategy',
+                'gpu_max_shared_clients_per_gpu',
+                'cilium_socket_lb_host_namespace_only'
+            ],
+            additionalProperties: false,
+            description: 'Cluster feature toggles.',
+            default: {
+                gpu_sharing_strategy: 'none',
+                gpu_max_shared_clients_per_gpu: 4,
+                cilium_socket_lb_host_namespace_only: false
+            }
+        },
         region: {
             type: 'string',
             description: 'Cloudfleet control plane region. This field can not be updated after creation.',
             example: 'europe-central-1a'
         },
+        networking: {
+            type: 'object',
+            properties: {
+                pod_cidr: {
+                    type: 'string',
+                    description: 'CIDR block for pod IPs.',
+                    default: '10.244.0.0/16'
+                },
+                service_cidr: {
+                    type: 'string',
+                    description: 'CIDR block for service IPs.',
+                    default: '10.96.0.0/12'
+                },
+                dual_stack: {
+                    type: 'boolean',
+                    description: 'Enable IPv4+IPv6 dual-stack networking.'
+                },
+                pod_cidr_v6: {
+                    type: 'string',
+                    description: 'IPv6 pod CIDR. Requires dual_stack.',
+                    default: '2001:db8:1:2::/48'
+                },
+                service_cidr_v6: {
+                    type: 'string',
+                    description: 'IPv6 service CIDR. Requires dual_stack.',
+                    default: '2001:db8:1:1::/112'
+                }
+            },
+            required: [
+                'pod_cidr',
+                'service_cidr',
+                'dual_stack',
+                'pod_cidr_v6',
+                'service_cidr_v6'
+            ],
+            additionalProperties: false,
+            description: 'Cluster networking configuration. Immutable after creation.',
+            default: {
+                pod_cidr: '10.244.0.0/16',
+                service_cidr: '10.96.0.0/12',
+                dual_stack: false,
+                pod_cidr_v6: '2001:db8:1:2::/48',
+                service_cidr_v6: '2001:db8:1:1::/112'
+            }
+        },
         id: {
             type: 'string',
             format: 'uuid',
@@ -606,16 +797,13 @@ export const ClusterSchema = {
         },
         status: {
             type: 'string',
-            description: 'Status of the cluster. When creating a new cluster, set to `active`. When deleting a clusters, set to `deleted`.',
-            example: 'active',
+            description: 'Status of the cluster.',
+            example: 'deployed',
             enum: [
-                'active',
-                'disabled',
-                'deleted',
                 'creating',
                 'deployed',
-                'failed',
-                'updating'
+                'updating',
+                'disabled'
             ]
         },
         endpoint: {
@@ -623,8 +811,8 @@ export const ClusterSchema = {
                 {
                     type: 'string',
                     format: 'uri',
-                    description: 'URL signed by the private CA of the Kubernetes cluster control plane. This is the endpoint that kubectl uses to connect to the cluster. (Deprecated, use endpoint_public instead)',
-                    example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.cloudfleet.dev:6443'
+                    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.',
+                    example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
                 },
                 {
                     type: 'string',
@@ -639,7 +827,7 @@ export const ClusterSchema = {
                 {
                     type: 'string',
                     format: 'uri',
-                    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.',
+                    description: 'Deprecated alias of `endpoint`; retained for backward compatibility.',
                     example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
                 },
                 {
@@ -674,22 +862,22 @@ export const ClusterSchema = {
             type: 'boolean',
             description: 'Indicates if the cluster is ready to be used.',
             example: true
-        },
-        version_channel: {
-            type: 'string',
-            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-]+)*))?$',
-            description: 'Version of the kubernetes cluster.',
-            example: '1.x.x-cfke.x'
         }
     },
     required: [
         'name',
         'tier',
+        'version_channel',
+        'release_channel',
+        'features',
         'region',
+        'networking',
         'id',
-        'status'
+        'status',
+        'ready'
     ],
-    additionalProperties: false
+    additionalProperties: false,
+    description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
 };
 export const ClusterUpdateInputSchema = {
     type: 'object',
@@ -705,6 +893,7 @@ export const ClusterUpdateInputSchema = {
         tier: {
             type: 'string',
             description: 'Tier of the cluster.',
+            default: 'basic',
             example: 'pro',
             enum: [
                 'basic',
@@ -715,13 +904,62 @@ export const ClusterUpdateInputSchema = {
             type: 'string',
             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-]+)*))?$',
             description: 'Version of the kubernetes cluster.',
+            default: '1.x.x-cfke.x',
             example: '1.x.x-cfke.x'
+        },
+        release_channel: {
+            type: 'string',
+            description: 'Release channel for the cluster\'s control plane.',
+            default: 'rapid',
+            example: 'rapid',
+            enum: [
+                'rapid',
+                'stable',
+                'extended'
+            ]
+        },
+        features: {
+            type: 'object',
+            properties: {
+                gpu_sharing_strategy: {
+                    type: 'string',
+                    description: 'GPU sharing strategy.',
+                    default: 'none',
+                    example: 'none',
+                    enum: [
+                        'none',
+                        'mps',
+                        'time_slicing'
+                    ]
+                },
+                gpu_max_shared_clients_per_gpu: {
+                    type: 'integer',
+                    minimum: 2,
+                    maximum: 48,
+                    description: 'Maximum number of pods that may share a single GPU.',
+                    default: 4,
+                    example: 10
+                },
+                cilium_socket_lb_host_namespace_only: {
+                    type: 'boolean',
+                    description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
+                    example: false
+                }
+            },
+            additionalProperties: false,
+            description: 'Cluster feature toggles.',
+            default: {
+                gpu_sharing_strategy: 'none',
+                gpu_max_shared_clients_per_gpu: 4,
+                cilium_socket_lb_host_namespace_only: false
+            }
         }
     },
     required: [
-        'tier'
+        'name'
     ],
-    additionalProperties: false
+    additionalProperties: false,
+    description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
 };
 export const FleetCreateInputSchema = {
     type: 'object',
@@ -993,7 +1231,8 @@ export const FleetCreateInputSchema = {
                             'z3'
                         ]
                     },
-                    description: 'Allowed values for `cfke.io/instance-family`.'
+                    description: 'Allowed values for `cfke.io/instance-family`.',
+                    default: []
                 },
                 'topology.kubernetes.io/region': {
                     type: 'array',
@@ -1066,15 +1305,27 @@ export const FleetCreateInputSchema = {
                             'us-west4'
                         ]
                     },
-                    description: 'Allowed values for `topology.kubernetes.io/region`.'
+                    description: 'Allowed values for `topology.kubernetes.io/region`.',
+                    default: []
                 }
             },
             additionalProperties: false,
-            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. Omit a field to place no restriction on that key.'
+            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.',
+            default: {
+                'karpenter.sh/capacity-type': [
+                    'on-demand',
+                    'spot'
+                ],
+                'kubernetes.io/arch': [
+                    'amd64'
+                ],
+                'cfke.io/instance-family': [],
+                'topology.kubernetes.io/region': []
+            }
         },
         scalingProfile: {
             type: 'string',
-            description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
+            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`).',
             default: 'conservative',
             example: 'conservative',
             enum: [
@@ -1094,7 +1345,8 @@ export const FleetCreateInputSchema = {
     required: [
         'id'
     ],
-    additionalProperties: false
+    additionalProperties: false,
+    description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
 };
 export const FleetSchema = {
     type: 'object',
@@ -1364,7 +1616,8 @@ export const FleetSchema = {
                             'z3'
                         ]
                     },
-                    description: 'Allowed values for `cfke.io/instance-family`.'
+                    description: 'Allowed values for `cfke.io/instance-family`.',
+                    default: []
                 },
                 'topology.kubernetes.io/region': {
                     type: 'array',
@@ -1437,15 +1690,31 @@ export const FleetSchema = {
                             'us-west4'
                         ]
                     },
-                    description: 'Allowed values for `topology.kubernetes.io/region`.'
+                    description: 'Allowed values for `topology.kubernetes.io/region`.',
+                    default: []
                 }
             },
+            required: [
+                'karpenter.sh/capacity-type',
+                'kubernetes.io/arch'
+            ],
             additionalProperties: false,
-            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. Omit a field to place no restriction on that key.'
+            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.',
+            default: {
+                'karpenter.sh/capacity-type': [
+                    'on-demand',
+                    'spot'
+                ],
+                'kubernetes.io/arch': [
+                    'amd64'
+                ],
+                'cfke.io/instance-family': [],
+                'topology.kubernetes.io/region': []
+            }
         },
         scalingProfile: {
             type: 'string',
-            description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
+            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`).',
             default: 'conservative',
             example: 'conservative',
             enum: [
@@ -1460,13 +1729,38 @@ export const FleetSchema = {
             pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
             description: 'Unique identifier of the kubernetes fleet.',
             example: 'new-clouds-fleet'
+        },
+        ready: {
+            type: 'boolean',
+            description: 'Indicates whether the fleet configuration is healthy.',
+            example: true
+        },
+        status_message: {
+            type: 'string',
+            description: 'Human-readable reason the fleet is not ready. Present only when `ready` is false.',
+            example: 'Invalid provider permissions.'
+        },
+        created_at: {
+            type: 'string',
+            description: 'Creation date and time of the fleet.',
+            example: '2024-09-12T09:11:27Z'
+        },
+        updated_at: {
+            type: 'string',
+            description: 'Date and time the fleet was last updated.',
+            example: '2024-09-12T09:11:27Z'
         }
     },
     required: [
+        'constraints',
         'scalingProfile',
-        'id'
+        'id',
+        'ready',
+        'created_at',
+        'updated_at'
     ],
-    additionalProperties: false
+    additionalProperties: false,
+    description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
 };
 export const FleetUpdateInputSchema = {
     type: 'object',
@@ -1552,7 +1846,11 @@ export const FleetUpdateInputSchema = {
                         ]
                     },
                     minItems: 1,
-                    description: 'Allowed values for `karpenter.sh/capacity-type`.'
+                    description: 'Allowed values for `karpenter.sh/capacity-type`.',
+                    default: [
+                        'on-demand',
+                        'spot'
+                    ]
                 },
                 'kubernetes.io/arch': {
                     type: 'array',
@@ -1564,7 +1862,10 @@ export const FleetUpdateInputSchema = {
                         ]
                     },
                     minItems: 1,
-                    description: 'Allowed values for `kubernetes.io/arch`.'
+                    description: 'Allowed values for `kubernetes.io/arch`.',
+                    default: [
+                        'amd64'
+                    ]
                 },
                 'cfke.io/instance-family': {
                     type: 'array',
@@ -1731,7 +2032,8 @@ export const FleetUpdateInputSchema = {
                             'z3'
                         ]
                     },
-                    description: 'Allowed values for `cfke.io/instance-family`.'
+                    description: 'Allowed values for `cfke.io/instance-family`.',
+                    default: []
                 },
                 'topology.kubernetes.io/region': {
                     type: 'array',
@@ -1804,15 +2106,28 @@ export const FleetUpdateInputSchema = {
                             'us-west4'
                         ]
                     },
-                    description: 'Allowed values for `topology.kubernetes.io/region`.'
+                    description: 'Allowed values for `topology.kubernetes.io/region`.',
+                    default: []
                 }
             },
             additionalProperties: false,
-            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. Omit a field to place no restriction on that key.'
+            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.',
+            default: {
+                'karpenter.sh/capacity-type': [
+                    'on-demand',
+                    'spot'
+                ],
+                'kubernetes.io/arch': [
+                    'amd64'
+                ],
+                'cfke.io/instance-family': [],
+                'topology.kubernetes.io/region': []
+            }
         },
         scalingProfile: {
             type: 'string',
-            description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
+            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`).',
+            default: 'conservative',
             example: 'conservative',
             enum: [
                 'aggressive',
@@ -1820,10 +2135,8 @@ export const FleetUpdateInputSchema = {
             ]
         }
     },
-    required: [
-        'scalingProfile'
-    ],
-    additionalProperties: false
+    additionalProperties: false,
+    description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
 };
 export const InviteCreateInputSchema = {
     type: 'object',