@meetkai/mka1 0.51.16 → 0.51.17

package/src/models/components/affinityrating.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+/**
+ * How well an accelerator suits a workload class. Catalog data, not a scheduling guarantee.
+ */
+export const AffinityRating = {
+  Optimal: "optimal",
+  Capable: "capable",
+  Unsuited: "unsuited",
+} as const;
+/**
+ * How well an accelerator suits a workload class. Catalog data, not a scheduling guarantee.
+ */
+export type AffinityRating = ClosedEnum<typeof AffinityRating>;
+
+/** @internal */
+export const AffinityRating$inboundSchema: z.ZodNativeEnum<
+  typeof AffinityRating
+> = z.nativeEnum(AffinityRating);
+/** @internal */
+export const AffinityRating$outboundSchema: z.ZodNativeEnum<
+  typeof AffinityRating
+> = AffinityRating$inboundSchema;

package/src/models/components/availabilitypriceband.ts

@@ -0,0 +1,62 @@
+/*
+ * 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";
+
+/**
+ * USD-per-hour price band observed within a bucket: exact min/max and the observation-weighted average, merged across anonymous providers. Percentiles are deliberately not served: they are not mergeable across providers from rollups.
+ */
+export type AvailabilityPriceBand = {
+  avg: number;
+  max: number;
+  min: number;
+};
+
+/** @internal */
+export const AvailabilityPriceBand$inboundSchema: z.ZodType<
+  AvailabilityPriceBand,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  avg: z.number(),
+  max: z.number(),
+  min: z.number(),
+});
+/** @internal */
+export type AvailabilityPriceBand$Outbound = {
+  avg: number;
+  max: number;
+  min: number;
+};
+
+/** @internal */
+export const AvailabilityPriceBand$outboundSchema: z.ZodType<
+  AvailabilityPriceBand$Outbound,
+  z.ZodTypeDef,
+  AvailabilityPriceBand
+> = z.object({
+  avg: z.number(),
+  max: z.number(),
+  min: z.number(),
+});
+
+export function availabilityPriceBandToJSON(
+  availabilityPriceBand: AvailabilityPriceBand,
+): string {
+  return JSON.stringify(
+    AvailabilityPriceBand$outboundSchema.parse(availabilityPriceBand),
+  );
+}
+export function availabilityPriceBandFromJSON(
+  jsonString: string,
+): SafeParseResult<AvailabilityPriceBand, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AvailabilityPriceBand$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AvailabilityPriceBand' from JSON`,
+  );
+}

package/src/models/components/deployment.ts

