@meetkai/mka1 0.49.16 → 0.49.18

package/src/models/components/finetunejob.ts

@@ -22,18 +22,30 @@ export type FinetuneJobStatus = ClosedEnum<typeof FinetuneJobStatus>;
  * A fine-tune job.
  */
 export type FinetuneJob = {
-  id: string;
-  name: string;
-  status: FinetuneJobStatus;
   baseModel: string;
+  checkpoints?: Array<string> | undefined;
+  createdAt: Date;
+  finishedAt?: Date | null | undefined;
+  /**
+   * Checkpoint this job warm-started from, if any
+   */
+  fromCheckpoint?: string | null | undefined;
+  id: string;
   method: string;
+  name: string;
+  /**
+   * ID of the model registered from this job's output weights on success (see Serving Models); pass it to Create Deployment to serve
+   */
+  outputModel?: string | null | undefined;
+  /**
+   * Job whose checkpoint this job warm-started from (derived from from_checkpoint); jobs may share a parent, so lineage forms a tree
+   */
+  parentJobId?: string | null | undefined;
   /**
    * 0.0–1.0 if known
    */
   progress?: number | null | undefined;
-  checkpoints?: Array<string> | undefined;
-  createdAt: Date;
-  finishedAt?: Date | null | undefined;
+  status: FinetuneJobStatus;
 };
 
 /** @internal */
@@ -51,35 +63,44 @@ export const FinetuneJob$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  id: z.string(),
-  name: z.string(),
-  status: FinetuneJobStatus$inboundSchema,
   base_model: z.string(),
-  method: z.string(),
-  progress: z.nullable(z.number()).optional(),
   checkpoints: z.array(z.string()).optional(),
   created_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   finished_at: z.nullable(
     z.string().datetime({ offset: true }).transform(v => new Date(v)),
   ).optional(),
+  from_checkpoint: z.nullable(z.string()).optional(),
+  id: z.string(),
+  method: z.string(),
+  name: z.string(),
+  output_model: z.nullable(z.string()).optional(),
+  parent_job_id: z.nullable(z.string()).optional(),
+  progress: z.nullable(z.number()).optional(),
+  status: FinetuneJobStatus$inboundSchema,
 }).transform((v) => {
   return remap$(v, {
     "base_model": "baseModel",
     "created_at": "createdAt",
     "finished_at": "finishedAt",
+    "from_checkpoint": "fromCheckpoint",
+    "output_model": "outputModel",
+    "parent_job_id": "parentJobId",
   });
 });
 /** @internal */
 export type FinetuneJob$Outbound = {
-  id: string;
-  name: string;
-  status: string;
   base_model: string;
-  method: string;
-  progress?: number | null | undefined;
   checkpoints?: Array<string> | undefined;
   created_at: string;
   finished_at?: string | null | undefined;
+  from_checkpoint?: string | null | undefined;
+  id: string;
+  method: string;
+  name: string;
+  output_model?: string | null | undefined;
+  parent_job_id?: string | null | undefined;
+  progress?: number | null | undefined;
+  status: string;
 };
 
 /** @internal */
@@ -88,20 +109,26 @@ export const FinetuneJob$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   FinetuneJob
 > = z.object({
-  id: z.string(),
-  name: z.string(),
-  status: FinetuneJobStatus$outboundSchema,
   baseModel: z.string(),
-  method: z.string(),
-  progress: z.nullable(z.number()).optional(),
   checkpoints: z.array(z.string()).optional(),
   createdAt: z.date().transform(v => v.toISOString()),
   finishedAt: z.nullable(z.date().transform(v => v.toISOString())).optional(),
+  fromCheckpoint: z.nullable(z.string()).optional(),
+  id: z.string(),
+  method: z.string(),
+  name: z.string(),
+  outputModel: z.nullable(z.string()).optional(),
+  parentJobId: z.nullable(z.string()).optional(),
+  progress: z.nullable(z.number()).optional(),
+  status: FinetuneJobStatus$outboundSchema,
 }).transform((v) => {
   return remap$(v, {
     baseModel: "base_model",
     createdAt: "created_at",
     finishedAt: "finished_at",
+    fromCheckpoint: "from_checkpoint",
+    outputModel: "output_model",
+    parentJobId: "parent_job_id",
   });
 });
 

package/src/models/components/finetunejobcreate.ts

