@vendure/mcp-plugin 3.8.0-minor-bootstrap.0

package/lib/tools/built-in/serializer.service.js

@@ -0,0 +1,413 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpToolSerializerService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+/** How much of a product's description a list item keeps; `get_product` has the whole text. */
+const LIST_ITEM_DESCRIPTION_LENGTH = 200;
+// Every built-in tool that returns an entity goes through this service, so each entity's output
+// shape has a single definition. It needs to be injectable because prices need the store's
+// configured decimal places, which only ConfigService can provide.
+let McpToolSerializerService = class McpToolSerializerService {
+    constructor(configService) {
+        this.configService = configService;
+    }
+    // Tool results carry the raw whole-number amount as well as this formatted string, so a
+    // language model can quote a price without doing the division itself.
+    //
+    // The digits are shifted as text rather than divided, because dividing by 100 can introduce
+    // floating-point error on real-world prices.
+    decimal(value) {
+        var _a;
+        const precision = (_a = this.configService.entityOptions.moneyStrategy.precision) !== null && _a !== void 0 ? _a : 2;
+        // Only matters if a store configures its own money strategy that can hand over a
+        // fractional amount; under the default one this is already a whole number.
+        const rounded = Math.round(value !== null && value !== void 0 ? value : 0);
+        const negative = rounded < 0;
+        const digits = String(Math.abs(rounded));
+        if (precision === 0) {
+            return `${negative ? '-' : ''}${digits}`;
+        }
+        const padded = digits.padStart(precision + 1, '0');
+        const whole = padded.slice(0, -precision);
+        const fraction = padded.slice(-precision);
+        return `${negative ? '-' : ''}${whole}.${fraction}`;
+    }
+    // UTC ISO strings so a language model can compare and quote dates without knowing the server's timezone.
+    isoDate(value) {
+        return value ? new Date(value).toISOString() : null;
+    }
+    variant(variant) {
+        if (!variant)
+            return null;
+        return {
+            id: variant.id,
+            name: variant.name,
+            sku: variant.sku,
+            enabled: variant.enabled,
+            price: variant.price,
+            priceDecimal: this.decimal(variant.price),
+            priceWithTax: variant.priceWithTax,
+            priceWithTaxDecimal: this.decimal(variant.priceWithTax),
+            currencyCode: variant.currencyCode,
+        };
+    }
+    adminVariant(variant, stockOnHand) {
+        return Object.assign(Object.assign({}, this.variant(variant)), { stockOnHand });
+    }
+    product(product) {
+        if (!product)
+            return null;
+        return {
+            id: product.id,
+            name: product.name,
+            slug: product.slug,
+            description: product.description,
+            enabled: product.enabled,
+            featuredAsset: product.featuredAsset ? this.asset(product.featuredAsset) : null,
+        };
+    }
+    productListItem(product, variants) {
+        var _a;
+        const description = (_a = product.description) !== null && _a !== void 0 ? _a : '';
+        return {
+            id: product.id,
+            name: product.name,
+            slug: product.slug,
+            description: description.length > LIST_ITEM_DESCRIPTION_LENGTH
+                ? `${description.slice(0, LIST_ITEM_DESCRIPTION_LENGTH)}...`
+                : description,
+            enabled: product.enabled,
+            featuredAsset: product.featuredAsset
+                ? { id: product.featuredAsset.id, preview: product.featuredAsset.preview }
+                : null,
+            priceRange: this.priceRange(variants),
+        };
+    }
+    priceRange(variants) {
+        if (variants.length === 0)
+            return null;
+        const prices = variants.map(variant => variant.priceWithTax);
+        const min = Math.min(...prices);
+        const max = Math.max(...prices);
+        return {
+            min,
+            minDecimal: this.decimal(min),
+            max,
+            maxDecimal: this.decimal(max),
+            currencyCode: variants[0].currencyCode,
+        };
+    }
+    // The option IDs here are what create_variant and update_variant take.
+    optionGroup(group) {
+        var _a;
+        return {
+            id: group.id,
+            code: group.code,
+            name: group.name,
+            options: ((_a = group.options) !== null && _a !== void 0 ? _a : []).map(option => ({
+                id: option.id,
+                code: option.code,
+                name: option.name,
+            })),
+        };
+    }
+    // stockLocationId is what adjust_stock needs; the name lets an agent tell locations apart.
+    stockLevel(level) {
+        var _a, _b;
+        return {
+            stockLocationId: level.stockLocationId,
+            stockLocationName: (_b = (_a = level.stockLocation) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : null,
+            stockOnHand: level.stockOnHand,
+            stockAllocated: level.stockAllocated,
+        };
+    }
+    collection(collection) {
+        if (!collection)
+            return null;
+        return {
+            id: collection.id,
+            name: collection.name,
+            slug: collection.slug,
+            description: collection.description,
+            featuredAsset: collection.featuredAsset ? this.asset(collection.featuredAsset) : null,
+        };
+    }
+    channel(channel) {
+        return {
+            id: channel.id,
+            code: channel.code,
+            token: channel.token,
+        };
+    }
+    customer(customer, addresses) {
+        if (!customer)
+            return null;
+        return {
+            id: customer.id,
+            firstName: customer.firstName,
+            lastName: customer.lastName,
+            emailAddress: customer.emailAddress,
+            phoneNumber: customer.phoneNumber,
+            addresses: addresses ? addresses.map(address => this.customerAddress(address)) : undefined,
+        };
+    }
+    customerAddress(address) {
+        var _a;
+        return Object.assign(Object.assign({ id: address.id }, this.address({
+            fullName: address.fullName,
+            company: address.company,
+            streetLine1: address.streetLine1,
+            streetLine2: address.streetLine2,
+            city: address.city,
+            province: address.province,
+            postalCode: address.postalCode,
+            // A saved address points at a Country entity, while an order stores the code directly.
+            countryCode: (_a = address.country) === null || _a === void 0 ? void 0 : _a.code,
+            phoneNumber: address.phoneNumber,
+        })), { defaultShippingAddress: address.defaultShippingAddress, defaultBillingAddress: address.defaultBillingAddress });
+    }
+    /** A customer group, whose ID is what `add_customer_to_group` takes. */
+    customerGroup(group) {
+        return { id: group.id, name: group.name };
+    }
+    // Errors are returned directly so the registry can report them as failed tool calls.
+    customerOrError(result) {
+        if (!(0, core_1.isGraphQlErrorResult)(result)) {
+            return { customer: this.customer(result) };
+        }
+        return Object.assign({}, result);
+    }
+    // State and amount together tell a caller whether this payment finished the checkout or left a balance.
+    payment(payment) {
+        var _a, _b, _c;
+        return {
+            id: payment.id,
+            method: payment.method,
+            amount: payment.amount,
+            amountDecimal: this.decimal(payment.amount),
+            state: payment.state,
+            transactionId: payment.transactionId,
+            errorMessage: payment.errorMessage,
+            publicMetadata: (_b = (_a = payment.metadata) === null || _a === void 0 ? void 0 : _a.public) !== null && _b !== void 0 ? _b : null,
+            refunds: (_c = payment.refunds) === null || _c === void 0 ? void 0 : _c.map(refund => {
+                var _a;
+                return ({
+                    id: refund.id,
+                    state: refund.state,
+                    total: refund.total,
+                    totalDecimal: this.decimal(refund.total),
+                    reason: (_a = refund.reason) !== null && _a !== void 0 ? _a : null,
+                });
+            }),
+        };
+    }
+    fulfillment(fulfillment, lines) {
+        return {
+            id: fulfillment.id,
+            state: fulfillment.state,
+            method: fulfillment.method,
+            trackingCode: fulfillment.trackingCode,
+            lines: lines.map(line => ({ orderLineId: line.orderLineId, quantity: line.quantity })),
+        };
+    }
+    refund(refund, currencyCode) {
+        var _a;
+        return {
+            id: refund.id,
+            state: refund.state,
+            total: refund.total,
+            totalDecimal: this.decimal(refund.total),
+            currencyCode,
+            reason: (_a = refund.reason) !== null && _a !== void 0 ? _a : null,
+            paymentId: refund.paymentId,
+        };
+    }
+    orderAddress(address) {
+        if (!address || Object.keys(address).length === 0)
+            return null;
+        return this.address(address);
+    }
+    address(address) {
+        // Null fields are dropped rather than sent as null, to save tokens; an empty string is kept
+        // since that's a value someone actually typed in.
+        const present = {};
+        const fields = [
+            'fullName',
+            'company',
+            'streetLine1',
+            'streetLine2',
+            'city',
+            'province',
+            'postalCode',
+            'countryCode',
+            'phoneNumber',
+        ];
+        for (const field of fields) {
+            const value = address[field];
+            if (value != null) {
+                present[field] = value;
+            }
+        }
+        return present;
+    }
+    orderNote(entry) {
+        return {
+            id: entry.id,
+            text: entry.data.note,
+            isPublic: entry.isPublic,
+            createdAt: this.isoDate(entry.createdAt),
+        };
+    }
+    order(order) {
+        var _a, _b;
+        if (!order)
+            return null;
+        return {
+            id: order.id,
+            code: order.code,
+            state: order.state,
+            active: order.active,
+            total: order.total,
+            totalDecimal: this.decimal(order.total),
+            totalWithTax: order.totalWithTax,
+            totalWithTaxDecimal: this.decimal(order.totalWithTax),
+            currencyCode: order.currencyCode,
+            totalQuantity: order.totalQuantity,
+            createdAt: this.isoDate(order.createdAt),
+            updatedAt: this.isoDate(order.updatedAt),
+            // Null while the order is still an open cart, set when the customer checks out.
+            orderPlacedAt: this.isoDate(order.orderPlacedAt),
+            couponCodes: order.couponCodes,
+            discounts: order.discounts.map(discount => ({
+                adjustmentSource: discount.adjustmentSource,
+                type: discount.type,
+                description: discount.description,
+                amount: discount.amount,
+                amountDecimal: this.decimal(discount.amount),
+                amountWithTax: discount.amountWithTax,
+                amountWithTaxDecimal: this.decimal(discount.amountWithTax),
+            })),
+            lines: (_b = (_a = order.lines) === null || _a === void 0 ? void 0 : _a.map(line => ({
+                id: line.id,
+                quantity: line.quantity,
+                linePriceWithTax: line.linePriceWithTax,
+                linePriceWithTaxDecimal: this.decimal(line.linePriceWithTax),
+                productVariant: line.productVariant
+                    ? {
+                        id: line.productVariant.id,
+                        name: line.productVariant.name,
+                        sku: line.productVariant.sku,
+                    }
+                    : null,
+            }))) !== null && _b !== void 0 ? _b : [],
+            payments: order.payments ? order.payments.map(payment => this.payment(payment)) : undefined,
+            // Left out by the cart tools, since an open cart has no shipments to report.
+            fulfillments: order.fulfillments
+                ? order.fulfillments.map(fulfillment => { var _a; return this.fulfillment(fulfillment, (_a = fulfillment.lines) !== null && _a !== void 0 ? _a : []); })
+                : undefined,
+            customer: this.orderCustomer(order.customer),
+            shippingAddress: this.orderAddress(order.shippingAddress),
+            billingAddress: this.orderAddress(order.billingAddress),
+            shippingWithTax: order.shippingWithTax,
+            shippingWithTaxDecimal: this.decimal(order.shippingWithTax),
+            shippingLines: order.shippingLines
+                ? order.shippingLines.map(line => ({
+                    id: line.id,
+                    shippingMethodId: line.shippingMethodId,
+                    priceWithTax: line.priceWithTax,
+                    priceWithTaxDecimal: this.decimal(line.priceWithTax),
+                }))
+                : undefined,
+        };
+    }
+    orderCustomer(customer) {
+        if (customer === undefined)
+            return undefined;
+        if (customer === null)
+            return null;
+        return {
+            id: customer.id,
+            emailAddress: customer.emailAddress,
+            firstName: customer.firstName,
+            lastName: customer.lastName,
+        };
+    }
+    // Errors are returned directly so the registry can report them as failed tool calls.
+    orderOrError(result) {
+        if (!(0, core_1.isGraphQlErrorResult)(result)) {
+            return { order: this.order(result) };
+        }
+        const errorResult = Object.assign({}, result);
+        if (errorResult.order instanceof core_1.Order) {
+            errorResult.order = this.order(errorResult.order);
+        }
+        if (errorResult.errorCode === 'COUPON_REMOVED_DURING_CHECKOUT_ERROR' &&
+            typeof errorResult.newTotalWithTax === 'number' &&
+            typeof errorResult.previousTotalWithTax === 'number') {
+            errorResult.newTotalWithTaxDecimal = this.decimal(errorResult.newTotalWithTax);
+            errorResult.previousTotalWithTaxDecimal = this.decimal(errorResult.previousTotalWithTax);
+        }
+        return errorResult;
+    }
+    // The currency belongs to the order, not the quote, so the caller passes it in.
+    shippingQuote(quote, currencyCode) {
+        return Object.assign(Object.assign({}, quote), { customFields: this.shopVisibleCustomFields('ShippingMethod', quote.customFields), priceDecimal: this.decimal(quote.price), priceWithTaxDecimal: this.decimal(quote.priceWithTax), currencyCode });
+    }
+    /** Same as `shippingQuote`: copies the quote and cuts `customFields` to what the Shop API shows. */
+    paymentQuote(quote) {
+        return Object.assign(Object.assign({}, quote), { customFields: this.shopVisibleCustomFields('PaymentMethod', quote.customFields) });
+    }
+    // A shop caller never holds admin permissions, so anything permission-gated is hidden too.
+    shopVisibleCustomFields(entityName, customFields) {
+        var _a;
+        if (customFields == null) {
+            return customFields;
+        }
+        const configs = (_a = this.configService.customFields[entityName]) !== null && _a !== void 0 ? _a : [];
+        const visible = {};
+        for (const [key, value] of Object.entries(customFields)) {
+            const config = configs.find(candidate => candidate.name === key);
+            if (config &&
+                config.internal !== true &&
+                config.public !== false &&
+                config.requiresPermission == null) {
+                visible[key] = value;
+            }
+        }
+        return visible;
+    }
+    /**
+     * Called directly by `upload_asset`, and from `product()` and `collection()` for the asset
+     * fields they carry.
+     */
+    asset(asset) {
+        return {
+            id: asset.id,
+            name: asset.name,
+            type: asset.type,
+            mimeType: asset.mimeType,
+            width: asset.width,
+            height: asset.height,
+            fileSize: asset.fileSize,
+            source: asset.source,
+            preview: asset.preview,
+            focalPoint: asset.focalPoint,
+        };
+    }
+};
+exports.McpToolSerializerService = McpToolSerializerService;
+exports.McpToolSerializerService = McpToolSerializerService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ConfigService])
+], McpToolSerializerService);
+//# sourceMappingURL=serializer.service.js.map

