@meetkai/mka1 0.51.7 → 0.51.9

package/src/react-query/servingRecipesGet.ts

@@ -0,0 +1,141 @@
+/*
+ * 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 {
+  buildServingRecipesGetQuery,
+  prefetchServingRecipesGet,
+  queryKeyServingRecipesGet,
+  ServingRecipesGetQueryData,
+} from "./servingRecipesGet.core.js";
+export {
+  buildServingRecipesGetQuery,
+  prefetchServingRecipesGet,
+  queryKeyServingRecipesGet,
+  type ServingRecipesGetQueryData,
+};
+
+export type ServingRecipesGetQueryError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Get a serving recipe
+ *
+ * @remarks
+ * Get one recipe catalog record. Tenants can read enabled recipes; disabled recipes are visible to cluster administrators only.
+ */
+export function useServingRecipesGet(
+  request: operations.GetServingRecipeRequest,
+  options?: QueryHookOptions<
+    ServingRecipesGetQueryData,
+    ServingRecipesGetQueryError
+  >,
+): UseQueryResult<ServingRecipesGetQueryData, ServingRecipesGetQueryError> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildServingRecipesGetQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Get a serving recipe
+ *
+ * @remarks
+ * Get one recipe catalog record. Tenants can read enabled recipes; disabled recipes are visible to cluster administrators only.
+ */
+export function useServingRecipesGetSuspense(
+  request: operations.GetServingRecipeRequest,
+  options?: SuspenseQueryHookOptions<
+    ServingRecipesGetQueryData,
+    ServingRecipesGetQueryError
+  >,
+): UseSuspenseQueryResult<
+  ServingRecipesGetQueryData,
+  ServingRecipesGetQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildServingRecipesGetQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setServingRecipesGetData(
+  client: QueryClient,
+  queryKeyBase: [
+    name: string,
+    parameters: { xOnBehalfOf?: string | undefined },
+  ],
+  data: ServingRecipesGetQueryData,
+): ServingRecipesGetQueryData | undefined {
+  const key = queryKeyServingRecipesGet(...queryKeyBase);
+
+  return client.setQueryData<ServingRecipesGetQueryData>(key, data);
+}
+
+export function invalidateServingRecipesGet(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [name: string, parameters: { xOnBehalfOf?: string | undefined }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "recipes", "get", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllServingRecipesGet(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "recipes", "get"],
+  });
+}

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