@@ -70,6 +70,14 @@ export type Deployment = {
   image: string | null;
   model: string;
   name: string;
+  /**
+   * Free-vocabulary refinement of status explaining why the current status persists (e.g. `awaiting_scheduler`, `tenant_blocked`, `budget_blocked`, `acquiring_capacity`, `rolling_update`, `draining`). Additive: values may appear, change, or disappear at any time, so clients must render it verbatim and must not switch on it — branch on `status` only. Absent when the status needs no explanation.
+   */
+  phase?: string | null | undefined;
+  /**
+   * Human-readable, provider-neutral sentence expanding on `phase` for direct display. Not stable, not machine-parseable; absent whenever `phase` is absent.
+   */
+  phaseMessage?: string | null | undefined;
   /**
    * Current config revision
    */
@@ -109,6 +117,8 @@ export const Deployment$inboundSchema: z.ZodType<
   image: z.nullable(z.string()),
   model: z.string(),
   name: z.string(),
+  phase: z.nullable(z.string()).optional(),
+  phase_message: z.nullable(z.string()).optional(),
   revision: z.number().int(),
   scaling: Scaling$inboundSchema,
   served_model_id: z.nullable(z.string()).optional(),
@@ -117,6 +127,7 @@ export const Deployment$inboundSchema: z.ZodType<
 }).transform((v) => {
   return remap$(v, {
     "created_at": "createdAt",
+    "phase_message": "phaseMessage",
     "served_model_id": "servedModelId",
     "updated_at": "updatedAt",
   });
@@ -131,6 +142,8 @@ export type Deployment$Outbound = {
   image: string | null;
   model: string;
   name: string;
+  phase?: string | null | undefined;
+  phase_message?: string | null | undefined;
   revision: number;
   scaling: Scaling$Outbound;
   served_model_id?: string | null | undefined;
@@ -152,6 +165,8 @@ export const Deployment$outboundSchema: z.ZodType<
   image: z.nullable(z.string()),
   model: z.string(),
   name: z.string(),
+  phase: z.nullable(z.string()).optional(),
+  phaseMessage: z.nullable(z.string()).optional(),
   revision: z.number().int(),
   scaling: Scaling$outboundSchema,
   servedModelId: z.nullable(z.string()).optional(),
@@ -160,6 +175,7 @@ export const Deployment$outboundSchema: z.ZodType<
 }).transform((v) => {
   return remap$(v, {
     createdAt: "created_at",
+    phaseMessage: "phase_message",
     servedModelId: "served_model_id",
     updatedAt: "updated_at",
   });

package/src/models/components/deploymentacceleratorspec.ts

@@ -11,14 +11,16 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 /**
  * Accelerator class: gpu (default) or cpu. For cpu-only recipes this is inferred; type is not required for cpu.
  */
-export const Class = {
+export const DeploymentAcceleratorSpecClass = {
   Gpu: "gpu",
   Cpu: "cpu",
 } as const;
 /**
  * Accelerator class: gpu (default) or cpu. For cpu-only recipes this is inferred; type is not required for cpu.
  */
-export type Class = ClosedEnum<typeof Class>;
+export type DeploymentAcceleratorSpecClass = ClosedEnum<
+  typeof DeploymentAcceleratorSpecClass
+>;
 
 /**
  * A hardware accelerator request for a deployment — GPU, NPU, TPU, or cpu-class serving.
@@ -31,7 +33,7 @@ export type DeploymentAcceleratorSpec = {
   /**
    * Accelerator class: gpu (default) or cpu. For cpu-only recipes this is inferred; type is not required for cpu.
    */
-  class?: Class | undefined;
+  class?: DeploymentAcceleratorSpecClass | undefined;
   /**
    * Accelerators per replica
    */
@@ -44,12 +46,13 @@ export type DeploymentAcceleratorSpec = {
 };
 
 /** @internal */
-export const Class$inboundSchema: z.ZodNativeEnum<typeof Class> = z.nativeEnum(
-  Class,
-);
+export const DeploymentAcceleratorSpecClass$inboundSchema: z.ZodNativeEnum<
+  typeof DeploymentAcceleratorSpecClass
+> = z.nativeEnum(DeploymentAcceleratorSpecClass);
 /** @internal */
-export const Class$outboundSchema: z.ZodNativeEnum<typeof Class> =
-  Class$inboundSchema;
+export const DeploymentAcceleratorSpecClass$outboundSchema: z.ZodNativeEnum<
+  typeof DeploymentAcceleratorSpecClass
+> = DeploymentAcceleratorSpecClass$inboundSchema;
 
 /** @internal */
 export const DeploymentAcceleratorSpec$inboundSchema: z.ZodType<
@@ -57,7 +60,7 @@ export const DeploymentAcceleratorSpec$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  class: Class$inboundSchema.default("gpu"),
+  class: DeploymentAcceleratorSpecClass$inboundSchema.default("gpu"),
   count: z.number().int().default(1),
   fallback: z.array(z.string()).optional(),
   type: z.string().optional(),
@@ -76,7 +79,7 @@ export const DeploymentAcceleratorSpec$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   DeploymentAcceleratorSpec
 > = z.object({
-  class: Class$outboundSchema.default("gpu"),
+  class: DeploymentAcceleratorSpecClass$outboundSchema.default("gpu"),
   count: z.number().int().default(1),
   fallback: z.array(z.string()).optional(),
   type: z.string().optional(),

package/src/models/components/finetunejob.ts

@@ -41,6 +41,14 @@ export type FinetuneJob = {
    * Job whose checkpoint this job warm-started from (derived from from_checkpoint); jobs may share a parent, so lineage forms a tree
    */
   parentJobId?: string | null | undefined;
+  /**
+   * Free-vocabulary refinement of status explaining why the current status persists (e.g. `seeking_capacity`, `awaiting_evaluation`, `acquiring_capacity`, `provisioning`, `finalizing`). Additive: values may appear, change, or disappear at any time, so clients must render it verbatim and must not switch on it — branch on `status` only. Absent when the status needs no explanation.
+   */
+  phase?: string | null | undefined;
+  /**
+   * Human-readable, provider-neutral sentence expanding on `phase` for direct display. Not stable, not machine-parseable; absent whenever `phase` is absent.
+   */
+  phaseMessage?: string | null | undefined;
   /**
    * 0.0–1.0 if known
    */
@@ -75,6 +83,8 @@ export const FinetuneJob$inboundSchema: z.ZodType<
   name: z.string(),
   output_model: z.nullable(z.string()).optional(),
   parent_job_id: z.nullable(z.string()).optional(),
+  phase: z.nullable(z.string()).optional(),
+  phase_message: z.nullable(z.string()).optional(),
   progress: z.nullable(z.number()).optional(),
   status: FinetuneJobStatus$inboundSchema,
 }).transform((v) => {
@@ -85,6 +95,7 @@ export const FinetuneJob$inboundSchema: z.ZodType<
     "from_checkpoint": "fromCheckpoint",
     "output_model": "outputModel",
     "parent_job_id": "parentJobId",
+    "phase_message": "phaseMessage",
   });
 });
 /** @internal */
@@ -99,6 +110,8 @@ export type FinetuneJob$Outbound = {
   name: string;
   output_model?: string | null | undefined;
   parent_job_id?: string | null | undefined;
+  phase?: string | null | undefined;
+  phase_message?: string | null | undefined;
   progress?: number | null | undefined;
   status: string;
 };
@@ -119,6 +132,8 @@ export const FinetuneJob$outboundSchema: z.ZodType<
   name: z.string(),
   outputModel: z.nullable(z.string()).optional(),
   parentJobId: z.nullable(z.string()).optional(),
+  phase: z.nullable(z.string()).optional(),
+  phaseMessage: z.nullable(z.string()).optional(),
   progress: z.nullable(z.number()).optional(),
   status: FinetuneJobStatus$outboundSchema,
 }).transform((v) => {
@@ -129,6 +144,7 @@ export const FinetuneJob$outboundSchema: z.ZodType<
     fromCheckpoint: "from_checkpoint",
     outputModel: "output_model",
     parentJobId: "parent_job_id",
+    phaseMessage: "phase_message",
   });
 });
 

