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

package/lib/tools/built-in/shop/list-my-orders.tool.d.ts

@@ -0,0 +1,100 @@
+import { CustomerService, OrderService, RequestContext, TranslatorService } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpToolSerializerService } from '../serializer.service';
+declare const listMyOrdersInput: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type ListMyOrdersInput = z.infer<typeof listMyOrdersInput>;
+export declare class ListMyOrdersTool implements McpToolHandler<ListMyOrdersInput> {
+    private readonly customerService;
+    private readonly orderService;
+    private readonly translator;
+    private readonly serializer;
+    constructor(customerService: CustomerService, orderService: OrderService, translator: TranslatorService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: ListMyOrdersInput): Promise<{
+        items: ({
+            id: import("@vendure/core").ID;
+            code: string;
+            state: import("@vendure/core").OrderState;
+            active: boolean;
+            total: number;
+            totalDecimal: string;
+            totalWithTax: number;
+            totalWithTaxDecimal: string;
+            currencyCode: import("@vendure/core").CurrencyCode;
+            totalQuantity: number;
+            createdAt: string | null;
+            updatedAt: string | null;
+            orderPlacedAt: string | null;
+            couponCodes: string[];
+            discounts: {
+                adjustmentSource: string;
+                type: import("@vendure/core").AdjustmentType;
+                description: string;
+                amount: number;
+                amountDecimal: string;
+                amountWithTax: number;
+                amountWithTaxDecimal: string;
+            }[];
+            lines: {
+                id: import("@vendure/core").ID;
+                quantity: number;
+                linePriceWithTax: number;
+                linePriceWithTaxDecimal: string;
+                productVariant: {
+                    id: import("@vendure/core").ID;
+                    name: import("@vendure/core").LocaleString;
+                    sku: string;
+                } | null;
+            }[];
+            payments: {
+                id: import("@vendure/core").ID;
+                method: string;
+                amount: number;
+                amountDecimal: string;
+                state: import("@vendure/core").PaymentState;
+                transactionId: string;
+                errorMessage: string | undefined;
+                publicMetadata: any;
+                refunds: {
+                    id: import("@vendure/core").ID;
+                    state: import("@vendure/core").RefundState;
+                    total: number;
+                    totalDecimal: string;
+                    reason: string;
+                }[];
+            }[] | undefined;
+            fulfillments: {
+                id: import("@vendure/core").ID;
+                state: import("@vendure/core").FulfillmentState;
+                method: string;
+                trackingCode: string;
+                lines: {
+                    orderLineId: import("@vendure/core").ID;
+                    quantity: number;
+                }[];
+            }[] | undefined;
+            customer: {
+                id: import("@vendure/core").ID;
+                emailAddress: string;
+                firstName: string;
+                lastName: string;
+            } | null | undefined;
+            shippingAddress: Record<string, string> | null;
+            billingAddress: Record<string, string> | null;
+            shippingWithTax: number;
+            shippingWithTaxDecimal: string;
+            shippingLines: {
+                id: import("@vendure/core").ID;
+                shippingMethodId: import("@vendure/core").ID | null;
+                priceWithTax: number;
+                priceWithTaxDecimal: string;
+            }[] | undefined;
+        } | null)[];
+        total: number;
+        hasMore: boolean;
+    }>;
+}
+export {};

package/lib/tools/built-in/shop/list-my-orders.tool.js