@@ -28,13 +28,6 @@ export type FinetuneJobCreateMethod = ClosedEnum<
  * Submit a fine-tune.
  */
 export type FinetuneJobCreate = {
-  name: string;
-  baseModel: string;
-  method?: FinetuneJobCreateMethod | undefined;
-  /**
-   * Volume path or Hugging Face dataset id
-   */
-  dataset: string;
   /**
    * A hardware accelerator request — GPU, NPU, TPU, or similar.
    *
@@ -44,15 +37,29 @@ export type FinetuneJobCreate = {
    */
   accelerator: AcceleratorSpec;
   /**
-   * Volume where checkpoints are written
+   * Required unless from_checkpoint is set (then inherited from the checkpoint's parent job; supplying a contradicting value is rejected)
    */
-  outputVolume: string;
+  baseModel?: string | null | undefined;
+  /**
+   * Volume path or Hugging Face dataset id
+   */
+  dataset: string;
+  /**
+   * Checkpoint to warm-start from: a checkpoint ID (see List output checkpoints) or a volume path. base_model and method are inherited from the checkpoint's parent job — supplying contradicting values is rejected. Hyperparameters may be overridden freely. The new job writes checkpoints under its own prefix and records parent_job_id for lineage.
+   */
+  fromCheckpoint?: string | null | undefined;
+  hyperparameters?: { [k: string]: any } | undefined;
   /**
    * Name/ID of a built image; defaults to a stock trainer
    */
   image?: string | null | undefined;
+  method?: FinetuneJobCreateMethod | undefined;
+  name: string;
+  /**
+   * Volume where checkpoints are written
+   */
+  outputVolume: string;
   secrets?: Array<string> | undefined;
-  hyperparameters?: { [k: string]: any } | undefined;
 };
 
 /** @internal */
@@ -70,32 +77,35 @@ export const FinetuneJobCreate$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  name: z.string(),
-  base_model: z.string(),
-  method: FinetuneJobCreateMethod$inboundSchema.default("lora"),
-  dataset: z.string(),
   accelerator: AcceleratorSpec$inboundSchema,
-  output_volume: z.string(),
+  base_model: z.nullable(z.string()).optional(),
+  dataset: z.string(),
+  from_checkpoint: z.nullable(z.string()).optional(),
+  hyperparameters: z.record(z.any()).optional(),
   image: z.nullable(z.string()).optional(),
+  method: FinetuneJobCreateMethod$inboundSchema.default("lora"),
+  name: z.string(),
+  output_volume: z.string(),
   secrets: z.array(z.string()).optional(),
-  hyperparameters: z.record(z.any()).optional(),
 }).transform((v) => {
   return remap$(v, {
     "base_model": "baseModel",
+    "from_checkpoint": "fromCheckpoint",
     "output_volume": "outputVolume",
   });
 });
 /** @internal */
 export type FinetuneJobCreate$Outbound = {
-  name: string;
-  base_model: string;
-  method: string;
-  dataset: string;
   accelerator: AcceleratorSpec$Outbound;
-  output_volume: string;
+  base_model?: string | null | undefined;
+  dataset: string;
+  from_checkpoint?: string | null | undefined;
+  hyperparameters?: { [k: string]: any } | undefined;
   image?: string | null | undefined;
+  method: string;
+  name: string;
+  output_volume: string;
   secrets?: Array<string> | undefined;
-  hyperparameters?: { [k: string]: any } | undefined;
 };
 
 /** @internal */
@@ -104,18 +114,20 @@ export const FinetuneJobCreate$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   FinetuneJobCreate
 > = z.object({
-  name: z.string(),
-  baseModel: z.string(),
-  method: FinetuneJobCreateMethod$outboundSchema.default("lora"),
-  dataset: z.string(),
   accelerator: AcceleratorSpec$outboundSchema,
-  outputVolume: z.string(),
+  baseModel: z.nullable(z.string()).optional(),
+  dataset: z.string(),
+  fromCheckpoint: z.nullable(z.string()).optional(),
+  hyperparameters: z.record(z.any()).optional(),
   image: z.nullable(z.string()).optional(),
+  method: FinetuneJobCreateMethod$outboundSchema.default("lora"),
+  name: z.string(),
+  outputVolume: z.string(),
   secrets: z.array(z.string()).optional(),
-  hyperparameters: z.record(z.any()).optional(),
 }).transform((v) => {
   return remap$(v, {
     baseModel: "base_model",
+    fromCheckpoint: "from_checkpoint",
     outputVolume: "output_volume",
   });
 });

