@meetkai/mka1 0.48.33 → 0.48.34

package/src/react-query/servingVolumesList.ts

@@ -0,0 +1,148 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  InvalidateQueryFilters,
+  QueryClient,
+  useQuery,
+  UseQueryResult,
+  useSuspenseQuery,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { useSDKContext } from "./_context.js";
+import {
+  QueryHookOptions,
+  SuspenseQueryHookOptions,
+  TupleToPrefixes,
+} from "./_types.js";
+import {
+  buildServingVolumesListQuery,
+  prefetchServingVolumesList,
+  queryKeyServingVolumesList,
+  ServingVolumesListQueryData,
+} from "./servingVolumesList.core.js";
+export {
+  buildServingVolumesListQuery,
+  prefetchServingVolumesList,
+  queryKeyServingVolumesList,
+  type ServingVolumesListQueryData,
+};
+
+export type ServingVolumesListQueryError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * List volumes
+ *
+ * @remarks
+ * List your volumes.
+ */
+export function useServingVolumesList(
+  request: operations.ListVolumesRequest,
+  options?: QueryHookOptions<
+    ServingVolumesListQueryData,
+    ServingVolumesListQueryError
+  >,
+): UseQueryResult<ServingVolumesListQueryData, ServingVolumesListQueryError> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildServingVolumesListQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List volumes
+ *
+ * @remarks
+ * List your volumes.
+ */
+export function useServingVolumesListSuspense(
+  request: operations.ListVolumesRequest,
+  options?: SuspenseQueryHookOptions<
+    ServingVolumesListQueryData,
+    ServingVolumesListQueryError
+  >,
+): UseSuspenseQueryResult<
+  ServingVolumesListQueryData,
+  ServingVolumesListQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildServingVolumesListQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setServingVolumesListData(
+  client: QueryClient,
+  queryKeyBase: [
+    parameters: {
+      cursor?: string | null | undefined;
+      limit?: number | undefined;
+      xOnBehalfOf?: string | undefined;
+    },
+  ],
+  data: ServingVolumesListQueryData,
+): ServingVolumesListQueryData | undefined {
+  const key = queryKeyServingVolumesList(...queryKeyBase);
+
+  return client.setQueryData<ServingVolumesListQueryData>(key, data);
+}
+
+export function invalidateServingVolumesList(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [parameters: {
+      cursor?: string | null | undefined;
+      limit?: number | undefined;
+      xOnBehalfOf?: string | undefined;
+    }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "volumes", "list", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllServingVolumesList(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "volumes", "list"],
+  });
+}

