@meetkai/mka1 0.51.11 → 0.51.13

package/src/models/components/replica.ts

@@ -8,24 +8,24 @@ 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";
+  DeploymentAcceleratorSpec,
+  DeploymentAcceleratorSpec$inboundSchema,
+  DeploymentAcceleratorSpec$Outbound,
+  DeploymentAcceleratorSpec$outboundSchema,
+} from "./deploymentacceleratorspec.js";
 
 /**
  * A single running replica (pod/container) behind a deployment.
  */
 export type Replica = {
   /**
-   * A hardware accelerator request — GPU, NPU, TPU, or similar.
+   * A hardware accelerator request for a deployment — GPU, NPU, TPU, or cpu-class serving.
    *
    * @remarks
    *
-   * Request an accelerator by type and count, with optional fallback types.
+   * Request an accelerator by type and count, with optional fallback types. Set class to cpu to deploy a cpu-capable managed recipe on CPU instances (type is then not required; the CPU resource floor comes from the recipe).
    */
-  accelerator: AcceleratorSpec;
+  accelerator: DeploymentAcceleratorSpec;
   id: string;
   node?: string | null | undefined;
   priceUsdHr?: number | undefined;
@@ -41,7 +41,7 @@ export type Replica = {
 /** @internal */
 export const Replica$inboundSchema: z.ZodType<Replica, z.ZodTypeDef, unknown> =
   z.object({
-    accelerator: AcceleratorSpec$inboundSchema,
+    accelerator: DeploymentAcceleratorSpec$inboundSchema,
     id: z.string(),
     node: z.nullable(z.string()).optional(),
     price_usd_hr: z.number().optional(),
@@ -59,7 +59,7 @@ export const Replica$inboundSchema: z.ZodType<Replica, z.ZodTypeDef, unknown> =
   });
 /** @internal */
 export type Replica$Outbound = {
-  accelerator: AcceleratorSpec$Outbound;
+  accelerator: DeploymentAcceleratorSpec$Outbound;
   id: string;
   node?: string | null | undefined;
   price_usd_hr?: number | undefined;
@@ -75,7 +75,7 @@ export const Replica$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   Replica
 > = z.object({
-  accelerator: AcceleratorSpec$outboundSchema,
+  accelerator: DeploymentAcceleratorSpec$outboundSchema,
   id: z.string(),
   node: z.nullable(z.string()).optional(),
   priceUsdHr: z.number().optional(),

package/src/models/components/spendgroup.ts

@@ -0,0 +1,75 @@
+/*
+ * 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";
+import {
+  SpendItem,
+  SpendItem$inboundSchema,
+  SpendItem$Outbound,
+  SpendItem$outboundSchema,
+} from "./spenditem.js";
+
+/**
+ * Aggregate spend for one resource class.
+ */
+export type SpendGroup = {
+  /**
+   * Highest-spend resources first; at most 100 entries.
+   */
+  items: Array<SpendItem>;
+  /**
+   * Full spend for this group in the window, including resources beyond the items cap.
+   */
+  totalUsd: number;
+};
+
+/** @internal */
+export const SpendGroup$inboundSchema: z.ZodType<
+  SpendGroup,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  items: z.array(SpendItem$inboundSchema),
+  total_usd: z.number(),
+}).transform((v) => {
+  return remap$(v, {
+    "total_usd": "totalUsd",
+  });
+});
+/** @internal */
+export type SpendGroup$Outbound = {
+  items: Array<SpendItem$Outbound>;
+  total_usd: number;
+};
+
+/** @internal */
+export const SpendGroup$outboundSchema: z.ZodType<
+  SpendGroup$Outbound,
+  z.ZodTypeDef,
+  SpendGroup
+> = z.object({
+  items: z.array(SpendItem$outboundSchema),
+  totalUsd: z.number(),
+}).transform((v) => {
+  return remap$(v, {
+    totalUsd: "total_usd",
+  });
+});
+
+export function spendGroupToJSON(spendGroup: SpendGroup): string {
+  return JSON.stringify(SpendGroup$outboundSchema.parse(spendGroup));
+}
+export function spendGroupFromJSON(
+  jsonString: string,
+): SafeParseResult<SpendGroup, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SpendGroup$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SpendGroup' from JSON`,
+  );
+}

package/src/models/components/spenditem.ts

@@ -0,0 +1,61 @@
+/*
+ * 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";
+
+/**
+ * Computed spend for one resource within the window.
+ */
+export type SpendItem = {
+  id: string;
+  name: string;
+  /**
+   * Computed spend within the window, in USD.
+   */
+  usd: number;
+};
+
+/** @internal */
+export const SpendItem$inboundSchema: z.ZodType<
+  SpendItem,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  name: z.string(),
+  usd: z.number(),
+});
+/** @internal */
+export type SpendItem$Outbound = {
+  id: string;
+  name: string;
+  usd: number;
+};
+
+/** @internal */
+export const SpendItem$outboundSchema: z.ZodType<
+  SpendItem$Outbound,
+  z.ZodTypeDef,
+  SpendItem
+> = z.object({
+  id: z.string(),
+  name: z.string(),
+  usd: z.number(),
+});
+
+export function spendItemToJSON(spendItem: SpendItem): string {
+  return JSON.stringify(SpendItem$outboundSchema.parse(spendItem));
+}
+export function spendItemFromJSON(
+  jsonString: string,
+): SafeParseResult<SpendItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SpendItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SpendItem' from JSON`,
+  );
+}

