@meetkai/mka1 0.54.50 → 0.54.51

package/src/funcs/reposTagsDelete.ts

@@ -0,0 +1,212 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+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 {
+  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";
+
+/**
+ * Delete an image tag
+ *
+ * @remarks
+ * 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.
+ *
+ * If set, this operation will use {@link Security.bearerAuth} from the global security.
+ */
+export function reposTagsDelete(
+  client: SDKCore,
+  request: operations.DeleteRepoTagRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    void,
+    | errors.RepoError
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: SDKCore,
+  request: operations.DeleteRepoTagRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      void,
+      | errors.RepoError
+      | SDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.DeleteRepoTagRequest$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",
+    }),
+    tag: encodeSimple("tag", payload.tag, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/api/v1/repos/{org}/{name}/tags/{tag}")(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: "deleteRepoTag",
+    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: "DELETE",
+    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<
+    void,
+    | errors.RepoError
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.nil(204, z.void()),
+    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/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

@@ -39,10 +39,13 @@ import { Result } from "../types/fp.js";
  * 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.
+ * 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.50",
-  genVersion: "2.938.0",
-  userAgent: "speakeasy-sdk/typescript 0.54.50 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.50",
+    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.50",
+    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/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

@@ -22,10 +22,13 @@ only. The repository id is stable, so a rename is a one-row DB update
 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.
+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/index.ts

@@ -523,6 +523,8 @@ 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/repo.ts

@@ -15,6 +15,16 @@ import {
 
 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).
@@ -44,6 +54,7 @@ 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),
@@ -57,6 +68,7 @@ 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;
@@ -68,6 +80,7 @@ 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),