latitudesh-typescript-sdk 0.3.7 → 0.3.8

package/dist/esm/sdk/kubernetesclusters.js

@@ -5,6 +5,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 } from "../lib/sdks.js";
@@ -30,6 +31,21 @@ export class KubernetesClusters extends ClientSDK {
     async createKubernetesCluster(request, options) {
         return unwrapAsync(kubernetesClustersCreateKubernetesCluster(this, request, options));
     }
+    /**
+     * 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:
+     * - `version`: 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) {
+        return unwrapAsync(kubernetesClustersListKubernetesAvailableVersions(this, options));
+    }
     /**
      * Get a Kubernetes Cluster
      *
@@ -49,10 +65,12 @@ export class KubernetesClusters extends ClientSDK {
         return unwrapAsync(kubernetesClustersDeleteKubernetesCluster(this, request, options));
     }
     /**
-     * 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.
      *
@@ -62,7 +80,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, options) {
         return unwrapAsync(kubernetesClustersUpdateKubernetesCluster(this, request, options));

package/dist/esm/sdk/kubernetesclusters.js.map

@@ -1 +1 @@
-{"version":3,"file":"kubernetesclusters.js","sourceRoot":"","sources":["../../../src/sdk/kubernetesclusters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,yCAAyC,EAAE,MAAM,uDAAuD,CAAC;AAClH,OAAO,EAAE,yCAAyC,EAAE,MAAM,uDAAuD,CAAC;AAClH,OAAO,EAAE,sCAAsC,EAAE,MAAM,oDAAoD,CAAC;AAC5G,OAAO,EAAE,gDAAgD,EAAE,MAAM,8DAA8D,CAAC;AAChI,OAAO,EAAE,wCAAwC,EAAE,MAAM,sDAAsD,CAAC;AAChH,OAAO,EAAE,yCAAyC,EAAE,MAAM,uDAAuD,CAAC;AAClH,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C;;;;;OAKG;IACH,KAAK,CAAC,sBAAsB,CAC1B,OAAiD,EACjD,OAAwB;QAExB,OAAO,WAAW,CAAC,wCAAwC,CACzD,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,uBAAuB,CAC3B,OAAuC,EACvC,OAAwB;QAExB,OAAO,WAAW,CAAC,yCAAyC,CAC1D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,oBAAoB,CACxB,OAA+C,EAC/C,OAAwB;QAExB,OAAO,WAAW,CAAC,sCAAsC,CACvD,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,uBAAuB,CAC3B,OAAkD,EAClD,OAAwB;QAExB,OAAO,WAAW,CAAC,yCAAyC,CAC1D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,uBAAuB,CAC3B,OAAkD,EAClD,OAAwB;QAExB,OAAO,WAAW,CAAC,yCAAyC,CAC1D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,8BAA8B,CAClC,OAAyD,EACzD,OAAwB;QAExB,OAAO,WAAW,CAAC,gDAAgD,CACjE,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"kubernetesclusters.js","sourceRoot":"","sources":["../../../src/sdk/kubernetesclusters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,yCAAyC,EAAE,MAAM,uDAAuD,CAAC;AAClH,OAAO,EAAE,yCAAyC,EAAE,MAAM,uDAAuD,CAAC;AAClH,OAAO,EAAE,sCAAsC,EAAE,MAAM,oDAAoD,CAAC;AAC5G,OAAO,EAAE,gDAAgD,EAAE,MAAM,8DAA8D,CAAC;AAChI,OAAO,EAAE,iDAAiD,EAAE,MAAM,+DAA+D,CAAC;AAClI,OAAO,EAAE,wCAAwC,EAAE,MAAM,sDAAsD,CAAC;AAChH,OAAO,EAAE,yCAAyC,EAAE,MAAM,uDAAuD,CAAC;AAClH,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C;;;;;OAKG;IACH,KAAK,CAAC,sBAAsB,CAC1B,OAAiD,EACjD,OAAwB;QAExB,OAAO,WAAW,CAAC,wCAAwC,CACzD,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,uBAAuB,CAC3B,OAAuC,EACvC,OAAwB;QAExB,OAAO,WAAW,CAAC,yCAAyC,CAC1D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,+BAA+B,CACnC,OAAwB;QAExB,OAAO,WAAW,CAAC,iDAAiD,CAClE,IAAI,EACJ,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,oBAAoB,CACxB,OAA+C,EAC/C,OAAwB;QAExB,OAAO,WAAW,CAAC,sCAAsC,CACvD,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,uBAAuB,CAC3B,OAAkD,EAClD,OAAwB;QAExB,OAAO,WAAW,CAAC,yCAAyC,CAC1D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,KAAK,CAAC,uBAAuB,CAC3B,OAAkD,EAClD,OAAwB;QAExB,OAAO,WAAW,CAAC,yCAAyC,CAC1D,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,8BAA8B,CAClC,OAAyD,EACzD,OAAwB;QAExB,OAAO,WAAW,CAAC,gDAAgD,CACjE,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF"}

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "latitudesh-typescript-sdk",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "latitudesh-typescript-sdk",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "author": "Speakeasy",
   "type": "module",
   "bin": {
@@ -31,8 +31,8 @@
     "build:mcp": "bun src/mcp-server/build.mts",
     "build": "npm run build:mcp && tshy",
     "prepublishOnly": "npm run build",
-    "test:coverage": "bun test --coverage tests/integration",
-    "test:integration": "bun test tests/integration"
+    "test:integration": "bun test tests/integration",
+    "test:coverage": "bun test --coverage tests/integration"
   },
   "peerDependencies": {},
   "devDependencies": {

package/src/funcs/kubernetesClustersListKubernetesAvailableVersions.ts

@@ -0,0 +1,161 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { LatitudeshCore } from "../core.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { LatitudeshError } from "../models/errors/latitudesherror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as models from "../models/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * 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:
+ * - `version`: 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).
+ */
+export function kubernetesClustersListKubernetesAvailableVersions(
+  client: LatitudeshCore,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.KubernetesAvailableVersions,
+    | errors.ErrorObject
+    | LatitudeshError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    options,
+  ));
+}
+
+async function $do(
+  client: LatitudeshCore,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.KubernetesAvailableVersions,
+      | errors.ErrorObject
+      | LatitudeshError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const path = pathToFunc("/kubernetes_clusters/available_versions")();
+
+  const headers = new Headers(compactMap({
+    Accept: "application/vnd.api+json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearer);
+  const securityInput = secConfig == null ? {} : { bearer: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "list-kubernetes-available-versions",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearer,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["401", "403", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    models.KubernetesAvailableVersions,
+    | errors.ErrorObject
+    | LatitudeshError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.KubernetesAvailableVersions$inboundSchema, {
+      ctype: "application/vnd.api+json",
+    }),
+    M.jsonErr([401, 403], errors.ErrorObject$inboundSchema, {
+      ctype: "application/vnd.api+json",
+    }),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/kubernetesClustersUpdateKubernetesCluster.ts

@@ -27,10 +27,12 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * 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.
  *
@@ -40,7 +42,16 @@ import { Result } from "../types/fp.js";
  *
  * 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).
  */
 export function kubernetesClustersUpdateKubernetesCluster(
   client: LatitudeshCore,

package/src/lib/config.ts

@@ -74,8 +74,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2023-06-01",
-  sdkVersion: "0.3.7",
+  sdkVersion: "0.3.8",
   genVersion: "2.879.6",
   userAgent:
-    "speakeasy-sdk/typescript 0.3.7 2.879.6 2023-06-01 latitudesh-typescript-sdk",
+    "speakeasy-sdk/typescript 0.3.8 2.879.6 2023-06-01 latitudesh-typescript-sdk",
 } as const;

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

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.3.7",
+    currentVersion: "0.3.8",
   },
 });
 

package/src/mcp-server/server.ts

@@ -40,6 +40,7 @@ import { tool$kubernetesClustersCreateKubernetesCluster } from "./tools/kubernet
 import { tool$kubernetesClustersDeleteKubernetesCluster } from "./tools/kubernetesClustersDeleteKubernetesCluster.js";
 import { tool$kubernetesClustersGetKubernetesCluster } from "./tools/kubernetesClustersGetKubernetesCluster.js";
 import { tool$kubernetesClustersGetKubernetesClusterKubeconfig } from "./tools/kubernetesClustersGetKubernetesClusterKubeconfig.js";
+import { tool$kubernetesClustersListKubernetesAvailableVersions } from "./tools/kubernetesClustersListKubernetesAvailableVersions.js";
 import { tool$kubernetesClustersListKubernetesClusters } from "./tools/kubernetesClustersListKubernetesClusters.js";
 import { tool$kubernetesClustersUpdateKubernetesCluster } from "./tools/kubernetesClustersUpdateKubernetesCluster.js";
 import { tool$operatingSystemsListPlans } from "./tools/operatingSystemsListPlans.js";
@@ -153,7 +154,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Latitudesh",
-    version: "0.3.7",
+    version: "0.3.8",
   });
 
   const client = new LatitudeshCore({
@@ -214,6 +215,7 @@ export function createMCPServer(deps: {
   tool(tool$operatingSystemsListPlans);
   tool(tool$kubernetesClustersListKubernetesClusters);
   tool(tool$kubernetesClustersCreateKubernetesCluster);
+  tool(tool$kubernetesClustersListKubernetesAvailableVersions);
   tool(tool$kubernetesClustersGetKubernetesCluster);
   tool(tool$kubernetesClustersDeleteKubernetesCluster);
   tool(tool$kubernetesClustersUpdateKubernetesCluster);

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

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { kubernetesClustersListKubernetesAvailableVersions } from "../../funcs/kubernetesClustersListKubernetesAvailableVersions.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+export const tool$kubernetesClustersListKubernetesAvailableVersions:
+  ToolDefinition = {
+    name: "kubernetes-clusters-list-kubernetes-available-versions",
+    description: `List Available Kubernetes Versions
+
+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:
+- \`version\`: 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).
+`,
+    tool: async (client, ctx) => {
+      const [result, apiCall] =
+        await kubernetesClustersListKubernetesAvailableVersions(
+          client,
+          { fetchOptions: { signal: ctx.signal } },
+        ).$inspect();
+
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true,
+        };
+      }
+
+      const value = result.value;
+
+      return formatResult(value, apiCall);
+    },
+  };

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 full Kubernetes version string (e.g., v1.35.3+rke2r1)
+   */
+  version?: 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({
+  version: z.string().optional(),
+  minor: z.string().optional(),
+});
+/** @internal */
+export type KubernetesAvailableVersionsData$Outbound = {
+  version?: string | undefined;
+  minor?: string | undefined;
+};
+
+/** @internal */
+export const KubernetesAvailableVersionsData$outboundSchema: z.ZodType<
+  KubernetesAvailableVersionsData$Outbound,
+  z.ZodTypeDef,
+  KubernetesAvailableVersionsData
+> = z.object({
+  version: 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",