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

package/lib/tools/built-in/shop/get-my-account.tool.js

@@ -0,0 +1,57 @@
+"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.GetMyAccountTool = 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 serializer_service_1 = require("../serializer.service");
+const getMyAccountInput = zod_1.z.strictObject({});
+let GetMyAccountTool = class GetMyAccountTool {
+    constructor(customerService, serializer) {
+        this.customerService = customerService;
+        this.serializer = serializer;
+    }
+    async execute(ctx) {
+        const customer = ctx.activeUserId
+            ? await this.customerService.findOneByUserId(ctx, ctx.activeUserId)
+            : undefined;
+        if (!customer) {
+            return { customer: null };
+        }
+        const addresses = await this.customerService.findAddressesByCustomerId(ctx, customer.id);
+        return { customer: this.serializer.customer(customer, addresses) };
+    }
+};
+exports.GetMyAccountTool = GetMyAccountTool;
+exports.GetMyAccountTool = GetMyAccountTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'get_my_account',
+        toolset: 'shop',
+        description: 'Get the authenticated customer account.',
+        keywords: [
+            'my profile',
+            'my account details',
+            'who am I logged in as',
+            'view my customer info',
+            'my personal details',
+            'show my account',
+        ],
+        permissions: [core_1.Permission.Authenticated],
+        behavior: 'readonly',
+        inputSchema: getMyAccountInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.CustomerService,
+        serializer_service_1.McpToolSerializerService])
+], GetMyAccountTool);
+//# sourceMappingURL=get-my-account.tool.js.map

package/lib/tools/built-in/shop/get-my-account.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-my-account.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/get-my-account.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAA4E;AAC5E,8CAA2D;AAC3D,6BAAwB;AAExB,8DAAiE;AAEjE,MAAM,iBAAiB,GAAG,OAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAmBtC,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IACzB,YACqB,eAAgC,EAChC,UAAoC;QADpC,oBAAe,GAAf,eAAe,CAAiB;QAChC,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB;QAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY;YAC7B,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC;YACnE,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC9B,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,yBAAyB,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzF,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;IACvE,CAAC;CACJ,CAAA;AAjBY,4CAAgB;2BAAhB,gBAAgB;IAjB5B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,yCAAyC;QACtD,QAAQ,EAAE;YACN,YAAY;YACZ,oBAAoB;YACpB,uBAAuB;YACvB,uBAAuB;YACvB,qBAAqB;YACrB,iBAAiB;SACpB;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,aAAa,CAAC;QACvC,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,iBAAiB;KACjC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAG6B,sBAAe;QACpB,6CAAwB;GAHhD,gBAAgB,CAiB5B"}

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

