latitudesh-typescript-sdk 0.4.1 → 0.5.0

package/src/funcs/virtualMachinesShowVirtualMachineMetrics.ts

@@ -0,0 +1,181 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { LatitudeshCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.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 { 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 * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Retrieve VM metrics
+ *
+ * @remarks
+ * Retrieve a time series for a single metric of a Virtual Machine.
+ */
+export function virtualMachinesShowVirtualMachineMetrics(
+  client: LatitudeshCore,
+  request: operations.ShowVirtualMachineMetricsRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.VirtualMachineMetrics,
+    | LatitudeshError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: LatitudeshCore,
+  request: operations.ShowVirtualMachineMetricsRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.VirtualMachineMetrics,
+      | LatitudeshError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.ShowVirtualMachineMetricsRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    virtual_machine_id: encodeSimple(
+      "virtual_machine_id",
+      payload.virtual_machine_id,
+      { explode: false, charEncoding: "percent" },
+    ),
+  };
+  const path = pathToFunc("/virtual_machines/{virtual_machine_id}/metrics")(
+    pathParams,
+  );
+
+  const query = encodeFormQuery({
+    "force_refresh": payload.force_refresh,
+    "metric": payload.metric,
+    "range": payload.range,
+  });
+
+  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: "show-virtual-machine-metrics",
+    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,
+    query: query,
+    body: body,
+    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,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    models.VirtualMachineMetrics,
+    | LatitudeshError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.VirtualMachineMetrics$inboundSchema, {
+      ctype: "application/vnd.api+json",
+    }),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/hooks/types.ts

@@ -15,6 +15,7 @@ export type HookContext = {
   retryConfig: RetryConfig;
   resolvedSecurity: SecurityState | null;
   options: SDKOptions;
+  timeoutMs?: number;
 };
 
 export type Awaitable<T> = T | Promise<T>;

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.4.1",
-  genVersion: "2.887.0",
+  sdkVersion: "0.5.0",
+  genVersion: "2.897.1",
   userAgent:
-    "speakeasy-sdk/typescript 0.4.1 2.887.0 2023-06-01 latitudesh-typescript-sdk",
+    "speakeasy-sdk/typescript 0.5.0 2.897.1 2023-06-01 latitudesh-typescript-sdk",
 } as const;

package/src/lib/sdks.ts

@@ -24,6 +24,7 @@ import {
   matchContentType,
 } from "./http.js";
 import { Logger } from "./logger.js";
+import { combineSignals } from "./primitives.js";
 import { retry, RetryConfig } from "./retries.js";
 import { SecurityState } from "./security.js";
 
@@ -197,9 +198,8 @@ export class ClientSDK {
       ...options?.fetchOptions,
       ...options,
     };
