latitudesh-typescript-sdk 0.3.7 → 0.3.9

package/src/mcp-server/tools/kubernetesClustersUpdateKubernetesCluster.ts

@@ -14,9 +14,11 @@ export const tool$kubernetesClustersUpdateKubernetesCluster: ToolDefinition<
   typeof args
 > = {
   name: "kubernetes-clusters-update-kubernetes-cluster",
-  description: `Scale Kubernetes Cluster
+  description: `Update Kubernetes Cluster
 
-Scales the worker nodes or control plane nodes of a Kubernetes cluster. The cluster must be in \`Provisioned\` phase to accept updates.
+Updates a Kubernetes cluster by scaling nodes or upgrading the Kubernetes version. The cluster must be in \`Provisioned\` phase to accept updates.
+
+## Scaling Operations
 
 Exactly one of \`worker_count\` or \`control_plane_count\` must be provided per request. You cannot scale workers and control plane nodes in the same request.
 
@@ -26,7 +28,16 @@ When scaling from 0 workers, you must provide a \`worker_plan\` since there is n
 
 Control plane scaling has a minimum of 1 node. You cannot scale control plane nodes to zero.
 
-Returns 202 Accepted when a scaling operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if the requested count matches the current count (no-op).
+## Version Upgrades
+
+Provide a \`kubernetes_version\` parameter to upgrade the cluster to a new Kubernetes version. Version upgrades follow these rules:
+
+- **No downgrades**: You cannot downgrade to a lower version than currently installed
+- **One minor version at a time**: You can only upgrade one minor version at a time (e.g., from 1.34 to 1.35, not from 1.34 to 1.36)
+- **Mutually exclusive**: Version upgrades cannot be combined with scaling operations in the same request
+- **Available versions only**: The target version must be in the list returned by \`GET /kubernetes_clusters/available_versions\`
+
+Returns 202 Accepted when an update operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if no change is needed (no-op).
 `,
   args,
   tool: async (client, args, ctx) => {

package/src/models/index.ts

@@ -31,6 +31,7 @@ export * from "./firewallserver.js";
 export * from "./ipaddress.js";
 export * from "./ipaddresses.js";
 export * from "./ipmisession.js";
+export * from "./kubernetesavailableversions.js";
 export * from "./kubernetescluster.js";
 export * from "./kubernetesclustercreateresponse.js";
 export * from "./kubernetesclusterdata.js";

package/src/models/kubernetesavailableversions.ts

@@ -0,0 +1,113 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+export type KubernetesAvailableVersionsData = {
+  /**
+   * The latest full Kubernetes version string for this minor version (e.g., v1.35.3+rke2r1)
+   */
+  latest?: string | undefined;
+  /**
+   * The minor version number (e.g., 1.35)
+   */
+  minor?: string | undefined;
+};
+
+/**
+ * Response schema for available Kubernetes versions
+ */
+export type KubernetesAvailableVersions = {
+  data?: Array<KubernetesAvailableVersionsData> | undefined;
+};
+
+/** @internal */
+export const KubernetesAvailableVersionsData$inboundSchema: z.ZodType<
+  KubernetesAvailableVersionsData,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  latest: z.string().optional(),
+  minor: z.string().optional(),
+});
+/** @internal */
+export type KubernetesAvailableVersionsData$Outbound = {
+  latest?: string | undefined;
+  minor?: string | undefined;
+};
+
+/** @internal */
+export const KubernetesAvailableVersionsData$outboundSchema: z.ZodType<
+  KubernetesAvailableVersionsData$Outbound,
+  z.ZodTypeDef,
+  KubernetesAvailableVersionsData
+> = z.object({
+  latest: z.string().optional(),
+  minor: z.string().optional(),
+});
+
+export function kubernetesAvailableVersionsDataToJSON(
+  kubernetesAvailableVersionsData: KubernetesAvailableVersionsData,
+): string {
+  return JSON.stringify(
+    KubernetesAvailableVersionsData$outboundSchema.parse(
+      kubernetesAvailableVersionsData,
+    ),
+  );
+}
+export function kubernetesAvailableVersionsDataFromJSON(
+  jsonString: string,
+): SafeParseResult<KubernetesAvailableVersionsData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => KubernetesAvailableVersionsData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'KubernetesAvailableVersionsData' from JSON`,
+  );
+}
+
+/** @internal */
+export const KubernetesAvailableVersions$inboundSchema: z.ZodType<
+  KubernetesAvailableVersions,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  data: z.array(z.lazy(() => KubernetesAvailableVersionsData$inboundSchema))
+    .optional(),
+});
+/** @internal */
+export type KubernetesAvailableVersions$Outbound = {
+  data?: Array<KubernetesAvailableVersionsData$Outbound> | undefined;
+};
+
+/** @internal */
+export const KubernetesAvailableVersions$outboundSchema: z.ZodType<
+  KubernetesAvailableVersions$Outbound,
+  z.ZodTypeDef,
+  KubernetesAvailableVersions
+> = z.object({
+  data: z.array(z.lazy(() => KubernetesAvailableVersionsData$outboundSchema))
+    .optional(),
+});
+
+export function kubernetesAvailableVersionsToJSON(
+  kubernetesAvailableVersions: KubernetesAvailableVersions,
+): string {
+  return JSON.stringify(
+    KubernetesAvailableVersions$outboundSchema.parse(
+      kubernetesAvailableVersions,
+    ),
+  );
+}
+export function kubernetesAvailableVersionsFromJSON(
+  jsonString: string,
+): SafeParseResult<KubernetesAvailableVersions, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => KubernetesAvailableVersions$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'KubernetesAvailableVersions' from JSON`,
+  );
+}

