@meetkai/mka1 0.51.13 → 0.51.15

package/src/models/components/eligibilityrequest.ts

@@ -0,0 +1,67 @@
+/*
+ * 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";
+import {
+  AcceleratorSpec,
+  AcceleratorSpec$inboundSchema,
+  AcceleratorSpec$Outbound,
+  AcceleratorSpec$outboundSchema,
+} from "./acceleratorspec.js";
+
+/**
+ * Pre-submission eligibility preview request. Mirrors the job form's accelerator block: type, count, and optional ordered fallback types.
+ */
+export type EligibilityRequest = {
+  /**
+   * A hardware accelerator request — GPU, NPU, TPU, or similar.
+   *
+   * @remarks
+   *
+   * Request an accelerator by type and count, with optional fallback types.
+   */
+  accelerator: AcceleratorSpec;
+};
+
+/** @internal */
+export const EligibilityRequest$inboundSchema: z.ZodType<
+  EligibilityRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  accelerator: AcceleratorSpec$inboundSchema,
+});
+/** @internal */
+export type EligibilityRequest$Outbound = {
+  accelerator: AcceleratorSpec$Outbound;
+};
+
+/** @internal */
+export const EligibilityRequest$outboundSchema: z.ZodType<
+  EligibilityRequest$Outbound,
+  z.ZodTypeDef,
+  EligibilityRequest
+> = z.object({
+  accelerator: AcceleratorSpec$outboundSchema,
+});
+
+export function eligibilityRequestToJSON(
+  eligibilityRequest: EligibilityRequest,
+): string {
+  return JSON.stringify(
+    EligibilityRequest$outboundSchema.parse(eligibilityRequest),
+  );
+}
+export function eligibilityRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<EligibilityRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => EligibilityRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'EligibilityRequest' from JSON`,
+  );
+}

package/src/models/components/index.ts

@@ -2,6 +2,7 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+export * from "./acceleratorpriceband.js";
 export * from "./acceleratorspec.js";
 export * from "./acceleratortype.js";
 export * from "./accessentry.js";
@@ -9,6 +10,7 @@ export * from "./accesslistresponse.js";
 export * from "./accessmutationrequest.js";
 export * from "./accessmutationresponse.js";
 export * from "./acknowledgedsafetycheck.js";
+export * from "./acquirability.js";
 export * from "./activateregistryentryrequest.js";
 export * from "./addcatalogmodelrequest.js";
 export * from "./agent.js";
@@ -149,6 +151,9 @@ export * from "./dpohyperparameters.js";
 export * from "./dragaction.js";
 export * from "./effectivepricerow.js";
 export * from "./effectivepricesresponse.js";
+export * from "./eligibilitypreview.js";
+export * from "./eligibilitypriceband.js";
+export * from "./eligibilityrequest.js";
 export * from "./embeddingmodel.js";
 export * from "./embeddingmodellimits.js";
 export * from "./embeddingmodellistresponse.js";

package/src/models/components/replica.ts

@@ -5,6 +5,7 @@
 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";
 import {
@@ -14,6 +15,18 @@ import {
   DeploymentAcceleratorSpec$outboundSchema,
 } from "./deploymentacceleratorspec.js";
 
+/**
+ * Whether the replica runs on cluster-internal capacity or externally acquired capacity
+ */
+export const Placement = {
+  Internal: "internal",
+  External: "external",
+} as const;
+/**
+ * Whether the replica runs on cluster-internal capacity or externally acquired capacity
+ */
+export type Placement = ClosedEnum<typeof Placement>;
+
 /**
  * A single running replica (pod/container) behind a deployment.
  */
@@ -27,23 +40,40 @@ export type Replica = {
    */
   accelerator: DeploymentAcceleratorSpec;
   id: string;
-  node?: string | null | undefined;
+  /**
+   * Whether the replica runs on cluster-internal capacity or externally acquired capacity
+   */
+  placement: Placement;
   priceUsdHr?: number | undefined;
   /**
-   * Provider backing this replica when allocated
+   * Backing infrastructure identity when allocated; omitted when the cluster hides provider identity
    */
   provider?: string | undefined;
+  /**
+   * Backing infrastructure region when allocated; omitted when the cluster hides provider identity
+   */
   region?: string | undefined;
   startedAt?: Date | null | undefined;
   status: string;
+  /**
+   * Opaque placement zone identifier, stable per allocation
+   */
+  zone: string;
 };
 
+/** @internal */
+export const Placement$inboundSchema: z.ZodNativeEnum<typeof Placement> = z
+  .nativeEnum(Placement);
+/** @internal */
+export const Placement$outboundSchema: z.ZodNativeEnum<typeof Placement> =
+  Placement$inboundSchema;
+
 /** @internal */
 export const Replica$inboundSchema: z.ZodType<Replica, z.ZodTypeDef, unknown> =
   z.object({
     accelerator: DeploymentAcceleratorSpec$inboundSchema,
     id: z.string(),
-    node: z.nullable(z.string()).optional(),
+    placement: Placement$inboundSchema,
     price_usd_hr: z.number().optional(),
     provider: z.string().optional(),
     region: z.string().optional(),
@@ -51,6 +81,7 @@ export const Replica$inboundSchema: z.ZodType<Replica, z.ZodTypeDef, unknown> =
       z.string().datetime({ offset: true }).transform(v => new Date(v)),
     ).optional(),
     status: z.string(),
+    zone: z.string(),
   }).transform((v) => {
     return remap$(v, {
       "price_usd_hr": "priceUsdHr",
@@ -61,12 +92,13 @@ export const Replica$inboundSchema: z.ZodType<Replica, z.ZodTypeDef, unknown> =
 export type Replica$Outbound = {
   accelerator: DeploymentAcceleratorSpec$Outbound;
   id: string;
-  node?: string | null | undefined;
+  placement: string;
   price_usd_hr?: number | undefined;
   provider?: string | undefined;
   region?: string | undefined;
   started_at?: string | null | undefined;
   status: string;
+  zone: string;
 };
 
 /** @internal */
@@ -77,12 +109,13 @@ export const Replica$outboundSchema: z.ZodType<
 > = z.object({
   accelerator: DeploymentAcceleratorSpec$outboundSchema,
   id: z.string(),
-  node: z.nullable(z.string()).optional(),
+  placement: Placement$outboundSchema,
   priceUsdHr: z.number().optional(),
   provider: z.string().optional(),
   region: z.string().optional(),
   startedAt: z.nullable(z.date().transform(v => v.toISOString())).optional(),
   status: z.string(),
+  zone: z.string(),
 }).transform((v) => {
   return remap$(v, {
     priceUsdHr: "price_usd_hr",

package/src/models/operations/index.ts

@@ -260,6 +260,7 @@ export * from "./llmrevoke.js";
 export * from "./modifyvectorstore.js";
 export * from "./pauseagentschedule.js";
 export * from "./pausefinetuningjob.js";
+export * from "./previeweligibility.js";
 export * from "./proxybrowserportrequest.js";
 export * from "./putorgautomodel.js";
 export * from "./regeneratescopedapikey.js";

package/src/models/operations/previeweligibility.ts

@@ -0,0 +1,70 @@
+/*
+ * 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 * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type PreviewEligibilityRequest = {
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+  eligibilityRequest: components.EligibilityRequest;
+};
+
+/** @internal */
+export const PreviewEligibilityRequest$inboundSchema: z.ZodType<
+  PreviewEligibilityRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  "X-On-Behalf-Of": z.string().optional(),
+  EligibilityRequest: components.EligibilityRequest$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+    "EligibilityRequest": "eligibilityRequest",
+  });
+});
+/** @internal */
+export type PreviewEligibilityRequest$Outbound = {
+  "X-On-Behalf-Of"?: string | undefined;
+  EligibilityRequest: components.EligibilityRequest$Outbound;
+};
+
+/** @internal */
+export const PreviewEligibilityRequest$outboundSchema: z.ZodType<
+  PreviewEligibilityRequest$Outbound,
+  z.ZodTypeDef,
+  PreviewEligibilityRequest
+> = z.object({
+  xOnBehalfOf: z.string().optional(),
+  eligibilityRequest: components.EligibilityRequest$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+    eligibilityRequest: "EligibilityRequest",
+  });
+});
+
+export function previewEligibilityRequestToJSON(
+  previewEligibilityRequest: PreviewEligibilityRequest,
+): string {
+  return JSON.stringify(
+    PreviewEligibilityRequest$outboundSchema.parse(previewEligibilityRequest),
+  );
+}
+export function previewEligibilityRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<PreviewEligibilityRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PreviewEligibilityRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PreviewEligibilityRequest' from JSON`,
+  );
+}

