@meetkai/mka1 0.54.49 → 0.54.51

package/src/models/components/repo.ts

@@ -7,14 +7,37 @@ 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 {
+  RepoKind,
+  RepoKind$inboundSchema,
+  RepoKind$outboundSchema,
+} from "./repokind.js";
 
 export type Repo = {
   createdAt: Date;
+  /**
+   * The user id of whoever created the repository, through any plane
+   *
+   * @remarks
+   * (the API, `git push`, the HF client, the OCI registry). It is the
+   * same id the platform session and mk-authentication's members
+   * directory use, so a name is one directory lookup away. `null`
+   * for a row that records no user id; never an empty string.
+   */
+  creator: string | null;
   description: string;
   /**
    * Opaque, stable repository id (the canonical key; not a user label).
    */
   id: string;
+  /**
+   * The repository's kind, or `null` for a legacy repository created
+   *
+   * @remarks
+   * before kinds existed and not yet typed through PATCH. An untyped
+   * repository is served by every plane.
+   */
+  kind: RepoKind | null;
   /**
    * The repository name (URL label).
    */
@@ -31,8 +54,10 @@ export const Repo$inboundSchema: z.ZodType<Repo, z.ZodTypeDef, unknown> = z
     created_at: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),
+    creator: z.nullable(z.string()),
     description: z.string(),
     id: z.string(),