package/src/models/kubernetesclusterdata.ts

@@ -26,6 +26,20 @@ export type KubernetesClusterDataPhase = ClosedEnum<
   typeof KubernetesClusterDataPhase
 >;
 
+/**
+ * The cluster's version status relative to available upgrades
+ */
+export const VersionStatus = {
+  UpToDate: "up_to_date",
+  UpgradeAvailable: "upgrade_available",
+  Unsupported: "unsupported",
+  Unknown: "unknown",
+} as const;
+/**
+ * The cluster's version status relative to available upgrades
+ */
+export type VersionStatus = ClosedEnum<typeof VersionStatus>;
+
 /**
  * Control plane status information
  */
@@ -230,6 +244,14 @@ export type KubernetesClusterDataAttributes = {
    * The Kubernetes version running on the cluster
    */
   kubernetesVersion?: string | undefined;
+  /**
+   * The cluster's version status relative to available upgrades
+   */
+  versionStatus?: VersionStatus | undefined;
+  /**
+   * The next available Kubernetes version for upgrade. Null if the cluster is already on the latest version, or if version status is unknown or unsupported.
+   */
+  availableUpgrade?: string | null | undefined;
   /**
    * When the cluster was created
    */
@@ -322,6 +344,15 @@ export const KubernetesClusterDataPhase$outboundSchema: z.ZodNativeEnum<
   typeof KubernetesClusterDataPhase
 > = KubernetesClusterDataPhase$inboundSchema;
 
+/** @internal */
+export const VersionStatus$inboundSchema: z.ZodNativeEnum<
+  typeof VersionStatus
+> = z.nativeEnum(VersionStatus);
+/** @internal */
+export const VersionStatus$outboundSchema: z.ZodNativeEnum<
+  typeof VersionStatus
+> = VersionStatus$inboundSchema;
+
 /** @internal */
 export const ControlPlane$inboundSchema: z.ZodType<
   ControlPlane,
@@ -637,6 +668,8 @@ export const KubernetesClusterDataAttributes$inboundSchema: z.ZodType<
   location: z.string().optional(),
   load_balancer_ips: z.array(z.string()).optional(),
   kubernetes_version: z.string().optional(),
+  version_status: VersionStatus$inboundSchema.optional(),
+  available_upgrade: z.nullable(z.string()).optional(),
   created_at: z.string().datetime({ offset: true }).transform(v => new Date(v))
     .optional(),
   plan: z.string().optional(),
@@ -666,6 +699,8 @@ export const KubernetesClusterDataAttributes$inboundSchema: z.ZodType<
     "kubeconfig_url": "kubeconfigUrl",
     "load_balancer_ips": "loadBalancerIps",
     "kubernetes_version": "kubernetesVersion",
+    "version_status": "versionStatus",
+    "available_upgrade": "availableUpgrade",
     "created_at": "createdAt",
     "worker_plan": "workerPlan",
     "control_plane_count": "controlPlaneCount",
@@ -690,6 +725,8 @@ export type KubernetesClusterDataAttributes$Outbound = {
   location?: string | undefined;
   load_balancer_ips?: Array<string> | undefined;
   kubernetes_version?: string | undefined;
+  version_status?: string | undefined;
+  available_upgrade?: string | null | undefined;
   created_at?: string | undefined;
   plan?: string | undefined;
   worker_plan?: string | null | undefined;
@@ -724,6 +761,8 @@ export const KubernetesClusterDataAttributes$outboundSchema: z.ZodType<
   location: z.string().optional(),
   loadBalancerIps: z.array(z.string()).optional(),
   kubernetesVersion: z.string().optional(),
+  versionStatus: VersionStatus$outboundSchema.optional(),
+  availableUpgrade: z.nullable(z.string()).optional(),
   createdAt: z.date().transform(v => v.toISOString()).optional(),
   plan: z.string().optional(),
   workerPlan: z.nullable(z.string()).optional(),
@@ -751,6 +790,8 @@ export const KubernetesClusterDataAttributes$outboundSchema: z.ZodType<
     kubeconfigUrl: "kubeconfig_url",
     loadBalancerIps: "load_balancer_ips",
     kubernetesVersion: "kubernetes_version",
+    versionStatus: "version_status",
+    availableUpgrade: "available_upgrade",
     createdAt: "created_at",
     workerPlan: "worker_plan",
     controlPlaneCount: "control_plane_count",

package/src/models/kubernetesclusterupdateresponse.ts

@@ -17,14 +17,15 @@ export type KubernetesClusterUpdateResponseType = ClosedEnum<
 >;
 
 /**
- * The update status. 'scaling' indicates nodes are being added or removed. 'unchanged' indicates the requested count matches the current count.
+ * The update status. 'scaling' indicates nodes are being added or removed. 'upgrading' indicates a version upgrade is in progress. 'unchanged' indicates no change was needed.
  */
 export const KubernetesClusterUpdateResponseStatus = {
   Scaling: "scaling",
+  Upgrading: "upgrading",
   Unchanged: "unchanged",
 } as const;
 /**
- * The update status. 'scaling' indicates nodes are being added or removed. 'unchanged' indicates the requested count matches the current count.
+ * The update status. 'scaling' indicates nodes are being added or removed. 'upgrading' indicates a version upgrade is in progress. 'unchanged' indicates no change was needed.
  */
 export type KubernetesClusterUpdateResponseStatus = ClosedEnum<
   typeof KubernetesClusterUpdateResponseStatus
@@ -36,7 +37,7 @@ export type KubernetesClusterUpdateResponseAttributes = {
    */
   name?: string | undefined;
   /**
-   * The update status. 'scaling' indicates nodes are being added or removed. 'unchanged' indicates the requested count matches the current count.
+   * The update status. 'scaling' indicates nodes are being added or removed. 'upgrading' indicates a version upgrade is in progress. 'unchanged' indicates no change was needed.
    */
   status?: KubernetesClusterUpdateResponseStatus | undefined;
   /**
@@ -47,6 +48,10 @@ export type KubernetesClusterUpdateResponseAttributes = {
    * The requested number of control plane nodes. Present when scaling control plane.
    */
   controlPlaneCount?: number | null | undefined;
+  /**
+   * The target Kubernetes version. Present when upgrading version.
+   */
+  kubernetesVersion?: string | null | undefined;
 };
 
 export type KubernetesClusterUpdateResponseData = {
@@ -91,10 +96,12 @@ export const KubernetesClusterUpdateResponseAttributes$inboundSchema: z.ZodType<
   status: KubernetesClusterUpdateResponseStatus$inboundSchema.optional(),
   worker_count: z.nullable(z.number().int()).optional(),
   control_plane_count: z.nullable(z.number().int()).optional(),
+  kubernetes_version: z.nullable(z.string()).optional(),
 }).transform((v) => {
   return remap$(v, {
     "worker_count": "workerCount",
     "control_plane_count": "controlPlaneCount",
+    "kubernetes_version": "kubernetesVersion",
   });
 });
 /** @internal */
@@ -103,6 +110,7 @@ export type KubernetesClusterUpdateResponseAttributes$Outbound = {
   status?: string | undefined;
   worker_count?: number | null | undefined;
   control_plane_count?: number | null | undefined;
+  kubernetes_version?: string | null | undefined;
 };
 
 /** @internal */
@@ -116,10 +124,12 @@ export const KubernetesClusterUpdateResponseAttributes$outboundSchema:
     status: KubernetesClusterUpdateResponseStatus$outboundSchema.optional(),
     workerCount: z.nullable(z.number().int()).optional(),
     controlPlaneCount: z.nullable(z.number().int()).optional(),
+    kubernetesVersion: z.nullable(z.string()).optional(),
   }).transform((v) => {
     return remap$(v, {
       workerCount: "worker_count",
       controlPlaneCount: "control_plane_count",
+      kubernetesVersion: "kubernetes_version",
     });
   });
 