package/src/models/components/spendsummary.ts

@@ -0,0 +1,95 @@
+/*
+ * 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";
+import {
+  SpendGroup,
+  SpendGroup$inboundSchema,
+  SpendGroup$Outbound,
+  SpendGroup$outboundSchema,
+} from "./spendgroup.js";
+import {
+  SpendWindow,
+  SpendWindow$inboundSchema,
+  SpendWindow$Outbound,
+  SpendWindow$outboundSchema,
+} from "./spendwindow.js";
+
+/**
+ * Aggregate spend computed as price × runtime overlap with the window; derived on read, never stored.
+ */
+export type SpendSummary = {
+  /**
+   * Aggregate spend for one resource class.
+   */
+  deployments: SpendGroup;
+  /**
+   * Aggregate spend for one resource class.
+   */
+  finetune: SpendGroup;
+  /**
+   * Total spend across deployments and fine-tune jobs in the window.
+   */
+  totalUsd: number;
+  /**
+   * The resolved reporting window.
+   */
+  window: SpendWindow;
+};
+
+/** @internal */
+export const SpendSummary$inboundSchema: z.ZodType<
+  SpendSummary,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  deployments: SpendGroup$inboundSchema,
+  finetune: SpendGroup$inboundSchema,
+  total_usd: z.number(),
+  window: SpendWindow$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "total_usd": "totalUsd",
+  });
+});
+/** @internal */
+export type SpendSummary$Outbound = {
+  deployments: SpendGroup$Outbound;
+  finetune: SpendGroup$Outbound;
+  total_usd: number;
+  window: SpendWindow$Outbound;
+};
+
+/** @internal */
+export const SpendSummary$outboundSchema: z.ZodType<
+  SpendSummary$Outbound,
+  z.ZodTypeDef,
+  SpendSummary
+> = z.object({
+  deployments: SpendGroup$outboundSchema,
+  finetune: SpendGroup$outboundSchema,
+  totalUsd: z.number(),
+  window: SpendWindow$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    totalUsd: "total_usd",
+  });
+});
+
+export function spendSummaryToJSON(spendSummary: SpendSummary): string {
+  return JSON.stringify(SpendSummary$outboundSchema.parse(spendSummary));
+}
+export function spendSummaryFromJSON(
+  jsonString: string,
+): SafeParseResult<SpendSummary, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SpendSummary$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SpendSummary' from JSON`,
+  );
+}

