ce-storefront 0.7.3 → 0.8.2

package/src/mcp-server/extensions.ts

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ZodRawShape } from "zod";
+import { PromptArgsRawShape, PromptDefinition } from "./prompts.js";
+import { ResourceDefinition, ResourceTemplateDefinition } from "./resources.js";
+import { ToolDefinition } from "./tools.js";
+
+export type Register = {
+  tool: <A extends ZodRawShape | undefined>(def: ToolDefinition<A>) => void;
+  resource: (def: ResourceDefinition) => void;
+  resourceTemplate: (def: ResourceTemplateDefinition) => void;
+  prompt: <A extends PromptArgsRawShape | undefined>(
+    prompt: PromptDefinition<A>,
+  ) => void;
+};

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

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { buildApplication, buildRouteMap, run } from "@stricli/core";
+import process from "node:process";
+import { buildContext } from "./cli.js";
+import { startCommand } from "./cli/start/command.js";
+
+const routes = buildRouteMap({
+  routes: {
+    start: startCommand,
+  },
+  docs: {
+    brief: "MCP server CLI",
+  },
+});
+
+export const app = buildApplication(routes, {
+  name: "mcp",
+  versionInfo: {
+    currentVersion: "0.8.2",
+  },
+});
+
+run(app, process.argv.slice(2), buildContext(process));

package/src/mcp-server/prompts.ts

@@ -0,0 +1,110 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
+import {
+  objectOutputType,
+  ZodOptional,
+  ZodType,
+  ZodTypeAny,
+  ZodTypeDef,
+} from "zod";
+import { CeStorefrontCore } from "../core.js";
+import { ConsoleLogger } from "./console-logger.js";
+import { MCPScope } from "./scopes.js";
+
+// '@modelcontextprotocol/sdk' currently does not export this type
+export type PromptArgsRawShape = {
+  [k: string]:
+    | ZodType<string, ZodTypeDef, string>
+    | ZodOptional<ZodType<string, ZodTypeDef, string>>;
+};
+
+export type PromptDefinition<
+  Args extends undefined | PromptArgsRawShape = undefined,
+> = Args extends PromptArgsRawShape ? {
+    name: string;
+    description?: string;
+    scopes?: MCPScope[];
+    args: Args;
+    prompt: (
+      client: CeStorefrontCore,
+      args: objectOutputType<Args, ZodTypeAny>,
+      extra: RequestHandlerExtra,
+    ) => GetPromptResult | Promise<GetPromptResult>;
+  }
+  : {
+    name: string;
+    description?: string;
+    scopes?: MCPScope[];
+    args?: undefined;
+    prompt: (
+      client: CeStorefrontCore,
+      extra: RequestHandlerExtra,
+    ) => GetPromptResult | Promise<GetPromptResult>;
+  };
+
+// Optional function to assist with formatting prompt results
+export async function formatResult(value: string): Promise<GetPromptResult> {
+  return {
+    messages: [
+      {
+        role: "user",
+        content: {
+          type: "text",
+          text: value,
+        },
+      },
+    ],
+  };
+}
+
+export function createRegisterPrompt(
+  logger: ConsoleLogger,
+  server: McpServer,
+  sdk: CeStorefrontCore,
+  allowedScopes: Set<MCPScope>,
+): <A extends PromptArgsRawShape | undefined>(
+  prompt: PromptDefinition<A>,
+) => void {
+  return <A extends PromptArgsRawShape | undefined>(
+    prompt: PromptDefinition<A>,
+  ): void => {
+    const scopes = prompt.scopes ?? [];
+    if (!scopes.every((s: MCPScope) => allowedScopes.has(s))) {
+      return;
+    }
+
+    if (prompt.args) {
+      if (prompt.description) {
+        server.prompt(
+          prompt.name,
+          prompt.description,
+          prompt.args,
+          async (args, ctx) => prompt.prompt(sdk, args, ctx),
+        );
+      } else {
+        server.prompt(
+          prompt.name,
+          prompt.args,
+          async (args, ctx) => prompt.prompt(sdk, args, ctx),
+        );
+      }
+    } else {
+      if (prompt.description) {
+        server.prompt(
+          prompt.name,
+          prompt.description,
+          async (ctx) => prompt.prompt(sdk, ctx),
+        );
+      } else {
+        server.prompt(prompt.name, async (ctx) => prompt.prompt(sdk, ctx));
+      }
+    }
+
+    logger.debug("Registered prompt", { name: prompt.name });
+  };
+}