package/src/models/updatekubernetescluster.ts

@@ -17,27 +17,31 @@ export type UpdateKubernetesClusterType = ClosedEnum<
 >;
 
 /**
- * Exactly one of worker_count or control_plane_count must be provided. These parameters are mutually exclusive.
+ * Provide one of: worker_count, control_plane_count (for scaling), or kubernetes_version (for upgrades). These are mutually exclusive operations.
  */
 export type UpdateKubernetesClusterAttributes = {
   /**
-   * Desired number of worker nodes. Must be between 0 and 10. Mutually exclusive with control_plane_count.
+   * Desired number of worker nodes. Must be between 0 and 10. Mutually exclusive with control_plane_count and kubernetes_version.
    */
   workerCount?: number | undefined;
   /**
-   * Desired number of control plane nodes. Minimum 1. Mutually exclusive with worker_count.
+   * Desired number of control plane nodes. Minimum 1. Mutually exclusive with worker_count and kubernetes_version.
    */
   controlPlaneCount?: number | undefined;
   /**
    * Plan slug for worker nodes. Required when scaling from 0 workers. Ignored when scaling an existing deployment.
    */
   workerPlan?: string | null | undefined;
+  /**
+   * Target Kubernetes version for upgrade (e.g., v1.35.0+rke2r1). Mutually exclusive with scaling operations. Must be one minor version higher than current.
+   */
+  kubernetesVersion?: string | undefined;
 };
 
 export type UpdateKubernetesClusterData = {
   type: UpdateKubernetesClusterType;
   /**
-   * Exactly one of worker_count or control_plane_count must be provided. These parameters are mutually exclusive.
+   * Provide one of: worker_count, control_plane_count (for scaling), or kubernetes_version (for upgrades). These are mutually exclusive operations.
    */
   attributes: UpdateKubernetesClusterAttributes;
 };