package/lib/tools/built-in/serializer.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.service.js","sourceRoot":"","sources":["../../../src/tools/built-in/serializer.service.ts"],"names":[],"mappings":"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"}

package/lib/tools/built-in/shop/add-to-cart.tool.d.ts

@@ -0,0 +1,21 @@
+import { OrderService, ProductVariantService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpActiveOrderService } from '../active-order.service';
+import { McpToolSerializerService } from '../serializer.service';
+declare const addToCartInput: z.ZodObject<{
+    variantId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    productId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    quantity: z.ZodNumber;
+}, z.core.$strict>;
+type AddToCartInput = z.infer<typeof addToCartInput>;
+export declare class AddToCartTool implements McpToolHandler<AddToCartInput> {
+    private readonly activeOrder;
+    private readonly orderService;
+    private readonly productVariantService;
+    private readonly serializer;
+    constructor(activeOrder: McpActiveOrderService, orderService: OrderService, productVariantService: ProductVariantService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: AddToCartInput): Promise<Record<string, unknown>>;
+    private resolveVariantId;
+}
+export {};

package/lib/tools/built-in/shop/add-to-cart.tool.js

@@ -0,0 +1,100 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddToCartTool = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const mcp_sdk_1 = require("@vendure/mcp-sdk");
+const zod_1 = require("zod");
+const active_order_service_1 = require("../active-order.service");
+const id_schema_1 = require("../id-schema");
+const int32_schema_1 = require("../int32-schema");
+const serializer_service_1 = require("../serializer.service");
+const addToCartInput = zod_1.z.strictObject({
+    variantId: id_schema_1.idSchema
+        .describe('Product variant ID, taken from the variants listed by get_product. Give this or productId, not both.')
+        .optional(),
+    productId: id_schema_1.idSchema
+        .describe('Product ID, as returned by search_products or get_product. Never pass a variant ID here. ' +
+        'Use this only when the product has a single variant; if it has several, the call is ' +
+        'refused and the variants are listed so you can pass one as variantId instead.')
+        .optional(),
+    quantity: int32_schema_1.int32Schema.min(1).describe('Quantity, a whole number of at least 1.'),
+});
+let AddToCartTool = class AddToCartTool {
+    constructor(activeOrder, orderService, productVariantService, serializer) {
+        this.activeOrder = activeOrder;
+        this.orderService = orderService;
+        this.productVariantService = productVariantService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        const variantId = await this.resolveVariantId(ctx, input);
+        const order = await this.activeOrder.findOrCreate(ctx);
+        return this.serializer.orderOrError(await this.orderService.addItemToOrder(order.ctx, order.id, variantId, input.quantity));
+    }
+    // Product and variant IDs can collide, so a product ID passed as a variant ID can silently
+    // resolve to the wrong item. Requiring the caller to say which kind of ID it holds prevents that.
+    async resolveVariantId(ctx, input) {
+        const exactlyOneIdMessage = 'Pass exactly one of variantId or productId.';
+        if (input.variantId != null && input.productId != null) {
+            throw new core_1.UserInputError(exactlyOneIdMessage);
+        }
+        if (input.variantId != null) {
+            return input.variantId;
+        }
+        if (input.productId == null) {
+            throw new core_1.UserInputError(exactlyOneIdMessage);
+        }
+        const variants = await this.productVariantService.getVariantsByProductId(ctx, input.productId, {}, []);
+        if (variants.items.length === 0) {
+            throw new core_1.UserInputError(`Product ${String(input.productId)} has no variants that can be bought.`);
+        }
+        if (variants.items.length > 1) {
+            throw new core_1.UserInputError(
+            // totalItems, not items.length, so the count is right even when there are more
+            // variants than the lookup's page limit.
+            `Product ${String(input.productId)} has ${variants.totalItems} variants. ` +
+                'Nothing was added. Call add_to_cart again with one of these as variantId: ' +
+                variants.items
+                    .map(variant => `${String(variant.id)} (${variant.name}, ${variant.sku})`)
+                    .join('; '));
+        }
+        return variants.items[0].id;
+    }
+};
+exports.AddToCartTool = AddToCartTool;
+exports.AddToCartTool = AddToCartTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'add_to_cart',
+        toolset: 'shop',
+        description: 'Add a product variant to the active cart. Pass exactly one of variantId or productId. ' +
+            'Product IDs and variant IDs are different things and are not interchangeable.',
+        keywords: [
+            'put in my basket',
+            'I want to buy this',
+            'add this item to my bag',
+            'grab this product',
+            'start an order with this',
+            'put this in my shopping bag',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'mutating',
+        usesActiveOrder: true,
+        inputSchema: addToCartInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [active_order_service_1.McpActiveOrderService,
+        core_1.OrderService,
+        core_1.ProductVariantService,
+        serializer_service_1.McpToolSerializerService])
+], AddToCartTool);
+//# sourceMappingURL=add-to-cart.tool.js.map