@@ -0,0 +1,63 @@
+"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.ListMyOrdersTool = 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 list_helpers_1 = require("../list-helpers");
+const order_list_helpers_1 = require("../order-list-helpers");
+const serializer_service_1 = require("../serializer.service");
+const listMyOrdersInput = zod_1.z.strictObject(Object.assign({}, (0, list_helpers_1.paginationFields)('orders')));
+let ListMyOrdersTool = class ListMyOrdersTool {
+    constructor(customerService, orderService, translator, serializer) {
+        this.customerService = customerService;
+        this.orderService = orderService;
+        this.translator = translator;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        if (!ctx.activeUserId)
+            return (0, list_helpers_1.page)([], 0, input);
+        const customer = await this.customerService.findOneByUserId(ctx, ctx.activeUserId);
+        if (!customer)
+            return (0, list_helpers_1.page)([], 0, input);
+        const result = await this.orderService.findByCustomerId(ctx, customer.id, (0, order_list_helpers_1.orderListOptions)(input, 'createdAt'), order_list_helpers_1.ORDER_LIST_RELATIONS);
+        (0, order_list_helpers_1.translateLineVariants)(result.items, this.translator, ctx);
+        return (0, list_helpers_1.page)(result.items.map(order => this.serializer.order(order)), result.totalItems, input);
+    }
+};
+exports.ListMyOrdersTool = ListMyOrdersTool;
+exports.ListMyOrdersTool = ListMyOrdersTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'list_my_orders',
+        toolset: 'shop',
+        description: 'List orders belonging to the authenticated customer, newest first.',
+        keywords: [
+            'my order history',
+            'my past purchases',
+            "everything I've ordered",
+            'show my previous orders',
+            'what have I bought before',
+            'my buying history',
+        ],
+        permissions: [core_1.Permission.Authenticated],
+        behavior: 'readonly',
+        inputSchema: listMyOrdersInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.CustomerService,
+        core_1.OrderService,
+        core_1.TranslatorService,
+        serializer_service_1.McpToolSerializerService])
+], ListMyOrdersTool);
+//# sourceMappingURL=list-my-orders.tool.js.map

package/lib/tools/built-in/shop/list-my-orders.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-my-orders.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/list-my-orders.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAA6G;AAC7G,8CAA2D;AAC3D,6BAAwB;AAExB,kDAAyD;AACzD,8DAAsG;AACtG,8DAAiE;AAEjE,MAAM,iBAAiB,GAAG,OAAC,CAAC,YAAY,mBACjC,IAAA,+BAAgB,EAAC,QAAQ,CAAC,EAC/B,CAAC;AAqBI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IACzB,YACqB,eAAgC,EAChC,YAA0B,EAC1B,UAA6B,EAC7B,UAAoC;QAHpC,oBAAe,GAAf,eAAe,CAAiB;QAChC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,eAAU,GAAV,UAAU,CAAmB;QAC7B,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAAwB;QACvD,IAAI,CAAC,GAAG,CAAC,YAAY;YAAE,OAAO,IAAA,mBAAI,EAAC,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;QACnF,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAA,mBAAI,EAAC,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,gBAAgB,CACnD,GAAG,EACH,QAAQ,CAAC,EAAE,EACX,IAAA,qCAAgB,EAAC,KAAK,EAAE,WAAW,CAAC,EACpC,yCAAoB,CACvB,CAAC;QACF,IAAA,0CAAqB,EAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC1D,OAAO,IAAA,mBAAI,EACP,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EACvD,MAAM,CAAC,UAAU,EACjB,KAAK,CACR,CAAC;IACN,CAAC;CACJ,CAAA;AAzBY,4CAAgB;2BAAhB,gBAAgB;IAjB5B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,oEAAoE;QACjF,QAAQ,EAAE;YACN,kBAAkB;YAClB,mBAAmB;YACnB,yBAAyB;YACzB,yBAAyB;YACzB,2BAA2B;YAC3B,mBAAmB;SACtB;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,aAAa,CAAC;QACvC,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,iBAAiB;KACjC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAG6B,sBAAe;QAClB,mBAAY;QACd,wBAAiB;QACjB,6CAAwB;GALhD,gBAAgB,CAyB5B"}

package/lib/tools/built-in/shop/place-order.tool.d.ts

