@meetkai/mka1 0.51.19 → 0.51.21

package/src/models/operations/uploadservingdatasetcontent.ts

@@ -0,0 +1,88 @@
+/*
+ * 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 UploadServingDatasetContentRequest = {
+  datasetId: string;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+  requestBody: ReadableStream<Uint8Array> | Blob | ArrayBuffer | Uint8Array;
+};
+
+/** @internal */
+export const UploadServingDatasetContentRequest$inboundSchema: z.ZodType<
+  UploadServingDatasetContentRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  dataset_id: z.string(),
+  "X-On-Behalf-Of": z.string().optional(),
+  RequestBody: z.union([
+    z.instanceof(ReadableStream<Uint8Array>),
+    z.instanceof(Blob),
+    z.instanceof(ArrayBuffer),
+    z.instanceof(Uint8Array),
+  ]),
+}).transform((v) => {
+  return remap$(v, {
+    "dataset_id": "datasetId",
+    "X-On-Behalf-Of": "xOnBehalfOf",
+    "RequestBody": "requestBody",
+  });
+});
+/** @internal */
+export type UploadServingDatasetContentRequest$Outbound = {
+  dataset_id: string;
+  "X-On-Behalf-Of"?: string | undefined;
+  RequestBody: ReadableStream<Uint8Array> | Blob | ArrayBuffer | Uint8Array;
+};
+
+/** @internal */
+export const UploadServingDatasetContentRequest$outboundSchema: z.ZodType<
+  UploadServingDatasetContentRequest$Outbound,
+  z.ZodTypeDef,
+  UploadServingDatasetContentRequest
+> = z.object({
+  datasetId: z.string(),
+  xOnBehalfOf: z.string().optional(),
+  requestBody: z.union([
+    z.instanceof(ReadableStream<Uint8Array>),
+    z.instanceof(Blob),
+    z.instanceof(ArrayBuffer),
+    z.instanceof(Uint8Array),
+  ]),
+}).transform((v) => {
+  return remap$(v, {
+    datasetId: "dataset_id",
+    xOnBehalfOf: "X-On-Behalf-Of",
+    requestBody: "RequestBody",
+  });
+});
+
+export function uploadServingDatasetContentRequestToJSON(
+  uploadServingDatasetContentRequest: UploadServingDatasetContentRequest,
+): string {
+  return JSON.stringify(
+    UploadServingDatasetContentRequest$outboundSchema.parse(
+      uploadServingDatasetContentRequest,
+    ),
+  );
+}
+export function uploadServingDatasetContentRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<UploadServingDatasetContentRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      UploadServingDatasetContentRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'UploadServingDatasetContentRequest' from JSON`,
+  );
+}

package/src/react-query/index.ts

@@ -301,6 +301,7 @@ export * from "./servingDatasetsCreate.js";
 export * from "./servingDatasetsDelete.js";
 export * from "./servingDatasetsGet.js";
 export * from "./servingDatasetsList.js";
+export * from "./servingDatasetsUploadContent.js";
 export * from "./servingDeploymentsCreate.js";
 export * from "./servingDeploymentsDelete.js";
 export * from "./servingDeploymentsDeregister.js";

package/src/react-query/servingDatasetsCreate.ts

@@ -51,7 +51,7 @@ export type ServingDatasetsCreateMutationError =
  * Register or begin uploading a dataset
  *
  * @remarks
- * Register a dataset by reference (`source`: an external dataset reference passed to the trainer as-is, or a `repo://{repo}[@{revision}][/{path}]` reference reserved for the versioned dataset store) — the dataset is `ready` immediately. Omit `source` to upload instead: the response is `pending_upload` and carries an `upload` block of presigned PUT targets; PUT the data, then call commit to seal the immutable manifest.
+ * Register a dataset by reference (`source`: an external dataset reference passed to the trainer as-is, or a `repo://{repo}[@{revision}][/{path}]` reference reserved for the versioned dataset store) — the dataset is `ready` immediately. Omit `source` to upload instead: the response is `pending_upload` and carries an `upload` block describing where to PUT the data. When the artifact store is not internet-exposed (the default posture) the block is `mode: api` and the target is the API upload path; when a public artifact endpoint is configured it is `mode: presigned` with time-bounded presigned PUT URLs. PUT the data, then call commit to seal the immutable manifest.
  */
 export function useServingDatasetsCreateMutation(
   options?: MutationHookOptions<

package/src/react-query/servingDatasetsUploadContent.ts

@@ -0,0 +1,113 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingDatasetsUploadContent } from "../funcs/servingDatasetsUploadContent.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 ServingDatasetsUploadContentMutationVariables = {
+  request: operations.UploadServingDatasetContentRequest;
+  options?: RequestOptions;
+};
+
+export type ServingDatasetsUploadContentMutationData =
+  components.DatasetUploadReceipt;
+
+export type ServingDatasetsUploadContentMutationError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Upload dataset content through the API
+ *
+ * @remarks
+ * Stream the raw dataset bytes through the serving API into the dataset's object storage. Valid only while the dataset is `pending_upload`; repeating the upload before commit overwrites the previous bytes. The response receipt carries the stored size and SHA-256 digest so the client can verify the bytes before calling commit. Uploads are capped by the cluster's configured maximum dataset size.
+ */
+export function useServingDatasetsUploadContentMutation(
+  options?: MutationHookOptions<
+    ServingDatasetsUploadContentMutationData,
+    ServingDatasetsUploadContentMutationError,
+    ServingDatasetsUploadContentMutationVariables
+  >,
+): UseMutationResult<
+  ServingDatasetsUploadContentMutationData,
+  ServingDatasetsUploadContentMutationError,
+  ServingDatasetsUploadContentMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildServingDatasetsUploadContentMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyServingDatasetsUploadContent(): MutationKey {
+  return ["@meetkai/mka1", "datasets", "uploadContent"];
+}
+
+export function buildServingDatasetsUploadContentMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: ServingDatasetsUploadContentMutationVariables,
+  ) => Promise<ServingDatasetsUploadContentMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyServingDatasetsUploadContent(),
+    mutationFn: function servingDatasetsUploadContentMutationFn({
+      request,
+      options,
+    }): Promise<ServingDatasetsUploadContentMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(servingDatasetsUploadContent(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/servingTenantsDeleteOrganization.ts

@@ -52,7 +52,9 @@ export type ServingTenantsDeleteOrganizationMutationError =
  * Trigger organization deletion teardown
  *
  * @remarks
- * Durably records an organization.deleted.v1 event and starts (or adopts) the mandatory teardown cascade: the organization is fenced against new work and every deployment is tombstoned and wound down, while all pricing, budget, spend, and usage records are preserved. Idempotent by event id. Cluster administrators only.
+ * Durably records an organization.deleted.v1 event and starts (or adopts) the mandatory teardown cascade: the organization is fenced against new work and every deployment is tombstoned and wound down, while all pricing, budget, spend, and usage records are preserved. Idempotent by event id. Cluster administrators only. Deprecated: this operation has moved to the operator admin plane at `POST /api/v1/admin/tenants/{org_id}/deletion`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useServingTenantsDeleteOrganizationMutation(
   options?: MutationHookOptions<

package/src/react-query/servingTenantsGet.ts

@@ -57,7 +57,9 @@ export type ServingTenantsGetQueryError =
  * Get a serving tenant
  *
  * @remarks
- * Get one organization's serving enablement record. Cluster administrators only.
+ * Get one organization's serving enablement record. Cluster administrators only. Deprecated: this operation has moved to the operator admin plane at `GET /api/v1/admin/tenants/{org_id}`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useServingTenantsGet(
   request: operations.GetServingTenantRequest,
@@ -81,7 +83,9 @@ export function useServingTenantsGet(
  * Get a serving tenant
  *
  * @remarks
- * Get one organization's serving enablement record. Cluster administrators only.
+ * Get one organization's serving enablement record. Cluster administrators only. Deprecated: this operation has moved to the operator admin plane at `GET /api/v1/admin/tenants/{org_id}`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useServingTenantsGetSuspense(
   request: operations.GetServingTenantRequest,

package/src/react-query/servingTenantsGetOrganizationDeletion.ts

@@ -56,7 +56,9 @@ export type ServingTenantsGetOrganizationDeletionQueryError =
  * Get organization deletion teardown state
  *
  * @remarks
- * Returns the durable teardown-cascade state for an organization (running or complete), so a cluster administrator can confirm offboarding progressed to completion. 404 if the organization has no teardown. Cluster administrators only.
+ * Returns the durable teardown-cascade state for an organization (running or complete), so a cluster administrator can confirm offboarding progressed to completion. 404 if the organization has no teardown. Cluster administrators only. Deprecated: this operation has moved to the operator admin plane at `GET /api/v1/admin/tenants/{org_id}/deletion`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useServingTenantsGetOrganizationDeletion(
   request: operations.GetServingOrganizationDeletionRequest,
@@ -83,7 +85,9 @@ export function useServingTenantsGetOrganizationDeletion(
  * Get organization deletion teardown state
  *
  * @remarks
- * Returns the durable teardown-cascade state for an organization (running or complete), so a cluster administrator can confirm offboarding progressed to completion. 404 if the organization has no teardown. Cluster administrators only.
+ * Returns the durable teardown-cascade state for an organization (running or complete), so a cluster administrator can confirm offboarding progressed to completion. 404 if the organization has no teardown. Cluster administrators only. Deprecated: this operation has moved to the operator admin plane at `GET /api/v1/admin/tenants/{org_id}/deletion`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useServingTenantsGetOrganizationDeletionSuspense(
   request: operations.GetServingOrganizationDeletionRequest,

package/src/react-query/servingTenantsList.ts

@@ -57,7 +57,9 @@ export type ServingTenantsListQueryError =
  * List serving tenants
  *
  * @remarks
- * List organization-wide serving enablement records. Cluster administrators only; a missing organization is not provisioned.
+ * List organization-wide serving enablement records. Cluster administrators only; a missing organization is not provisioned. Deprecated: this operation has moved to the operator admin plane at `GET /api/v1/admin/tenants`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useServingTenantsList(
   request: operations.ListServingTenantsRequest,
@@ -81,7 +83,9 @@ export function useServingTenantsList(
  * List serving tenants
  *
  * @remarks
- * List organization-wide serving enablement records. Cluster administrators only; a missing organization is not provisioned.
+ * List organization-wide serving enablement records. Cluster administrators only; a missing organization is not provisioned. Deprecated: this operation has moved to the operator admin plane at `GET /api/v1/admin/tenants`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useServingTenantsListSuspense(
   request: operations.ListServingTenantsRequest,

package/src/react-query/servingTenantsSet.ts

@@ -51,7 +51,9 @@ export type ServingTenantsSetMutationError =
  * Set serving tenant enablement
  *
  * @remarks
- * Enable or disable serving for an organization and all of its teams. Disabling blocks product API access but does not stop existing workloads or callbacks. Cluster administrators only.
+ * Enable or disable serving for an organization and all of its teams. Disabling blocks product API access but does not stop existing workloads or callbacks. Cluster administrators only. Deprecated: this operation has moved to the operator admin plane at `PUT /api/v1/admin/tenants/{org_id}`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useServingTenantsSetMutation(
   options?: MutationHookOptions<

package/src/sdk/datasets.ts

@@ -7,6 +7,7 @@ import { servingDatasetsCreate } from "../funcs/servingDatasetsCreate.js";
 import { servingDatasetsDelete } from "../funcs/servingDatasetsDelete.js";
 import { servingDatasetsGet } from "../funcs/servingDatasetsGet.js";
 import { servingDatasetsList } from "../funcs/servingDatasetsList.js";
+import { servingDatasetsUploadContent } from "../funcs/servingDatasetsUploadContent.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import * as operations from "../models/operations/index.js";
@@ -34,7 +35,7 @@ export class Datasets extends ClientSDK {
    * Register or begin uploading a dataset
    *
    * @remarks
-   * Register a dataset by reference (`source`: an external dataset reference passed to the trainer as-is, or a `repo://{repo}[@{revision}][/{path}]` reference reserved for the versioned dataset store) — the dataset is `ready` immediately. Omit `source` to upload instead: the response is `pending_upload` and carries an `upload` block of presigned PUT targets; PUT the data, then call commit to seal the immutable manifest.
+   * Register a dataset by reference (`source`: an external dataset reference passed to the trainer as-is, or a `repo://{repo}[@{revision}][/{path}]` reference reserved for the versioned dataset store) — the dataset is `ready` immediately. Omit `source` to upload instead: the response is `pending_upload` and carries an `upload` block describing where to PUT the data. When the artifact store is not internet-exposed (the default posture) the block is `mode: api` and the target is the API upload path; when a public artifact endpoint is configured it is `mode: presigned` with time-bounded presigned PUT URLs. PUT the data, then call commit to seal the immutable manifest.
    */
   async create(
     request: operations.CreateDatasetRequest,
@@ -97,4 +98,21 @@ export class Datasets extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Upload dataset content through the API
+   *
+   * @remarks
+   * Stream the raw dataset bytes through the serving API into the dataset's object storage. Valid only while the dataset is `pending_upload`; repeating the upload before commit overwrites the previous bytes. The response receipt carries the stored size and SHA-256 digest so the client can verify the bytes before calling commit. Uploads are capped by the cluster's configured maximum dataset size.
+   */
+  async uploadContent(
+    request: operations.UploadServingDatasetContentRequest,
+    options?: RequestOptions,
+  ): Promise<components.DatasetUploadReceipt> {
+    return unwrapAsync(servingDatasetsUploadContent(
+      this,
+      request,
+      options,
+    ));
+  }
 }

package/src/sdk/tenants.ts

@@ -17,7 +17,9 @@ export class Tenants extends ClientSDK {
    * List serving tenants
    *
    * @remarks
-   * List organization-wide serving enablement records. Cluster administrators only; a missing organization is not provisioned.
+   * List organization-wide serving enablement records. Cluster administrators only; a missing organization is not provisioned. Deprecated: this operation has moved to the operator admin plane at `GET /api/v1/admin/tenants`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+   *
+   * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   async list(
     request: operations.ListServingTenantsRequest,
@@ -34,7 +36,9 @@ export class Tenants extends ClientSDK {
    * Get a serving tenant
    *
    * @remarks
-   * Get one organization's serving enablement record. Cluster administrators only.
+   * Get one organization's serving enablement record. Cluster administrators only. Deprecated: this operation has moved to the operator admin plane at `GET /api/v1/admin/tenants/{org_id}`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+   *
+   * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   async get(
     request: operations.GetServingTenantRequest,
@@ -51,7 +55,9 @@ export class Tenants extends ClientSDK {
    * Set serving tenant enablement
    *
    * @remarks
-   * Enable or disable serving for an organization and all of its teams. Disabling blocks product API access but does not stop existing workloads or callbacks. Cluster administrators only.
+   * Enable or disable serving for an organization and all of its teams. Disabling blocks product API access but does not stop existing workloads or callbacks. Cluster administrators only. Deprecated: this operation has moved to the operator admin plane at `PUT /api/v1/admin/tenants/{org_id}`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+   *
+   * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   async set(
     request: operations.SetServingTenantRequest,
@@ -68,7 +74,9 @@ export class Tenants extends ClientSDK {
    * Get organization deletion teardown state
    *
    * @remarks
-   * Returns the durable teardown-cascade state for an organization (running or complete), so a cluster administrator can confirm offboarding progressed to completion. 404 if the organization has no teardown. Cluster administrators only.
+   * Returns the durable teardown-cascade state for an organization (running or complete), so a cluster administrator can confirm offboarding progressed to completion. 404 if the organization has no teardown. Cluster administrators only. Deprecated: this operation has moved to the operator admin plane at `GET /api/v1/admin/tenants/{org_id}/deletion`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+   *
+   * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   async getOrganizationDeletion(
     request: operations.GetServingOrganizationDeletionRequest,
@@ -85,7 +93,9 @@ export class Tenants extends ClientSDK {
    * Trigger organization deletion teardown
    *
    * @remarks
-   * Durably records an organization.deleted.v1 event and starts (or adopts) the mandatory teardown cascade: the organization is fenced against new work and every deployment is tombstoned and wound down, while all pricing, budget, spend, and usage records are preserved. Idempotent by event id. Cluster administrators only.
+   * Durably records an organization.deleted.v1 event and starts (or adopts) the mandatory teardown cascade: the organization is fenced against new work and every deployment is tombstoned and wound down, while all pricing, budget, spend, and usage records are preserved. Idempotent by event id. Cluster administrators only. Deprecated: this operation has moved to the operator admin plane at `POST /api/v1/admin/tenants/{org_id}/deletion`. This path keeps working for one transition release (responses carry `Deprecation: true` and a `Link` successor header) and is removed from this document in the next SDK major.
+   *
+   * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   async deleteOrganization(
     request: operations.DeleteServingOrganizationRequest,