@meetkai/mka1 0.51.9 → 0.51.10

package/src/funcs/servingFinetuneJobsGetMetrics.ts

@@ -0,0 +1,199 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { SDKCore } from "../core.js";
+import { 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";
+
+/**
+ * Training metrics
+ *
+ * @remarks
+ * Return the training metric series (loss, learning rate, ...) pushed by the training run.
+ */
+export function servingFinetuneJobsGetMetrics(
+  client: SDKCore,
+  request: operations.GetFinetuneMetricsRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Array<components.TrainingMetricPoint>,
+    | 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.GetFinetuneMetricsRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Array<components.TrainingMetricPoint>,
+      | errors.ServingError
+      | errors.ServingHTTPValidationError
+      | SDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.GetFinetuneMetricsRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    job_id: encodeSimple("job_id", payload.job_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/api/v1/serving/finetune-jobs/{job_id}/metrics")(
+    pathParams,
+  );
+
+  const headers = new Headers(compactMap({
+    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: "getFinetuneMetrics",
+    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: "GET",
+    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<
+    Array<components.TrainingMetricPoint>,
+    | errors.ServingError
+    | errors.ServingHTTPValidationError
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, z.array(components.TrainingMetricPoint$inboundSchema)),
+    M.jsonErr([403, 404], 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.9",
+  sdkVersion: "0.51.10",
   genVersion: "2.918.4",
-  userAgent: "speakeasy-sdk/typescript 0.51.9 2.918.4 1.1.0 @meetkai/mka1",
+  userAgent: "speakeasy-sdk/typescript 0.51.10 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.9",
+    currentVersion: "0.51.10",
   },
 });
 

package/src/mcp-server/server.ts

@@ -319,6 +319,7 @@ import { tool$servingFinetuneJobsCreate } from "./tools/servingFinetuneJobsCreat
 import { tool$servingFinetuneJobsGet } from "./tools/servingFinetuneJobsGet.js";
 import { tool$servingFinetuneJobsGetEvents } from "./tools/servingFinetuneJobsGetEvents.js";
 import { tool$servingFinetuneJobsGetLogs } from "./tools/servingFinetuneJobsGetLogs.js";
+import { tool$servingFinetuneJobsGetMetrics } from "./tools/servingFinetuneJobsGetMetrics.js";
 import { tool$servingFinetuneJobsList } from "./tools/servingFinetuneJobsList.js";
 import { tool$servingFinetuneJobsListCheckpoints } from "./tools/servingFinetuneJobsListCheckpoints.js";
 import { tool$servingImagesDelete } from "./tools/servingImagesDelete.js";
@@ -359,7 +360,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "SDK",
-    version: "0.51.9",
+    version: "0.51.10",
   });
 
   const client = new SDKCore({
@@ -699,6 +700,7 @@ export function createMCPServer(deps: {
   tool(tool$servingFinetuneJobsListCheckpoints);
   tool(tool$servingFinetuneJobsGetEvents);
   tool(tool$servingFinetuneJobsGetLogs);
+  tool(tool$servingFinetuneJobsGetMetrics);
   tool(tool$servingImagesList);
   tool(tool$servingImagesRegister);
   tool(tool$servingImagesDelete);

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingFinetuneJobsGetMetrics } from "../../funcs/servingFinetuneJobsGetMetrics.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetFinetuneMetricsRequest$inboundSchema,
+};
+
+export const tool$servingFinetuneJobsGetMetrics: ToolDefinition<typeof args> = {
+  name: "serving-finetune-jobs-get-metrics",
+  description: `Training metrics
+
+Return the training metric series (loss, learning rate, ...) pushed by the training run.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await servingFinetuneJobsGetMetrics(
+      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/index.ts

@@ -532,6 +532,7 @@ export * from "./toolchoice.js";
 export * from "./toolchoicemode.js";
 export * from "./tooldefinition.js";
 export * from "./toplogprob.js";
+export * from "./trainingmetricpoint.js";
 export * from "./transcriptionresponse.js";
 export * from "./typeaction.js";
 export * from "./update.js";

package/src/models/components/trainingmetricpoint.ts

@@ -0,0 +1,68 @@
+/*
+ * 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";
+
+/**
+ * One training metric observation pushed by the training run.
+ */
+export type TrainingMetricPoint = {
+  /**
+   * Numeric metric values keyed by name (train_loss, valid_loss, learning_rate, epoch, ...)
+   */
+  data: { [k: string]: number };
+  /**
+   * Global training step the observation was reported at
+   */
+  step?: number | null | undefined;
+  timestamp: Date;
+};
+
+/** @internal */
+export const TrainingMetricPoint$inboundSchema: z.ZodType<
+  TrainingMetricPoint,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  data: z.record(z.number()),
+  step: z.nullable(z.number().int()).optional(),
+  timestamp: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+/** @internal */
+export type TrainingMetricPoint$Outbound = {
+  data: { [k: string]: number };
+  step?: number | null | undefined;
+  timestamp: string;
+};
+
+/** @internal */
+export const TrainingMetricPoint$outboundSchema: z.ZodType<
+  TrainingMetricPoint$Outbound,
+  z.ZodTypeDef,
+  TrainingMetricPoint
+> = z.object({
+  data: z.record(z.number()),
+  step: z.nullable(z.number().int()).optional(),
+  timestamp: z.date().transform(v => v.toISOString()),
+});
+
+export function trainingMetricPointToJSON(
+  trainingMetricPoint: TrainingMetricPoint,
+): string {
+  return JSON.stringify(
+    TrainingMetricPoint$outboundSchema.parse(trainingMetricPoint),
+  );
+}
+export function trainingMetricPointFromJSON(
+  jsonString: string,
+): SafeParseResult<TrainingMetricPoint, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TrainingMetricPoint$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TrainingMetricPoint' from JSON`,
+  );
+}

package/src/models/operations/getfinetunemetrics.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 GetFinetuneMetricsRequest = {
+  jobId: string;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const GetFinetuneMetricsRequest$inboundSchema: z.ZodType<
+  GetFinetuneMetricsRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  job_id: z.string(),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "job_id": "jobId",
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type GetFinetuneMetricsRequest$Outbound = {
+  job_id: string;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const GetFinetuneMetricsRequest$outboundSchema: z.ZodType<
+  GetFinetuneMetricsRequest$Outbound,
+  z.ZodTypeDef,
+  GetFinetuneMetricsRequest
+> = z.object({
+  jobId: z.string(),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    jobId: "job_id",
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function getFinetuneMetricsRequestToJSON(
+  getFinetuneMetricsRequest: GetFinetuneMetricsRequest,
+): string {
+  return JSON.stringify(
+    GetFinetuneMetricsRequest$outboundSchema.parse(getFinetuneMetricsRequest),
+  );
+}
+export function getFinetuneMetricsRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<GetFinetuneMetricsRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetFinetuneMetricsRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetFinetuneMetricsRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -146,6 +146,7 @@ export * from "./getfilesusage.js";
 export * from "./getfinetuneevents.js";
 export * from "./getfinetunejob.js";
 export * from "./getfinetunelogs.js";
+export * from "./getfinetunemetrics.js";
 export * from "./getguardrails.js";
 export * from "./getimage.js";
 export * from "./getjwtfromkey.js";

package/src/react-query/index.ts

@@ -312,6 +312,7 @@ export * from "./servingFinetuneJobsCreate.js";
 export * from "./servingFinetuneJobsGet.js";
 export * from "./servingFinetuneJobsGetEvents.js";
 export * from "./servingFinetuneJobsGetLogs.js";
+export * from "./servingFinetuneJobsGetMetrics.js";
 export * from "./servingFinetuneJobsList.js";
 export * from "./servingFinetuneJobsListCheckpoints.js";
 export * from "./servingImagesDelete.js";

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

@@ -0,0 +1,78 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingFinetuneJobsGetMetrics } from "../funcs/servingFinetuneJobsGetMetrics.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 ServingFinetuneJobsGetMetricsQueryData = Array<
+  components.TrainingMetricPoint
+>;
+
+export function prefetchServingFinetuneJobsGetMetrics(
+  queryClient: QueryClient,
+  client$: SDKCore,
+  request: operations.GetFinetuneMetricsRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildServingFinetuneJobsGetMetricsQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildServingFinetuneJobsGetMetricsQuery(
+  client$: SDKCore,
+  request: operations.GetFinetuneMetricsRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<ServingFinetuneJobsGetMetricsQueryData>;
+} {
+  return {
+    queryKey: queryKeyServingFinetuneJobsGetMetrics(request.jobId, {
+      xOnBehalfOf: request.xOnBehalfOf,
+    }),
+    queryFn: async function servingFinetuneJobsGetMetricsQueryFn(
+      ctx,
+    ): Promise<ServingFinetuneJobsGetMetricsQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(servingFinetuneJobsGetMetrics(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyServingFinetuneJobsGetMetrics(
+  jobId: string,
+  parameters: { xOnBehalfOf?: string | undefined },
+): QueryKey {
+  return ["@meetkai/mka1", "finetuneJobs", "getMetrics", jobId, parameters];
+}

package/src/react-query/servingFinetuneJobsGetMetrics.ts

@@ -0,0 +1,144 @@
+/*
+ * 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 {
+  buildServingFinetuneJobsGetMetricsQuery,
+  prefetchServingFinetuneJobsGetMetrics,
+  queryKeyServingFinetuneJobsGetMetrics,
+  ServingFinetuneJobsGetMetricsQueryData,
+} from "./servingFinetuneJobsGetMetrics.core.js";
+export {
+  buildServingFinetuneJobsGetMetricsQuery,
+  prefetchServingFinetuneJobsGetMetrics,
+  queryKeyServingFinetuneJobsGetMetrics,
+  type ServingFinetuneJobsGetMetricsQueryData,
+};
+
+export type ServingFinetuneJobsGetMetricsQueryError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Training metrics
+ *
+ * @remarks
+ * Return the training metric series (loss, learning rate, ...) pushed by the training run.
+ */
+export function useServingFinetuneJobsGetMetrics(
+  request: operations.GetFinetuneMetricsRequest,
+  options?: QueryHookOptions<
+    ServingFinetuneJobsGetMetricsQueryData,
+    ServingFinetuneJobsGetMetricsQueryError
+  >,
+): UseQueryResult<
+  ServingFinetuneJobsGetMetricsQueryData,
+  ServingFinetuneJobsGetMetricsQueryError
+> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildServingFinetuneJobsGetMetricsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Training metrics
+ *
+ * @remarks
+ * Return the training metric series (loss, learning rate, ...) pushed by the training run.
+ */
+export function useServingFinetuneJobsGetMetricsSuspense(
+  request: operations.GetFinetuneMetricsRequest,
+  options?: SuspenseQueryHookOptions<
+    ServingFinetuneJobsGetMetricsQueryData,
+    ServingFinetuneJobsGetMetricsQueryError
+  >,
+): UseSuspenseQueryResult<
+  ServingFinetuneJobsGetMetricsQueryData,
+  ServingFinetuneJobsGetMetricsQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildServingFinetuneJobsGetMetricsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setServingFinetuneJobsGetMetricsData(
+  client: QueryClient,
+  queryKeyBase: [
+    jobId: string,
+    parameters: { xOnBehalfOf?: string | undefined },
+  ],
+  data: ServingFinetuneJobsGetMetricsQueryData,
+): ServingFinetuneJobsGetMetricsQueryData | undefined {
+  const key = queryKeyServingFinetuneJobsGetMetrics(...queryKeyBase);
+
+  return client.setQueryData<ServingFinetuneJobsGetMetricsQueryData>(key, data);
+}
+
+export function invalidateServingFinetuneJobsGetMetrics(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [jobId: string, parameters: { xOnBehalfOf?: string | undefined }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "finetuneJobs", "getMetrics", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllServingFinetuneJobsGetMetrics(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "finetuneJobs", "getMetrics"],
+  });
+}