@meetkai/mka1 0.54.49 → 0.54.50

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

@@ -16,7 +16,9 @@ export const tool$reposCreate: ToolDefinition<typeof args> = {
 
 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).
 `,
   args,
   tool: async (client, args, ctx) => {

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

@@ -15,7 +15,9 @@ export const tool$reposList: ToolDefinition<typeof args> = {
   description: `List the caller's org's repositories
 
 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.
 `,
   args,
   tool: async (client, args, ctx) => {

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

@@ -14,9 +14,18 @@ export const tool$reposUpdate: ToolDefinition<typeof args> = {
   name: "repos-update",
   description: `Update a repository's labels
 
-Applies a label-only update (name/description); org owner/admin only.
-The repository id is stable, so a rename is a one-row DB update — no
-Gitea write. Omitted fields are left unchanged.
+Applies a label-only update (name/description/kind); org owner/admin
+only. The repository id is stable, so a rename is a one-row DB update
+— no Gitea write. Omitted fields are left unchanged.
+
+\`kind\` is the ONE way a repository's kind changes after creation (the
+protocol planes never change it): it types a legacy \`kind: null\`
+repository and corrects a wrong kind. \`repo\`, \`model\` and \`dataset\`
+convert freely and any repository may become \`image\`; a repository
+that still holds container-image content can be given no other kind
+— leaving \`image\`, or typing a legacy \`null\` row as anything else, is
+refused with \`409 kind_has_content\` (delete the tags through the
+registry first). A kind is never un-set.
 `,
   args,
   tool: async (client, args, ctx) => {

package/src/models/components/createreporequest.ts

@@ -4,11 +4,30 @@
 
 import * as z from "zod/v3";
 import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
+/**
+ * What the repository will hold. Defaults to `repo`.
+ */
+export const CreateRepoRequestKind = {
+  Repo: "repo",
+  Model: "model",
+  Dataset: "dataset",
+  Image: "image",
+} as const;
+/**
+ * What the repository will hold. Defaults to `repo`.
+ */
+export type CreateRepoRequestKind = ClosedEnum<typeof CreateRepoRequestKind>;
+
 export type CreateRepoRequest = {
   description?: string | undefined;
+  /**
+   * What the repository will hold. Defaults to `repo`.
+   */
+  kind?: CreateRepoRequestKind | undefined;
   /**
    * The repository name. Must start with an alphanumeric character and
    *
@@ -18,6 +37,15 @@ export type CreateRepoRequest = {
   name: string;
 };
 
+/** @internal */
+export const CreateRepoRequestKind$inboundSchema: z.ZodNativeEnum<
+  typeof CreateRepoRequestKind
+> = z.nativeEnum(CreateRepoRequestKind);
+/** @internal */
+export const CreateRepoRequestKind$outboundSchema: z.ZodNativeEnum<
+  typeof CreateRepoRequestKind
+> = CreateRepoRequestKind$inboundSchema;
+
 /** @internal */
 export const CreateRepoRequest$inboundSchema: z.ZodType<
   CreateRepoRequest,
@@ -25,11 +53,13 @@ export const CreateRepoRequest$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   description: z.string().optional(),
+  kind: CreateRepoRequestKind$inboundSchema.default("repo"),
   name: z.string(),
 });
 /** @internal */
 export type CreateRepoRequest$Outbound = {
   description?: string | undefined;
+  kind: string;
   name: string;
 };
 
@@ -40,6 +70,7 @@ export const CreateRepoRequest$outboundSchema: z.ZodType<
   CreateRepoRequest
 > = z.object({
   description: z.string().optional(),
+  kind: CreateRepoRequestKind$outboundSchema.default("repo"),
   name: z.string(),
 });
 

package/src/models/components/featureflagenvironment.ts

@@ -10,6 +10,14 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type FeatureFlagEnvironment = {
   createdAt: Date;
+  /**
+   * Whether the environment has an active evaluation key.
+   */
+  evaluationKeyConfigured: boolean;
+  /**
+   * The active key's prefix plus the first and last four characters of its payload, for display. Null when no key is configured, or when the active key was generated before hints were recorded.
+   */
+  evaluationKeyHint: string | null;
   id: string;
   key: string;
   name: string;
@@ -23,6 +31,8 @@ export const FeatureFlagEnvironment$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   created_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  evaluation_key_configured: z.boolean(),
+  evaluation_key_hint: z.nullable(z.string()),
   id: z.string(),
   key: z.string(),
   name: z.string(),
@@ -30,12 +40,16 @@ export const FeatureFlagEnvironment$inboundSchema: z.ZodType<
 }).transform((v) => {
   return remap$(v, {
     "created_at": "createdAt",
+    "evaluation_key_configured": "evaluationKeyConfigured",
+    "evaluation_key_hint": "evaluationKeyHint",
     "updated_at": "updatedAt",
   });
 });
 /** @internal */
 export type FeatureFlagEnvironment$Outbound = {
   created_at: string;
+  evaluation_key_configured: boolean;
+  evaluation_key_hint: string | null;
   id: string;
   key: string;
   name: string;
@@ -49,6 +63,8 @@ export const FeatureFlagEnvironment$outboundSchema: z.ZodType<
   FeatureFlagEnvironment
 > = z.object({
   createdAt: z.date().transform(v => v.toISOString()),
+  evaluationKeyConfigured: z.boolean(),
+  evaluationKeyHint: z.nullable(z.string()),
   id: z.string(),
   key: z.string(),
   name: z.string(),
@@ -56,6 +72,8 @@ export const FeatureFlagEnvironment$outboundSchema: z.ZodType<
 }).transform((v) => {
   return remap$(v, {
     createdAt: "created_at",
+    evaluationKeyConfigured: "evaluation_key_configured",
+    evaluationKeyHint: "evaluation_key_hint",
     updatedAt: "updated_at",
   });
 });

package/src/models/components/index.ts

@@ -521,6 +521,7 @@ export * from "./registrymodelorigin.js";
 export * from "./registrysource.js";
 export * from "./reinforcementhyperparameters.js";
 export * from "./repo.js";
+export * from "./repokind.js";
 export * from "./repositorylist.js";
 export * from "./requestcounts.js";
 export * from "./resolvedreference.js";

package/src/models/components/patchreporequest.ts

@@ -6,6 +6,11 @@ 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 {
+  RepoKind,
+  RepoKind$inboundSchema,
+  RepoKind$outboundSchema,
+} from "./repokind.js";
 
 /**
  * A partial update. Every field is optional; an omitted field is left
@@ -15,6 +20,13 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  */
 export type PatchRepoRequest = {
   description?: string | undefined;
+  /**
+   * Switch the repository's kind (see the operation description for
+   *
+   * @remarks
+   * the rules). Cannot be `null`: a kind is never un-set.
+   */
+  kind?: RepoKind | undefined;
   name?: string | undefined;
 };
 
@@ -25,11 +37,13 @@ export const PatchRepoRequest$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   description: z.string().optional(),
+  kind: RepoKind$inboundSchema.optional(),
   name: z.string().optional(),
 });
 /** @internal */
 export type PatchRepoRequest$Outbound = {
   description?: string | undefined;
+  kind?: string | undefined;
   name?: string | undefined;
 };
 