package/src/models/components/spendwindow.ts

@@ -0,0 +1,59 @@
+/*
+ * 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";
+
+/**
+ * The resolved reporting window.
+ */
+export type SpendWindow = {
+  end: Date;
+  /**
+   * Lower bound of the window; null when the request set none (total covers all history).
+   */
+  start?: Date | null | undefined;
+};
+
+/** @internal */
+export const SpendWindow$inboundSchema: z.ZodType<
+  SpendWindow,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  end: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  start: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+});
+/** @internal */
+export type SpendWindow$Outbound = {
+  end: string;
+  start?: string | null | undefined;
+};
+
+/** @internal */
+export const SpendWindow$outboundSchema: z.ZodType<
+  SpendWindow$Outbound,
+  z.ZodTypeDef,
+  SpendWindow
+> = z.object({
+  end: z.date().transform(v => v.toISOString()),
+  start: z.nullable(z.date().transform(v => v.toISOString())).optional(),
+});
+
+export function spendWindowToJSON(spendWindow: SpendWindow): string {
+  return JSON.stringify(SpendWindow$outboundSchema.parse(spendWindow));
+}
+export function spendWindowFromJSON(
+  jsonString: string,
+): SafeParseResult<SpendWindow, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SpendWindow$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SpendWindow' from JSON`,
+  );
+}

package/src/models/operations/getspend.ts

