@meetkai/mka1 0.51.13 → 0.51.15

package/src/funcs/servingEligibilityPreview.ts

@@ -0,0 +1,193 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { SDKCore } from "../core.js";
+import { encodeJSON, 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 * 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 { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * 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 servingEligibilityPreview(
+  client: SDKCore,
+  request: operations.PreviewEligibilityRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.EligibilityPreview,
+    | errors.ServingError
+    | errors.ServingHTTPValidationError
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: SDKCore,
+  request: operations.PreviewEligibilityRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.EligibilityPreview,
+      | errors.ServingError
+      | errors.ServingHTTPValidationError
+      | SDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.PreviewEligibilityRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.EligibilityRequest, {
+    explode: true,
+  });
+
+  const path = pathToFunc("/api/v1/serving/eligibility")();
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    "X-On-Behalf-Of": encodeSimple(
+      "X-On-Behalf-Of",
+      payload["X-On-Behalf-Of"],
+      { explode: false, charEncoding: "none" },
+    ),
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearerAuth);
+  const securityInput = secConfig == null ? {} : { bearerAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "previewEligibility",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearerAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || {
+        strategy: "backoff",
+        backoff: {
+          initialInterval: 500,
+          maxInterval: 5000,
+          exponent: 1.5,
+          maxElapsedTime: 15000,
+        },
+        retryConnectionErrors: true,
+      }
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    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 responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    components.EligibilityPreview,
+    | errors.ServingError
+    | errors.ServingHTTPValidationError
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.EligibilityPreview$inboundSchema),
+    M.jsonErr(403, errors.ServingError$inboundSchema),
+    M.jsonErr(422, errors.ServingHTTPValidationError$inboundSchema),
+    M.fail([401, "4XX"]),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.1.0",
-  sdkVersion: "0.51.13",
+  sdkVersion: "0.51.15",
   genVersion: "2.918.4",
-  userAgent: "speakeasy-sdk/typescript 0.51.13 2.918.4 1.1.0 @meetkai/mka1",
+  userAgent: "speakeasy-sdk/typescript 0.51.15 2.918.4 1.1.0 @meetkai/mka1",
 } as const;

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

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

package/src/mcp-server/server.ts

@@ -314,6 +314,7 @@ import { tool$servingDeploymentsRegister } from "./tools/servingDeploymentsRegis
 import { tool$servingDeploymentsRollback } from "./tools/servingDeploymentsRollback.js";
 import { tool$servingDeploymentsUpdate } from "./tools/servingDeploymentsUpdate.js";
 import { tool$servingDeploymentsUpdateScaling } from "./tools/servingDeploymentsUpdateScaling.js";
+import { tool$servingEligibilityPreview } from "./tools/servingEligibilityPreview.js";
 import { tool$servingFinetuneJobsCancel } from "./tools/servingFinetuneJobsCancel.js";
 import { tool$servingFinetuneJobsCreate } from "./tools/servingFinetuneJobsCreate.js";
 import { tool$servingFinetuneJobsGet } from "./tools/servingFinetuneJobsGet.js";
