@meetkai/mka1 0.51.13 → 0.51.14

package/src/models/components/eligibilitypreview.ts

@@ -0,0 +1,145 @@
+/*
+ * 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";
+import {
+  Acquirability,
+  Acquirability$inboundSchema,
+  Acquirability$outboundSchema,
+} from "./acquirability.js";
+import {
+  EligibilityPriceBand,
+  EligibilityPriceBand$inboundSchema,
+  EligibilityPriceBand$Outbound,
+  EligibilityPriceBand$outboundSchema,
+} from "./eligibilitypriceband.js";
+
+/**
+ * Coarse expected-start band for the request as the market looks now.
+ */
+export const EstStart = {
+  Immediate: "immediate",
+  Minutes: "minutes",
+  Queued: "queued",
+  Unknown: "unknown",
+} as const;
+/**
+ * Coarse expected-start band for the request as the market looks now.
+ */
+export type EstStart = ClosedEnum<typeof EstStart>;
+
+/**
+ * Provider-anonymous capacity preview: counts, price bands, and advice only. Configurations, providers, regions, and SKUs are never enumerated.
+ */
+export type EligibilityPreview = {
+  /**
+   * Banded estimate of how reliably matching capacity can be acquired, computed from availability history. "unknown" means no history, never a guess.
+   */
+  acquirability: Acquirability;
+  /**
+   * Matching configurations that could start immediately.
+   */
+  acquirableNow: number;
+  /**
+   * Machine-generated, provider-anonymous guidance.
+   */
+  advice: Array<string>;
+  /**
+   * Whether any known configuration matches the request.
+   */
+  eligible: boolean;
+  /**
+   * Coarse expected-start band for the request as the market looks now.
+   */
+  estStart: EstStart;
+  /**
+   * USD-per-hour price band across the configurations matching an eligibility request.
+   */
+  priceUsdHr?: EligibilityPriceBand | undefined;
+  /**
+   * Known matching configurations currently out of stock.
+   */
+  watchable: number;
+};
+
+/** @internal */
+export const EstStart$inboundSchema: z.ZodNativeEnum<typeof EstStart> = z
+  .nativeEnum(EstStart);
+/** @internal */
+export const EstStart$outboundSchema: z.ZodNativeEnum<typeof EstStart> =
+  EstStart$inboundSchema;
+
+/** @internal */
+export const EligibilityPreview$inboundSchema: z.ZodType<
+  EligibilityPreview,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  acquirability: Acquirability$inboundSchema,
+  acquirable_now: z.number().int(),
+  advice: z.array(z.string()),
+  eligible: z.boolean(),
+  est_start: EstStart$inboundSchema,
+  price_usd_hr: EligibilityPriceBand$inboundSchema.optional(),
+  watchable: z.number().int(),
+}).transform((v) => {
+  return remap$(v, {
+    "acquirable_now": "acquirableNow",
+    "est_start": "estStart",
+    "price_usd_hr": "priceUsdHr",
+  });
+});
+/** @internal */
+export type EligibilityPreview$Outbound = {
+  acquirability: string;
+  acquirable_now: number;
+  advice: Array<string>;
+  eligible: boolean;
+  est_start: string;
+  price_usd_hr?: EligibilityPriceBand$Outbound | undefined;
+  watchable: number;
+};
+
+/** @internal */
+export const EligibilityPreview$outboundSchema: z.ZodType<
+  EligibilityPreview$Outbound,
+  z.ZodTypeDef,
+  EligibilityPreview
+> = z.object({
+  acquirability: Acquirability$outboundSchema,
+  acquirableNow: z.number().int(),
+  advice: z.array(z.string()),
+  eligible: z.boolean(),
+  estStart: EstStart$outboundSchema,
+  priceUsdHr: EligibilityPriceBand$outboundSchema.optional(),
+  watchable: z.number().int(),
+}).transform((v) => {
+  return remap$(v, {
+    acquirableNow: "acquirable_now",
+    estStart: "est_start",
+    priceUsdHr: "price_usd_hr",
+  });
+});
+
+export function eligibilityPreviewToJSON(
+  eligibilityPreview: EligibilityPreview,
+): string {
+  return JSON.stringify(
+    EligibilityPreview$outboundSchema.parse(eligibilityPreview),
+  );
+}
+export function eligibilityPreviewFromJSON(
+  jsonString: string,
+): SafeParseResult<EligibilityPreview, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => EligibilityPreview$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'EligibilityPreview' from JSON`,
+  );
+}

package/src/models/components/eligibilitypriceband.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 across the configurations matching an eligibility request.
+ */
+export type EligibilityPriceBand = {
+  max: number;
+  min: number;
+  p50: number;
+};
+
+/** @internal */
+export const EligibilityPriceBand$inboundSchema: z.ZodType<
+  EligibilityPriceBand,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  max: z.number(),
+  min: z.number(),
+  p50: z.number(),
+});
+/** @internal */
+export type EligibilityPriceBand$Outbound = {
+  max: number;
+  min: number;
+  p50: number;
+};
+
+/** @internal */
+export const EligibilityPriceBand$outboundSchema: z.ZodType<
+  EligibilityPriceBand$Outbound,
+  z.ZodTypeDef,
+  EligibilityPriceBand
+> = z.object({
+  max: z.number(),
+  min: z.number(),
+  p50: z.number(),
+});
+
+export function eligibilityPriceBandToJSON(
+  eligibilityPriceBand: EligibilityPriceBand,
+): string {
+  return JSON.stringify(
+    EligibilityPriceBand$outboundSchema.parse(eligibilityPriceBand),
+  );
+}
+export function eligibilityPriceBandFromJSON(
+  jsonString: string,
+): SafeParseResult<EligibilityPriceBand, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => EligibilityPriceBand$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'EligibilityPriceBand' from JSON`,
+  );
+}

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/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));