@@ -0,0 +1,100 @@
+import { ConfigService, OrderService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpToolSerializerService } from '../serializer.service';
+declare const getOrderInput: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strict>;
+type GetOrderInput = z.infer<typeof getOrderInput>;
+export declare class ShopGetOrderTool implements McpToolHandler<GetOrderInput> {
+    private readonly configService;
+    private readonly orderService;
+    private readonly serializer;
+    constructor(configService: ConfigService, orderService: OrderService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: GetOrderInput): Promise<{
+        order: {
+            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;
+        message?: undefined;
+    } | {
+        order: null;
+        message: string;
+    }>;
+}
+export {};

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

@@ -0,0 +1,67 @@
+"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.ShopGetOrderTool = 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 order_list_helpers_1 = require("../order-list-helpers");
+const serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const getOrderInput = zod_1.z.strictObject({
+    code: string_schemas_1.shortText.describe('Order code.'),
+});
+let ShopGetOrderTool = class ShopGetOrderTool {
+    constructor(configService, orderService, serializer) {
+        this.configService = configService;
+        this.orderService = orderService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        const order = await this.orderService.findOneByCode(ctx, input.code, order_list_helpers_1.ORDER_DETAIL_RELATIONS);
+        const access = this.configService.orderOptions.orderByCodeAccessStrategy;
+        if (order && (await access.canAccessOrder(ctx, order))) {
+            return { order: this.serializer.order(order) };
+        }
+        // One message for "no such code" and "someone else's order": telling them apart would let an
+        // anonymous caller find out which codes exist.
+        return {
+            order: null,
+            message: `No order with code ${input.code} is visible to this caller. ` +
+                'Sign in as the customer who placed it to see it.',
+        };
+    }
+};
+exports.ShopGetOrderTool = ShopGetOrderTool;
+exports.ShopGetOrderTool = ShopGetOrderTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'get_order',
+        toolset: 'shop',
+        description: 'Get an accessible order by code.',
+        keywords: [
+            'track my order',
+            'where is my package',
+            'check my order status',
+            'look up my purchase by number',
+            'find my order with the reference',
+            'how is my delivery going',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'readonly',
+        inputSchema: getOrderInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ConfigService,
+        core_1.OrderService,
+        serializer_service_1.McpToolSerializerService])
+], ShopGetOrderTool);
+//# sourceMappingURL=get-order.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-order.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/get-order.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAAwF;AACxF,8CAA2D;AAC3D,6BAAwB;AAExB,8DAA+D;AAC/D,8DAAiE;AACjE,sDAA8C;AAE9C,MAAM,aAAa,GAAG,OAAC,CAAC,YAAY,CAAC;IACjC,IAAI,EAAE,0BAAS,CAAC,QAAQ,CAAC,aAAa,CAAC;CAC1C,CAAC,CAAC;AAqBI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IACzB,YACqB,aAA4B,EAC5B,YAA0B,EAC1B,UAAoC;QAFpC,kBAAa,GAAb,aAAa,CAAe;QAC5B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAAoB;QACnD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,2CAAsB,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,yBAAyB,CAAC;QACzE,IAAI,KAAK,IAAI,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YACrD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,CAAC;QACD,6FAA6F;QAC7F,+CAA+C;QAC/C,OAAO;YACH,KAAK,EAAE,IAAI;YACX,OAAO,EACH,sBAAsB,KAAK,CAAC,IAAI,8BAA8B;gBAC9D,kDAAkD;SACzD,CAAC;IACN,CAAC;CACJ,CAAA;AAtBY,4CAAgB;2BAAhB,gBAAgB;IAjB5B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,kCAAkC;QAC/C,QAAQ,EAAE;YACN,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,+BAA+B;YAC/B,kCAAkC;YAClC,0BAA0B;SAC7B;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,aAAa;KAC7B,CAAC;IACD,IAAA,mBAAU,GAAE;qCAG2B,oBAAa;QACd,mBAAY;QACd,6CAAwB;GAJhD,gBAAgB,CAsB5B"}

package/lib/tools/built-in/shop/get-product.tool.d.ts