-    if (!fetchOptions?.signal && conf.timeoutMs && conf.timeoutMs > 0) {
-      const timeoutSignal = AbortSignal.timeout(conf.timeoutMs);
-      fetchOptions.signal = timeoutSignal;
+    if (!fetchOptions?.signal && conf.timeoutMs != null && conf.timeoutMs > 0) {
+      context.timeoutMs = conf.timeoutMs;
     }
 
     if (conf.body instanceof ReadableStream) {
@@ -246,10 +246,19 @@ export class ClientSDK {
     >
   > {
     const { context, isErrorStatusCode } = options;
+    const timeoutMs = context.timeoutMs;
 
     return retry(
       async () => {
-        const req = await this.#hooks.beforeRequest(context, request.clone());
+        const cloned = request.clone();
+        let attempt = cloned;
+        if (timeoutMs != null && timeoutMs > 0) {
+          const timeoutSignal = AbortSignal.timeout(timeoutMs);
+          const combined = combineSignals(cloned.signal, timeoutSignal)
+            ?? timeoutSignal;
+          attempt = new Request(cloned, { signal: combined });
+        }
+        const req = await this.#hooks.beforeRequest(context, attempt);
         await logRequest(this.#logger, req).catch((e) =>
           this.#logger?.log("Failed to log request:", e)
         );

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

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

package/src/mcp-server/server.ts

@@ -133,9 +133,13 @@ import { tool$userProfileListTeams } from "./tools/userProfileListTeams.js";
 import { tool$userProfileUpdate } from "./tools/userProfileUpdate.js";
 import { tool$virtualMachinesCreate } from "./tools/virtualMachinesCreate.js";
 import { tool$virtualMachinesCreateVirtualMachineAction } from "./tools/virtualMachinesCreateVirtualMachineAction.js";
+import { tool$virtualMachinesCreateVirtualMachineNetworkAttachment } from "./tools/virtualMachinesCreateVirtualMachineNetworkAttachment.js";
 import { tool$virtualMachinesDelete } from "./tools/virtualMachinesDelete.js";
+import { tool$virtualMachinesDestroyVirtualMachineNetworkAttachment } from "./tools/virtualMachinesDestroyVirtualMachineNetworkAttachment.js";
 import { tool$virtualMachinesGet } from "./tools/virtualMachinesGet.js";
 import { tool$virtualMachinesList } from "./tools/virtualMachinesList.js";
+import { tool$virtualMachinesListVirtualMachineNetworkAttachments } from "./tools/virtualMachinesListVirtualMachineNetworkAttachments.js";
+import { tool$virtualMachinesShowVirtualMachineMetrics } from "./tools/virtualMachinesShowVirtualMachineMetrics.js";
 import { tool$virtualMachinesUpdateVirtualMachine } from "./tools/virtualMachinesUpdateVirtualMachine.js";
 import { tool$virtualNetworksDelete } from "./tools/virtualNetworksDelete.js";
 import { tool$vpnSessionsCreate } from "./tools/vpnSessionsCreate.js";
@@ -154,7 +158,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Latitudesh",
-    version: "0.4.1",
+    version: "0.5.0",
   });
 
   const client = new LatitudeshCore({
@@ -298,6 +302,10 @@ export function createMCPServer(deps: {
   tool(tool$virtualMachinesDelete);
   tool(tool$virtualMachinesUpdateVirtualMachine);
   tool(tool$virtualMachinesCreateVirtualMachineAction);
+  tool(tool$virtualMachinesShowVirtualMachineMetrics);
+  tool(tool$virtualMachinesListVirtualMachineNetworkAttachments);
+  tool(tool$virtualMachinesCreateVirtualMachineNetworkAttachment);
+  tool(tool$virtualMachinesDestroyVirtualMachineNetworkAttachment);
   tool(tool$privateNetworksList);
   tool(tool$privateNetworksCreate);
   tool(tool$privateNetworksUpdate);

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

@@ -16,7 +16,7 @@ export const tool$blockStorageDeleteStorageVolumes: ToolDefinition<
   name: "block-storage-delete-storage-volumes",
   description: `Delete volume
 
-Allows you to remove persistent storage from a project.`,
+Allows you to remove a volume from a project.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await blockStorageDeleteStorageVolumes(

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

@@ -14,7 +14,7 @@ export const tool$blockStorageGetStorageVolume: ToolDefinition<typeof args> = {
   name: "block-storage-get-storage-volume",
   description: `Retrieve volume
 
-Shows details of a specific volume storage.`,
+Shows details of a specific volume.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await blockStorageGetStorageVolume(

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

@@ -16,7 +16,7 @@ export const tool$blockStoragePostStorageVolumesMount: ToolDefinition<
   name: "block-storage-post-storage-volumes-mount",
   description: `Mount volume
 
-Mounts volume storage by adding the client to an allowed list`,
+Mounts a volume by adding the client to an allowed list`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await blockStoragePostStorageVolumesMount(

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

@@ -16,7 +16,7 @@ export const tool$filesystemStorageDeleteFilesystem: ToolDefinition<
   name: "filesystem-storage-delete-filesystem",
   description: `Delete filesystem
 
-Allows you to remove persistent storage from a project.`,
+Allows you to remove a filesystem from a project.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await filesystemStorageDeleteFilesystem(

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

@@ -14,7 +14,7 @@ export const tool$objectStorageDeleteStorageBuckets: ToolDefinition<
   typeof args
 > = {
   name: "object-storage-delete-storage-buckets",
-  description: `Delete object storage
+  description: `Delete bucket
 
 Allows you to remove an object storage from a project.`,
   args,

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

@@ -12,7 +12,7 @@ const args = {
 
 export const tool$objectStorageGetStorageBucket: ToolDefinition<typeof args> = {
   name: "object-storage-get-storage-bucket",
-  description: `Retrieve object storage
+  description: `Retrieve bucket
 
 Shows details of a specific object storage.`,
   args,

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

@@ -13,7 +13,7 @@ const args = {
 export const tool$objectStorageGetStorageBuckets: ToolDefinition<typeof args> =
   {
     name: "object-storage-get-storage-buckets",
-    description: `List object storages
+    description: `List buckets
 
 Lists all object storages from a team.`,
     args,

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

@@ -13,7 +13,7 @@ const args = {
 export const tool$objectStoragePostStorageBuckets: ToolDefinition<typeof args> =
   {
     name: "object-storage-post-storage-buckets",
-    description: `Create object storage
+    description: `Create bucket
 
 Creates a new object storage bucket for a project.`,
     args,

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

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { virtualMachinesCreateVirtualMachineNetworkAttachment } from "../../funcs/virtualMachinesCreateVirtualMachineNetworkAttachment.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request:
+    operations.CreateVirtualMachineNetworkAttachmentRequest$inboundSchema,
+};
+
+export const tool$virtualMachinesCreateVirtualMachineNetworkAttachment:
+  ToolDefinition<typeof args> = {
+    name: "virtual-machines-create-virtual-machine-network-attachment",
+    description: `Attach a network to a VM
+
+Attaches a virtual network (VLAN) to a Virtual Machine. Work runs asynchronously and returns 202 Accepted.
+`,
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] =
+        await virtualMachinesCreateVirtualMachineNetworkAttachment(
+          client,
+          args.request,
+          { 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/virtualMachinesDestroyVirtualMachineNetworkAttachment.ts

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { virtualMachinesDestroyVirtualMachineNetworkAttachment } from "../../funcs/virtualMachinesDestroyVirtualMachineNetworkAttachment.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request:
+    operations.DestroyVirtualMachineNetworkAttachmentRequest$inboundSchema,
+};
+
+export const tool$virtualMachinesDestroyVirtualMachineNetworkAttachment:
+  ToolDefinition<typeof args> = {
+    name: "virtual-machines-destroy-virtual-machine-network-attachment",
+    description: `Detach a network from a VM
+
+Detaches a virtual network (VLAN) from a Virtual Machine. Work runs asynchronously and returns 202 Accepted.
+`,
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] =
+        await virtualMachinesDestroyVirtualMachineNetworkAttachment(
+          client,
+          args.request,
+          { 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/virtualMachinesListVirtualMachineNetworkAttachments.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { virtualMachinesListVirtualMachineNetworkAttachments } from "../../funcs/virtualMachinesListVirtualMachineNetworkAttachments.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListVirtualMachineNetworkAttachmentsRequest$inboundSchema,
+};
+
+export const tool$virtualMachinesListVirtualMachineNetworkAttachments:
+  ToolDefinition<typeof args> = {
+    name: "virtual-machines-list-virtual-machine-network-attachments",
+    description: `List VM network attachments
+
+Lists the secondary network attachments currently configured for a Virtual Machine.
+`,
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] =
+        await virtualMachinesListVirtualMachineNetworkAttachments(
+          client,
+          args.request,
+          { 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/virtualMachinesShowVirtualMachineMetrics.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { virtualMachinesShowVirtualMachineMetrics } from "../../funcs/virtualMachinesShowVirtualMachineMetrics.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ShowVirtualMachineMetricsRequest$inboundSchema,
+};
+
+export const tool$virtualMachinesShowVirtualMachineMetrics: ToolDefinition<
+  typeof args
+> = {
+  name: "virtual-machines-show-virtual-machine-metrics",
+  description: `Retrieve VM metrics
+
+Retrieve a time series for a single metric of a Virtual Machine.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await virtualMachinesShowVirtualMachineMetrics(
+      client,
+      args.request,
+      { 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);
+  },
+};