@@ -361,7 +362,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "SDK",
-    version: "0.51.13",
+    version: "0.51.15",
   });
 
   const client = new SDKCore({
@@ -694,6 +695,7 @@ export function createMCPServer(deps: {
   tool(tool$servingDeploymentsListRevisions);
   tool(tool$servingDeploymentsRollback);
   tool(tool$servingDeploymentsUpdateScaling);
+  tool(tool$servingEligibilityPreview);
   tool(tool$servingFinetuneJobsList);
   tool(tool$servingFinetuneJobsCreate);
   tool(tool$servingFinetuneJobsCancel);

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingEligibilityPreview } from "../../funcs/servingEligibilityPreview.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.PreviewEligibilityRequest$inboundSchema,
+};
+
+export const tool$servingEligibilityPreview: ToolDefinition<typeof args> = {
+  name: "serving-eligibility-preview",
+  description: `Preview accelerator eligibility
+
+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.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await servingEligibilityPreview(
+      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/models/components/acceleratorpriceband.ts

@@ -0,0 +1,58 @@
+/*
+ * 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 configurations acquirable now for an accelerator type.
+ */
+export type AcceleratorPriceBand = {
+  min: number;
+  p50: number;
+};
+
+/** @internal */
+export const AcceleratorPriceBand$inboundSchema: z.ZodType<
+  AcceleratorPriceBand,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  min: z.number(),
+  p50: z.number(),
+});
+/** @internal */
+export type AcceleratorPriceBand$Outbound = {
+  min: number;
+  p50: number;
+};
+
+/** @internal */
+export const AcceleratorPriceBand$outboundSchema: z.ZodType<
+  AcceleratorPriceBand$Outbound,
+  z.ZodTypeDef,
+  AcceleratorPriceBand
+> = z.object({
+  min: z.number(),
+  p50: z.number(),
+});
+
+export function acceleratorPriceBandToJSON(
+  acceleratorPriceBand: AcceleratorPriceBand,
+): string {
+  return JSON.stringify(
+    AcceleratorPriceBand$outboundSchema.parse(acceleratorPriceBand),
+  );
+}
+export function acceleratorPriceBandFromJSON(
+  jsonString: string,
+): SafeParseResult<AcceleratorPriceBand, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AcceleratorPriceBand$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AcceleratorPriceBand' from JSON`,
+  );
+}

package/src/models/components/acceleratortype.ts

@@ -8,6 +8,17 @@ 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 {
+  AcceleratorPriceBand,
+  AcceleratorPriceBand$inboundSchema,
+  AcceleratorPriceBand$Outbound,
+  AcceleratorPriceBand$outboundSchema,
+} from "./acceleratorpriceband.js";
+import {
+  Acquirability,
+  Acquirability$inboundSchema,
+  Acquirability$outboundSchema,
+} from "./acquirability.js";
 
 export const Kind = {
   Gpu: "gpu",
@@ -21,6 +32,14 @@ export type Kind = ClosedEnum<typeof Kind>;
  * An offered accelerator type in the catalog.
  */
 export type AcceleratorType = {
+  /**
+   * Banded estimate of how reliably matching capacity can be acquired, computed from availability history. "unknown" means no history, never a guess.
+   */
+  acquirability?: Acquirability | undefined;
+  /**
+   * Configurations acquirable now (0 when offered is false). Absent when live market data is unavailable.
+   */
+  acquirableCount?: number | undefined;
   kind?: Kind | undefined;
   /**
    * Max accelerators of this type per replica
@@ -28,6 +47,14 @@ export type AcceleratorType = {
   maxCount: number;
   memoryGb: number;
   name: string;
+  /**
+   * Whether any capacity acquirable right now matches this type. Absent when live market data is unavailable.
+   */
+  offered?: boolean | undefined;
+  /**
+   * USD-per-hour price band across configurations acquirable now for an accelerator type.
+   */
+  priceUsdHr?: AcceleratorPriceBand | undefined;
   vendor: string;
 };
 
@@ -45,23 +72,33 @@ export const AcceleratorType$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  acquirability: Acquirability$inboundSchema.optional(),
+  acquirable_count: z.number().int().optional(),
   kind: Kind$inboundSchema.default("gpu"),
   max_count: z.number().int(),
   memory_gb: z.number().int(),
   name: z.string(),
+  offered: z.boolean().optional(),
+  price_usd_hr: AcceleratorPriceBand$inboundSchema.optional(),
   vendor: z.string(),
 }).transform((v) => {
   return remap$(v, {
+    "acquirable_count": "acquirableCount",
     "max_count": "maxCount",
     "memory_gb": "memoryGb",
+    "price_usd_hr": "priceUsdHr",
   });
 });
 /** @internal */
 export type AcceleratorType$Outbound = {
+  acquirability?: string | undefined;
+  acquirable_count?: number | undefined;
   kind: string;
   max_count: number;
   memory_gb: number;
   name: string;
+  offered?: boolean | undefined;
+  price_usd_hr?: AcceleratorPriceBand$Outbound | undefined;
   vendor: string;
 };
 
@@ -71,15 +108,21 @@ export const AcceleratorType$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   AcceleratorType
 > = z.object({
+  acquirability: Acquirability$outboundSchema.optional(),
+  acquirableCount: z.number().int().optional(),
   kind: Kind$outboundSchema.default("gpu"),
   maxCount: z.number().int(),
   memoryGb: z.number().int(),
   name: z.string(),
+  offered: z.boolean().optional(),
+  priceUsdHr: AcceleratorPriceBand$outboundSchema.optional(),
   vendor: z.string(),
 }).transform((v) => {
   return remap$(v, {
+    acquirableCount: "acquirable_count",
     maxCount: "max_count",
     memoryGb: "memory_gb",
+    priceUsdHr: "price_usd_hr",
   });
 });
 

package/src/models/components/acquirability.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+/**
+ * Banded estimate of how reliably matching capacity can be acquired, computed from availability history. "unknown" means no history, never a guess.
+ */
+export const Acquirability = {
+  High: "high",
+  Medium: "medium",
+  Low: "low",
+  Unknown: "unknown",
+} as const;
+/**
+ * Banded estimate of how reliably matching capacity can be acquired, computed from availability history. "unknown" means no history, never a guess.
+ */
+export type Acquirability = ClosedEnum<typeof Acquirability>;
+
+/** @internal */
+export const Acquirability$inboundSchema: z.ZodNativeEnum<
+  typeof Acquirability
+> = z.nativeEnum(Acquirability);
+/** @internal */
+export const Acquirability$outboundSchema: z.ZodNativeEnum<
+  typeof Acquirability
+> = Acquirability$inboundSchema;

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`,
+  );
+}