@@ -0,0 +1,57 @@
+import { ProductService, ProductVariantService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpToolSerializerService } from '../serializer.service';
+declare const getProductInput: z.ZodObject<{
+    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    slug: z.ZodOptional<z.ZodString>;
+    variantOffset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type GetProductInput = z.infer<typeof getProductInput>;
+export declare class ShopGetProductTool implements McpToolHandler<GetProductInput> {
+    private readonly productService;
+    private readonly productVariantService;
+    private readonly serializer;
+    constructor(productService: ProductService, productVariantService: ProductVariantService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: GetProductInput): Promise<{
+        product: null;
+    } | {
+        product: {
+            variantTotal: number;
+            hasMoreVariants: boolean;
+            variants: ({
+                id: import("@vendure/core").ID;
+                name: import("@vendure/core").LocaleString;
+                sku: string;
+                enabled: boolean;
+                price: number;
+                priceDecimal: string;
+                priceWithTax: number;
+                priceWithTaxDecimal: string;
+                currencyCode: import("@vendure/core").CurrencyCode;
+            } | null)[];
+            id?: import("@vendure/core").ID | undefined;
+            name?: import("@vendure/core").LocaleString | undefined;
+            slug?: import("@vendure/core").LocaleString | undefined;
+            description?: import("@vendure/core").LocaleString | undefined;
+            enabled?: boolean | undefined;
+            featuredAsset?: {
+                id: import("@vendure/core").ID;
+                name: import("@vendure/core").LocaleString;
+                type: import("@vendure/core").AssetType;
+                mimeType: string;
+                width: number;
+                height: number;
+                fileSize: number;
+                source: string;
+                preview: string;
+                focalPoint: {
+                    x: number;
+                    y: number;
+                } | undefined;
+            } | null | undefined;
+        };
+    }>;
+    private findProduct;
+}
+export {};

package/lib/tools/built-in/shop/get-product.tool.js

@@ -0,0 +1,81 @@
+"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.ShopGetProductTool = 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 id_schema_1 = require("../id-schema");
+const list_helpers_1 = require("../list-helpers");
+const serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const getProductInput = zod_1.z.strictObject({
+    id: id_schema_1.idSchema.describe('Product ID.').optional(),
+    slug: string_schemas_1.shortText.describe('Product slug, used when ID is omitted.').optional(),
+    variantOffset: list_helpers_1.variantOffset,
+});
+let ShopGetProductTool = class ShopGetProductTool {
+    constructor(productService, productVariantService, serializer) {
+        this.productService = productService;
+        this.productVariantService = productVariantService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        var _a;
+        const product = await this.findProduct(ctx, input);
+        if ((product === null || product === void 0 ? void 0 : product.enabled) !== true) {
+            return { product: null };
+        }
+        // Loading variants through ProductService instead would silently return them with no price,
+        // since only ProductVariantService works prices out per channel.
+        const offset = (_a = input.variantOffset) !== null && _a !== void 0 ? _a : 0;
+        const variants = await this.productVariantService.getVariantsByProductId(ctx, product.id, { skip: offset }, []);
+        return {
+            product: Object.assign(Object.assign(Object.assign({}, this.serializer.product(product)), { variants: variants.items.map(variant => this.serializer.variant(variant)) }), (0, list_helpers_1.variantPaging)(offset, variants)),
+        };
+    }
+    async findProduct(ctx, input) {
+        if (input.id != null) {
+            return this.productService.findOne(ctx, input.id, ['featuredAsset', 'assets']);
+        }
+        if (input.slug != null) {
+            return this.productService.findOneBySlug(ctx, input.slug, ['featuredAsset', 'assets']);
+        }
+        return undefined;
+    }
+};
+exports.ShopGetProductTool = ShopGetProductTool;
+exports.ShopGetProductTool = ShopGetProductTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'get_product',
+        toolset: 'shop',
+        description: 'Get an enabled product by ID or slug, including its purchasable variants. Each variant ' +
+            'carries the ID that add_to_cart needs. When hasMoreVariants is true, call again with ' +
+            'variantOffset to get the next batch.',
+        keywords: [
+            'tell me about this item',
+            'show me this product',
+            'product details for shoppers',
+            'view an item page',
+            'info on a specific product',
+            'see this thing you sell',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'readonly',
+        inputSchema: getProductInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ProductService,
+        core_1.ProductVariantService,
+        serializer_service_1.McpToolSerializerService])
+], ShopGetProductTool);
+//# sourceMappingURL=get-product.tool.js.map