package/src/models/components/index.ts

@@ -2,9 +2,14 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+export * from "./acceleratoravailability.js";
+export * from "./acceleratoravailabilitybucket.js";
+export * from "./acceleratorhourofdayslot.js";
 export * from "./acceleratorpriceband.js";
+export * from "./acceleratorprovideravailability.js";
 export * from "./acceleratorspec.js";
 export * from "./acceleratortype.js";
+export * from "./acceleratorworkloadaffinity.js";
 export * from "./accessentry.js";
 export * from "./accesslistresponse.js";
 export * from "./accessmutationrequest.js";
@@ -13,6 +18,7 @@ export * from "./acknowledgedsafetycheck.js";
 export * from "./acquirability.js";
 export * from "./activateregistryentryrequest.js";
 export * from "./addcatalogmodelrequest.js";
+export * from "./affinityrating.js";
 export * from "./agent.js";
 export * from "./agentcompactioncontextmanagement.js";
 export * from "./agentconnector.js";
@@ -33,6 +39,7 @@ export * from "./agentversionlist.js";
 export * from "./allowedtools.js";
 export * from "./autochunkingstrategy.js";
 export * from "./autoendpoint.js";
+export * from "./availabilitypriceband.js";
 export * from "./banwordsconfig.js";
 export * from "./banwordsguardrail.js";
 export * from "./batchendpoint.js";

package/src/models/operations/getaccelerator.ts