+    kind: z.nullable(RepoKind$inboundSchema),
     name: z.string(),
     org: z.string(),
   }).transform((v) => {
@@ -43,8 +68,10 @@ export const Repo$inboundSchema: z.ZodType<Repo, z.ZodTypeDef, unknown> = z
 /** @internal */
 export type Repo$Outbound = {
   created_at: string;
+  creator: string | null;
   description: string;
   id: string;
+  kind: string | null;
   name: string;
   org: string;
 };
@@ -53,8 +80,10 @@ export type Repo$Outbound = {
 export const Repo$outboundSchema: z.ZodType<Repo$Outbound, z.ZodTypeDef, Repo> =
   z.object({
     createdAt: z.date().transform(v => v.toISOString()),
+    creator: z.nullable(z.string()),
     description: z.string(),
     id: z.string(),
+    kind: z.nullable(RepoKind$outboundSchema),
     name: z.string(),
     org: z.string(),
   }).transform((v) => {

package/src/models/components/repokind.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+/**
+ * What a repository holds — a property of the content, not of the
+ *
+ * @remarks
+ * client that made it. `repo` is a plain git repository (git, `gh`);
+ * `model` and `dataset` are git repositories in the Hugging Face
+ * layouts, served under `/api/models` and `/api/datasets` respectively;
+ * `image` holds container images served by the OCI registry. Every kind
+ * is reachable over git; the HF and OCI planes answer only for their
+ * own kinds.
+ */
+export const RepoKind = {
+  Repo: "repo",
+  Model: "model",
+  Dataset: "dataset",
+  Image: "image",
+} as const;
+/**
+ * What a repository holds — a property of the content, not of the
+ *
+ * @remarks
+ * client that made it. `repo` is a plain git repository (git, `gh`);
+ * `model` and `dataset` are git repositories in the Hugging Face
+ * layouts, served under `/api/models` and `/api/datasets` respectively;
+ * `image` holds container images served by the OCI registry. Every kind
+ * is reachable over git; the HF and OCI planes answer only for their
+ * own kinds.
+ */
+export type RepoKind = ClosedEnum<typeof RepoKind>;
+
+/** @internal */
+export const RepoKind$inboundSchema: z.ZodNativeEnum<typeof RepoKind> = z
+  .nativeEnum(RepoKind);
+/** @internal */
+export const RepoKind$outboundSchema: z.ZodNativeEnum<typeof RepoKind> =
+  RepoKind$inboundSchema;

package/src/models/components/repotag.ts

@@ -0,0 +1,90 @@
+/*
+ * 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 RepoTag = {
+  /**
+   * The manifest the tag points at, `sha256:<hex>`.
+   */
+  digest: string;
+  /**
+   * The manifest's media type, as the registry serves it.
+   */
+  mediaType: string;
+  /**
+   * The image's total size in bytes as its manifest declares it (the
+   *
+   * @remarks
+   * config plus every layer — what `docker images` prints), or `null`
+   * when the manifest states no total: a multi-arch index, whose
+   * sizes belong to its per-platform children.
+   */
+  size: number | null;
+  tag: string;
+  /**
+   * When the tag was last pushed or moved.
+   */
+  updatedAt: Date;
+};
+
+/** @internal */
+export const RepoTag$inboundSchema: z.ZodType<RepoTag, z.ZodTypeDef, unknown> =
+  z.object({
+    digest: z.string(),
+    media_type: z.string(),
+    size: z.nullable(z.number().int()),
+    tag: z.string(),
+    updated_at: z.string().datetime({ offset: true }).transform(v =>
+      new Date(v)
+    ),
+  }).transform((v) => {
+    return remap$(v, {
+      "media_type": "mediaType",
+      "updated_at": "updatedAt",
+    });
+  });
+/** @internal */
+export type RepoTag$Outbound = {
+  digest: string;
+  media_type: string;
+  size: number | null;
+  tag: string;
+  updated_at: string;
+};
+
+/** @internal */
+export const RepoTag$outboundSchema: z.ZodType<
+  RepoTag$Outbound,
+  z.ZodTypeDef,
+  RepoTag
+> = z.object({
+  digest: z.string(),
+  mediaType: z.string(),
+  size: z.nullable(z.number().int()),
+  tag: z.string(),
+  updatedAt: z.date().transform(v => v.toISOString()),
+}).transform((v) => {
+  return remap$(v, {
+    mediaType: "media_type",
+    updatedAt: "updated_at",
+  });
+});
+
+export function repoTagToJSON(repoTag: RepoTag): string {
+  return JSON.stringify(RepoTag$outboundSchema.parse(repoTag));
+}
+export function repoTagFromJSON(
+  jsonString: string,
+): SafeParseResult<RepoTag, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RepoTag$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RepoTag' from JSON`,
+  );
+}

package/src/models/components/repotaglist.ts

@@ -0,0 +1,66 @@
+/*
+ * 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";
+import {
+  RepoTag,
+  RepoTag$inboundSchema,
+  RepoTag$Outbound,
+  RepoTag$outboundSchema,
+} from "./repotag.js";
+
+export type RepoTagList = {
+  /**
+   * Newest-moved first.
+   */
+  tags: Array<RepoTag>;
+  /**
+   * `true` when the repository holds more tags than this one page
+   *
+   * @remarks
+   * (1000) shows. Never silently cut.
+   */
+  truncated: boolean;
+};
+
+/** @internal */
+export const RepoTagList$inboundSchema: z.ZodType<
+  RepoTagList,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  tags: z.array(RepoTag$inboundSchema),
+  truncated: z.boolean(),
+});
+/** @internal */
+export type RepoTagList$Outbound = {
+  tags: Array<RepoTag$Outbound>;
+  truncated: boolean;
+};
+
+/** @internal */
+export const RepoTagList$outboundSchema: z.ZodType<
+  RepoTagList$Outbound,
+  z.ZodTypeDef,
+  RepoTagList
+> = z.object({
+  tags: z.array(RepoTag$outboundSchema),
+  truncated: z.boolean(),
+});
+
+export function repoTagListToJSON(repoTagList: RepoTagList): string {
+  return JSON.stringify(RepoTagList$outboundSchema.parse(repoTagList));
+}
+export function repoTagListFromJSON(
+  jsonString: string,
+): SafeParseResult<RepoTagList, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RepoTagList$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RepoTagList' from JSON`,
+  );
+}

package/src/models/operations/deleterepotag.ts