package/lib/tools/built-in/shop/get-product.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-product.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/get-product.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAAkG;AAClG,8CAA2D;AAC3D,6BAAwB;AAExB,4CAAwC;AACxC,kDAA+D;AAC/D,8DAAiE;AACjE,sDAA8C;AAE9C,MAAM,eAAe,GAAG,OAAC,CAAC,YAAY,CAAC;IACnC,EAAE,EAAE,oBAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IAC/C,IAAI,EAAE,0BAAS,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC,QAAQ,EAAE;IAC7E,aAAa,EAAb,4BAAa;CAChB,CAAC,CAAC;AAwBI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC3B,YACqB,cAA8B,EAC9B,qBAA4C,EAC5C,UAAoC;QAFpC,mBAAc,GAAd,cAAc,CAAgB;QAC9B,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAAsB;;QACrD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnD,IAAI,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,MAAK,IAAI,EAAE,CAAC;YAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;QACD,4FAA4F;QAC5F,iEAAiE;QACjE,MAAM,MAAM,GAAG,MAAA,KAAK,CAAC,aAAa,mCAAI,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,sBAAsB,CACpE,GAAG,EACH,OAAO,CAAC,EAAE,EACV,EAAE,IAAI,EAAE,MAAM,EAAE,EAChB,EAAE,CACL,CAAC;QACF,OAAO;YACH,OAAO,gDACA,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,KACnC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KACtE,IAAA,4BAAa,EAAC,MAAM,EAAE,QAAQ,CAAC,CACrC;SACJ,CAAC;IACN,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,GAAmB,EAAE,KAAsB;QACjE,IAAI,KAAK,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;CACJ,CAAA;AAvCY,gDAAkB;6BAAlB,kBAAkB;IApB9B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,MAAM;QACf,WAAW,EACP,yFAAyF;YACzF,uFAAuF;YACvF,sCAAsC;QAC1C,QAAQ,EAAE;YACN,yBAAyB;YACzB,sBAAsB;YACtB,8BAA8B;YAC9B,mBAAmB;YACnB,4BAA4B;YAC5B,yBAAyB;SAC5B;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,eAAe;KAC/B,CAAC;IACD,IAAA,mBAAU,GAAE;qCAG4B,qBAAc;QACP,4BAAqB;QAChC,6CAAwB;GAJhD,kBAAkB,CAuC9B"}

package/lib/tools/built-in/shop/index.d.ts

@@ -0,0 +1,19 @@
+import { AddToCartTool } from './add-to-cart.tool';
+import { ApplyCouponCodeTool } from './apply-coupon-code.tool';
+import { GetCartTool } from './get-cart.tool';
+import { ShopGetCollectionTool } from './get-collection.tool';
+import { GetEligiblePaymentMethodsTool } from './get-eligible-payment-methods.tool';
+import { GetEligibleShippingMethodsTool } from './get-eligible-shipping-methods.tool';
+import { GetMyAccountTool } from './get-my-account.tool';
+import { ShopGetOrderTool } from './get-order.tool';
+import { ShopGetProductTool } from './get-product.tool';
+import { ShopListCollectionsTool } from './list-collections.tool';
+import { ListMyOrdersTool } from './list-my-orders.tool';
+import { PlaceOrderTool } from './place-order.tool';
+import { RemoveCouponCodeTool } from './remove-coupon-code.tool';
+import { RemoveFromCartTool } from './remove-from-cart.tool';
+import { SearchProductsTool } from './search-products.tool';
+import { SetCheckoutDetailsTool } from './set-checkout-details.tool';
+import { SetShippingMethodTool } from './set-shipping-method.tool';
+import { UpdateCartLineTool } from './update-cart-line.tool';
+export declare const shopToolProviders: (typeof AddToCartTool | typeof ApplyCouponCodeTool | typeof GetCartTool | typeof ShopGetCollectionTool | typeof GetEligiblePaymentMethodsTool | typeof GetEligibleShippingMethodsTool | typeof GetMyAccountTool | typeof ShopGetOrderTool | typeof ShopGetProductTool | typeof ShopListCollectionsTool | typeof ListMyOrdersTool | typeof PlaceOrderTool | typeof RemoveCouponCodeTool | typeof RemoveFromCartTool | typeof SearchProductsTool | typeof SetCheckoutDetailsTool | typeof SetShippingMethodTool | typeof UpdateCartLineTool)[];