@@ -0,0 +1,188 @@
+import { CustomerService, ID, OrderService, RequestContext, SessionService, TransactionalConnection } 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 placeOrderInput: z.ZodObject<{
+    paymentMethodCode: z.ZodString;
+    paymentMetadata: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strict>;
+type PlaceOrderInput = z.infer<typeof placeOrderInput>;
+export declare class PlaceOrderTool implements McpToolHandler<PlaceOrderInput> {
+    private readonly activeOrder;
+    private readonly orderService;
+    private readonly serializer;
+    private readonly connection;
+    private readonly customerService;
+    private readonly sessionService;
+    constructor(activeOrder: McpActiveOrderService, orderService: OrderService, serializer: McpToolSerializerService, connection: TransactionalConnection, customerService: CustomerService, sessionService: SessionService);
+    execute(ctx: RequestContext, input: PlaceOrderInput): Promise<Record<string, unknown> | {
+        status: "placed";
+        order: {
+            id: ID;
+            code: string;
+            state: import("@vendure/core").OrderState;
+            active: boolean;
+            total: number;
+            totalDecimal: string;
+            totalWithTax: number;
+            totalWithTaxDecimal: string;
+            currencyCode: import("@vendure/core").CurrencyCode;
+            totalQuantity: number;
+            createdAt: string | null;
+            updatedAt: string | null;
+            orderPlacedAt: string | null;
+            couponCodes: string[];
+            discounts: {
+                adjustmentSource: string;
+                type: import("@vendure/core").AdjustmentType;
+                description: string;
+                amount: number;
+                amountDecimal: string;
+                amountWithTax: number;
+                amountWithTaxDecimal: string;
+            }[];
+            lines: {
+                id: ID;
+                quantity: number;
+                linePriceWithTax: number;
+                linePriceWithTaxDecimal: string;
+                productVariant: {
+                    id: ID;
+                    name: import("@vendure/core").LocaleString;
+                    sku: string;
+                } | null;
+            }[];
+            payments: {
+                id: ID;
+                method: string;
+                amount: number;
+                amountDecimal: string;
+                state: import("@vendure/core").PaymentState;
+                transactionId: string;
+                errorMessage: string | undefined;
+                publicMetadata: any;
+                refunds: {
+                    id: ID;
+                    state: import("@vendure/core").RefundState;
+                    total: number;
+                    totalDecimal: string;
+                    reason: string;
+                }[];
+            }[] | undefined;
+            fulfillments: {
+                id: ID;
+                state: import("@vendure/core").FulfillmentState;
+                method: string;
+                trackingCode: string;
+                lines: {
+                    orderLineId: ID;
+                    quantity: number;
+                }[];
+            }[] | undefined;
+            customer: {
+                id: ID;
+                emailAddress: string;
+                firstName: string;
+                lastName: string;
+            } | null | undefined;
+            shippingAddress: Record<string, string> | null;
+            billingAddress: Record<string, string> | null;
+            shippingWithTax: number;
+            shippingWithTaxDecimal: string;
+            shippingLines: {
+                id: ID;
+                shippingMethodId: ID | null;
+                priceWithTax: number;
+                priceWithTaxDecimal: string;
+            }[] | undefined;
+        } | null;
+        message?: undefined;
+    } | {
+        status: "awaiting_payment";
+        order: {
+            id: ID;
+            code: string;
+            state: import("@vendure/core").OrderState;
+            active: boolean;
+            total: number;
+            totalDecimal: string;
+            totalWithTax: number;
+            totalWithTaxDecimal: string;
+            currencyCode: import("@vendure/core").CurrencyCode;
+            totalQuantity: number;
+            createdAt: string | null;
+            updatedAt: string | null;
+            orderPlacedAt: string | null;
+            couponCodes: string[];
+            discounts: {
+                adjustmentSource: string;
+                type: import("@vendure/core").AdjustmentType;
+                description: string;
+                amount: number;
+                amountDecimal: string;
+                amountWithTax: number;
+                amountWithTaxDecimal: string;
+            }[];
+            lines: {
+                id: ID;
+                quantity: number;
+                linePriceWithTax: number;
+                linePriceWithTaxDecimal: string;
+                productVariant: {
+                    id: ID;
+                    name: import("@vendure/core").LocaleString;
+                    sku: string;
+                } | null;
+            }[];
+            payments: {
+                id: ID;
+                method: string;
+                amount: number;
+                amountDecimal: string;
+                state: import("@vendure/core").PaymentState;
+                transactionId: string;
+                errorMessage: string | undefined;
+                publicMetadata: any;
+                refunds: {
+                    id: ID;
+                    state: import("@vendure/core").RefundState;
+                    total: number;
+                    totalDecimal: string;
+                    reason: string;
+                }[];
+            }[] | undefined;
+            fulfillments: {
+                id: ID;
+                state: import("@vendure/core").FulfillmentState;
+                method: string;
+                trackingCode: string;
+                lines: {
+                    orderLineId: ID;
+                    quantity: number;
+                }[];
+            }[] | undefined;
+            customer: {
+                id: ID;
+                emailAddress: string;
+                firstName: string;
+                lastName: string;
+            } | null | undefined;
+            shippingAddress: Record<string, string> | null;
+            billingAddress: Record<string, string> | null;
+            shippingWithTax: number;
+            shippingWithTaxDecimal: string;
+            shippingLines: {
+                id: ID;
+                shippingMethodId: ID | null;
+                priceWithTax: number;
+                priceWithTaxDecimal: string;
+            }[] | undefined;
+        } | null;
+        message: string;
+    }>;
+    private startArrangingPayment;
+    private takePayment;
+    private describeOutcome;
+}
+export {};

package/lib/tools/built-in/shop/place-order.tool.js

@@ -0,0 +1,152 @@
+"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.PlaceOrderTool = 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 constants_1 = require("../../../constants");
+const active_order_service_1 = require("../active-order.service");
+const serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const placeOrderInput = zod_1.z.strictObject({
+    paymentMethodCode: string_schemas_1.shortText.describe('Payment method code.'),
+    paymentMetadata: zod_1.z.looseObject({}).describe('Metadata passed to the payment handler.').optional(),
+});
+// These carry a message the caller can act on (e.g. a bad payment method or an expired cart),
+// so they're passed on unchanged instead of being replaced with a generic error.
+// IllegalOperationError is left out because `addPaymentToOrder` only throws it from a state
+// change that runs after the payment provider was called.
+const CALLER_SAFE_ERRORS = [core_1.UserInputError, core_1.EntityNotFoundError, core_1.ForbiddenError, core_1.UnauthorizedError];
+let PlaceOrderTool = class PlaceOrderTool {
+    constructor(activeOrder, orderService, serializer, connection, customerService, sessionService) {
+        this.activeOrder = activeOrder;
+        this.orderService = orderService;
+        this.serializer = serializer;
+        this.connection = connection;
+        this.customerService = customerService;
+        this.sessionService = sessionService;
+    }
+    async execute(ctx, input) {
+        const order = await this.activeOrder.findOrThrow(ctx);
+        // Taking a payment has to run inside a database transaction: `addPaymentToOrder` refuses to
+        // run without one.
+        return this.connection.withTransaction(order.ctx, async (txCtx) => {
+            const current = await this.orderService.findOne(txCtx, order.id);
+            if (!current) {
+                // The cart was there a moment ago, so only a concurrent deletion gets here.
+                throw new core_1.EntityNotFoundError('Order', order.id);
+            }
+            const arranging = await this.startArrangingPayment(txCtx, current);
+            if (arranging.kind === 'error') {
+                return arranging.result;
+            }
+            const result = await this.takePayment(txCtx, current, input);
+            if ((0, core_1.isGraphQlErrorResult)(result)) {
+                if (arranging.movedOutOfCart) {
+                    await this.orderService.transitionToState(txCtx, order.id, 'AddingItems');
+                }
+                return this.serializer.orderOrError(result);
+            }
+            result.payments = await this.orderService.getOrderPayments(txCtx, result.id);
+            return this.describeOutcome(txCtx, order.id, result);
+        });
+    }
+    async startArrangingPayment(txCtx, current) {
+        if (current.state !== 'AddingItems') {
+            return { kind: 'ok', movedOutOfCart: false };
+        }
+        const transition = await this.orderService.transitionToState(txCtx, current.id, 'ArrangingPayment');
+        if ((0, core_1.isGraphQlErrorResult)(transition)) {
+            if (transition.transitionError ===
+                txCtx.translate('message.cannot-transition-to-payment-without-customer', {
+                    fromState: current.state,
+                    toState: 'ArrangingPayment',
+                })) {
+                throw new core_1.UserInputError('This cart has no customer yet. For a guest checkout call ' +
+                    'set_checkout_details with customer { emailAddress, firstName, ' +
+                    'lastName } first, or sign in as a customer.');
+            }
+            return { kind: 'error', result: this.serializer.orderOrError(transition) };
+        }
+        return { kind: 'ok', movedOutOfCart: true };
+    }
+    async takePayment(txCtx, order, input) {
+        var _a;
+        const payment = {
+            method: input.paymentMethodCode,
+            metadata: (_a = input.paymentMetadata) !== null && _a !== void 0 ? _a : {},
+        };
+        try {
+            return await this.orderService.addPaymentToOrder(txCtx, order.id, payment);
+        }
+        catch (e) {
+            if (CALLER_SAFE_ERRORS.some(errorType => e instanceof errorType)) {
+                throw e;
+            }
+            // The rollback removes the Payment row but cannot undo a charge the payment provider
+            // already made, so the order code is logged for the store to match against the provider.
+            core_1.Logger.error(`place_order payment failed for order ${order.code}: ${e instanceof Error ? e.message : String(e)}`, constants_1.loggerCtx, e instanceof Error ? e.stack : undefined);
+            throw new core_1.UserInputError('Taking the payment failed and nothing was saved on the order, but the payment ' +
+                'provider may already have charged the customer. Do not retry. Tell the user to ' +
+                `contact the store about order ${order.code}.`);
+        }
+    }
+    async describeOutcome(txCtx, orderId, result) {
+        if (result.orderPlacedAt) {
+            await this.customerService.createAddressesForNewCustomer(txCtx, result);
+            if (txCtx.session && (0, core_1.idsAreEqual)(txCtx.session.activeOrderId, orderId)) {
+                await this.sessionService.unsetActiveOrder(txCtx, txCtx.session);
+            }
+            return { status: 'placed', order: this.serializer.order(result) };
+        }
+        let message = 'Payment was created, but the order is not placed yet. Look at order.payments for ' +
+            "each payment's state and any publicMetadata with the shopper's next step.";
+        if (result.state === 'ArrangingPayment') {
+            message += ' The cart cannot be edited while the order is in ArrangingPayment.';
+        }
+        return {
+            status: 'awaiting_payment',
+            order: this.serializer.order(result),
+            message,
+        };
+    }
+};
+exports.PlaceOrderTool = PlaceOrderTool;
+exports.PlaceOrderTool = PlaceOrderTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'place_order',
+        toolset: 'shop',
+        description: 'Add payment to the active cart and place the order. The store order process decides which ' +
+            'checkout details are required. Returns "placed" or "awaiting_payment" with payment details.',
+        keywords: [
+            'check out',
+            'complete my purchase',
+            'pay now',
+            'finalize and submit my order',
+            'buy everything in my basket',
+            'confirm and pay',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'destructive',
+        usesActiveOrder: true,
+        inputSchema: placeOrderInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [active_order_service_1.McpActiveOrderService,
+        core_1.OrderService,
+        serializer_service_1.McpToolSerializerService,
+        core_1.TransactionalConnection,
+        core_1.CustomerService,
+        core_1.SessionService])
+], PlaceOrderTool);
+//# sourceMappingURL=place-order.tool.js.map