@@ -0,0 +1,81 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingRecipesList } from "../funcs/servingRecipesList.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 ServingRecipesListQueryData = components.PageServingRecipe;
+
+export function prefetchServingRecipesList(
+  queryClient: QueryClient,
+  client$: SDKCore,
+  request: operations.ListServingRecipesRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildServingRecipesListQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildServingRecipesListQuery(
+  client$: SDKCore,
+  request: operations.ListServingRecipesRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<ServingRecipesListQueryData>;
+} {
+  return {
+    queryKey: queryKeyServingRecipesList({
+      cursor: request.cursor,
+      limit: request.limit,
+      xOnBehalfOf: request.xOnBehalfOf,
+    }),
+    queryFn: async function servingRecipesListQueryFn(
+      ctx,
+    ): Promise<ServingRecipesListQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(servingRecipesList(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyServingRecipesList(
+  parameters: {
+    cursor?: string | null | undefined;
+    limit?: number | undefined;
+    xOnBehalfOf?: string | undefined;
+  },
+): QueryKey {
+  return ["@meetkai/mka1", "recipes", "list", parameters];
+}

package/src/react-query/servingRecipesList.ts

@@ -0,0 +1,147 @@
+/*
+ * 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 {
+  buildServingRecipesListQuery,
+  prefetchServingRecipesList,
+  queryKeyServingRecipesList,
+  ServingRecipesListQueryData,
+} from "./servingRecipesList.core.js";
+export {
+  buildServingRecipesListQuery,
+  prefetchServingRecipesList,
+  queryKeyServingRecipesList,
+  type ServingRecipesListQueryData,
+};
+
+export type ServingRecipesListQueryError =
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * List serving recipes
+ *
+ * @remarks
+ * List the cluster-global serving recipe catalog. Tenants see only enabled (deployable) recipes; cluster administrators see every registered recipe including disabled ones.
+ */
+export function useServingRecipesList(
+  request: operations.ListServingRecipesRequest,
+  options?: QueryHookOptions<
+    ServingRecipesListQueryData,
+    ServingRecipesListQueryError
+  >,
+): UseQueryResult<ServingRecipesListQueryData, ServingRecipesListQueryError> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildServingRecipesListQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List serving recipes
+ *
+ * @remarks
+ * List the cluster-global serving recipe catalog. Tenants see only enabled (deployable) recipes; cluster administrators see every registered recipe including disabled ones.
+ */
+export function useServingRecipesListSuspense(
+  request: operations.ListServingRecipesRequest,
+  options?: SuspenseQueryHookOptions<
+    ServingRecipesListQueryData,
+    ServingRecipesListQueryError
+  >,
+): UseSuspenseQueryResult<
+  ServingRecipesListQueryData,
+  ServingRecipesListQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildServingRecipesListQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setServingRecipesListData(
+  client: QueryClient,
+  queryKeyBase: [
+    parameters: {
+      cursor?: string | null | undefined;
+      limit?: number | undefined;
+      xOnBehalfOf?: string | undefined;
+    },
+  ],
+  data: ServingRecipesListQueryData,
+): ServingRecipesListQueryData | undefined {
+  const key = queryKeyServingRecipesList(...queryKeyBase);
+
+  return client.setQueryData<ServingRecipesListQueryData>(key, data);
+}
+
+export function invalidateServingRecipesList(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [parameters: {
+      cursor?: string | null | undefined;
+      limit?: number | undefined;
+      xOnBehalfOf?: string | undefined;
+    }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "recipes", "list", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllServingRecipesList(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "recipes", "list"],
+  });
+}

package/src/react-query/servingRecipesRegister.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingRecipesRegister } from "../funcs/servingRecipesRegister.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.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 { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type ServingRecipesRegisterMutationVariables = {
+  request: operations.RegisterServingRecipeRequest;
+  options?: RequestOptions;
+};
+
+export type ServingRecipesRegisterMutationData = components.ServingRecipe;
+
+export type ServingRecipesRegisterMutationError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Register a serving recipe
+ *
+ * @remarks
+ * Register (or re-register) a digest-pinned recipe manifest in the catalog. A new recipe registers disabled; re-registration replaces the manifest and preserves enablement. Cluster administrators only.
+ */
+export function useServingRecipesRegisterMutation(
+  options?: MutationHookOptions<
+    ServingRecipesRegisterMutationData,
+    ServingRecipesRegisterMutationError,
+    ServingRecipesRegisterMutationVariables
+  >,
+): UseMutationResult<
+  ServingRecipesRegisterMutationData,
+  ServingRecipesRegisterMutationError,
+  ServingRecipesRegisterMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildServingRecipesRegisterMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyServingRecipesRegister(): MutationKey {
+  return ["@meetkai/mka1", "recipes", "register"];
+}
+
+export function buildServingRecipesRegisterMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: ServingRecipesRegisterMutationVariables,
+  ) => Promise<ServingRecipesRegisterMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyServingRecipesRegister(),
+    mutationFn: function servingRecipesRegisterMutationFn({
+      request,
+      options,
+    }): Promise<ServingRecipesRegisterMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(servingRecipesRegister(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/servingRecipesSetEnabled.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingRecipesSetEnabled } from "../funcs/servingRecipesSetEnabled.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.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 { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type ServingRecipesSetEnabledMutationVariables = {
+  request: operations.SetServingRecipeEnabledRequest;
+  options?: RequestOptions;
+};
+
+export type ServingRecipesSetEnabledMutationData = components.ServingRecipe;
+
+export type ServingRecipesSetEnabledMutationError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Enable or disable a serving recipe
+ *
+ * @remarks
+ * Toggle cluster-wide deployability of a registered recipe. Disabling does not stop deployments already running the recipe. Cluster administrators only.
+ */
+export function useServingRecipesSetEnabledMutation(
+  options?: MutationHookOptions<
+    ServingRecipesSetEnabledMutationData,
+    ServingRecipesSetEnabledMutationError,
+    ServingRecipesSetEnabledMutationVariables
+  >,
+): UseMutationResult<
+  ServingRecipesSetEnabledMutationData,
+  ServingRecipesSetEnabledMutationError,
+  ServingRecipesSetEnabledMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildServingRecipesSetEnabledMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyServingRecipesSetEnabled(): MutationKey {
+  return ["@meetkai/mka1", "recipes", "setEnabled"];
+}
+
+export function buildServingRecipesSetEnabledMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: ServingRecipesSetEnabledMutationVariables,
+  ) => Promise<ServingRecipesSetEnabledMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyServingRecipesSetEnabled(),
+    mutationFn: function servingRecipesSetEnabledMutationFn({
+      request,
+      options,
+    }): Promise<ServingRecipesSetEnabledMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(servingRecipesSetEnabled(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/sdk/feedback.ts

@@ -6,6 +6,8 @@ import { llmFeedbackBatchGetCompletionFeedback } from "../funcs/llmFeedbackBatch
 import { llmFeedbackBatchGetResponseFeedback } from "../funcs/llmFeedbackBatchGetResponseFeedback.js";
 import { llmFeedbackCreateCompletionFeedback } from "../funcs/llmFeedbackCreateCompletionFeedback.js";
 import { llmFeedbackCreateResponseFeedback } from "../funcs/llmFeedbackCreateResponseFeedback.js";
+import { llmFeedbackExportCompletionFeedback } from "../funcs/llmFeedbackExportCompletionFeedback.js";
+import { llmFeedbackExportResponseFeedback } from "../funcs/llmFeedbackExportResponseFeedback.js";
 import { llmFeedbackGetCompletionFeedback } from "../funcs/llmFeedbackGetCompletionFeedback.js";
 import { llmFeedbackGetExportStatus } from "../funcs/llmFeedbackGetExportStatus.js";
 import { llmFeedbackGetResponseFeedback } from "../funcs/llmFeedbackGetResponseFeedback.js";
@@ -190,19 +192,51 @@ export class Feedback extends ClientSDK {
     ));
   }
 
