@mistralai/mistralai 2.4.0 → 2.5.0

package/src/funcs/fineTuningJobsList.ts

@@ -1,183 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: ff094245e1ab
- */
-
-import { MistralCore } from "../core.js";
-import { encodeFormQuery } 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 { MistralError } from "../models/errors/mistralerror.js";
-import { ResponseValidationError } from "../models/errors/responsevalidationerror.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";
-
-/**
- * Get Fine Tuning Jobs
- *
- * @remarks
- * Get a list of fine-tuning jobs for your organization and user.
- */
-export function fineTuningJobsList(
-  client: MistralCore,
-  request?:
-    | operations.JobsApiRoutesFineTuningGetFineTuningJobsRequest
-    | undefined,
-  options?: RequestOptions,
-): APIPromise<
-  Result<
-    components.ListFineTuningJobsResponse,
-    | MistralError
-    | ResponseValidationError
-    | ConnectionError
-    | RequestAbortedError
-    | RequestTimeoutError
-    | InvalidRequestError
-    | UnexpectedClientError
-    | SDKValidationError
-  >
-> {
-  return new APIPromise($do(
-    client,
-    request,
-    options,
-  ));
-}
-
-async function $do(
-  client: MistralCore,
-  request?:
-    | operations.JobsApiRoutesFineTuningGetFineTuningJobsRequest
-    | undefined,
-  options?: RequestOptions,
-): Promise<
-  [
-    Result<
-      components.ListFineTuningJobsResponse,
-      | MistralError
-      | ResponseValidationError
-      | ConnectionError
-      | RequestAbortedError
-      | RequestTimeoutError
-      | InvalidRequestError
-      | UnexpectedClientError
-      | SDKValidationError
-    >,
-    APICall,
-  ]
-> {
-  const parsed = safeParse(
-    request,
-    (value) =>
-      operations.JobsApiRoutesFineTuningGetFineTuningJobsRequest$outboundSchema
-        .optional().parse(value),
-    "Input validation failed",
-  );
-  if (!parsed.ok) {
-    return [parsed, { status: "invalid" }];
-  }
-  const payload = parsed.value;
-  const body = null;
-
-  const path = pathToFunc("/v1/fine_tuning/jobs")();
-
-  const query = encodeFormQuery({
-    "created_after": payload?.created_after,
-    "created_before": payload?.created_before,
-    "created_by_me": payload?.created_by_me,
-    "model": payload?.model,
-    "page": payload?.page,
-    "page_size": payload?.page_size,
-    "status": payload?.status,
-    "suffix": payload?.suffix,
-    "wandb_name": payload?.wandb_name,
-    "wandb_project": payload?.wandb_project,
-  });
-
-  const headers = new Headers(compactMap({
-    Accept: "application/json",
-  }));
-
-  const secConfig = await extractSecurity(client._options.apiKey);
-  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
-  const requestSecurity = resolveGlobalSecurity(securityInput);
-
-  const context = {
-    options: client._options,
-    baseURL: options?.serverURL ?? client._baseURL ?? "",
-    operationID: "jobs_api_routes_fine_tuning_get_fine_tuning_jobs",
-    oAuth2Scopes: null,
-
-    resolvedSecurity: requestSecurity,
-
-    securitySource: client._options.apiKey,
-    retryConfig: options?.retries
-      || client._options.retryConfig
-      || { strategy: "none" },
-    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
-  };
-
-  const requestRes = client._createRequest(context, {
-    security: requestSecurity,
-    method: "GET",
-    baseURL: options?.serverURL,
-    path: path,
-    headers: headers,
-    query: query,
-    body: body,
-    userAgent: client._options.userAgent,
-    timeoutMs: options?.timeoutMs || client._options.timeoutMs || 300000,
-  }, 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 [result] = await M.match<
-    components.ListFineTuningJobsResponse,
-    | MistralError
-    | ResponseValidationError
-    | ConnectionError
-    | RequestAbortedError
-    | RequestTimeoutError
-    | InvalidRequestError
-    | UnexpectedClientError
-    | SDKValidationError
-  >(
-    M.json(200, components.ListFineTuningJobsResponse$inboundSchema),
-    M.fail("4XX"),
-    M.fail("5XX"),
-  )(response, req);
-  if (!result.ok) {
-    return [result, { status: "complete", request: req, response }];
-  }
-
-  return [result, { status: "complete", request: req, response }];
-}

package/src/models/components/checkpoint.ts

@@ -1,49 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: 51417fff99a1
- */
-
-import * as z from "zod/v4";
-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 { Metric, Metric$inboundSchema } from "./metric.js";
-
-export type Checkpoint = {
-  /**
-   * Metrics at the step number during the fine-tuning job. Use these metrics to assess if the training is going smoothly (loss should decrease, token accuracy should increase).
-   */
-  metrics: Metric;
-  /**
-   * The step number that the checkpoint was created at.
-   */
-  stepNumber: number;
-  /**
-   * The UNIX timestamp (in seconds) for when the checkpoint was created.
-   */
-  createdAt: number;
-};
-
-/** @internal */
-export const Checkpoint$inboundSchema: z.ZodType<Checkpoint, unknown> = z
-  .object({
-    metrics: Metric$inboundSchema,
-    step_number: z.int(),
-    created_at: z.int(),
-  }).transform((v) => {
-    return remap$(v, {
-      "step_number": "stepNumber",
-      "created_at": "createdAt",
-    });
-  });
-
-export function checkpointFromJSON(
-  jsonString: string,
-): SafeParseResult<Checkpoint, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Checkpoint$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Checkpoint' from JSON`,
-  );
-}