package/src/sdk/accelerators.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingAcceleratorsList } from "../funcs/servingAcceleratorsList.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Accelerators extends ClientSDK {
+  /**
+   * List available accelerator types
+   *
+   * @remarks
+   * List the accelerator types available to your organization (GPU, NPU, TPU).
+   */
+  async list(
+    request: operations.ListAcceleratorsRequest,
+    options?: RequestOptions,
+  ): Promise<components.PageAcceleratorType> {
+    return unwrapAsync(servingAcceleratorsList(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/deployments.ts

@@ -0,0 +1,208 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingDeploymentsCreate } from "../funcs/servingDeploymentsCreate.js";
+import { servingDeploymentsDelete } from "../funcs/servingDeploymentsDelete.js";
+import { servingDeploymentsGet } from "../funcs/servingDeploymentsGet.js";
+import { servingDeploymentsGetLogs } from "../funcs/servingDeploymentsGetLogs.js";
+import { servingDeploymentsGetMetrics } from "../funcs/servingDeploymentsGetMetrics.js";
+import { servingDeploymentsList } from "../funcs/servingDeploymentsList.js";
+import { servingDeploymentsListReplicas } from "../funcs/servingDeploymentsListReplicas.js";
+import { servingDeploymentsListRevisions } from "../funcs/servingDeploymentsListRevisions.js";
+import { servingDeploymentsRollback } from "../funcs/servingDeploymentsRollback.js";
+import { servingDeploymentsUpdate } from "../funcs/servingDeploymentsUpdate.js";
+import { servingDeploymentsUpdateScaling } from "../funcs/servingDeploymentsUpdateScaling.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Deployments extends ClientSDK {
+  /**
+   * Create an inference deployment
+   *
+   * @remarks
+   * Create and start an inference deployment for a model, and return its endpoint.
+   */
+  async create(
+    request: operations.CreateDeploymentRequest,
+    options?: RequestOptions,
+  ): Promise<components.Deployment> {
+    return unwrapAsync(servingDeploymentsCreate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List deployments
+   *
+   * @remarks
+   * List your inference deployments.
+   */
+  async list(
+    request: operations.ListDeploymentsRequest,
+    options?: RequestOptions,
+  ): Promise<components.PageDeployment> {
+    return unwrapAsync(servingDeploymentsList(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get a deployment
+   *
+   * @remarks
+   * Retrieve a single deployment, including its status and endpoint URL.
+   */
+  async get(
+    request: operations.GetDeploymentRequest,
+    options?: RequestOptions,
+  ): Promise<components.Deployment> {
+    return unwrapAsync(servingDeploymentsGet(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Update a deployment (new revision)
+   *
+   * @remarks
+   * Update a deployment's configuration, rolling out a new revision.
+   */
+  async update(
+    request: operations.UpdateDeploymentRequest,
+    options?: RequestOptions,
+  ): Promise<components.Deployment> {
+    return unwrapAsync(servingDeploymentsUpdate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Tear down a deployment
+   *
+   * @remarks
+   * Tear down a deployment and release its resources.
+   */
+  async delete(
+    request: operations.DeleteDeploymentRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(servingDeploymentsDelete(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Update autoscaling live (no redeploy)
+   *
+   * @remarks
+   * Change a deployment's autoscaling limits in place, without redeploying.
+   */
+  async updateScaling(
+    request: operations.UpdateScalingRequest,
+    options?: RequestOptions,
+  ): Promise<components.Deployment> {
+    return unwrapAsync(servingDeploymentsUpdateScaling(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List config revisions
+   *
+   * @remarks
+   * List a deployment's configuration revisions, most recent first.
+   */
+  async listRevisions(
+    request: operations.ListRevisionsRequest,
+    options?: RequestOptions,
+  ): Promise<components.PageRevision> {
+    return unwrapAsync(servingDeploymentsListRevisions(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Roll back to a previous revision
+   *
+   * @remarks
+   * Roll a deployment back to a previous configuration revision.
+   */
+  async rollback(
+    request: operations.RollbackDeploymentRequest,
+    options?: RequestOptions,
+  ): Promise<components.Deployment> {
+    return unwrapAsync(servingDeploymentsRollback(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Fetch deployment logs
+   *
+   * @remarks
+   * Fetch recent log lines from a deployment's replicas.
+   */
+  async getLogs(
+    request: operations.GetDeploymentLogsRequest,
+    options?: RequestOptions,
+  ): Promise<Array<components.LogLine>> {
+    return unwrapAsync(servingDeploymentsGetLogs(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Live serving metrics
+   *
+   * @remarks
+   * Return live serving metrics (throughput, queue depth, accelerator usage).
+   */
+  async getMetrics(
+    request: operations.GetDeploymentMetricsRequest,
+    options?: RequestOptions,
+  ): Promise<components.Metrics> {
+    return unwrapAsync(servingDeploymentsGetMetrics(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List running replicas
+   *
+   * @remarks
+   * List the replicas currently backing a deployment.
+   */
+  async listReplicas(
+    request: operations.ListReplicasRequest,
+    options?: RequestOptions,
+  ): Promise<components.PageReplica> {
+    return unwrapAsync(servingDeploymentsListReplicas(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/finetunejobs.ts

@@ -0,0 +1,136 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingFinetuneJobsCancel } from "../funcs/servingFinetuneJobsCancel.js";
+import { servingFinetuneJobsCreate } from "../funcs/servingFinetuneJobsCreate.js";
+import { servingFinetuneJobsGet } from "../funcs/servingFinetuneJobsGet.js";
+import { servingFinetuneJobsGetEvents } from "../funcs/servingFinetuneJobsGetEvents.js";
+import { servingFinetuneJobsGetLogs } from "../funcs/servingFinetuneJobsGetLogs.js";
+import { servingFinetuneJobsList } from "../funcs/servingFinetuneJobsList.js";
+import { servingFinetuneJobsListCheckpoints } from "../funcs/servingFinetuneJobsListCheckpoints.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class FinetuneJobs extends ClientSDK {
+  /**
+   * Submit a fine-tune job
+   *
+   * @remarks
+   * Submit a fine-tune job for a base model and dataset, and return its id.
+   */
+  async create(
+    request: operations.CreateFinetuneJobRequest,
+    options?: RequestOptions,
+  ): Promise<components.FinetuneJob> {
+    return unwrapAsync(servingFinetuneJobsCreate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List fine-tune jobs
+   *
+   * @remarks
+   * List your fine-tune jobs.
+   */
+  async list(
+    request: operations.ListFinetuneJobsRequest,
+    options?: RequestOptions,
+  ): Promise<components.PageFinetuneJob> {
+    return unwrapAsync(servingFinetuneJobsList(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get a fine-tune job
+   *
+   * @remarks
+   * Retrieve a fine-tune job, including its status and progress.
+   */
+  async get(
+    request: operations.GetFinetuneJobRequest,
+    options?: RequestOptions,
+  ): Promise<components.FinetuneJob> {
+    return unwrapAsync(servingFinetuneJobsGet(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Cancel a fine-tune job
+   *
+   * @remarks
+   * Cancel a running fine-tune job.
+   */
+  async cancel(
+    request: operations.CancelFinetuneJobRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(servingFinetuneJobsCancel(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Fetch training logs
+   *
+   * @remarks
+   * Fetch recent training log lines for a job.
+   */
+  async getLogs(
+    request: operations.GetFinetuneLogsRequest,
+    options?: RequestOptions,
+  ): Promise<Array<components.LogLine>> {
+    return unwrapAsync(servingFinetuneJobsGetLogs(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Status timeline
+   *
+   * @remarks
+   * Return the job's status timeline (queued, running, checkpoints, completion).
+   */
+  async getEvents(
+    request: operations.GetFinetuneEventsRequest,
+    options?: RequestOptions,
+  ): Promise<Array<components.JobEvent>> {
+    return unwrapAsync(servingFinetuneJobsGetEvents(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List output checkpoints
+   *
+   * @remarks
+   * List the checkpoints a fine-tune job has produced.
+   */
+  async listCheckpoints(
+    request: operations.ListFinetuneCheckpointsRequest,
+    options?: RequestOptions,
+  ): Promise<Array<components.Checkpoint>> {
+    return unwrapAsync(servingFinetuneJobsListCheckpoints(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -15,6 +15,7 @@ import { Permissions } from "./permissions.js";
 import { Sandbox } from "./sandbox.js";
 import { SandboxUsage } from "./sandboxusage.js";
 import { Search } from "./search.js";
+import { Serving } from "./serving.js";
 import { Usage } from "./usage.js";
 
 export class SDK extends ClientSDK {
@@ -82,4 +83,9 @@ export class SDK extends ClientSDK {
   get usage(): Usage {
     return (this._usage ??= new Usage(this._options));
   }
+
+  private _serving?: Serving;
+  get serving(): Serving {
+    return (this._serving ??= new Serving(this._options));
+  }
 }

package/src/sdk/sdkimages.ts

@@ -0,0 +1,82 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingImagesBuild } from "../funcs/servingImagesBuild.js";
+import { servingImagesDelete } from "../funcs/servingImagesDelete.js";
+import { servingImagesGet } from "../funcs/servingImagesGet.js";
+import { servingImagesList } from "../funcs/servingImagesList.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class SDKImages extends ClientSDK {
+  /**
+   * Build a container image
+   *
+   * @remarks
+   * Build a custom container image from a recipe for use by deployments and jobs.
+   */
+  async build(
+    request: operations.BuildImageRequest,
+    options?: RequestOptions,
+  ): Promise<components.Image> {
+    return unwrapAsync(servingImagesBuild(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List images
+   *
+   * @remarks
+   * List your container images.
+   */
+  async list(
+    request: operations.ListImagesRequest,
+    options?: RequestOptions,
+  ): Promise<components.PageImage> {
+    return unwrapAsync(servingImagesList(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get an image
+   *
+   * @remarks
+   * Retrieve an image, including its build status.
+   */
+  async get(
+    request: operations.GetImageRequest,
+    options?: RequestOptions,
+  ): Promise<components.Image> {
+    return unwrapAsync(servingImagesGet(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete an image
+   *
+   * @remarks
+   * Delete a container image.
+   */
+  async delete(
+    request: operations.DeleteImageRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(servingImagesDelete(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/sdkmodels.ts

@@ -0,0 +1,82 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingModelsDelete } from "../funcs/servingModelsDelete.js";
+import { servingModelsGet } from "../funcs/servingModelsGet.js";
+import { servingModelsList } from "../funcs/servingModelsList.js";
+import { servingModelsRegister } from "../funcs/servingModelsRegister.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class SDKModels extends ClientSDK {
+  /**
+   * Register a model
+   *
+   * @remarks
+   * Register a model (from a source or volume) so it can be deployed or fine-tuned.
+   */
+  async register(
+    request: operations.RegisterModelRequest,
+    options?: RequestOptions,
+  ): Promise<components.Model> {
+    return unwrapAsync(servingModelsRegister(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List models
+   *
+   * @remarks
+   * List your registered models.
+   */
+  async list(
+    request: operations.ListServingModelsRequest,
+    options?: RequestOptions,
+  ): Promise<components.PageModel> {
+    return unwrapAsync(servingModelsList(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get a model
+   *
+   * @remarks
+   * Retrieve a registered model.
+   */
+  async get(
+    request: operations.GetServingModelRequest,
+    options?: RequestOptions,
+  ): Promise<components.Model> {
+    return unwrapAsync(servingModelsGet(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Deregister a model
+   *
+   * @remarks
+   * Deregister a model from the catalog.
+   */
+  async delete(
+    request: operations.DeleteModelRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(servingModelsDelete(
+      this,
+      request,
+      options,
+    ));
+  }
+}