@@ -64,11 +68,13 @@ export const UpdateKubernetesClusterAttributes$inboundSchema: z.ZodType<
   worker_count: z.number().int().optional(),
   control_plane_count: z.number().int().optional(),
   worker_plan: z.nullable(z.string()).optional(),
+  kubernetes_version: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     "worker_count": "workerCount",
     "control_plane_count": "controlPlaneCount",
     "worker_plan": "workerPlan",
+    "kubernetes_version": "kubernetesVersion",
   });
 });
 /** @internal */
@@ -76,6 +82,7 @@ export type UpdateKubernetesClusterAttributes$Outbound = {
   worker_count?: number | undefined;
   control_plane_count?: number | undefined;
   worker_plan?: string | null | undefined;
+  kubernetes_version?: string | undefined;
 };
 
 /** @internal */
@@ -87,11 +94,13 @@ export const UpdateKubernetesClusterAttributes$outboundSchema: z.ZodType<
   workerCount: z.number().int().optional(),
   controlPlaneCount: z.number().int().optional(),
   workerPlan: z.nullable(z.string()).optional(),
+  kubernetesVersion: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     workerCount: "worker_count",
     controlPlaneCount: "control_plane_count",
     workerPlan: "worker_plan",
+    kubernetesVersion: "kubernetes_version",
   });
 });
 