package/lib/tools/built-in/shop/add-to-cart.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-to-cart.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/add-to-cart.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAOuB;AACvB,8CAA2D;AAC3D,6BAAwB;AAExB,kEAAgE;AAChE,4CAAwC;AACxC,kDAA8C;AAC9C,8DAAiE;AAEjE,MAAM,cAAc,GAAG,OAAC,CAAC,YAAY,CAAC;IAClC,SAAS,EAAE,oBAAQ;SACd,QAAQ,CACL,sGAAsG,CACzG;SACA,QAAQ,EAAE;IACf,SAAS,EAAE,oBAAQ;SACd,QAAQ,CACL,2FAA2F;QACvF,sFAAsF;QACtF,+EAA+E,CACtF;SACA,QAAQ,EAAE;IACf,QAAQ,EAAE,0BAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CACnF,CAAC,CAAC;AAwBI,IAAM,aAAa,GAAnB,MAAM,aAAa;IACtB,YACqB,WAAkC,EAClC,YAA0B,EAC1B,qBAA4C,EAC5C,UAAoC;QAHpC,gBAAW,GAAX,WAAW,CAAuB;QAClC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAAqB;QACpD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAC/B,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CACzF,CAAC;IACN,CAAC;IAED,2FAA2F;IAC3F,kGAAkG;IAC1F,KAAK,CAAC,gBAAgB,CAAC,GAAmB,EAAE,KAAqB;QACrE,MAAM,mBAAmB,GAAG,6CAA6C,CAAC;QAC1E,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;YACrD,MAAM,IAAI,qBAAc,CAAC,mBAAmB,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,SAAS,CAAC;QAC3B,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;YAC1B,MAAM,IAAI,qBAAc,CAAC,mBAAmB,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,sBAAsB,CACpE,GAAG,EACH,KAAK,CAAC,SAAS,EACf,EAAE,EACF,EAAE,CACL,CAAC;QACF,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,qBAAc,CACpB,WAAW,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,sCAAsC,CAC3E,CAAC;QACN,CAAC;QACD,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,qBAAc;YACpB,+EAA+E;YAC/E,yCAAyC;YACzC,WAAW,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,QAAQ,CAAC,UAAU,aAAa;gBACtE,4EAA4E;gBAC5E,QAAQ,CAAC,KAAK;qBACT,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,GAAG,GAAG,CAAC;qBACzE,IAAI,CAAC,IAAI,CAAC,CACtB,CAAC;QACN,CAAC;QACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChC,CAAC;CACJ,CAAA;AAtDY,sCAAa;wBAAb,aAAa;IApBzB,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,MAAM;QACf,WAAW,EACP,wFAAwF;YACxF,+EAA+E;QACnF,QAAQ,EAAE;YACN,kBAAkB;YAClB,oBAAoB;YACpB,yBAAyB;YACzB,mBAAmB;YACnB,0BAA0B;YAC1B,6BAA6B;SAChC;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,cAAc;KAC9B,CAAC;IACD,IAAA,mBAAU,GAAE;qCAGyB,4CAAqB;QACpB,mBAAY;QACH,4BAAqB;QAChC,6CAAwB;GALhD,aAAa,CAsDzB"}