@@ -40,6 +54,7 @@ export const PatchRepoRequest$outboundSchema: z.ZodType<
   PatchRepoRequest
 > = z.object({
   description: z.string().optional(),
+  kind: RepoKind$outboundSchema.optional(),
   name: z.string().optional(),
 });
 

package/src/models/components/repo.ts

@@ -7,6 +7,11 @@ 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;
@@ -15,6 +20,14 @@ export type Repo = {
    * 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).
    */
@@ -33,6 +46,7 @@ export const Repo$inboundSchema: z.ZodType<Repo, z.ZodTypeDef, unknown> = z
     ),
     description: z.string(),
     id: z.string(),
+    kind: z.nullable(RepoKind$inboundSchema),
     name: z.string(),
     org: z.string(),
   }).transform((v) => {
@@ -45,6 +59,7 @@ export type Repo$Outbound = {
   created_at: string;
   description: string;
   id: string;
+  kind: string | null;
   name: string;
   org: string;
 };
@@ -55,6 +70,7 @@ export const Repo$outboundSchema: z.ZodType<Repo$Outbound, z.ZodTypeDef, Repo> =
     createdAt: z.date().transform(v => v.toISOString()),
     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/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/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/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> {

package/src/react-query/reposUpdate.ts

@@ -50,9 +50,18 @@ export type ReposUpdateMutationError =
  * Update a repository's labels
  *
  * @remarks
- * Applies a label-only update (name/description); org owner/admin only.
- * The repository id is stable, so a rename is a one-row DB update — no
- * Gitea write. Omitted fields are left unchanged.
+ * Applies a label-only update (name/description/kind); org owner/admin
+ * only. The repository id is stable, so a rename is a one-row DB update
+ * — no Gitea write. Omitted fields are left unchanged.
+ *
+ * `kind` is the ONE way a repository's kind changes after creation (the
+ * protocol planes never change it): it types a legacy `kind: null`
+ * repository and corrects a wrong kind. `repo`, `model` and `dataset`
+ * convert freely and any repository may become `image`; a repository
+ * that still holds container-image content can be given no other kind
+ * — leaving `image`, or typing a legacy `null` row as anything else, is
+ * refused with `409 kind_has_content` (delete the tags through the
+ * registry first). A kind is never un-set.
  */
 export function useReposUpdateMutation(
   options?: MutationHookOptions<

package/src/sdk/environments.ts

@@ -131,7 +131,7 @@ export class Environments extends ClientSDK {
    * 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.
    */
   async generateEvaluationKey(
     request: operations.GenerateFeatureFlagEvaluationKeyRequest,

package/src/sdk/repos.ts

@@ -18,7 +18,9 @@ export class Repos extends ClientSDK {
    *
    * @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.
    */
   async list(
     request: operations.ListReposRequest,
@@ -37,7 +39,9 @@ export class Repos extends ClientSDK {
    * @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).
    */
   async create(
     request: operations.CreateRepoRequest,
@@ -90,9 +94,18 @@ export class Repos extends ClientSDK {
    * Update a repository's labels
    *
    * @remarks
-   * Applies a label-only update (name/description); org owner/admin only.
-   * The repository id is stable, so a rename is a one-row DB update — no
-   * Gitea write. Omitted fields are left unchanged.
+   * Applies a label-only update (name/description/kind); org owner/admin
+   * only. The repository id is stable, so a rename is a one-row DB update
+   * — no Gitea write. Omitted fields are left unchanged.
+   *
+   * `kind` is the ONE way a repository's kind changes after creation (the
+   * protocol planes never change it): it types a legacy `kind: null`
+   * repository and corrects a wrong kind. `repo`, `model` and `dataset`
+   * convert freely and any repository may become `image`; a repository
+   * that still holds container-image content can be given no other kind
+   * — leaving `image`, or typing a legacy `null` row as anything else, is
+   * refused with `409 kind_has_content` (delete the tags through the
+   * registry first). A kind is never un-set.
    */
   async update(
     request: operations.PatchRepoRequest,