package/src/react-query/index.ts

@@ -307,6 +307,7 @@ export * from "./servingDeploymentsRegister.js";
 export * from "./servingDeploymentsRollback.js";
 export * from "./servingDeploymentsUpdate.js";
 export * from "./servingDeploymentsUpdateScaling.js";
+export * from "./servingEligibilityPreview.js";
 export * from "./servingFinetuneJobsCancel.js";
 export * from "./servingFinetuneJobsCreate.js";
 export * from "./servingFinetuneJobsGet.js";

package/src/react-query/servingEligibilityPreview.ts

@@ -0,0 +1,113 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingEligibilityPreview } from "../funcs/servingEligibilityPreview.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+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 { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type ServingEligibilityPreviewMutationVariables = {
+  request: operations.PreviewEligibilityRequest;
+  options?: RequestOptions;
+};
+
+export type ServingEligibilityPreviewMutationData =
+  components.EligibilityPreview;
+
+export type ServingEligibilityPreviewMutationError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Preview accelerator eligibility
+ *
+ * @remarks
+ * Preview, before submitting a job or deployment, how much matching capacity the cluster can currently acquire and how likely it is to start. The response is provider-anonymous: counts, price bands, and advice only. This is an advisory read; it reserves nothing.
+ */
+export function useServingEligibilityPreviewMutation(
+  options?: MutationHookOptions<
+    ServingEligibilityPreviewMutationData,
+    ServingEligibilityPreviewMutationError,
+    ServingEligibilityPreviewMutationVariables
+  >,
+): UseMutationResult<
+  ServingEligibilityPreviewMutationData,
+  ServingEligibilityPreviewMutationError,
+  ServingEligibilityPreviewMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildServingEligibilityPreviewMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyServingEligibilityPreview(): MutationKey {
+  return ["@meetkai/mka1", "eligibility", "preview"];
+}
+
+export function buildServingEligibilityPreviewMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: ServingEligibilityPreviewMutationVariables,
+  ) => Promise<ServingEligibilityPreviewMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyServingEligibilityPreview(),
+    mutationFn: function servingEligibilityPreviewMutationFn({
+      request,
+      options,
+    }): Promise<ServingEligibilityPreviewMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(servingEligibilityPreview(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/sdk/eligibility.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingEligibilityPreview } from "../funcs/servingEligibilityPreview.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 Eligibility extends ClientSDK {
+  /**
+   * Preview accelerator eligibility
+   *
+   * @remarks
+   * Preview, before submitting a job or deployment, how much matching capacity the cluster can currently acquire and how likely it is to start. The response is provider-anonymous: counts, price bands, and advice only. This is an advisory read; it reserves nothing.
+   */
+  async preview(
+    request: operations.PreviewEligibilityRequest,
+    options?: RequestOptions,
+  ): Promise<components.EligibilityPreview> {
+    return unwrapAsync(servingEligibilityPreview(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/serving.ts

@@ -5,6 +5,7 @@
 import { ClientSDK } from "../lib/sdks.js";
 import { Accelerators } from "./accelerators.js";
 import { Deployments } from "./deployments.js";
+import { Eligibility } from "./eligibility.js";
 import { FinetuneJobs } from "./finetunejobs.js";
 import { Recipes } from "./recipes.js";
 import { SDKImages } from "./sdkimages.js";
@@ -25,6 +26,11 @@ export class Serving extends ClientSDK {
     return (this._deployments ??= new Deployments(this._options));
   }
 
+  private _eligibility?: Eligibility;
+  get eligibility(): Eligibility {
+    return (this._eligibility ??= new Eligibility(this._options));
+  }
+
   private _finetuneJobs?: FinetuneJobs;
   get finetuneJobs(): FinetuneJobs {
     return (this._finetuneJobs ??= new FinetuneJobs(this._options));