package/src/mcp-server/resources.ts

@@ -0,0 +1,158 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  McpServer,
+  ResourceMetadata,
+  ResourceTemplate,
+} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { Variables } from "@modelcontextprotocol/sdk/shared/uriTemplate.js";
+import { ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
+import { CeStorefrontCore } from "../core.js";
+import { ConsoleLogger } from "./console-logger.js";
+import { MCPScope } from "./scopes.js";
+import { isAsyncIterable, isBinaryData, valueToBase64 } from "./shared.js";
+
+export type ReadResourceCallback = (
+  client: CeStorefrontCore,
+  uri: URL,
+  extra: RequestHandlerExtra,
+) => ReadResourceResult | Promise<ReadResourceResult>;
+
+export type ResourceDefinition = {
+  name: string;
+  description?: string;
+  metadata?: ResourceMetadata;
+  scopes?: MCPScope[];
+  resource: string;
+  read: ReadResourceCallback;
+};
+
+export type ReadResourceTemplateCallback = (
+  client: CeStorefrontCore,
+  uri: URL,
+  vars: Variables,
+  extra: RequestHandlerExtra,
+) => ReadResourceResult | Promise<ReadResourceResult>;
+
+export type ResourceTemplateDefinition = {
+  name: string;
+  description: string;
+  metadata?: ResourceMetadata;
+  scopes?: MCPScope[];
+  resource: ResourceTemplate;
+  read: ReadResourceTemplateCallback;
+};
+
+// Optional function to assist with formatting resource results
+export async function formatResult(
+  value: unknown,
+  uri: URL,
+  init: { mimeType?: string | undefined; response?: Response | undefined },
+): Promise<ReadResourceResult> {
+  if (typeof value === "undefined") {
+    return { contents: [] };
+  }
+
+  let contents: ReadResourceResult["contents"] = [];
+
+  const mimeType = init.mimeType ?? init.response?.headers.get("content-type")
+    ?? "";
+
+  if (mimeType.search(/\bjson\b/g) !== -1) {
+    contents = [{ uri: uri.toString(), mimeType, text: JSON.stringify(value) }];
+  } else if (
+    mimeType.startsWith("text/event-stream")
+    && isAsyncIterable(value)
+  ) {
+    contents = [
+      {
+        uri: uri.toString(),
+        mimeType: "application/json",
+        text: await stringifySSEToJSON(value),
+      },
+    ];
+  } else if (
+    (mimeType.startsWith("text/") || mimeType.startsWith("application/"))
+    && typeof value === "string"
+  ) {
+    contents = [{ uri: uri.toString(), mimeType, text: value }];
+  } else if (isBinaryData(value)) {
+    const blob = await valueToBase64(value);
+    contents = blob == null ? [] : [{ uri: uri.toString(), blob, mimeType }];
+  } else {
+    throw new Error(`Unsupported content type: "${mimeType}"`);
+  }
+
+  return { contents };
+}
+
+async function stringifySSEToJSON(
+  value: AsyncIterable<unknown>,
+): Promise<string> {
+  const payloads = [];
+
+  for await (const chunk of value) {
+    payloads.push(chunk);
+  }
+
+  return JSON.stringify(payloads);
+}
+
+export function createRegisterResource(
+  logger: ConsoleLogger,
+  server: McpServer,
+  sdk: CeStorefrontCore,
+  allowedScopes: Set<MCPScope>,
+): (resource: ResourceDefinition) => void {
+  return (resource: ResourceDefinition): void => {
+    const scopes = resource.scopes ?? [];
+    if (!scopes.every((s: MCPScope) => allowedScopes.has(s))) {
+      return;
+    }
+
+    const metadata: ResourceMetadata = {
+      ...resource.metadata,
+      description: resource.description,
+    };
+
+    server.resource(
+      resource.name,
+      resource.resource,
+      metadata,
+      async (uri, ctx) => resource.read(sdk, uri, ctx),
+    );
+
+    logger.debug("Registered resource", { name: resource.name });
+  };
+}
+
+export function createRegisterResourceTemplate(
+  logger: ConsoleLogger,
+  server: McpServer,
+  sdk: CeStorefrontCore,
+  allowedScopes: Set<MCPScope>,
+): (resource: ResourceTemplateDefinition) => void {
+  return (resource: ResourceTemplateDefinition): void => {
+    const scopes = resource.scopes ?? [];
+    if (!scopes.every((s: MCPScope) => allowedScopes.has(s))) {
+      return;
+    }
+
+    const metadata: ResourceMetadata = {
+      ...resource.metadata,
+      description: resource.description,
+    };
+
+    server.resource(
+      resource.name,
+      resource.resource,
+      metadata,
+      async (uri, vars, ctx) => resource.read(sdk, uri, vars, ctx),
+    );
+
+    logger.debug("Registered resource template", { name: resource.name });
+  };
+}

package/src/mcp-server/scopes.ts

@@ -0,0 +1,7 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export const mcpScopes = [] as const;
+
+export type MCPScope = (typeof mcpScopes)[number];

package/src/mcp-server/server.ts

@@ -0,0 +1,159 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CeStorefrontCore } from "../core.js";
+import { SDKOptions } from "../lib/config.js";
+import type { ConsoleLogger } from "./console-logger.js";
+import { createRegisterPrompt } from "./prompts.js";
+import {
+  createRegisterResource,
+  createRegisterResourceTemplate,
+} from "./resources.js";
+import { MCPScope, mcpScopes } from "./scopes.js";
+import { createRegisterTool } from "./tools.js";
+import { tool$authCheckVerificationStatus } from "./tools/authCheckVerificationStatus.js";
+import { tool$authCreateNotificationPreferences } from "./tools/authCreateNotificationPreferences.js";
+import { tool$authGenerateOtp } from "./tools/authGenerateOtp.js";
+import { tool$authGetNotificationPreferences } from "./tools/authGetNotificationPreferences.js";
+import { tool$authGetUserDetail } from "./tools/authGetUserDetail.js";
+import { tool$authLoginWithEmail } from "./tools/authLoginWithEmail.js";
+import { tool$authLoginWithPhone } from "./tools/authLoginWithPhone.js";
+import { tool$authLoginWithWhatsapp } from "./tools/authLoginWithWhatsapp.js";
+import { tool$authLogout } from "./tools/authLogout.js";
+import { tool$authRefreshToken } from "./tools/authRefreshToken.js";
+import { tool$authUpdateNotificationPreferences } from "./tools/authUpdateNotificationPreferences.js";
+import { tool$authUpdateUser } from "./tools/authUpdateUser.js";
+import { tool$authVerifyOtp } from "./tools/authVerifyOtp.js";
+import { tool$campaignsSubscribeNewsletter } from "./tools/campaignsSubscribeNewsletter.js";
+import { tool$cartsApplyCoupon } from "./tools/cartsApplyCoupon.js";
+import { tool$cartsCreateCart } from "./tools/cartsCreateCart.js";
+import { tool$cartsCreateCartAddress } from "./tools/cartsCreateCartAddress.js";
+import { tool$cartsDeleteCart } from "./tools/cartsDeleteCart.js";
+import { tool$cartsGetCart } from "./tools/cartsGetCart.js";
+import { tool$cartsGetUserCart } from "./tools/cartsGetUserCart.js";
+import { tool$cartsRemoveCoupon } from "./tools/cartsRemoveCoupon.js";
+import { tool$cartsRemoveUserCart } from "./tools/cartsRemoveUserCart.js";
+import { tool$cartsUpdateCart } from "./tools/cartsUpdateCart.js";
+import { tool$catalogGetProductDetail } from "./tools/catalogGetProductDetail.js";
+import { tool$catalogGetVariantDetail } from "./tools/catalogGetVariantDetail.js";
+import { tool$catalogListCategories } from "./tools/catalogListCategories.js";
+import { tool$catalogListCrosssellProducts } from "./tools/catalogListCrosssellProducts.js";
+import { tool$catalogListProductReviews } from "./tools/catalogListProductReviews.js";
+import { tool$catalogListProducts } from "./tools/catalogListProducts.js";
+import { tool$catalogListProductVariants } from "./tools/catalogListProductVariants.js";
+import { tool$catalogListSimilarProducts } from "./tools/catalogListSimilarProducts.js";
+import { tool$catalogListSkus } from "./tools/catalogListSkus.js";
+import { tool$catalogListUpsellProducts } from "./tools/catalogListUpsellProducts.js";
+import { tool$catalogSearchProducts } from "./tools/catalogSearchProducts.js";
+import { tool$commonListCountryPincodes } from "./tools/commonListCountryPincodes.js";
+import { tool$customersCreateAddress } from "./tools/customersCreateAddress.js";
+import { tool$customersDeleteAddress } from "./tools/customersDeleteAddress.js";
+import { tool$customersGetAddressDetail } from "./tools/customersGetAddressDetail.js";
+import { tool$customersListAddresses } from "./tools/customersListAddresses.js";
+import { tool$customersListUserReviews } from "./tools/customersListUserReviews.js";
+import { tool$customersUpdateAddressDetail } from "./tools/customersUpdateAddressDetail.js";
+import { tool$ordersCancelOrder } from "./tools/ordersCancelOrder.js";
+import { tool$ordersCreateOrder } from "./tools/ordersCreateOrder.js";
+import { tool$ordersGetOrderDetail } from "./tools/ordersGetOrderDetail.js";
+import { tool$ordersGetPaymentStatus } from "./tools/ordersGetPaymentStatus.js";
+import { tool$ordersListOrders } from "./tools/ordersListOrders.js";
+import { tool$ordersListOrderShipments } from "./tools/ordersListOrderShipments.js";
+import { tool$ordersRetryOrderPayment } from "./tools/ordersRetryOrderPayment.js";
+import { tool$shippingCheckDeliveryAvailability } from "./tools/shippingCheckDeliveryAvailability.js";
+
+export function createMCPServer(deps: {
+  logger: ConsoleLogger;
+  allowedTools?: string[] | undefined;
+  scopes?: MCPScope[] | undefined;
+  serverURL?: string | undefined;
+  authorization?: SDKOptions["authorization"] | undefined;
+  server?: SDKOptions["server"] | undefined;
+  storeId?: SDKOptions["storeId"] | undefined;
+}) {
+  const server = new McpServer({
+    name: "CeStorefront",
+    version: "0.8.2",
+  });
+
+  const client = new CeStorefrontCore({
+    authorization: deps.authorization,
+    serverURL: deps.serverURL,
+    server: deps.server,
+    storeId: deps.storeId,
+  });
+
+  const scopes = new Set(deps.scopes ?? mcpScopes);
+
+  const allowedTools = deps.allowedTools && new Set(deps.allowedTools);
+  const tool = createRegisterTool(
+    deps.logger,
+    server,
+    client,
+    scopes,
+    allowedTools,
+  );
+  const resource = createRegisterResource(deps.logger, server, client, scopes);
+  const resourceTemplate = createRegisterResourceTemplate(
+    deps.logger,
+    server,
+    client,
+    scopes,
+  );
+  const prompt = createRegisterPrompt(deps.logger, server, client, scopes);
+  const register = { tool, resource, resourceTemplate, prompt };
+  void register; // suppress unused warnings
+
+  tool(tool$catalogListProducts);
+  tool(tool$catalogListSkus);
+  tool(tool$catalogGetProductDetail);
+  tool(tool$catalogListProductVariants);
+  tool(tool$catalogGetVariantDetail);
+  tool(tool$catalogListCategories);
+  tool(tool$catalogListProductReviews);
+  tool(tool$catalogListSimilarProducts);
+  tool(tool$catalogListUpsellProducts);
+  tool(tool$catalogListCrosssellProducts);
+  tool(tool$catalogSearchProducts);
+  tool(tool$cartsCreateCart);
+  tool(tool$cartsGetCart);
+  tool(tool$cartsDeleteCart);
+  tool(tool$cartsGetUserCart);
+  tool(tool$cartsRemoveUserCart);
+  tool(tool$cartsUpdateCart);
+  tool(tool$cartsCreateCartAddress);
+  tool(tool$cartsApplyCoupon);
+  tool(tool$cartsRemoveCoupon);
+  tool(tool$customersListAddresses);
+  tool(tool$customersCreateAddress);
+  tool(tool$customersGetAddressDetail);
+  tool(tool$customersUpdateAddressDetail);
+  tool(tool$customersDeleteAddress);
+  tool(tool$customersListUserReviews);
+  tool(tool$ordersCreateOrder);
+  tool(tool$ordersListOrders);
+  tool(tool$ordersGetOrderDetail);
+  tool(tool$ordersGetPaymentStatus);
+  tool(tool$ordersListOrderShipments);
+  tool(tool$ordersCancelOrder);
+  tool(tool$ordersRetryOrderPayment);
+  tool(tool$shippingCheckDeliveryAvailability);
+  tool(tool$authLoginWithPhone);
+  tool(tool$authLoginWithEmail);
+  tool(tool$authLoginWithWhatsapp);
+  tool(tool$authVerifyOtp);
+  tool(tool$authGetUserDetail);
+  tool(tool$authUpdateUser);
+  tool(tool$authRefreshToken);
+  tool(tool$authGetNotificationPreferences);
+  tool(tool$authCreateNotificationPreferences);
+  tool(tool$authUpdateNotificationPreferences);
+  tool(tool$authGenerateOtp);
+  tool(tool$authLogout);
+  tool(tool$authCheckVerificationStatus);
+  tool(tool$commonListCountryPincodes);
+  tool(tool$campaignsSubscribeNewsletter);
+
+  return server;
+}