package/lib/tools/built-in/shop/place-order.tool.js.map

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

package/lib/tools/built-in/shop/product-search-query.d.ts

@@ -0,0 +1,4 @@
+import { ListQueryOptions, Product } from '@vendure/core';
+import { type ListInput } from '../list-helpers';
+export declare function productSearchWords(query: string | undefined, trimPlurals?: boolean): string[];
+export declare function publicProductListOptions(input: ListInput, words?: string[]): ListQueryOptions<Product>;

package/lib/tools/built-in/shop/product-search-query.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.productSearchWords = productSearchWords;
+exports.publicProductListOptions = publicProductListOptions;
+const list_helpers_1 = require("../list-helpers");
+// Words under four characters are left alone so short words like "gas" or "bus" aren't mangled.
+function singular(word) {
+    if (word.length < 4) {
+        return word;
+    }
+    if (/(?:s|x|z|ch|sh)es$/i.test(word)) {
+        return word.slice(0, -2);
+    }
+    if (/[^s]s$/i.test(word)) {
+        return word.slice(0, -1);
+    }
+    return word;
+}
+// `trimPlurals` is used as a second attempt when the words as typed find nothing.
+function productSearchWords(query, trimPlurals = false) {
+    const words = (query !== null && query !== void 0 ? query : '')
+        .trim()
+        .split(/\s+/)
+        .filter(word => word.length > 0);
+    return trimPlurals ? words.map(singular) : words;
+}
+function publicProductListOptions(input, words = []) {
+    const options = (0, list_helpers_1.listOptions)({ limit: input.limit, offset: input.offset });
+    const wordFilters = words.map(word => ({
+        _or: [{ name: { contains: word } }, { slug: { contains: word } }],
+    }));
+    return Object.assign(Object.assign({}, options), { filter: Object.assign({ enabled: { eq: true } }, (wordFilters.length ? { _and: wordFilters } : {})) });
+}
+//# sourceMappingURL=product-search-query.js.map