package/src/models/components/image.ts

@@ -26,14 +26,14 @@ export type ImageStatus = ClosedEnum<typeof ImageStatus>;
  * A built (or building) image.
  */
 export type Image = {
+  createdAt: Date;
   id: string;
   name: string;
-  status: ImageStatus;
   /**
    * Declarative recipe for a container image.
    */
   spec: ImageSpec;
-  createdAt: Date;
+  status: ImageStatus;
 };
 
 /** @internal */
@@ -46,13 +46,13 @@ export const ImageStatus$outboundSchema: z.ZodNativeEnum<typeof ImageStatus> =
 /** @internal */
 export const Image$inboundSchema: z.ZodType<Image, z.ZodTypeDef, unknown> = z
   .object({
-    id: z.string(),
-    name: z.string(),
-    status: ImageStatus$inboundSchema,
-    spec: ImageSpec$inboundSchema,
     created_at: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),
+    id: z.string(),
+    name: z.string(),
+    spec: ImageSpec$inboundSchema,
+    status: ImageStatus$inboundSchema,
   }).transform((v) => {
     return remap$(v, {
       "created_at": "createdAt",
@@ -60,11 +60,11 @@ export const Image$inboundSchema: z.ZodType<Image, z.ZodTypeDef, unknown> = z
   });
 /** @internal */
 export type Image$Outbound = {
+  created_at: string;
   id: string;
   name: string;
-  status: string;
   spec: ImageSpec$Outbound;
-  created_at: string;
+  status: string;
 };
 
 /** @internal */
@@ -73,11 +73,11 @@ export const Image$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   Image
 > = z.object({
+  createdAt: z.date().transform(v => v.toISOString()),
   id: z.string(),
   name: z.string(),
-  status: ImageStatus$outboundSchema,
   spec: ImageSpec$outboundSchema,
-  createdAt: z.date().transform(v => v.toISOString()),
+  status: ImageStatus$outboundSchema,
 }).transform((v) => {
   return remap$(v, {
     createdAt: "created_at",

package/src/models/components/imagespec.ts

@@ -12,18 +12,18 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  * Declarative recipe for a container image.
  */
 export type ImageSpec = {
+  aptPackages?: Array<string> | undefined;
   /**
    * Base OCI image to build on
    */
   baseImage?: string | undefined;
-  pythonVersion?: string | undefined;
-  aptPackages?: Array<string> | undefined;
-  pipPackages?: Array<string> | undefined;
-  env?: { [k: string]: string } | undefined;
   /**
    * Shell commands run at build time
    */
   commands?: Array<string> | undefined;
+  env?: { [k: string]: string } | undefined;
+  pipPackages?: Array<string> | undefined;
+  pythonVersion?: string | undefined;
 };
 
 /** @internal */
@@ -32,28 +32,28 @@ export const ImageSpec$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  base_image: z.string().default("nvidia/cuda:12.9.0-devel-ubuntu22.04"),
-  python_version: z.string().default("3.12"),
   apt_packages: z.array(z.string()).optional(),
-  pip_packages: z.array(z.string()).optional(),
-  env: z.record(z.string()).optional(),
+  base_image: z.string().default("nvidia/cuda:12.9.0-devel-ubuntu22.04"),
   commands: z.array(z.string()).optional(),
+  env: z.record(z.string()).optional(),
+  pip_packages: z.array(z.string()).optional(),
+  python_version: z.string().default("3.12"),
 }).transform((v) => {
   return remap$(v, {
-    "base_image": "baseImage",
-    "python_version": "pythonVersion",
     "apt_packages": "aptPackages",
+    "base_image": "baseImage",
     "pip_packages": "pipPackages",
+    "python_version": "pythonVersion",
   });
 });
 /** @internal */
 export type ImageSpec$Outbound = {
-  base_image: string;
-  python_version: string;
   apt_packages?: Array<string> | undefined;
-  pip_packages?: Array<string> | undefined;
-  env?: { [k: string]: string } | undefined;
+  base_image: string;
   commands?: Array<string> | undefined;
+  env?: { [k: string]: string } | undefined;
+  pip_packages?: Array<string> | undefined;
+  python_version: string;
 };
 
 /** @internal */
@@ -62,18 +62,18 @@ export const ImageSpec$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   ImageSpec
 > = z.object({
-  baseImage: z.string().default("nvidia/cuda:12.9.0-devel-ubuntu22.04"),
-  pythonVersion: z.string().default("3.12"),
   aptPackages: z.array(z.string()).optional(),
-  pipPackages: z.array(z.string()).optional(),
-  env: z.record(z.string()).optional(),
+  baseImage: z.string().default("nvidia/cuda:12.9.0-devel-ubuntu22.04"),
   commands: z.array(z.string()).optional(),
+  env: z.record(z.string()).optional(),
+  pipPackages: z.array(z.string()).optional(),
+  pythonVersion: z.string().default("3.12"),
 }).transform((v) => {
   return remap$(v, {
-    baseImage: "base_image",
-    pythonVersion: "python_version",
     aptPackages: "apt_packages",
+    baseImage: "base_image",
     pipPackages: "pip_packages",
+    pythonVersion: "python_version",
   });
 });
 

package/src/models/components/index.ts

@@ -136,6 +136,7 @@ export * from "./deletepromptresponse.js";
 export * from "./deleteresponseobject.js";
 export * from "./deployment.js";
 export * from "./deploymentcreate.js";
+export * from "./deploymentendpoint.js";
 export * from "./deploymentrollbackrequest.js";
 export * from "./deploymentupdate.js";
 export * from "./deploystrategy.js";

package/src/models/components/jobevent.ts

@@ -11,9 +11,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  * An entry in a job's status timeline.
  */
 export type JobEvent = {
+  message: string;
   timestamp: Date;
   type: string;
-  message: string;
 };
 
 /** @internal */
@@ -22,15 +22,15 @@ export const JobEvent$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  message: z.string(),
   timestamp: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   type: z.string(),
-  message: z.string(),
 });
 /** @internal */
 export type JobEvent$Outbound = {
+  message: string;
   timestamp: string;
   type: string;
-  message: string;
 };
 
 /** @internal */
@@ -39,9 +39,9 @@ export const JobEvent$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   JobEvent
 > = z.object({
+  message: z.string(),
   timestamp: z.date().transform(v => v.toISOString()),
   type: z.string(),
-  message: z.string(),
 });
 
 export function jobEventToJSON(jobEvent: JobEvent): string {

package/src/models/components/logline.ts

@@ -11,28 +11,28 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  * One line of logs.
  */
 export type LogLine = {
-  timestamp: Date;
+  message: string;
   /**
    * Replica / container the line came from
    */
   source?: string | null | undefined;
-  message: string;
+  timestamp: Date;
 };
 
 /** @internal */
 export const LogLine$inboundSchema: z.ZodType<LogLine, z.ZodTypeDef, unknown> =
   z.object({
+    message: z.string(),
+    source: z.nullable(z.string()).optional(),
     timestamp: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),
-    source: z.nullable(z.string()).optional(),
-    message: z.string(),
   });
 /** @internal */
 export type LogLine$Outbound = {
-  timestamp: string;
-  source?: string | null | undefined;
   message: string;
+  source?: string | null | undefined;
+  timestamp: string;
 };
 
 /** @internal */
@@ -41,9 +41,9 @@ export const LogLine$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   LogLine
 > = z.object({
-  timestamp: z.date().transform(v => v.toISOString()),
-  source: z.nullable(z.string()).optional(),
   message: z.string(),
+  source: z.nullable(z.string()).optional(),
+  timestamp: z.date().transform(v => v.toISOString()),
 });
 
 export function logLineToJSON(logLine: LogLine): string {

package/src/models/components/metrics.ts

@@ -12,41 +12,41 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  * Live serving metrics for a deployment.
  */
 export type Metrics = {
-  replicas: number;
-  /**
-   * Requests waiting for a free replica
-   */
-  queueBacklog: number;
+  acceleratorMemoryUsedMb: number;
   /**
    * 0.0–1.0 across replicas
    */
   acceleratorUtilization: number;
-  acceleratorMemoryUsedMb: number;
+  /**
+   * Requests waiting for a free replica
+   */
+  queueBacklog: number;
+  replicas: number;
   requestsPerSecond: number;
 };
 
 /** @internal */
 export const Metrics$inboundSchema: z.ZodType<Metrics, z.ZodTypeDef, unknown> =
   z.object({
-    replicas: z.number().int(),
-    queue_backlog: z.number().int(),
-    accelerator_utilization: z.number(),
     accelerator_memory_used_mb: z.number().int(),
+    accelerator_utilization: z.number(),
+    queue_backlog: z.number().int(),
+    replicas: z.number().int(),
     requests_per_second: z.number(),
   }).transform((v) => {
     return remap$(v, {
-      "queue_backlog": "queueBacklog",
-      "accelerator_utilization": "acceleratorUtilization",
       "accelerator_memory_used_mb": "acceleratorMemoryUsedMb",
+      "accelerator_utilization": "acceleratorUtilization",
+      "queue_backlog": "queueBacklog",
       "requests_per_second": "requestsPerSecond",
     });
   });
 /** @internal */
 export type Metrics$Outbound = {
-  replicas: number;
-  queue_backlog: number;
-  accelerator_utilization: number;
   accelerator_memory_used_mb: number;
+  accelerator_utilization: number;
+  queue_backlog: number;
+  replicas: number;
   requests_per_second: number;
 };
 
@@ -56,16 +56,16 @@ export const Metrics$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   Metrics
 > = z.object({
-  replicas: z.number().int(),
-  queueBacklog: z.number().int(),
-  acceleratorUtilization: z.number(),
   acceleratorMemoryUsedMb: z.number().int(),
+  acceleratorUtilization: z.number(),
+  queueBacklog: z.number().int(),
+  replicas: z.number().int(),
   requestsPerSecond: z.number(),
 }).transform((v) => {
   return remap$(v, {
-    queueBacklog: "queue_backlog",
-    acceleratorUtilization: "accelerator_utilization",
     acceleratorMemoryUsedMb: "accelerator_memory_used_mb",
+    acceleratorUtilization: "accelerator_utilization",
+    queueBacklog: "queue_backlog",
     requestsPerSecond: "requests_per_second",
   });
 });

package/src/models/components/model.ts

@@ -12,23 +12,23 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  * A registered model.
  */
 export type Model = {
+  createdAt: Date;
   id: string;
   name: string;
-  source: string;
   revision?: string | null | undefined;
-  createdAt: Date;
+  source: string;
 };
 
 /** @internal */
 export const Model$inboundSchema: z.ZodType<Model, z.ZodTypeDef, unknown> = z
   .object({
-    id: z.string(),
-    name: z.string(),
-    source: z.string(),
-    revision: z.nullable(z.string()).optional(),
     created_at: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),
+    id: z.string(),
+    name: z.string(),
+    revision: z.nullable(z.string()).optional(),
+    source: z.string(),
   }).transform((v) => {
     return remap$(v, {
       "created_at": "createdAt",
@@ -36,11 +36,11 @@ export const Model$inboundSchema: z.ZodType<Model, z.ZodTypeDef, unknown> = z
   });
 /** @internal */
 export type Model$Outbound = {
+  created_at: string;
   id: string;
   name: string;
-  source: string;
   revision?: string | null | undefined;
-  created_at: string;
+  source: string;
 };
 
 /** @internal */
@@ -49,11 +49,11 @@ export const Model$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   Model
 > = z.object({
+  createdAt: z.date().transform(v => v.toISOString()),
   id: z.string(),
   name: z.string(),
-  source: z.string(),
   revision: z.nullable(z.string()).optional(),
-  createdAt: z.date().transform(v => v.toISOString()),
+  source: z.string(),
 }).transform((v) => {
   return remap$(v, {
     createdAt: "created_at",

package/src/models/components/modelregister.ts

@@ -12,11 +12,11 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  */
 export type ModelRegister = {
   name: string;
+  revision?: string | null | undefined;
   /**
    * Hugging Face id or volume path
    */
   source: string;
-  revision?: string | null | undefined;
 };
 
 /** @internal */
@@ -26,14 +26,14 @@ export const ModelRegister$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   name: z.string(),
-  source: z.string(),
   revision: z.nullable(z.string()).optional(),
+  source: z.string(),
 });
 /** @internal */
 export type ModelRegister$Outbound = {
   name: string;
-  source: string;
   revision?: string | null | undefined;
+  source: string;
 };
 
 /** @internal */
@@ -43,8 +43,8 @@ export const ModelRegister$outboundSchema: z.ZodType<
   ModelRegister
 > = z.object({
   name: z.string(),
-  source: z.string(),
   revision: z.nullable(z.string()).optional(),
+  source: z.string(),
 });
 
 export function modelRegisterToJSON(modelRegister: ModelRegister): string {