package/src/mcp-server/shared.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { bytesToBase64 } from "../lib/base64.js";
+
+type BinaryData =
+  | Uint8Array
+  | ArrayBuffer
+  | Blob
+  | ReadableStream
+  | Response
+  | string;
+
+export async function consumeStream(
+  stream: ReadableStream<Uint8Array>,
+): Promise<Uint8Array> {
+  const reader = stream.getReader();
+  const chunks: Uint8Array[] = [];
+
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (value != null) chunks.push(value);
+      if (done) break;
+    }
+  } finally {
+    reader.releaseLock();
+  }
+
+  return new Uint8Array(await new Blob(chunks).arrayBuffer());
+}
+
+export function isAsyncIterable(
+  value: unknown,
+): value is AsyncIterable<string> {
+  return (
+    typeof value === "object" && value != null && Symbol.asyncIterator in value
+  );
+}
+
+export function isBinaryData(value: unknown): value is BinaryData {
+  return (
+    value instanceof Uint8Array
+    || value instanceof ArrayBuffer
+    || value instanceof Blob
+    || value instanceof ReadableStream
+    || value instanceof Response
+    || typeof value === "string"
+  );
+}
+
+const base64Schema = z.string().base64();
+
+export async function valueToBase64(
+  value: BinaryData | null | undefined,
+): Promise<string | null> {
+  if (value == null) {
+    return null;
+  } else if (value instanceof Uint8Array) {
+    return bytesToBase64(value);
+  } else if (value instanceof ArrayBuffer) {
+    return bytesToBase64(new Uint8Array(value));
+  } else if (value instanceof Response || value instanceof Blob) {
+    return bytesToBase64(new Uint8Array(await value.arrayBuffer()));
+  } else if (value instanceof ReadableStream) {
+    return bytesToBase64(await consumeStream(value));
+  } else if (typeof value === "string") {
+    return base64Schema.parse(value);
+  } else {
+    value satisfies never;
+    throw new Error(`Unsupported image value type: ${typeof value}`);
+  }
+}

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { authCheckVerificationStatus } from "../../funcs/authCheckVerificationStatus.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CheckVerificationStatusRequestBody$inboundSchema,
+};
+
+export const tool$authCheckVerificationStatus: ToolDefinition<typeof args> = {
+  name: "auth-check-verification-status",
+  description: `Check email/phone verification status
+
+The Check Verification Status API allows to verify the status of email and phone number verification for a specific user. Upon a successful request, the API responds with the verification status of the provided email and phone number. If the user is not found or there's an issue with the request, an error response is returned with an appropriate message.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await authCheckVerificationStatus(
+      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/authCreateNotificationPreferences.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { authCreateNotificationPreferences } from "../../funcs/authCreateNotificationPreferences.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CreateNotificationPreferencesRequest$inboundSchema,
+};
+
+export const tool$authCreateNotificationPreferences: ToolDefinition<
+  typeof args
+> = {
+  name: "auth-create-notification-preferences",
+  description: `Create user notification preferences
+
+Create user notification preferences API allows clients to create a user's notification preferences based on their unique user identifier (user_id).`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await authCreateNotificationPreferences(
+      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/authGenerateOtp.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { authGenerateOtp } from "../../funcs/authGenerateOtp.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GenerateOtpRequestBody$inboundSchema,
+};
+
+export const tool$authGenerateOtp: ToolDefinition<typeof args> = {
+  name: "auth-generate-otp",
+  description: `Generate OTP
+
+Generating a One-Time Password (OTP) typically involves creating a random code that is sent to a user for authentication or verification purposes.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await authGenerateOtp(
+      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);
+  },
+};