package/lib/tools/built-in/shop/product-search-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-search-query.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/product-search-query.ts"],"names":[],"mappings":";;AAmBA,gDAMC;AAED,4DAYC;AArCD,kDAA8D;AAE9D,gGAAgG;AAChG,SAAS,QAAQ,CAAC,IAAY;IAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,kFAAkF;AAClF,SAAgB,kBAAkB,CAAC,KAAyB,EAAE,WAAW,GAAG,KAAK;IAC7E,MAAM,KAAK,GAAG,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC;SACtB,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACrD,CAAC;AAED,SAAgB,wBAAwB,CAAC,KAAgB,EAAE,QAAkB,EAAE;IAC3E,MAAM,OAAO,GAAG,IAAA,0BAAW,EAAU,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACnF,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;KACpE,CAAC,CAAC,CAAC;IACJ,uCACO,OAAO,KACV,MAAM,kBACF,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAClB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAE1D;AACN,CAAC"}

package/lib/tools/built-in/shop/remove-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 removeCouponCodeInput: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strict>;
+type RemoveCouponCodeInput = z.infer<typeof removeCouponCodeInput>;
+export declare class RemoveCouponCodeTool implements McpToolHandler<RemoveCouponCodeInput> {
+    private readonly activeOrder;
+    private readonly orderService;
+    private readonly serializer;
+    constructor(activeOrder: McpActiveOrderService, orderService: OrderService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: RemoveCouponCodeInput): Promise<Record<string, unknown>>;
+}
+export {};