package/src/sdk/kubernetesclusters.ts

@@ -6,6 +6,7 @@ import { kubernetesClustersCreateKubernetesCluster } from "../funcs/kubernetesCl
 import { kubernetesClustersDeleteKubernetesCluster } from "../funcs/kubernetesClustersDeleteKubernetesCluster.js";
 import { kubernetesClustersGetKubernetesCluster } from "../funcs/kubernetesClustersGetKubernetesCluster.js";
 import { kubernetesClustersGetKubernetesClusterKubeconfig } from "../funcs/kubernetesClustersGetKubernetesClusterKubeconfig.js";
+import { kubernetesClustersListKubernetesAvailableVersions } from "../funcs/kubernetesClustersListKubernetesAvailableVersions.js";
 import { kubernetesClustersListKubernetesClusters } from "../funcs/kubernetesClustersListKubernetesClusters.js";
 import { kubernetesClustersUpdateKubernetesCluster } from "../funcs/kubernetesClustersUpdateKubernetesCluster.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
@@ -50,6 +51,27 @@ export class KubernetesClusters extends ClientSDK {
     ));
   }
 
+  /**
+   * List Available Kubernetes Versions
+   *
+   * @remarks
+   * Returns the list of available Kubernetes versions for cluster creation and upgrades. Versions are sourced from the RKE2 release channels and cached for 24 hours.
+   *
+   * Each version object includes:
+   * - `latest`: The full version string (e.g., `v1.35.3+rke2r1`)
+   * - `minor`: The minor version number (e.g., `1.35`)
+   *
+   * The API returns the latest 5 supported minor versions. When upgrading clusters, you can only upgrade one minor version at a time (e.g., from 1.34 to 1.35).
+   */
+  async listKubernetesAvailableVersions(
+    options?: RequestOptions,
+  ): Promise<models.KubernetesAvailableVersions> {
+    return unwrapAsync(kubernetesClustersListKubernetesAvailableVersions(
+      this,
+      options,
+    ));
+  }
+
   /**
    * Get a Kubernetes Cluster
    *
@@ -85,10 +107,12 @@ export class KubernetesClusters extends ClientSDK {
   }
 
   /**
-   * Scale Kubernetes Cluster
+   * Update Kubernetes Cluster
    *
    * @remarks
-   * Scales the worker nodes or control plane nodes of a Kubernetes cluster. The cluster must be in `Provisioned` phase to accept updates.
+   * Updates a Kubernetes cluster by scaling nodes or upgrading the Kubernetes version. The cluster must be in `Provisioned` phase to accept updates.
+   *
+   * ## Scaling Operations
    *
    * Exactly one of `worker_count` or `control_plane_count` must be provided per request. You cannot scale workers and control plane nodes in the same request.
    *
@@ -98,7 +122,16 @@ export class KubernetesClusters extends ClientSDK {
    *
    * Control plane scaling has a minimum of 1 node. You cannot scale control plane nodes to zero.
    *
-   * Returns 202 Accepted when a scaling operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if the requested count matches the current count (no-op).
+   * ## Version Upgrades
+   *
+   * Provide a `kubernetes_version` parameter to upgrade the cluster to a new Kubernetes version. Version upgrades follow these rules:
+   *
+   * - **No downgrades**: You cannot downgrade to a lower version than currently installed
+   * - **One minor version at a time**: You can only upgrade one minor version at a time (e.g., from 1.34 to 1.35, not from 1.34 to 1.36)
+   * - **Mutually exclusive**: Version upgrades cannot be combined with scaling operations in the same request
+   * - **Available versions only**: The target version must be in the list returned by `GET /kubernetes_clusters/available_versions`
+   *
+   * Returns 202 Accepted when an update operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if no change is needed (no-op).
    */
   async updateKubernetesCluster(
     request: operations.UpdateKubernetesClusterRequest,