package/lib/tools/built-in/shop/index.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shopToolProviders = void 0;
+const add_to_cart_tool_1 = require("./add-to-cart.tool");
+const apply_coupon_code_tool_1 = require("./apply-coupon-code.tool");
+const get_cart_tool_1 = require("./get-cart.tool");
+const get_collection_tool_1 = require("./get-collection.tool");
+const get_eligible_payment_methods_tool_1 = require("./get-eligible-payment-methods.tool");
+const get_eligible_shipping_methods_tool_1 = require("./get-eligible-shipping-methods.tool");
+const get_my_account_tool_1 = require("./get-my-account.tool");
+const get_order_tool_1 = require("./get-order.tool");
+const get_product_tool_1 = require("./get-product.tool");
+const list_collections_tool_1 = require("./list-collections.tool");
+const list_my_orders_tool_1 = require("./list-my-orders.tool");
+const place_order_tool_1 = require("./place-order.tool");
+const remove_coupon_code_tool_1 = require("./remove-coupon-code.tool");
+const remove_from_cart_tool_1 = require("./remove-from-cart.tool");
+const search_products_tool_1 = require("./search-products.tool");
+const set_checkout_details_tool_1 = require("./set-checkout-details.tool");
+const set_shipping_method_tool_1 = require("./set-shipping-method.tool");
+const update_cart_line_tool_1 = require("./update-cart-line.tool");
+exports.shopToolProviders = [
+    search_products_tool_1.SearchProductsTool,
+    list_collections_tool_1.ShopListCollectionsTool,
+    get_collection_tool_1.ShopGetCollectionTool,
+    get_product_tool_1.ShopGetProductTool,
+    get_cart_tool_1.GetCartTool,
+    get_eligible_payment_methods_tool_1.GetEligiblePaymentMethodsTool,
+    get_eligible_shipping_methods_tool_1.GetEligibleShippingMethodsTool,
+    add_to_cart_tool_1.AddToCartTool,
+    update_cart_line_tool_1.UpdateCartLineTool,
+    remove_from_cart_tool_1.RemoveFromCartTool,
+    apply_coupon_code_tool_1.ApplyCouponCodeTool,
+    remove_coupon_code_tool_1.RemoveCouponCodeTool,
+    set_checkout_details_tool_1.SetCheckoutDetailsTool,
+    set_shipping_method_tool_1.SetShippingMethodTool,
+    place_order_tool_1.PlaceOrderTool,
+    get_order_tool_1.ShopGetOrderTool,
+    get_my_account_tool_1.GetMyAccountTool,
+    list_my_orders_tool_1.ListMyOrdersTool,
+];
+//# sourceMappingURL=index.js.map

package/lib/tools/built-in/shop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/index.ts"],"names":[],"mappings":";;;AAAA,yDAAmD;AACnD,qEAA+D;AAC/D,mDAA8C;AAC9C,+DAA8D;AAC9D,2FAAoF;AACpF,6FAAsF;AACtF,+DAAyD;AACzD,qDAAoD;AACpD,yDAAwD;AACxD,mEAAkE;AAClE,+DAAyD;AACzD,yDAAoD;AACpD,uEAAiE;AACjE,mEAA6D;AAC7D,iEAA4D;AAC5D,2EAAqE;AACrE,yEAAmE;AACnE,mEAA6D;AAEhD,QAAA,iBAAiB,GAAG;IAC7B,yCAAkB;IAClB,+CAAuB;IACvB,2CAAqB;IACrB,qCAAkB;IAClB,2BAAW;IACX,iEAA6B;IAC7B,mEAA8B;IAC9B,gCAAa;IACb,0CAAkB;IAClB,0CAAkB;IAClB,4CAAmB;IACnB,8CAAoB;IACpB,kDAAsB;IACtB,gDAAqB;IACrB,iCAAc;IACd,iCAAgB;IAChB,sCAAgB;IAChB,sCAAgB;CACnB,CAAC"}

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