package/lib/tools/built-in/shop/remove-coupon-code.tool.js

@@ -0,0 +1,63 @@
+"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.RemoveCouponCodeTool = 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 serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const removeCouponCodeInput = zod_1.z.strictObject({
+    code: string_schemas_1.shortText.describe('Coupon code.'),
+});
+let RemoveCouponCodeTool = class RemoveCouponCodeTool {
+    constructor(activeOrder, orderService, serializer) {
+        this.activeOrder = activeOrder;
+        this.orderService = orderService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        const order = await this.activeOrder.findEditable(ctx);
+        if ((0, core_1.isGraphQlErrorResult)(order)) {
+            return this.serializer.orderOrError(order);
+        }
+        return {
+            order: this.serializer.order(await this.orderService.removeCouponCode(order.ctx, order.id, input.code)),
+        };
+    }
+};
+exports.RemoveCouponCodeTool = RemoveCouponCodeTool;
+exports.RemoveCouponCodeTool = RemoveCouponCodeTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'remove_coupon_code',
+        toolset: 'shop',
+        description: 'Remove a coupon code from the active cart.',
+        keywords: [
+            'take off the discount',
+            'cancel my promo code',
+            'remove the voucher',
+            'get rid of the coupon',
+            'undo the discount code',
+            'clear the applied promo',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'mutating',
+        usesActiveOrder: true,
+        inputSchema: removeCouponCodeInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [active_order_service_1.McpActiveOrderService,
+        core_1.OrderService,
+        serializer_service_1.McpToolSerializerService])
+], RemoveCouponCodeTool);
+//# sourceMappingURL=remove-coupon-code.tool.js.map

package/lib/tools/built-in/shop/remove-coupon-code.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-coupon-code.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/remove-coupon-code.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAA+F;AAC/F,8CAA2D;AAC3D,6BAAwB;AAExB,kEAAgE;AAChE,8DAAiE;AACjE,sDAA8C;AAE9C,MAAM,qBAAqB,GAAG,OAAC,CAAC,YAAY,CAAC;IACzC,IAAI,EAAE,0BAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;CAC3C,CAAC,CAAC;AAsBI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC7B,YACqB,WAAkC,EAClC,YAA0B,EAC1B,UAAoC;QAFpC,gBAAW,GAAX,WAAW,CAAuB;QAClC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAA4B;QAC3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,IAAA,2BAAoB,EAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO;YACH,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CACxB,MAAM,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAC5E;SACJ,CAAC;IACN,CAAC;CACJ,CAAA;AAlBY,oDAAoB;+BAApB,oBAAoB;IAlBhC,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,4CAA4C;QACzD,QAAQ,EAAE;YACN,uBAAuB;YACvB,sBAAsB;YACtB,oBAAoB;YACpB,uBAAuB;YACvB,wBAAwB;YACxB,yBAAyB;SAC5B;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,qBAAqB;KACrC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAGyB,4CAAqB;QACpB,mBAAY;QACd,6CAAwB;GAJhD,oBAAoB,CAkBhC"}