@cloudinary/asset-management-mcp 0.9.3 → 0.10.0

package/src/funcs/uploadEvalUploadParams.ts

@@ -0,0 +1,154 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ec50bea37a36
+ */
+
+import { CloudinaryAssetMgmtCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.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 { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  EvalRequest,
+  EvalRequest$zodSchemaOutbound,
+} from "../models/evalrequest.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Evaluate a dynamic upload-parameter expression
+ *
+ * @remarks
+ * Evaluates a dynamic eval expression against the supplied upload parameters and returns the resulting upload parameters.
+ */
+export function uploadEvalUploadParams(
+  client$: CloudinaryAssetMgmtCore,
+  request: EvalRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: CloudinaryAssetMgmtCore,
+  request: EvalRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => EvalRequest$zodSchemaOutbound.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$, { explode: true });
+
+  const pathParams$ = {
+    cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc("/v1_1/{cloud_name}/eval")(
+    pathParams$,
+  );
+
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "evalUploadParams",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
+
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    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,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    "request": req$,
+    response: doResult.value,
+  }];
+}

package/src/funcs/uploadUploadChunk.ts

@@ -41,13 +41,26 @@ export enum UploadChunkAcceptEnum {
  * large files with the ability to resume interrupted uploads. Each request uploads one chunk of the file.
  * It is required for any files that are larger than 100 MB. This is often relevant for video files, as they
  * tend to have larger file sizes. Minimum chunk size is 5 MB.
+ *
+ * The `file` field accepts either the chunk bytes (multipart) or an HTTP/HTTPS URL. When a URL is supplied,
+ * Cloudinary downloads it and validates the response `Content-Length` against the chunk-size contract
+ * (exact match in the uniform-size flow; within 5 MB floor and 5 GiB cap in explicit-order mode) before
+ * storing any bytes. A mismatch aborts with 400 and persists no state. The remote server must return a
+ * `Content-Length` header; chunked transfer-encoded responses are rejected.
+ *
+ * **Explicit-order totals** (`X-Upload-Part-Number`): `X-Upload-Total-Parts` may be omitted on non-terminal
+ * chunks until the session total *N* is established by any earlier chunk that sent the header. After *N* is
+ * known, the chunk for part index *N* must include `X-Upload-Total-Parts: N`. Whenever the header appears,
+ * its value must be the same integer *N* for that `X-Unique-Upload-Id` (no conflicting totals).
  */
 export function uploadUploadChunk(
   client$: CloudinaryAssetMgmtCore,
   resource_type: UploadResourceType | undefined,
-  contentRange: string,
   xUniqueUploadId: string,
   upload_request: UploadRequest,
+  contentRange?: string | undefined,
+  xUploadPartNumber?: number | undefined,
+  xUploadTotalParts?: number | undefined,
   options?: RequestOptions,
 ): APIPromise<
   Result<
@@ -64,9 +77,11 @@ export function uploadUploadChunk(
   return new APIPromise($do(
     client$,
     resource_type,
-    contentRange,
     xUniqueUploadId,
     upload_request,
+    contentRange,
+    xUploadPartNumber,
+    xUploadTotalParts,
     options,
   ));
 }
@@ -74,9 +89,11 @@ export function uploadUploadChunk(
 async function $do(
   client$: CloudinaryAssetMgmtCore,
   resource_type: UploadResourceType | undefined,
-  contentRange: string,
   xUniqueUploadId: string,
   upload_request: UploadRequest,
+  contentRange?: string | undefined,
+  xUploadPartNumber?: number | undefined,
+  xUploadTotalParts?: number | undefined,
   options?: RequestOptions & { acceptHeaderOverride?: UploadChunkAcceptEnum },
 ): Promise<
   [
@@ -95,9 +112,11 @@ async function $do(
 > {
   const input$: UploadChunkRequest = {
     resource_type: resource_type,
-    contentRange: contentRange,
     xUniqueUploadId: xUniqueUploadId,
     upload_request: upload_request,
+    contentRange: contentRange,
+    xUploadPartNumber: xUploadPartNumber,
+    xUploadTotalParts: xUploadTotalParts,
   };
 
   const parsed$ = safeParse(
@@ -138,6 +157,16 @@ async function $do(
       payload$.xUniqueUploadId,
       { explode: false, charEncoding: "none" },
     ),
+    "X-Upload-Part-Number": encodeSimple(
+      "X-Upload-Part-Number",
+      payload$.xUploadPartNumber,
+      { explode: false, charEncoding: "none" },
+    ),
+    "X-Upload-Total-Parts": encodeSimple(
+      "X-Upload-Total-Parts",
+      payload$.xUploadTotalParts,
+      { explode: false, charEncoding: "none" },
+    ),
   }));
   const securityInput = await extractSecurity(client$._options.security);
   const requestSecurity = resolveGlobalSecurity(securityInput);

package/src/hooks/oauth2scopes.ts

@@ -17,4 +17,8 @@ export type OAuth2Scope =
   /**
    * Allows uploading new assets.
    */
-  | "upload";
+  | "upload"
+  /**
+   * Generate media
+   */
+  | "media_generation";

package/src/landing-page.ts

@@ -939,7 +939,7 @@ http_headers = { "api-key" = "YOUR_API_KEY", "api-secret" = "YOUR_API_SECRET", "
         <h1>Instructions</h1>
         <p>One-click installation for Claude Desktop users</p>
         <div class="instruction-item">
-          <a href="https://github.com/cloudinary/asset-management-mcp/releases/download/v0.9.3/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
+          <a href="https://github.com/cloudinary/asset-management-mcp/releases/download/v0.10.0/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
             📥 Download MCP Bundle
           </a>
         </div>

package/src/lib/config.ts

@@ -112,9 +112,9 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 
 export const SDK_METADATA = {
   language: "typescript",
-  openapiDocVersion: "0.5.1",
-  sdkVersion: "0.9.3",
-  genVersion: "2.885.1",
+  openapiDocVersion: "0.7.4",
+  sdkVersion: "0.10.0",
+  genVersion: "2.918.4",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 0.9.3 2.885.1 0.5.1 @cloudinary/asset-management-mcp",
+    "speakeasy-sdk/mcp-typescript 0.10.0 2.918.4 0.7.4 @cloudinary/asset-management-mcp",
 } as const;

package/src/lib/encodings.ts

@@ -4,7 +4,7 @@
  */
 
 import { bytesToBase64 } from "./base64.js";
-import { isPlainObject } from "./is-plain-object.js";
+import { isPlainObject } from "./primitives.js";
 
 export class EncodingError extends Error {
   constructor(message: string) {

package/src/lib/env.ts

@@ -3,8 +3,6 @@
  * @generated-id: c52972a3b198
  */
 
-import { dlv } from "./dlv.js";
-
 import * as z from "zod";
 import { SDKOptions } from "./config.js";
 
@@ -40,8 +38,13 @@ export function env(): Env {
     return envMemo;
   }
 
+  const globals = globalThis as {
+    process?: { env?: Record<string, string | undefined> };
+    Deno?: { env?: { toObject?: () => Record<string, string | undefined> } };
+  };
+
   envMemo = envSchema.parse(
-    dlv(globalThis, "process.env") ?? dlv(globalThis, "Deno.env") ?? {},
+    globals.process?.env ?? globals.Deno?.env?.toObject?.() ?? {},
   );
   return envMemo;
 }

package/src/lib/http.ts

@@ -46,8 +46,10 @@ export class HTTPClient {
   private requestHooks: BeforeRequestHook[] = [];
   private requestErrorHooks: RequestErrorHook[] = [];
   private responseHooks: ResponseHook[] = [];
+  private options: HTTPClientOptions;
 
-  constructor(private options: HTTPClientOptions = {}) {
+  constructor(options: HTTPClientOptions = {}) {
+    this.options = options;
     this.fetcher = options.fetcher || DEFAULT_FETCHER;
   }
 

package/src/lib/primitives.ts

@@ -112,3 +112,19 @@ export function invariant(
     throw new InvariantError(message);
   }
 }
+
+export function isPlainObject(
+  value: unknown,
+): value is Record<string, unknown> {
+  if (value === null || typeof value !== "object") return false;
+  if (Object.prototype.toString.call(value) !== "[object Object]") return false;
+  const proto = Object.getPrototypeOf(value);
+  if (proto === null || proto === Object.prototype) return true;
+  // cross-realm plain objects (vm contexts, iframes) inherit from a
+  // different realm's Object.prototype, which itself has a null prototype
+  try {
+    return Object.getPrototypeOf(proto) === null;
+  } catch {
+    return false;
+  }
+}

package/src/lib/retries.ts

@@ -195,6 +195,14 @@ async function retryBackoff(
 }
 
 function retryIntervalFromResponse(res: Response): number {
+  const retryAfterMsVal = res.headers.get("retry-after-ms");
+  if (retryAfterMsVal) {
+    const parsedMs = Number(retryAfterMsVal);
+    if (Number.isFinite(parsedMs) && parsedMs >= 0) {
+      return parsedMs;
+    }
+  }
+
   const retryVal = res.headers.get("retry-after") || "";
   if (!retryVal) {
     return 0;

package/src/lib/security.ts

@@ -14,17 +14,22 @@ type OAuth2PasswordFlow = {
   tokenURL: string;
 };
 
-export enum SecurityErrorCode {
-  Incomplete = "incomplete",
-  UnrecognisedSecurityType = "unrecognized_security_type",
-}
+export const SecurityErrorCode = {
+  Incomplete: "incomplete",
+  UnrecognisedSecurityType: "unrecognized_security_type",
+} as const;
+export type SecurityErrorCode =
+  (typeof SecurityErrorCode)[keyof typeof SecurityErrorCode];
 
 export class SecurityError extends Error {
+  public code: SecurityErrorCode;
+
   constructor(
-    public code: SecurityErrorCode,
+    code: SecurityErrorCode,
     message: string,
   ) {
     super(message);
+    this.code = code;
     this.name = "SecurityError";
   }
 

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

@@ -22,7 +22,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.9.3",
+    currentVersion: "0.10.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -38,8 +38,11 @@ import { tool$foldersCreateFolder } from "./tools/foldersCreateFolder.js";
 import { tool$foldersDestroyFolder } from "./tools/foldersDestroyFolder.js";
 import { tool$foldersSearchFolders } from "./tools/foldersSearchFolders.js";
 import { tool$foldersUpdateFolder } from "./tools/foldersUpdateFolder.js";
+import { tool$generationGenerateImage } from "./tools/generationGenerateImage.js";
+import { tool$generationGenerateImageFromImages } from "./tools/generationGenerateImageFromImages.js";
 import { tool$searchSearchAssets } from "./tools/searchSearchAssets.js";
 import { tool$searchVisualSearchAssets } from "./tools/searchVisualSearchAssets.js";
+import { tool$tasksGetGenerationTaskStatus } from "./tools/tasksGetGenerationTaskStatus.js";
 import { tool$uploadUpload } from "./tools/uploadUpload.js";
 import { tool$usageGetUsage } from "./tools/usageGetUsage.js";
 
@@ -60,7 +63,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "CloudinaryAssetMgmt",
-    version: "0.9.3",
+    version: "0.10.0",
   });
 
   const getClient = deps.getSDK || (() =>
@@ -130,6 +133,9 @@ export function createMCPServer(deps: {
   tool(tool$foldersSearchFolders);
   tool(tool$searchSearchAssets);
   tool(tool$searchVisualSearchAssets);
+  tool(tool$generationGenerateImage);
+  tool(tool$generationGenerateImageFromImages);
+  tool(tool$tasksGetGenerationTaskStatus);
 
   if (deps.dynamic) {
     registerDynamicTools(deps.logger, server, getClient, toolMap, scopes);

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

@@ -4,11 +4,11 @@
  */
 
 import { assetsDestroyByAssetId } from "../../funcs/assetsDestroyByAssetId.js";
-import { ComponentsDestroyRequest$zodSchema } from "../../models/componentsdestroyrequest.js";
+import { DestroyByAssetIdRequest$zodSchema } from "../../models/destroybyassetidrequest.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: ComponentsDestroyRequest$zodSchema.describe(
+  request: DestroyByAssetIdRequest$zodSchema.describe(
     `The asset to delete and related options.`,
   ),
 };

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

@@ -0,0 +1,52 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 358095938b5f
+ */
+
+import { generationGenerateImage } from "../../funcs/generationGenerateImage.js";
+import { GenerateImageRequest$zodSchema } from "../../models/generateimagerequest.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: GenerateImageRequest$zodSchema.describe(
+    `A JSON object containing the generation request parameters.`,
+  ),
+};
+
+export const tool$generationGenerateImage: ToolDefinition<typeof args> = {
+  name: "generate-image",
+  description: `Generate an image
+
+Generate an image from a text prompt using AI models.
+
+The model is selected via the optional \`model\` object:
+1. If \`model.id\` is provided, use that exact model.
+2. Else if \`model.family\` (+ optional \`model.tier\`) is provided, resolve via the model registry; a missing tier defaults to \`standard\`.
+3. If \`model\` is omitted, use the global default (nano-banana / premium, i.e. \`nano-banana-2\`).
+`,
+  scopes: ["builder"],
+  annotations: {
+    "title": "Generate an Image",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await generationGenerateImage(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

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

@@ -0,0 +1,71 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 326fa47baec5
+ */
+
+import { generationGenerateImageFromImages } from "../../funcs/generationGenerateImageFromImages.js";
+import { ImageToImageRequest$zodSchema } from "../../models/imagetoimagerequest.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: ImageToImageRequest$zodSchema.describe(
+    `A JSON object containing the image-to-image generation request parameters.`,
+  ),
+};
+
+export const tool$generationGenerateImageFromImages: ToolDefinition<
+  typeof args
+> = {
+  name: "generate-image-from-images",
+  description: `Generate an image from reference images
+
+Generate an image guided by one or more **reference images** — restyle,
+on-brand variants, character consistency, virtual try-on, edit/extend —
+steered by \`prompt\`.
+
+Only edit-capable models are selectable here. The model is selected via
+the optional \`model\` object, exactly like \`text_to_image\`, but IDs are
+restricted to edit models:
+1. If \`model.id\` is provided, use that exact edit model.
+2. Else if \`model.family\` (+ optional \`model.tier\`) is provided, resolve
+
+
+
+
+
+
+
+
+   to that family's edit model (e.g. \`nano-banana\` / \`premium\` →
+   \`nano-banana-2-edit\`).
+3. If \`model\` is omitted, use the default edit model (\`nano-banana-2-edit\`).
+
+Each reference image is either a stored managed asset (by \`asset_id\`,
+read-permission checked) or an external HTTPS \`url\`.
+`,
+  scopes: ["builder"],
+  annotations: {
+    "title": "Generate an Image from Reference Images",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await generationGenerateImageFromImages(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

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

@@ -29,11 +29,12 @@ Uses a Lucene-like query language to filter assets by descriptive attributes (\`
 - **Booleans**: \`AND\`, \`OR\`, \`NOT\` (uppercase), or \`+\` (must), \`-\` (must not). \`NOT\` must appear between clauses — a bare leading \`NOT\` is a parse error; use \`-field:value\` to negate the first clause. Group with parentheses: \`(shirt OR pants) AND clothes\`.
 - **Wildcards**: trailing \`*\` only, for prefix match (\`public_id:shoes_*\`, \`format:jp*\`, \`tags:shirt*\`). Not supported on \`folder\`, \`asset_folder\`, \`resource_type\`, or \`type\`. Leading \`*\`, middle \`*\`, \`?\`, and bare \`*\` (\`folder:*\`, \`context.alt:*\`) are all parse errors — wildcards cannot be used as a "field is present" probe.
 - **Tokenized vs exact fields**: \`tags\`, \`filename\`, \`display_name\`, \`context.<key>\`, and \`metadata.<id>\` match on tokens split by whitespace and punctuation — \`tags:analysis\` matches the tag \`full-analysis\`. \`public_id\`, \`folder\`, \`asset_folder\`, and \`format\` match the whole value — \`public_id:dog\` will not match \`dog_pldcwy\`; use \`public_id="dog_pldcwy"\` (exact) or \`public_id:dog*\` (prefix). These exact-match fields still accept a trailing \`*\` for prefix match (except \`folder\` / \`asset_folder\`, where wildcards are ignored).
-- **Dates**: ISO-8601 in quotes (\`uploaded_at>"2024-01-15"\`) or relative shorthand \`Nh\`, \`Nd\`, \`Nw\`, \`Nm\`, \`Ny\` (\`uploaded_at>1d\`, \`created_at:[4w TO 1w]\`). Send raw \`<\`/\`>\`, never HTML-escaped.
-- **Quoting**: wrap any value containing a space, colon, or other reserved character (\`! ( ) { } [ ] ^ ~ ?  \\ = & < > |\`) in double quotes, or escape each character with \`\\\`. Examples: \`tags:"service:mantels"\`, \`aspect_ratio:"16:9"\`, \`folder:"My Folder"\`.
+- **Dates**: ISO-8601 in quotes (\`uploaded_at>"2024-01-15"\`, \`created_at>"2026-01-01T00:00:00Z"\`) or relative shorthand \`Nh\`, \`Nd\`, \`Nw\` (\`uploaded_at>1d\`, \`created_at:[4w TO 1w]\`). Send raw \`<\`/\`>\`, never HTML-escaped.
+- **Quoting**: wrap any value containing a space, colon, or other reserved character (\`! ( ) { } [ ] ^ ~ ?  \\ = & < > |\`) in double quotes, or escape each character with \`\\\`. Examples: \`tags:"service:mantels"\`, \`tags:"brand:openhaul"\`, \`aspect_ratio:"16:9"\`, \`folder:"My Folder"\`.
 
 ## Common mistakes
 
+- No months or years shorthand. \`1m\` and \`1y\` are not supported; use ISO dates: \`created_at>"2024-01-01"\` or \`created_at:["2024-01-01" TO "2024-04-01"]\`.
 - Use \`folder:\` or \`asset_folder:\` (singular); \`folders:\`, \`asset_folder_id:\`, and other invented variants are not valid fields. Pass the exact folder name — wildcards do not apply here.
 - There is no "has any value" / presence probe. \`folder:*\`, \`metadata.alt:*\`, \`context.key:*\`, \`tags:*\`, and \`-tags:*\` are all parse errors. See *"Which assets have any value for \`metadata.<id>\`?"* under **Common tasks** for workarounds.
 - \`NOT foo AND bar\` is a parse error. Write it as \`bar AND NOT foo\` or \`-foo AND bar\`, and keep every \`NOT\` between two clauses (\`a AND NOT b AND NOT c\` is fine; \`NOT b AND NOT c …\` is not).

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

@@ -0,0 +1,44 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d4dcec03e501
+ */
+
+import * as z from "zod";
+import { tasksGetGenerationTaskStatus } from "../../funcs/tasksGetGenerationTaskStatus.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  task_id: z.string().describe("The ID of the generation task."),
+};
+
+export const tool$tasksGetGenerationTaskStatus: ToolDefinition<typeof args> = {
+  name: "get-generation-task",
+  description: `Get a generation task
+
+Get the status of a generation task.`,
+  scopes: ["builder"],
+  annotations: {
+    "title": "Get a Generation Task",
+    "destructiveHint": false,
+    "idempotentHint": true,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await tasksGetGenerationTaskStatus(
+      client,
+      args.task_id,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

package/src/mcp-server/tools.ts

@@ -357,6 +357,8 @@ export function registerDynamicTools(
       if (def.args) {
         const jsonSchema = z.toJSONSchema(z.object(def.args), {
           target: "draft-2020-12",
+          io: "input",
+          unrepresentable: "any",
         });
         schemaText += JSON.stringify(jsonSchema, null, 2);
       } else {

package/src/models/addonquota.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1e523cb9c814
+ */
+
+import * as z from "zod";
+import { Feature, Feature$zodSchema } from "./feature.js";
+
+/**
+ * Quota usage for a single add-on.
+ */
+export type AddonQuota = {
+  type: Feature;
+  used_by_request: number | null;
+  remaining: number | null;
+  limit: number | null;
+};
+
+export const AddonQuota$zodSchema: z.ZodType<AddonQuota> = z.object({
+  limit: z.int().nullable().describe("Maximum generations allowed per period."),
+  remaining: z.int().nullable().describe(
+    "Generations remaining in the current period.",
+  ),
+  type: Feature$zodSchema.describe("The add-on a quota applies to."),
+  used_by_request: z.int().nullable().describe(
+    "Number of generations consumed by this request.",
+  ),
+}).describe("Quota usage for a single add-on.");