@@ -0,0 +1,67 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type GetAcceleratorRequest = {
+  name: string;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const GetAcceleratorRequest$inboundSchema: z.ZodType<
+  GetAcceleratorRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type GetAcceleratorRequest$Outbound = {
+  name: string;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const GetAcceleratorRequest$outboundSchema: z.ZodType<
+  GetAcceleratorRequest$Outbound,
+  z.ZodTypeDef,
+  GetAcceleratorRequest
+> = z.object({
+  name: z.string(),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function getAcceleratorRequestToJSON(
+  getAcceleratorRequest: GetAcceleratorRequest,
+): string {
+  return JSON.stringify(
+    GetAcceleratorRequest$outboundSchema.parse(getAcceleratorRequest),
+  );
+}
+export function getAcceleratorRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<GetAcceleratorRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetAcceleratorRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetAcceleratorRequest' from JSON`,
+  );
+}

package/src/models/operations/getacceleratoravailability.ts

@@ -0,0 +1,97 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Lookback window for the series.
+ */
+export const Window = {
+  TwentyFourh: "24h",
+  Sevend: "7d",
+  Thirtyd: "30d",
+} as const;
+/**
+ * Lookback window for the series.
+ */
+export type Window = ClosedEnum<typeof Window>;
+
+export type GetAcceleratorAvailabilityRequest = {
+  name: string;
+  /**
+   * Lookback window for the series.
+   */
+  window?: Window | undefined;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const Window$inboundSchema: z.ZodNativeEnum<typeof Window> = z
+  .nativeEnum(Window);
+/** @internal */
+export const Window$outboundSchema: z.ZodNativeEnum<typeof Window> =
+  Window$inboundSchema;
+
+/** @internal */
+export const GetAcceleratorAvailabilityRequest$inboundSchema: z.ZodType<
+  GetAcceleratorAvailabilityRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+  window: Window$inboundSchema.default("7d"),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type GetAcceleratorAvailabilityRequest$Outbound = {
+  name: string;
+  window: string;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const GetAcceleratorAvailabilityRequest$outboundSchema: z.ZodType<
+  GetAcceleratorAvailabilityRequest$Outbound,
+  z.ZodTypeDef,
+  GetAcceleratorAvailabilityRequest
+> = z.object({
+  name: z.string(),
+  window: Window$outboundSchema.default("7d"),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function getAcceleratorAvailabilityRequestToJSON(
+  getAcceleratorAvailabilityRequest: GetAcceleratorAvailabilityRequest,
+): string {
+  return JSON.stringify(
+    GetAcceleratorAvailabilityRequest$outboundSchema.parse(
+      getAcceleratorAvailabilityRequest,
+    ),
+  );
+}
+export function getAcceleratorAvailabilityRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<GetAcceleratorAvailabilityRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetAcceleratorAvailabilityRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetAcceleratorAvailabilityRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -112,6 +112,8 @@ export * from "./exportcompletionfeedback.js";
 export * from "./exportresponsefeedback.js";
 export * from "./extract.js";
 export * from "./extractwithschema.js";
+export * from "./getaccelerator.js";
+export * from "./getacceleratoravailability.js";
 export * from "./getagent.js";
 export * from "./getagentconnector.js";
 export * from "./getagentrun.js";

package/src/react-query/index.ts

@@ -293,6 +293,8 @@ export * from "./sandboxSetPricing.js";
 export * from "./sandboxTerminate.js";
 export * from "./sandboxUploadArchive.js";
 export * from "./sandboxUploadFile.js";
+export * from "./servingAcceleratorsAvailability.js";
+export * from "./servingAcceleratorsGet.js";
 export * from "./servingAcceleratorsList.js";
 export * from "./servingDeploymentsCreate.js";
 export * from "./servingDeploymentsDelete.js";

package/src/react-query/servingAcceleratorsAvailability.core.ts

@@ -0,0 +1,81 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingAcceleratorsAvailability } from "../funcs/servingAcceleratorsAvailability.js";
+import { combineSignals } from "../lib/primitives.js";
+import { 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 type ServingAcceleratorsAvailabilityQueryData =
+  components.AcceleratorAvailability;
+
+export function prefetchServingAcceleratorsAvailability(
+  queryClient: QueryClient,
+  client$: SDKCore,
+  request: operations.GetAcceleratorAvailabilityRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildServingAcceleratorsAvailabilityQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildServingAcceleratorsAvailabilityQuery(
+  client$: SDKCore,
+  request: operations.GetAcceleratorAvailabilityRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<ServingAcceleratorsAvailabilityQueryData>;
+} {
+  return {
+    queryKey: queryKeyServingAcceleratorsAvailability(request.name, {
+      window: request.window,
+      xOnBehalfOf: request.xOnBehalfOf,
+    }),
+    queryFn: async function servingAcceleratorsAvailabilityQueryFn(
+      ctx,
+    ): Promise<ServingAcceleratorsAvailabilityQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(servingAcceleratorsAvailability(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyServingAcceleratorsAvailability(
+  name: string,
+  parameters: {
+    window?: operations.Window | undefined;
+    xOnBehalfOf?: string | undefined;
+  },
+): QueryKey {
+  return ["@meetkai/mka1", "accelerators", "availability", name, parameters];
+}