@@ -0,0 +1,42 @@
+import { CollectionService, ID, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpToolSerializerService } from '../serializer.service';
+declare const listCollectionsInput: z.ZodObject<{
+    parentId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type ListCollectionsInput = z.infer<typeof listCollectionsInput>;
+export declare class ShopListCollectionsTool implements McpToolHandler<ListCollectionsInput> {
+    private readonly collectionService;
+    private readonly serializer;
+    constructor(collectionService: CollectionService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: ListCollectionsInput): Promise<{
+        items: ({
+            id: ID;
+            name: import("@vendure/core").LocaleString;
+            slug: import("@vendure/core").LocaleString;
+            description: import("@vendure/core").LocaleString;
+            featuredAsset: {
+                id: ID;
+                name: import("@vendure/core").LocaleString;
+                type: import("@vendure/core").AssetType;
+                mimeType: string;
+                width: number;
+                height: number;
+                fileSize: number;
+                source: string;
+                preview: string;
+                focalPoint: {
+                    x: number;
+                    y: number;
+                } | undefined;
+            } | null;
+        } | null)[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    private childCollections;
+}
+export {};

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

@@ -0,0 +1,75 @@
+"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.ShopListCollectionsTool = 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 id_schema_1 = require("../id-schema");
+const list_helpers_1 = require("../list-helpers");
+const serializer_service_1 = require("../serializer.service");
+const collection_lookup_1 = require("./collection-lookup");
+const listCollectionsInput = zod_1.z.strictObject(Object.assign(Object.assign({}, (0, list_helpers_1.paginationFields)('collections')), { parentId: id_schema_1.idSchema.describe('Return the children of this collection.').optional() }));
+let ShopListCollectionsTool = class ShopListCollectionsTool {
+    constructor(collectionService, serializer) {
+        this.collectionService = collectionService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        if (input.parentId != null) {
+            return this.childCollections(ctx, input.parentId, input);
+        }
+        const result = await this.collectionService.findAll(ctx, (0, collection_lookup_1.publicCollectionListOptions)(input), [
+            'featuredAsset',
+        ]);
+        return (0, list_helpers_1.page)(result.items.map(collection => this.serializer.collection(collection)), result.totalItems, input);
+    }
+    // getChildren isn't channel-scoped, so the results are reloaded by id to get the right translations.
+    async childCollections(ctx, parentId, input) {
+        const parent = await this.collectionService.findOne(ctx, parentId);
+        if (!parent || parent.isPrivate) {
+            return (0, list_helpers_1.page)([], 0, input);
+        }
+        const children = await this.collectionService.getChildren(ctx, parentId);
+        const publicChildren = children.filter(collection => !collection.isPrivate);
+        const channelChildren = await this.collectionService.findByIds(ctx, publicChildren.map(collection => collection.id));
+        const byId = new Map(channelChildren.map(collection => [String(collection.id), collection]));
+        const visibleChildren = publicChildren
+            .map(collection => byId.get(String(collection.id)))
+            .filter(collection => collection != null);
+        const items = (0, list_helpers_1.slicePage)(visibleChildren, input).map(collection => this.serializer.collection(collection));
+        return (0, list_helpers_1.page)(items, visibleChildren.length, input);
+    }
+};
+exports.ShopListCollectionsTool = ShopListCollectionsTool;
+exports.ShopListCollectionsTool = ShopListCollectionsTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'list_collections',
+        toolset: 'shop',
+        description: 'List public collections with pagination.',
+        keywords: [
+            'browse all categories',
+            'what departments do you have',
+            'show me your product groups',
+            'list of shop categories',
+            'see every collection',
+            'how is the store organized',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'readonly',
+        inputSchema: listCollectionsInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.CollectionService,
+        serializer_service_1.McpToolSerializerService])
+], ShopListCollectionsTool);
+//# sourceMappingURL=list-collections.tool.js.map

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

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