@meetkai/mka1 0.51.14 → 0.51.16

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingSecretsGet } from "../../funcs/servingSecretsGet.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetSecretRequest$inboundSchema,
+};
+
+export const tool$servingSecretsGet: ToolDefinition<typeof args> = {
+  name: "serving-secrets-get",
+  description: `Get a secret
+
+Retrieve secret metadata: key names and allowed use. Values are never returned.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await servingSecretsGet(
+      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/deploymentcreate.ts

@@ -95,6 +95,9 @@ export type DeploymentCreate = {
    * Create-time scaling. Omitted min_containers defaults to one; explicit zero is preserved.
    */
   scaling?: DeploymentScalingCreate | undefined;
+  /**
+   * Each referenced secret must include "serving" in its allowed_use.
+   */
   secrets?: Array<string> | undefined;
   /**
    * How a config change or rollback is rolled out.

package/src/models/components/finetunejobcreate.ts

@@ -59,6 +59,9 @@ export type FinetuneJobCreate = {
    * Volume where checkpoints are written
    */
   outputVolume: string;
+  /**
+   * Each referenced secret must include "finetune" in its allowed_use.
+   */
   secrets?: Array<string> | undefined;
 };
 

package/src/models/components/metrics.ts

@@ -12,11 +12,10 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  * Live serving metrics for a deployment.
  */
 export type Metrics = {
-  acceleratorMemoryUsedMb: number;
   /**
-   * 0.0–1.0 across replicas
+   * 0.0–1.0 serving-engine KV-cache usage averaged across Ready replicas
    */
-  acceleratorUtilization: number;
+  kvCacheUtilization: number;
   /**
    * Requests waiting for a free replica
    */
@@ -28,23 +27,20 @@ export type Metrics = {
 /** @internal */
 export const Metrics$inboundSchema: z.ZodType<Metrics, z.ZodTypeDef, unknown> =
   z.object({
-    accelerator_memory_used_mb: z.number().int(),
-    accelerator_utilization: z.number(),
+    kv_cache_utilization: z.number(),
     queue_backlog: z.number().int(),
     replicas: z.number().int(),
     requests_per_second: z.number(),
   }).transform((v) => {
     return remap$(v, {
-      "accelerator_memory_used_mb": "acceleratorMemoryUsedMb",
-      "accelerator_utilization": "acceleratorUtilization",
+      "kv_cache_utilization": "kvCacheUtilization",
       "queue_backlog": "queueBacklog",
       "requests_per_second": "requestsPerSecond",
     });
   });
 /** @internal */
 export type Metrics$Outbound = {
-  accelerator_memory_used_mb: number;
-  accelerator_utilization: number;
+  kv_cache_utilization: number;
   queue_backlog: number;
   replicas: number;
   requests_per_second: number;
@@ -56,15 +52,13 @@ export const Metrics$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   Metrics
 > = z.object({
-  acceleratorMemoryUsedMb: z.number().int(),
-  acceleratorUtilization: z.number(),
+  kvCacheUtilization: z.number(),
   queueBacklog: z.number().int(),
   replicas: z.number().int(),
   requestsPerSecond: z.number(),
 }).transform((v) => {
   return remap$(v, {
-    acceleratorMemoryUsedMb: "accelerator_memory_used_mb",
-    acceleratorUtilization: "accelerator_utilization",
+    kvCacheUtilization: "kv_cache_utilization",
     queueBacklog: "queue_backlog",
     requestsPerSecond: "requests_per_second",
   });

package/src/models/components/model.ts

@@ -13,6 +13,10 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  */
 export type Model = {
   createdAt: Date;
+  /**
+   * Managed runtime recipes that can serve this model one-click; empty means the model is not deployable via a managed runtime (preflight signal, not a create-time error)
+   */
+  deployableRuntimes: Array<string>;
   id: string;
   name: string;
   revision?: string | null | undefined;
@@ -25,6 +29,7 @@ export const Model$inboundSchema: z.ZodType<Model, z.ZodTypeDef, unknown> = z
     created_at: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),
+    deployable_runtimes: z.array(z.string()),
     id: z.string(),
     name: z.string(),
     revision: z.nullable(z.string()).optional(),
@@ -32,11 +37,13 @@ export const Model$inboundSchema: z.ZodType<Model, z.ZodTypeDef, unknown> = z
   }).transform((v) => {
     return remap$(v, {
       "created_at": "createdAt",
+      "deployable_runtimes": "deployableRuntimes",
     });
   });
 /** @internal */
 export type Model$Outbound = {
   created_at: string;
+  deployable_runtimes: Array<string>;
   id: string;
   name: string;
   revision?: string | null | undefined;
@@ -50,6 +57,7 @@ export const Model$outboundSchema: z.ZodType<
   Model
 > = z.object({
   createdAt: z.date().transform(v => v.toISOString()),
+  deployableRuntimes: z.array(z.string()),
   id: z.string(),
   name: z.string(),
   revision: z.nullable(z.string()).optional(),
@@ -57,6 +65,7 @@ export const Model$outboundSchema: z.ZodType<
 }).transform((v) => {
   return remap$(v, {
     createdAt: "created_at",
+    deployableRuntimes: "deployable_runtimes",
   });
 });
 

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/components/secret.ts

@@ -5,13 +5,24 @@
 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";
 
+export const AllowedUse = {
+  Finetune: "finetune",
+  Serving: "serving",
+} as const;
+export type AllowedUse = ClosedEnum<typeof AllowedUse>;
+
 /**
  * A secret. Only key names are ever returned, never values.
  */
 export type Secret = {
+  /**
+   * Products that may resolve this secret into a workload environment
+   */
+  allowedUse: Array<AllowedUse>;
   createdAt: Date;
   id: string;
   /**
@@ -21,9 +32,17 @@ export type Secret = {
   name: string;
 };
 
+/** @internal */
+export const AllowedUse$inboundSchema: z.ZodNativeEnum<typeof AllowedUse> = z
+  .nativeEnum(AllowedUse);
+/** @internal */
+export const AllowedUse$outboundSchema: z.ZodNativeEnum<typeof AllowedUse> =
+  AllowedUse$inboundSchema;
+
 /** @internal */
 export const Secret$inboundSchema: z.ZodType<Secret, z.ZodTypeDef, unknown> = z
   .object({
+    allowed_use: z.array(AllowedUse$inboundSchema),
     created_at: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),
@@ -32,11 +51,13 @@ export const Secret$inboundSchema: z.ZodType<Secret, z.ZodTypeDef, unknown> = z
     name: z.string(),
   }).transform((v) => {
     return remap$(v, {
+      "allowed_use": "allowedUse",
       "created_at": "createdAt",
     });
   });
 /** @internal */
 export type Secret$Outbound = {
+  allowed_use: Array<string>;
   created_at: string;
   id: string;
   keys: Array<string>;
@@ -49,12 +70,14 @@ export const Secret$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   Secret
 > = z.object({
+  allowedUse: z.array(AllowedUse$outboundSchema),
   createdAt: z.date().transform(v => v.toISOString()),
   id: z.string(),
   keys: z.array(z.string()),
   name: z.string(),
 }).transform((v) => {
   return remap$(v, {
+    allowedUse: "allowed_use",
     createdAt: "created_at",
   });
 });

package/src/models/components/secretcreate.ts

@@ -3,14 +3,26 @@
  */
 
 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";
 
+export const SecretCreateAllowedUse = {
+  Finetune: "finetune",
+  Serving: "serving",
+} as const;
+export type SecretCreateAllowedUse = ClosedEnum<typeof SecretCreateAllowedUse>;
+
 /**
  * Create a secret. Values are write-only and never returned.
  */
 export type SecretCreate = {
+  /**
+   * Products that may resolve this secret into a workload environment. Defaults to both when omitted.
+   */
+  allowedUse?: Array<SecretCreateAllowedUse> | undefined;
   /**
    * Key/value pairs injected as env vars
    */
@@ -18,17 +30,32 @@ export type SecretCreate = {
   name: string;
 };
 
+/** @internal */
+export const SecretCreateAllowedUse$inboundSchema: z.ZodNativeEnum<
+  typeof SecretCreateAllowedUse
+> = z.nativeEnum(SecretCreateAllowedUse);
+/** @internal */
+export const SecretCreateAllowedUse$outboundSchema: z.ZodNativeEnum<
+  typeof SecretCreateAllowedUse
+> = SecretCreateAllowedUse$inboundSchema;
+
 /** @internal */
 export const SecretCreate$inboundSchema: z.ZodType<
   SecretCreate,
   z.ZodTypeDef,
   unknown
 > = z.object({
+  allowed_use: z.array(SecretCreateAllowedUse$inboundSchema).optional(),
   data: z.record(z.string()),
   name: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "allowed_use": "allowedUse",
+  });
 });
 /** @internal */
 export type SecretCreate$Outbound = {
+  allowed_use?: Array<string> | undefined;
   data: { [k: string]: string };
   name: string;
 };
@@ -39,8 +66,13 @@ export const SecretCreate$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   SecretCreate
 > = z.object({
+  allowedUse: z.array(SecretCreateAllowedUse$outboundSchema).optional(),
   data: z.record(z.string()),
   name: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    allowedUse: "allowed_use",
+  });
 });
 
 export function secretCreateToJSON(secretCreate: SecretCreate): string {

package/src/models/components/spendsummary.ts

@@ -21,13 +21,13 @@ import {
 } from "./spendwindow.js";
 
 /**
- * Aggregate spend computed as price × runtime overlap with the window; derived on read, never stored.
+ * Aggregate spend computed as price × runtime overlap with the window; derived on read, never stored. The deployments group is present only on clusters where the deployments product is available; fine-tune-only clusters return the finetune group alone.
  */
 export type SpendSummary = {
   /**
    * Aggregate spend for one resource class.
    */
-  deployments: SpendGroup;
+  deployments?: SpendGroup | undefined;
   /**
    * Aggregate spend for one resource class.
    */
@@ -48,7 +48,7 @@ export const SpendSummary$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  deployments: SpendGroup$inboundSchema,
+  deployments: SpendGroup$inboundSchema.optional(),
   finetune: SpendGroup$inboundSchema,
   total_usd: z.number(),
   window: SpendWindow$inboundSchema,
@@ -59,7 +59,7 @@ export const SpendSummary$inboundSchema: z.ZodType<
 });
 /** @internal */
 export type SpendSummary$Outbound = {
-  deployments: SpendGroup$Outbound;
+  deployments?: SpendGroup$Outbound | undefined;
   finetune: SpendGroup$Outbound;
   total_usd: number;
   window: SpendWindow$Outbound;
@@ -71,7 +71,7 @@ export const SpendSummary$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   SpendSummary
 > = z.object({
-  deployments: SpendGroup$outboundSchema,
+  deployments: SpendGroup$outboundSchema.optional(),
   finetune: SpendGroup$outboundSchema,
   totalUsd: z.number(),
   window: SpendWindow$outboundSchema,

package/src/models/components/volume.ts

@@ -5,9 +5,22 @@
 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";
 
+/**
+ * deleting while asynchronous artifact removal is still in progress
+ */
+export const VolumeStatus = {
+  Active: "active",
+  Deleting: "deleting",
+} as const;
+/**
+ * deleting while asynchronous artifact removal is still in progress
+ */
+export type VolumeStatus = ClosedEnum<typeof VolumeStatus>;
+
 /**
  * A persistent volume.
  */
@@ -16,8 +29,23 @@ export type Volume = {
   id: string;
   name: string;
   sizeGb?: number | null | undefined;
+  /**
+   * deleting while asynchronous artifact removal is still in progress
+   */
+  status: VolumeStatus;
+  /**
+   * Bytes of artifacts (logs and checkpoints) currently accounted to the volume
+   */
+  usedBytes: number;
 };
 
+/** @internal */
+export const VolumeStatus$inboundSchema: z.ZodNativeEnum<typeof VolumeStatus> =
+  z.nativeEnum(VolumeStatus);
+/** @internal */
+export const VolumeStatus$outboundSchema: z.ZodNativeEnum<typeof VolumeStatus> =
+  VolumeStatus$inboundSchema;
+
 /** @internal */
 export const Volume$inboundSchema: z.ZodType<Volume, z.ZodTypeDef, unknown> = z
   .object({
@@ -27,10 +55,13 @@ export const Volume$inboundSchema: z.ZodType<Volume, z.ZodTypeDef, unknown> = z
     id: z.string(),
     name: z.string(),
     size_gb: z.nullable(z.number().int()).optional(),
+    status: VolumeStatus$inboundSchema,
+    used_bytes: z.number().int(),
   }).transform((v) => {
     return remap$(v, {
       "created_at": "createdAt",
       "size_gb": "sizeGb",
+      "used_bytes": "usedBytes",
     });
   });
 /** @internal */
@@ -39,6 +70,8 @@ export type Volume$Outbound = {
   id: string;
   name: string;
   size_gb?: number | null | undefined;
+  status: string;
+  used_bytes: number;
 };
 
 /** @internal */
@@ -51,10 +84,13 @@ export const Volume$outboundSchema: z.ZodType<
   id: z.string(),
   name: z.string(),
   sizeGb: z.nullable(z.number().int()).optional(),
+  status: VolumeStatus$outboundSchema,
+  usedBytes: z.number().int(),
 }).transform((v) => {
   return remap$(v, {
     createdAt: "created_at",
     sizeGb: "size_gb",
+    usedBytes: "used_bytes",
   });
 });
 

package/src/models/operations/getsecret.ts

@@ -0,0 +1,69 @@
+/*
+ * 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 GetSecretRequest = {
+  secretId: string;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const GetSecretRequest$inboundSchema: z.ZodType<
+  GetSecretRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  secret_id: z.string(),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "secret_id": "secretId",
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type GetSecretRequest$Outbound = {
+  secret_id: string;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const GetSecretRequest$outboundSchema: z.ZodType<
+  GetSecretRequest$Outbound,
+  z.ZodTypeDef,
+  GetSecretRequest
+> = z.object({
+  secretId: z.string(),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    secretId: "secret_id",
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function getSecretRequestToJSON(
+  getSecretRequest: GetSecretRequest,
+): string {
+  return JSON.stringify(
+    GetSecretRequest$outboundSchema.parse(getSecretRequest),
+  );
+}
+export function getSecretRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<GetSecretRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetSecretRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetSecretRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -163,6 +163,7 @@ export * from "./getresponse.js";
 export * from "./getresponsefeedback.js";
 export * from "./getresponsesusage.js";
 export * from "./getsandboxusage.js";
+export * from "./getsecret.js";
 export * from "./getserviceaccount.js";
 export * from "./getservingmodel.js";
 export * from "./getservingorganizationdeletion.js";

package/src/react-query/index.ts

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