@meetkai/mka1 0.54.49 → 0.54.51

package/src/funcs/reposTagsList.ts

@@ -0,0 +1,213 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+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";
+
+/**
+ * List an image repository's tags
+ *
+ * @remarks
+ * Lists the container-image tags a repository holds, newest-moved first,
+ * each with the manifest it points at, the manifest's media type, the
+ * image's declared size and when the tag last moved. The same access
+ * check as reading the repository (org owner/admin; `read:repos` for a
+ * key).
+ *
+ * It is a fact about what the repository HOLDS, not about its `kind`:
+ * a `model` lists `[]`, and a legacy `kind: null` repository that still
+ * holds images lists them — those are the tags a `409 kind_has_content`
+ * on PATCH is about, and deleting them through this API is what makes
+ * that PATCH go through.
+ *
+ * One page, of at most 1000 tags; `truncated` says whether the
+ * repository holds more. The registry's own `GET /v2/{org}/{name}/tags/list`
+ * is the paginated, names-only listing every OCI client speaks.
+ *
+ * If set, this operation will use {@link Security.bearerAuth} from the global security.
+ */
+export function reposTagsList(
+  client: SDKCore,
+  request: operations.ListRepoTagsRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.RepoTagList,
+    | errors.RepoError
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: SDKCore,
+  request: operations.ListRepoTagsRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.RepoTagList,
+      | errors.RepoError
+      | SDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.ListRepoTagsRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    name: encodeSimple("name", payload.name, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    org: encodeSimple("org", payload.org, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/api/v1/repos/{org}/{name}/tags")(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, [0]);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "listRepoTags",
+    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<
+    components.RepoTagList,
+    | errors.RepoError
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.RepoTagList$inboundSchema),
+    M.jsonErr([401, 403, 404], errors.RepoError$inboundSchema),
+    M.jsonErr(500, errors.RepoError$inboundSchema),
+    M.fail("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/funcs/reposUpdate.ts

@@ -31,9 +31,21 @@ import { Result } from "../types/fp.js";
  * 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
+ * whose container images are still named by a tag can be given no
+ * other kind — leaving `image`, or typing a legacy `null` row as
+ * anything else, is refused with `409 kind_has_content` (list and
+ * delete the tags through this API first). A switch away from `image`
+ * collects every image no tag reaches before it is judged, so an image
+ * only ever pushed by digest, or untagged through the registry, never
+ * blocks it. A kind is never un-set.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

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.54.49",
-  genVersion: "2.938.0",
-  userAgent: "speakeasy-sdk/typescript 0.54.49 2.938.0 1.1.0 @meetkai/mka1",
+  sdkVersion: "0.54.51",
+  genVersion: "2.941.0",
+  userAgent: "speakeasy-sdk/typescript 0.54.51 2.941.0 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.54.49",
+    currentVersion: "0.54.51",
   },
 });
 

package/src/mcp-server/server.ts

@@ -394,6 +394,8 @@ import { tool$reposCreate } from "./tools/reposCreate.js";
 import { tool$reposDelete } from "./tools/reposDelete.js";
 import { tool$reposGet } from "./tools/reposGet.js";
 import { tool$reposList } from "./tools/reposList.js";
+import { tool$reposTagsDelete } from "./tools/reposTagsDelete.js";
+import { tool$reposTagsList } from "./tools/reposTagsList.js";
 import { tool$reposUpdate } from "./tools/reposUpdate.js";
 import { tool$sandboxCreate } from "./tools/sandboxCreate.js";
 import { tool$sandboxDownloadArchive } from "./tools/sandboxDownloadArchive.js";
@@ -468,7 +470,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "SDK",
-    version: "0.54.49",
+    version: "0.54.51",
   });
 
   const client = new SDKCore({
@@ -919,6 +921,8 @@ export function createMCPServer(deps: {
   tool(tool$authClusterInviteInfo);
   tool(tool$authClusterAcceptInvite);
   tool(tool$authApiKeyGetJwtFromKey);
+  tool(tool$reposTagsList);
+  tool(tool$reposTagsDelete);
   tool(tool$trackingExperimentsCreate);
   tool(tool$trackingExperimentsSearch);
   tool(tool$trackingExperimentsGet);

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

@@ -16,7 +16,7 @@ export const tool$flagsEnvironmentsGenerateEvaluationKey: ToolDefinition<
   name: "flags-environments-generate-evaluation-key",
   description: `Generate or replace an environment evaluation key
 
-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.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await flagsEnvironmentsGenerateEvaluationKey(

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/reposTagsDelete.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { reposTagsDelete } from "../../funcs/reposTagsDelete.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.DeleteRepoTagRequest$inboundSchema,
+};
+
+export const tool$reposTagsDelete: ToolDefinition<typeof args> = {
+  name: "repos-tags-delete",
+  description: `Delete an image tag
+
+Removes one tag; org owner/admin only (\`write:repos\` for a key). The
+same untag as the registry's \`DELETE /v2/{org}/{name}/manifests/{tag}\`:
+the name goes and the image stays, reachable by digest and by any
+other tag that names it.
+
+What makes a repository convertible afterwards is the kind switch
+itself: \`PATCH\` to another \`kind\` first collects every image no tag
+reaches (a multi-arch index's per-platform images included) and is
+refused with \`409 kind_has_content\` only for images a tag still
+names. So delete the tags the listing shows, then switch.
+`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await reposTagsDelete(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(void 0, apiCall);
+  },
+};

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

@@ -0,0 +1,52 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { reposTagsList } from "../../funcs/reposTagsList.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListRepoTagsRequest$inboundSchema,
+};
+
+export const tool$reposTagsList: ToolDefinition<typeof args> = {
+  name: "repos-tags-list",
+  description: `List an image repository's tags
+
+Lists the container-image tags a repository holds, newest-moved first,
+each with the manifest it points at, the manifest's media type, the
+image's declared size and when the tag last moved. The same access
+check as reading the repository (org owner/admin; \`read:repos\` for a
+key).
+
+It is a fact about what the repository HOLDS, not about its \`kind\`:
+a \`model\` lists \`[]\`, and a legacy \`kind: null\` repository that still
+holds images lists them — those are the tags a \`409 kind_has_content\`
+on PATCH is about, and deleting them through this API is what makes
+that PATCH go through.
+
+One page, of at most 1000 tags; \`truncated\` says whether the
+repository holds more. The registry's own \`GET /v2/{org}/{name}/tags/list\`
+is the paginated, names-only listing every OCI client speaks.
+`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await reposTagsList(
+      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/mcp-server/tools/reposUpdate.ts

@@ -14,9 +14,21 @@ 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
+whose container images are still named by a tag can be given no
+other kind — leaving \`image\`, or typing a legacy \`null\` row as
+anything else, is refused with \`409 kind_has_content\` (list and
+delete the tags through this API first). A switch away from \`image\`
+collects every image no tag reaches before it is judged, so an image
+only ever pushed by digest, or untagged through the registry, never
+blocks it. 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,7 +521,10 @@ 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 "./repotag.js";
+export * from "./repotaglist.js";
 export * from "./requestcounts.js";
 export * from "./resolvedreference.js";
 export * from "./resolvereferencerequest.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(),
 });