package/src/models/components/classifierfinetuningjob.ts

@@ -1,168 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: 2224f41020d5
- */
-
-import * as z from "zod/v4";
-import { remap as remap$ } from "../../lib/primitives.js";
-import { safeParse } from "../../lib/schemas.js";
-import * as openEnums from "../../types/enums.js";
-import { OpenEnum } from "../../types/enums.js";
-import { Result as SafeParseResult } from "../../types/fp.js";
-import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-import {
-  ClassifierTrainingParameters,
-  ClassifierTrainingParameters$inboundSchema,
-} from "./classifiertrainingparameters.js";
-import { JobMetadata, JobMetadata$inboundSchema } from "./jobmetadata.js";
-import {
-  WandbIntegrationResult,
-  WandbIntegrationResult$inboundSchema,
-} from "./wandbintegrationresult.js";
-
-/**
- * The current status of the fine-tuning job.
- */
-export const ClassifierFineTuningJobStatus = {
-  Queued: "QUEUED",
-  Started: "STARTED",
-  Validating: "VALIDATING",
-  Validated: "VALIDATED",
-  Running: "RUNNING",
-  FailedValidation: "FAILED_VALIDATION",
-  Failed: "FAILED",
-  Success: "SUCCESS",
-  Cancelled: "CANCELLED",
-  CancellationRequested: "CANCELLATION_REQUESTED",
-} as const;
-/**
- * The current status of the fine-tuning job.
- */
-export type ClassifierFineTuningJobStatus = OpenEnum<
-  typeof ClassifierFineTuningJobStatus
->;
-
-export type ClassifierFineTuningJobIntegration = WandbIntegrationResult;
-
-export type ClassifierFineTuningJob = {
-  /**
-   * The ID of the job.
-   */
-  id: string;
-  autoStart: boolean;
-  model: string;
-  /**
-   * The current status of the fine-tuning job.
-   */
-  status: ClassifierFineTuningJobStatus;
-  /**
-   * The UNIX timestamp (in seconds) for when the fine-tuning job was created.
-   */
-  createdAt: number;
-  /**
-   * The UNIX timestamp (in seconds) for when the fine-tuning job was last modified.
-   */
-  modifiedAt: number;
-  /**
-   * A list containing the IDs of uploaded files that contain training data.
-   */
-  trainingFiles: Array<string>;
-  /**
-   * A list containing the IDs of uploaded files that contain validation data.
-   */
-  validationFiles?: Array<string> | null | undefined;
-  /**
-   * The object type of the fine-tuning job.
-   */
-  object: "job";
-  /**
-   * The name of the fine-tuned model that is being created. The value will be `null` if the fine-tuning job is still running.
-   */
-  fineTunedModel?: string | null | undefined;
-  /**
-   * Optional user-provided string inserted into the fine-tuned model name to help identify it. For example, a suffix of `"my-great-model"` produces a name like `ft:open-mistral-7b:abcd1234:20260101:my-great-model:efgh5678`.
-   */
-  suffix?: string | null | undefined;
-  /**
-   * A list of integrations enabled for your fine-tuning job.
-   */
-  integrations?: Array<WandbIntegrationResult> | null | undefined;
-  /**
-   * Total number of tokens trained.
-   */
-  trainedTokens?: number | null | undefined;
-  metadata?: JobMetadata | null | undefined;
-  /**
-   * The type of job (`FT` for fine-tuning).
-   */
-  jobType: "classifier";
-  hyperparameters: ClassifierTrainingParameters;
-};
-
-/** @internal */
-export const ClassifierFineTuningJobStatus$inboundSchema: z.ZodType<
-  ClassifierFineTuningJobStatus,
-  unknown
-> = openEnums.inboundSchema(ClassifierFineTuningJobStatus);
-
-/** @internal */
-export const ClassifierFineTuningJobIntegration$inboundSchema: z.ZodType<
-  ClassifierFineTuningJobIntegration,
-  unknown
-> = WandbIntegrationResult$inboundSchema;
-
-export function classifierFineTuningJobIntegrationFromJSON(
-  jsonString: string,
-): SafeParseResult<ClassifierFineTuningJobIntegration, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) =>
-      ClassifierFineTuningJobIntegration$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'ClassifierFineTuningJobIntegration' from JSON`,
-  );
-}
-
-/** @internal */
-export const ClassifierFineTuningJob$inboundSchema: z.ZodType<
-  ClassifierFineTuningJob,
-  unknown
-> = z.object({
-  id: z.string(),
-  auto_start: z.boolean(),
-  model: z.string(),
-  status: ClassifierFineTuningJobStatus$inboundSchema,
-  created_at: z.int(),
-  modified_at: z.int(),
-  training_files: z.array(z.string()),
-  validation_files: z.nullable(z.array(z.string())).optional(),
-  object: z.literal("job").default("job"),
-  fine_tuned_model: z.nullable(z.string()).optional(),
-  suffix: z.nullable(z.string()).optional(),
-  integrations: z.nullable(z.array(WandbIntegrationResult$inboundSchema))
-    .optional(),
-  trained_tokens: z.nullable(z.int()).optional(),
-  metadata: z.nullable(JobMetadata$inboundSchema).optional(),
-  job_type: z.literal("classifier"),
-  hyperparameters: ClassifierTrainingParameters$inboundSchema,
-}).transform((v) => {
-  return remap$(v, {
-    "auto_start": "autoStart",
-    "created_at": "createdAt",
-    "modified_at": "modifiedAt",
-    "training_files": "trainingFiles",
-    "validation_files": "validationFiles",
-    "fine_tuned_model": "fineTunedModel",
-    "trained_tokens": "trainedTokens",
-    "job_type": "jobType",
-  });
-});
-
-export function classifierFineTuningJobFromJSON(
-  jsonString: string,
-): SafeParseResult<ClassifierFineTuningJob, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => ClassifierFineTuningJob$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'ClassifierFineTuningJob' from JSON`,
-  );
-}