+  /**
+   * Export completion feedback as CSV
+   *
+   * @remarks
+   * Synchronously exports the completion feedback entries visible to the caller as a CSV file, ordered by the creation date of the underlying request. Visibility matches the list endpoint: callers see their own feedback; org owners and admins see their whole team. Supports filtering by rating. The export is capped at 50,000 rows; when the cap is hit the response carries an X-Export-Truncated header and older rows (with the default descending order) are omitted.
+   */
+  async exportCompletionFeedback(
+    request: operations.ExportCompletionFeedbackRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ExportCompletionFeedbackResponse> {
+    return unwrapAsync(llmFeedbackExportCompletionFeedback(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Export response feedback as CSV
+   *
+   * @remarks
+   * Synchronously exports the response feedback entries visible to the caller as a CSV file, ordered by the creation date of the underlying request. Visibility matches the list endpoint: callers see their own feedback; org owners and admins see their whole team. Supports filtering by rating. The export is capped at 50,000 rows; when the cap is hit the response carries an X-Export-Truncated header and older rows (with the default descending order) are omitted.
+   */
+  async exportResponseFeedback(
+    request: operations.ExportResponseFeedbackRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ExportResponseFeedbackResponse> {
+    return unwrapAsync(llmFeedbackExportResponseFeedback(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Start feedback export
    *
    * @remarks
-   * Starts a background job to export all feedback data to parquet files in S3/R2. Only one export can run simultaneously.
+   * Starts a background job to export all feedback data across every tenant to parquet files in S3/R2. Only one export can run simultaneously. Restricted to cluster administrators.
    */
   async startExport(
-    request: operations.StartExportFeedbackRequest,
     options?: RequestOptions,
   ): Promise<components.StartExportFeedbackResponse> {
     return unwrapAsync(llmFeedbackStartExport(
       this,
-      request,
       options,
     ));
   }
@@ -211,15 +245,13 @@ export class Feedback extends ClientSDK {
    * Get feedback export status
    *
    * @remarks
-   * Checks the status and progress of the currently running or most recently completed feedback export job.
+   * Checks the status and progress of the currently running or most recently completed feedback export job. Restricted to cluster administrators.
    */
   async getExportStatus(
-    request: operations.GetExportStatusRequest,
     options?: RequestOptions,
   ): Promise<components.GetExportStatusResponse> {
     return unwrapAsync(llmFeedbackGetExportStatus(
       this,
-      request,
       options,
     ));
   }