package/lib/tools/built-in/shop/address-schema.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export declare const addressInputSchema: z.ZodObject<{
+    fullName: z.ZodOptional<z.ZodString>;
+    company: z.ZodOptional<z.ZodString>;
+    streetLine1: z.ZodString;
+    streetLine2: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    province: z.ZodOptional<z.ZodString>;
+    postalCode: z.ZodOptional<z.ZodString>;
+    countryCode: z.ZodString;
+    phoneNumber: z.ZodOptional<z.ZodString>;
+    defaultShippingAddress: z.ZodOptional<z.ZodBoolean>;
+    defaultBillingAddress: z.ZodOptional<z.ZodBoolean>;
+    customFields: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strict>;

package/lib/tools/built-in/shop/address-schema.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addressInputSchema = void 0;
+const zod_1 = require("zod");
+const string_schemas_1 = require("../string-schemas");
+exports.addressInputSchema = zod_1.z.strictObject({
+    fullName: string_schemas_1.shortText.optional(),
+    company: string_schemas_1.shortText.optional(),
+    streetLine1: string_schemas_1.shortText,
+    streetLine2: string_schemas_1.shortText.optional(),
+    city: string_schemas_1.shortText.optional(),
+    province: string_schemas_1.shortText.optional(),
+    postalCode: string_schemas_1.shortText.optional(),
+    countryCode: string_schemas_1.shortText,
+    phoneNumber: string_schemas_1.shortText.optional(),
+    defaultShippingAddress: zod_1.z.boolean().optional(),
+    defaultBillingAddress: zod_1.z.boolean().optional(),
+    customFields: zod_1.z.looseObject({}).describe('Address custom fields.').optional(),
+});
+//# sourceMappingURL=address-schema.js.map

package/lib/tools/built-in/shop/address-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-schema.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/address-schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,sDAA8C;AAEjC,QAAA,kBAAkB,GAAG,OAAC,CAAC,YAAY,CAAC;IAC7C,QAAQ,EAAE,0BAAS,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,0BAAS,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,0BAAS;IACtB,WAAW,EAAE,0BAAS,CAAC,QAAQ,EAAE;IACjC,IAAI,EAAE,0BAAS,CAAC,QAAQ,EAAE;IAC1B,QAAQ,EAAE,0BAAS,CAAC,QAAQ,EAAE;IAC9B,UAAU,EAAE,0BAAS,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,0BAAS;IACtB,WAAW,EAAE,0BAAS,CAAC,QAAQ,EAAE;IACjC,sBAAsB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9C,qBAAqB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7C,YAAY,EAAE,OAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;CAChF,CAAC,CAAC"}

package/lib/tools/built-in/shop/apply-coupon-code.tool.d.ts

@@ -0,0 +1,17 @@
+import { OrderService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpActiveOrderService } from '../active-order.service';
+import { McpToolSerializerService } from '../serializer.service';
+declare const applyCouponCodeInput: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strict>;
+type ApplyCouponCodeInput = z.infer<typeof applyCouponCodeInput>;
+export declare class ApplyCouponCodeTool implements McpToolHandler<ApplyCouponCodeInput> {
+    private readonly activeOrder;
+    private readonly orderService;
+    private readonly serializer;
+    constructor(activeOrder: McpActiveOrderService, orderService: OrderService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: ApplyCouponCodeInput): Promise<Record<string, unknown>>;
+}
+export {};