@@ -0,0 +1,84 @@
+/*
+ * 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 DeleteRepoTagRequest = {
+  /**
+   * The organization URL slug.
+   */
+  org: string;
+  /**
+   * The repository name (URL label).
+   */
+  name: string;
+  /**
+   * The image tag, exactly as pushed (tags are case-sensitive).
+   */
+  tag: string;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const DeleteRepoTagRequest$inboundSchema: z.ZodType<
+  DeleteRepoTagRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  org: z.string(),
+  name: z.string(),
+  tag: z.string(),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type DeleteRepoTagRequest$Outbound = {
+  org: string;
+  name: string;
+  tag: string;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const DeleteRepoTagRequest$outboundSchema: z.ZodType<
+  DeleteRepoTagRequest$Outbound,
+  z.ZodTypeDef,
+  DeleteRepoTagRequest
+> = z.object({
+  org: z.string(),
+  name: z.string(),
+  tag: z.string(),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function deleteRepoTagRequestToJSON(
+  deleteRepoTagRequest: DeleteRepoTagRequest,
+): string {
+  return JSON.stringify(
+    DeleteRepoTagRequest$outboundSchema.parse(deleteRepoTagRequest),
+  );
+}
+export function deleteRepoTagRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<DeleteRepoTagRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DeleteRepoTagRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DeleteRepoTagRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -115,6 +115,7 @@ export * from "./deleteorgautomodel.js";
 export * from "./deleteorgbudget.js";
 export * from "./deleteprompt.js";
 export * from "./deleterepo.js";
+export * from "./deleterepotag.js";
 export * from "./deleteresponse.js";
 export * from "./deleteserviceaccount.js";
 export * from "./deleteserviceaccountapikey.js";
@@ -296,6 +297,7 @@ export * from "./listprompts.js";
 export * from "./listpromptversions.js";
 export * from "./listrepos.js";
 export * from "./listrepositoriesapiv1sandboxgithubrepositoriesget.js";
+export * from "./listrepotags.js";
 export * from "./listresponsefeedback.js";
 export * from "./listresponses.js";
 export * from "./listscopedapikeys.js";

package/src/models/operations/listrepos.ts

@@ -10,6 +10,13 @@ import * as components from "../components/index.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type ListReposRequest = {
+  /**
+   * Narrow the listing to one kind. Omit it for every repository,
+   *
+   * @remarks
+   * untyped ones included.
+   */
+  kind?: components.RepoKind | undefined;
   /**
    * Optional external end-user identifier forwarded by the API gateway.
    */
@@ -29,6 +36,7 @@ export const ListReposRequest$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  kind: components.RepoKind$inboundSchema.optional(),
   "X-On-Behalf-Of": z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
@@ -37,6 +45,7 @@ export const ListReposRequest$inboundSchema: z.ZodType<
 });
 /** @internal */
 export type ListReposRequest$Outbound = {
+  kind?: string | undefined;
   "X-On-Behalf-Of"?: string | undefined;
 };
 
@@ -46,6 +55,7 @@ export const ListReposRequest$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   ListReposRequest
 > = z.object({
+  kind: components.RepoKind$outboundSchema.optional(),
   xOnBehalfOf: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {

package/src/models/operations/listrepotags.ts

@@ -0,0 +1,77 @@
+/*
+ * 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 ListRepoTagsRequest = {
+  /**
+   * The organization URL slug.
+   */
+  org: string;
+  /**
+   * The repository name (URL label).
+   */
+  name: string;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const ListRepoTagsRequest$inboundSchema: z.ZodType<
+  ListRepoTagsRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  org: z.string(),
+  name: z.string(),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type ListRepoTagsRequest$Outbound = {
+  org: string;
+  name: string;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const ListRepoTagsRequest$outboundSchema: z.ZodType<
+  ListRepoTagsRequest$Outbound,
+  z.ZodTypeDef,
+  ListRepoTagsRequest
+> = z.object({
+  org: z.string(),
+  name: z.string(),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function listRepoTagsRequestToJSON(
+  listRepoTagsRequest: ListRepoTagsRequest,
+): string {
+  return JSON.stringify(
+    ListRepoTagsRequest$outboundSchema.parse(listRepoTagsRequest),
+  );
+}
+export function listRepoTagsRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<ListRepoTagsRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListRepoTagsRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListRepoTagsRequest' from JSON`,
+  );
+}

package/src/react-query/flagsEnvironmentsGenerateEvaluationKey.ts

@@ -50,7 +50,7 @@ export type FlagsEnvironmentsGenerateEvaluationKeyMutationError =
  * Generate or replace an environment evaluation key
  *
  * @remarks
- * Returns the new plaintext key once. Only its SHA-256 digest is stored; generating another key immediately replaces the previous credential on this replica.
+ * Returns the new plaintext key once. Only its SHA-256 digest and a display hint are stored; generating another key immediately replaces the previous credential on this replica.
  */
 export function useFlagsEnvironmentsGenerateEvaluationKeyMutation(
   options?: MutationHookOptions<

package/src/react-query/index.ts

@@ -392,6 +392,8 @@ export * from "./reposCreate.js";
 export * from "./reposDelete.js";
 export * from "./reposGet.js";
 export * from "./reposList.js";
+export * from "./reposTagsDelete.js";
+export * from "./reposTagsList.js";
 export * from "./reposUpdate.js";
 export * from "./sandboxCreate.js";
 export * from "./sandboxDownloadArchive.js";

package/src/react-query/reposCreate.ts

@@ -52,7 +52,9 @@ export type ReposCreateMutationError =
  * @remarks
  * Provisions a repository (org owner/admin only): DB insert
  * (authoritative) → Gitea create (rolled back on failure). The repository
- * belongs to the caller's org.
+ * belongs to the caller's org. `kind` says what it will hold and defaults
+ * to `repo` (a plain git repository); it decides which protocol planes
+ * answer for the name (see the `Repo` schema).
  */
 export function useReposCreateMutation(
   options?: MutationHookOptions<

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

@@ -11,6 +11,7 @@ import { SDKCore } from "../core.js";
 import { reposList } from "../funcs/reposList.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 ReposListQueryData = operations.ListReposResponseBody;
@@ -39,7 +40,10 @@ export function buildReposListQuery(
   queryFn: (context: QueryFunctionContext) => Promise<ReposListQueryData>;
 } {
   return {
-    queryKey: queryKeyReposList({ xOnBehalfOf: request.xOnBehalfOf }),
+    queryKey: queryKeyReposList({
+      kind: request.kind,
+      xOnBehalfOf: request.xOnBehalfOf,
+    }),
     queryFn: async function reposListQueryFn(ctx): Promise<ReposListQueryData> {
       const sig = combineSignals(
         ctx.signal,
@@ -62,7 +66,10 @@ export function buildReposListQuery(
 }
 
 export function queryKeyReposList(
-  parameters: { xOnBehalfOf?: string | undefined },
+  parameters: {
+    kind?: components.RepoKind | undefined;
+    xOnBehalfOf?: string | undefined;
+  },
 ): QueryKey {
   return ["@meetkai/mka1", "repos", "list", parameters];
 }

package/src/react-query/reposList.ts

@@ -10,6 +10,7 @@ import {
   useSuspenseQuery,
   UseSuspenseQueryResult,
 } from "@tanstack/react-query";
+import * as components from "../models/components/index.js";
 import {
   ConnectionError,
   InvalidRequestError,
@@ -57,7 +58,9 @@ export type ReposListQueryError =
  *
  * @remarks
  * Returns every repository in the caller's org (org owner/admin only).
- * Pure DB read.
+ * Pure DB read. With `kind`, only repositories of that kind; an untyped
+ * (legacy, `kind: null`) repository appears in the unfiltered listing
+ * only.
  */
 export function useReposList(
   request: operations.ListReposRequest,
@@ -79,7 +82,9 @@ export function useReposList(
  *
  * @remarks
  * Returns every repository in the caller's org (org owner/admin only).
- * Pure DB read.
+ * Pure DB read. With `kind`, only repositories of that kind; an untyped
+ * (legacy, `kind: null`) repository appears in the unfiltered listing
+ * only.
  */
 export function useReposListSuspense(
   request: operations.ListReposRequest,
@@ -98,7 +103,12 @@ export function useReposListSuspense(
 
 export function setReposListData(
   client: QueryClient,
-  queryKeyBase: [parameters: { xOnBehalfOf?: string | undefined }],
+  queryKeyBase: [
+    parameters: {
+      kind?: components.RepoKind | undefined;
+      xOnBehalfOf?: string | undefined;
+    },
+  ],
   data: ReposListQueryData,
 ): ReposListQueryData | undefined {
   const key = queryKeyReposList(...queryKeyBase);
@@ -109,7 +119,10 @@ export function setReposListData(
 export function invalidateReposList(
   client: QueryClient,
   queryKeyBase: TupleToPrefixes<
-    [parameters: { xOnBehalfOf?: string | undefined }]
+    [parameters: {
+      kind?: components.RepoKind | undefined;
+      xOnBehalfOf?: string | undefined;
+    }]
   >,
   filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
 ): Promise<void> {