package/src/models/components/classifierfinetuningjobdetails.ts

@@ -1,189 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: 081aa779ef56
- */
-
-import * as z from "zod/v4";
-import { remap as remap$ } from "../../lib/primitives.js";
-import { safeParse } from "../../lib/schemas.js";
-import * as openEnums from "../../types/enums.js";
-import { OpenEnum } from "../../types/enums.js";
-import { Result as SafeParseResult } from "../../types/fp.js";
-import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-import { Checkpoint, Checkpoint$inboundSchema } from "./checkpoint.js";
-import {
-  ClassifierTargetResult,
-  ClassifierTargetResult$inboundSchema,
-} from "./classifiertargetresult.js";
-import {
-  ClassifierTrainingParameters,
-  ClassifierTrainingParameters$inboundSchema,
-} from "./classifiertrainingparameters.js";
-import { Event, Event$inboundSchema } from "./event.js";
-import { JobMetadata, JobMetadata$inboundSchema } from "./jobmetadata.js";
-import {
-  WandbIntegrationResult,
-  WandbIntegrationResult$inboundSchema,
-} from "./wandbintegrationresult.js";
-
-/**
- * The current status of the fine-tuning job.
- */
-export const ClassifierFineTuningJobDetailsStatus = {
-  Queued: "QUEUED",
-  Started: "STARTED",
-  Validating: "VALIDATING",
-  Validated: "VALIDATED",
-  Running: "RUNNING",
-  FailedValidation: "FAILED_VALIDATION",
-  Failed: "FAILED",
-  Success: "SUCCESS",
-  Cancelled: "CANCELLED",
-  CancellationRequested: "CANCELLATION_REQUESTED",
-} as const;
-/**
- * The current status of the fine-tuning job.
- */
-export type ClassifierFineTuningJobDetailsStatus = OpenEnum<
-  typeof ClassifierFineTuningJobDetailsStatus
->;
-
-export type ClassifierFineTuningJobDetailsIntegration = WandbIntegrationResult;
-
-export type ClassifierFineTuningJobDetails = {
-  /**
-   * The ID of the job.
-   */
-  id: string;
-  autoStart: boolean;
-  model: string;
-  /**
-   * The current status of the fine-tuning job.
-   */
-  status: ClassifierFineTuningJobDetailsStatus;
-  /**
-   * The UNIX timestamp (in seconds) for when the fine-tuning job was created.
-   */
-  createdAt: number;
-  /**
-   * The UNIX timestamp (in seconds) for when the fine-tuning job was last modified.
-   */
-  modifiedAt: number;
-  /**
-   * A list containing the IDs of uploaded files that contain training data.
-   */
-  trainingFiles: Array<string>;
-  /**
-   * A list containing the IDs of uploaded files that contain validation data.
-   */
-  validationFiles?: Array<string> | null | undefined;
-  /**
-   * The object type of the fine-tuning job.
-   */
-  object: "job";
-  /**
-   * The name of the fine-tuned model that is being created. The value will be `null` if the fine-tuning job is still running.
-   */
-  fineTunedModel?: string | null | undefined;
-  /**
-   * Optional user-provided string inserted into the fine-tuned model name to help identify it. For example, a suffix of `"my-great-model"` produces a name like `ft:open-mistral-7b:abcd1234:20260101:my-great-model:efgh5678`.
-   */
-  suffix?: string | null | undefined;
-  /**
-   * A list of integrations enabled for your fine-tuning job.
-   */
-  integrations?: Array<WandbIntegrationResult> | null | undefined;
-  /**
-   * Total number of tokens trained.
-   */
-  trainedTokens?: number | null | undefined;
-  metadata?: JobMetadata | null | undefined;
-  /**
-   * The type of job (`FT` for fine-tuning).
-   */
-  jobType: "classifier";
-  hyperparameters: ClassifierTrainingParameters;
-  /**
-   * Event items are created every time the status of a fine-tuning job changes. The timestamped list of all events is accessible here.
-   */
-  events?: Array<Event> | undefined;
-  checkpoints?: Array<Checkpoint> | undefined;
-  classifierTargets: Array<ClassifierTargetResult>;
-};
-
-/** @internal */
-export const ClassifierFineTuningJobDetailsStatus$inboundSchema: z.ZodType<
-  ClassifierFineTuningJobDetailsStatus,
-  unknown
-> = openEnums.inboundSchema(ClassifierFineTuningJobDetailsStatus);
-
-/** @internal */
-export const ClassifierFineTuningJobDetailsIntegration$inboundSchema: z.ZodType<
-  ClassifierFineTuningJobDetailsIntegration,
-  unknown
-> = WandbIntegrationResult$inboundSchema;
-
-export function classifierFineTuningJobDetailsIntegrationFromJSON(
-  jsonString: string,
-): SafeParseResult<
-  ClassifierFineTuningJobDetailsIntegration,
-  SDKValidationError
-> {
-  return safeParse(
-    jsonString,
-    (x) =>
-      ClassifierFineTuningJobDetailsIntegration$inboundSchema.parse(
-        JSON.parse(x),
-      ),
-    `Failed to parse 'ClassifierFineTuningJobDetailsIntegration' from JSON`,
-  );
-}
-
-/** @internal */
-export const ClassifierFineTuningJobDetails$inboundSchema: z.ZodType<
-  ClassifierFineTuningJobDetails,
-  unknown
-> = z.object({
-  id: z.string(),
-  auto_start: z.boolean(),
-  model: z.string(),
-  status: ClassifierFineTuningJobDetailsStatus$inboundSchema,
-  created_at: z.int(),
-  modified_at: z.int(),
-  training_files: z.array(z.string()),
-  validation_files: z.nullable(z.array(z.string())).optional(),
-  object: z.literal("job").default("job"),
-  fine_tuned_model: z.nullable(z.string()).optional(),
-  suffix: z.nullable(z.string()).optional(),
-  integrations: z.nullable(z.array(WandbIntegrationResult$inboundSchema))
-    .optional(),
-  trained_tokens: z.nullable(z.int()).optional(),
-  metadata: z.nullable(JobMetadata$inboundSchema).optional(),
-  job_type: z.literal("classifier"),
-  hyperparameters: ClassifierTrainingParameters$inboundSchema,
-  events: z.array(Event$inboundSchema).optional(),
-  checkpoints: z.array(Checkpoint$inboundSchema).optional(),
-  classifier_targets: z.array(ClassifierTargetResult$inboundSchema),
-}).transform((v) => {
-  return remap$(v, {
-    "auto_start": "autoStart",
-    "created_at": "createdAt",
-    "modified_at": "modifiedAt",
-    "training_files": "trainingFiles",
-    "validation_files": "validationFiles",
-    "fine_tuned_model": "fineTunedModel",
-    "trained_tokens": "trainedTokens",
-    "job_type": "jobType",
-    "classifier_targets": "classifierTargets",
-  });
-});
-
-export function classifierFineTuningJobDetailsFromJSON(
-  jsonString: string,
-): SafeParseResult<ClassifierFineTuningJobDetails, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => ClassifierFineTuningJobDetails$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'ClassifierFineTuningJobDetails' from JSON`,
-  );
-}

package/src/models/components/classifiertarget.ts

@@ -1,49 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: 197182b170fb
- */
-
-import * as z from "zod/v4";
-import { remap as remap$ } from "../../lib/primitives.js";
-import {
-  FTClassifierLossFunction,
-  FTClassifierLossFunction$outboundSchema,
-} from "./ftclassifierlossfunction.js";
-
-export type ClassifierTarget = {
-  name: string;
-  labels: Array<string>;
-  weight?: number | undefined;
-  lossFunction?: FTClassifierLossFunction | null | undefined;
-};
-
-/** @internal */
-export type ClassifierTarget$Outbound = {
-  name: string;
-  labels: Array<string>;
-  weight: number;
-  loss_function?: string | null | undefined;
-};
-
-/** @internal */
-export const ClassifierTarget$outboundSchema: z.ZodType<
-  ClassifierTarget$Outbound,
-  ClassifierTarget
-> = z.object({
-  name: z.string(),
-  labels: z.array(z.string()),
-  weight: z.number().default(1),
-  lossFunction: z.nullable(FTClassifierLossFunction$outboundSchema).optional(),
-}).transform((v) => {
-  return remap$(v, {
-    lossFunction: "loss_function",
-  });
-});
-
-export function classifierTargetToJSON(
-  classifierTarget: ClassifierTarget,
-): string {
-  return JSON.stringify(
-    ClassifierTarget$outboundSchema.parse(classifierTarget),
-  );
-}