@@ -0,0 +1,73 @@
+/*
+ * 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 GetSpendRequest = {
+  start?: Date | null | undefined;
+  end?: Date | null | undefined;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const GetSpendRequest$inboundSchema: z.ZodType<
+  GetSpendRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  start: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  end: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type GetSpendRequest$Outbound = {
+  start?: string | null | undefined;
+  end?: string | null | undefined;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const GetSpendRequest$outboundSchema: z.ZodType<
+  GetSpendRequest$Outbound,
+  z.ZodTypeDef,
+  GetSpendRequest
+> = z.object({
+  start: z.nullable(z.date().transform(v => v.toISOString())).optional(),
+  end: z.nullable(z.date().transform(v => v.toISOString())).optional(),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function getSpendRequestToJSON(
+  getSpendRequest: GetSpendRequest,
+): string {
+  return JSON.stringify(GetSpendRequest$outboundSchema.parse(getSpendRequest));
+}
+export function getSpendRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<GetSpendRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetSpendRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetSpendRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -176,6 +176,7 @@ export * from "./getskillversion.js";
 export * from "./getskillversioncontent.js";
 export * from "./getspeechtotexthistory.js";
 export * from "./getspeechtotexthistorycontent.js";
+export * from "./getspend.js";
 export * from "./getteam.js";
 export * from "./gettexttospeechhistory.js";
 export * from "./gettexttospeechhistorycontent.js";

package/src/react-query/index.ts

@@ -331,6 +331,7 @@ export * from "./servingRecipesSetEnabled.js";
 export * from "./servingSecretsCreate.js";
 export * from "./servingSecretsDelete.js";
 export * from "./servingSecretsList.js";
+export * from "./servingSpendGet.js";
 export * from "./servingTenantsDeleteOrganization.js";
 export * from "./servingTenantsGet.js";
 export * from "./servingTenantsGetOrganizationDeletion.js";

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

@@ -0,0 +1,79 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingSpendGet } from "../funcs/servingSpendGet.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 ServingSpendGetQueryData = components.SpendSummary;
+
+export function prefetchServingSpendGet(
+  queryClient: QueryClient,
+  client$: SDKCore,
+  request: operations.GetSpendRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildServingSpendGetQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildServingSpendGetQuery(
+  client$: SDKCore,
+  request: operations.GetSpendRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (context: QueryFunctionContext) => Promise<ServingSpendGetQueryData>;
+} {
+  return {
+    queryKey: queryKeyServingSpendGet({
+      start: request.start,
+      end: request.end,
+      xOnBehalfOf: request.xOnBehalfOf,
+    }),
+    queryFn: async function servingSpendGetQueryFn(
+      ctx,
+    ): Promise<ServingSpendGetQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(servingSpendGet(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyServingSpendGet(
+  parameters: {
+    start?: Date | null | undefined;
+    end?: Date | null | undefined;
+    xOnBehalfOf?: string | undefined;
+  },
+): QueryKey {
+  return ["@meetkai/mka1", "spend", "get", parameters];
+}

package/src/react-query/servingSpendGet.ts

@@ -0,0 +1,145 @@
+/*
+ * 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 {
+  buildServingSpendGetQuery,
+  prefetchServingSpendGet,
+  queryKeyServingSpendGet,
+  ServingSpendGetQueryData,
+} from "./servingSpendGet.core.js";
+export {
+  buildServingSpendGetQuery,
+  prefetchServingSpendGet,
+  queryKeyServingSpendGet,
+  type ServingSpendGetQueryData,
+};
+
+export type ServingSpendGetQueryError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Cost and spend summary
+ *
+ * @remarks
+ * Aggregate spend for your organization, computed from retained compute ledgers as price × runtime overlap with the requested window. Spend is derived on read and is never stored.
+ */
+export function useServingSpendGet(
+  request: operations.GetSpendRequest,
+  options?: QueryHookOptions<
+    ServingSpendGetQueryData,
+    ServingSpendGetQueryError
+  >,
+): UseQueryResult<ServingSpendGetQueryData, ServingSpendGetQueryError> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildServingSpendGetQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Cost and spend summary
+ *
+ * @remarks
+ * Aggregate spend for your organization, computed from retained compute ledgers as price × runtime overlap with the requested window. Spend is derived on read and is never stored.
+ */
+export function useServingSpendGetSuspense(
+  request: operations.GetSpendRequest,
+  options?: SuspenseQueryHookOptions<
+    ServingSpendGetQueryData,
+    ServingSpendGetQueryError
+  >,
+): UseSuspenseQueryResult<ServingSpendGetQueryData, ServingSpendGetQueryError> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildServingSpendGetQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setServingSpendGetData(
+  client: QueryClient,
+  queryKeyBase: [
+    parameters: {
+      start?: Date | null | undefined;
+      end?: Date | null | undefined;
+      xOnBehalfOf?: string | undefined;
+    },
+  ],
+  data: ServingSpendGetQueryData,
+): ServingSpendGetQueryData | undefined {
+  const key = queryKeyServingSpendGet(...queryKeyBase);
+
+  return client.setQueryData<ServingSpendGetQueryData>(key, data);
+}
+
+export function invalidateServingSpendGet(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [parameters: {
+      start?: Date | null | undefined;
+      end?: Date | null | undefined;
+      xOnBehalfOf?: string | undefined;
+    }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "spend", "get", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllServingSpendGet(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "spend", "get"],
+  });
+}

package/src/sdk/serving.ts

@@ -10,6 +10,7 @@ import { Recipes } from "./recipes.js";
 import { SDKImages } from "./sdkimages.js";
 import { SDKModels } from "./sdkmodels.js";
 import { Secrets } from "./secrets.js";
+import { Spend } from "./spend.js";
 import { Tenants } from "./tenants.js";
 import { Volumes } from "./volumes.js";
 
@@ -49,6 +50,11 @@ export class Serving extends ClientSDK {
     return (this._secrets ??= new Secrets(this._options));
   }
 
+  private _spend?: Spend;
+  get spend(): Spend {
+    return (this._spend ??= new Spend(this._options));
+  }
+
   private _tenants?: Tenants;
   get tenants(): Tenants {
     return (this._tenants ??= new Tenants(this._options));