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

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

package/lib/tools/built-in/shop/remove-from-cart.tool.js

@@ -0,0 +1,58 @@
+"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.RemoveFromCartTool = 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 serializer_service_1 = require("../serializer.service");
+const removeFromCartInput = zod_1.z.strictObject({
+    orderLineId: id_schema_1.idSchema.describe('Order line ID.'),
+});
+let RemoveFromCartTool = class RemoveFromCartTool {
+    constructor(activeOrder, orderService, serializer) {
+        this.activeOrder = activeOrder;
+        this.orderService = orderService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        const order = await this.activeOrder.findOrThrow(ctx);
+        return this.serializer.orderOrError(await this.orderService.removeItemFromOrder(order.ctx, order.id, input.orderLineId));
+    }
+};
+exports.RemoveFromCartTool = RemoveFromCartTool;
+exports.RemoveFromCartTool = RemoveFromCartTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'remove_from_cart',
+        toolset: 'shop',
+        description: 'Remove a line from the active cart.',
+        keywords: [
+            'take this out of my basket',
+            'delete an item from my cart',
+            'remove this product',
+            "I don't want this anymore",
+            'drop a line from my order',
+            'get rid of a cart item',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'mutating',
+        usesActiveOrder: true,
+        inputSchema: removeFromCartInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [active_order_service_1.McpActiveOrderService,
+        core_1.OrderService,
+        serializer_service_1.McpToolSerializerService])
+], RemoveFromCartTool);
+//# sourceMappingURL=remove-from-cart.tool.js.map

package/lib/tools/built-in/shop/remove-from-cart.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-from-cart.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/remove-from-cart.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAAyE;AACzE,8CAA2D;AAC3D,6BAAwB;AAExB,kEAAgE;AAChE,4CAAwC;AACxC,8DAAiE;AAEjE,MAAM,mBAAmB,GAAG,OAAC,CAAC,YAAY,CAAC;IACvC,WAAW,EAAE,oBAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CACnD,CAAC,CAAC;AAsBI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC3B,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,KAA0B;QACzD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAC/B,MAAM,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,CACtF,CAAC;IACN,CAAC;CACJ,CAAA;AAbY,gDAAkB;6BAAlB,kBAAkB;IAlB9B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,qCAAqC;QAClD,QAAQ,EAAE;YACN,4BAA4B;YAC5B,6BAA6B;YAC7B,qBAAqB;YACrB,2BAA2B;YAC3B,2BAA2B;YAC3B,wBAAwB;SAC3B;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,mBAAmB;KACnC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAGyB,4CAAqB;QACpB,mBAAY;QACd,6CAAwB;GAJhD,kBAAkB,CAa9B"}

package/lib/tools/built-in/shop/search-products.tool.d.ts

@@ -0,0 +1,48 @@
+import { CollectionService, ID, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpCatalogQueryService } from '../catalog-query.service';
+import { McpToolSerializerService } from '../serializer.service';
+declare const searchProductsInput: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+    collectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    collectionSlug: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type SearchProductsInput = z.infer<typeof searchProductsInput>;
+export declare class SearchProductsTool implements McpToolHandler<SearchProductsInput> {
+    private readonly collectionService;
+    private readonly catalog;
+    private readonly serializer;
+    constructor(collectionService: CollectionService, catalog: McpCatalogQueryService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: SearchProductsInput): Promise<{
+        items: {
+            id: ID;
+            name: import("@vendure/core").LocaleString;
+            slug: import("@vendure/core").LocaleString;
+            description: string;
+            enabled: boolean;
+            featuredAsset: {
+                id: ID;
+                preview: string;
+            } | null;
+            priceRange: {
+                min: number;
+                minDecimal: string;
+                max: number;
+                maxDecimal: string;
+                currencyCode: import("@vendure/core").CurrencyCode;
+            } | null;
+        }[];
+        total: number;
+        hasMore: boolean;
+    } | {
+        message: string;
+        items: never[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    private findProducts;
+}
+export {};

package/lib/tools/built-in/shop/search-products.tool.js

@@ -0,0 +1,95 @@
+"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.SearchProductsTool = 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 catalog_query_service_1 = require("../catalog-query.service");
+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 collection_lookup_1 = require("./collection-lookup");
+const product_search_query_1 = require("./product-search-query");
+// Each word adds two LIKE conditions to the query, and a long query matches nothing anyway.
+const MAX_QUERY_LENGTH = 200;
+const MAX_QUERY_WORDS = 10;
+const searchProductsInput = zod_1.z
+    .strictObject(Object.assign({ query: string_schemas_1.shortText
+        .max(MAX_QUERY_LENGTH)
+        .refine(value => (0, product_search_query_1.productSearchWords)(value).length <= MAX_QUERY_WORDS, `Use at most ${MAX_QUERY_WORDS} words.`)
+        .describe('Text to look up in product names and slugs.')
+        .optional(), collectionId: id_schema_1.idSchema
+        .describe('Only products in this collection. Take the id from list_collections or get_collection.')
+        .optional(), collectionSlug: string_schemas_1.shortText
+        .describe('Only products in this collection. Take the slug from list_collections or get_collection.')
+        .optional() }, (0, list_helpers_1.paginationFields)('products')))
+    .refine(input => !(input.collectionId != null && input.collectionSlug != null), {
+    message: 'Pass collectionId or collectionSlug, not both.',
+});
+let SearchProductsTool = class SearchProductsTool {
+    constructor(collectionService, catalog, serializer) {
+        this.collectionService = collectionService;
+        this.catalog = catalog;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        let collectionId;
+        const lookup = (0, collection_lookup_1.collectionLookup)(input.collectionId, input.collectionSlug);
+        if (lookup) {
+            const collection = await (0, collection_lookup_1.findPublicCollection)(this.collectionService, ctx, lookup);
+            if (!collection) {
+                return Object.assign(Object.assign({}, (0, list_helpers_1.page)([], 0, input)), { message: (0, collection_lookup_1.noCollectionMessage)(lookup) });
+            }
+            collectionId = collection.id;
+        }
+        const words = (0, product_search_query_1.productSearchWords)(input.query);
+        const singularWords = (0, product_search_query_1.productSearchWords)(input.query, true);
+        let result = await this.findProducts(ctx, input, words, collectionId);
+        // A plural like "cameras" won't match "Instant Camera", so retry once with plurals trimmed.
+        if (result.totalItems === 0 && singularWords.join(' ') !== words.join(' ')) {
+            result = await this.findProducts(ctx, input, singularWords, collectionId);
+        }
+        const variantsByProduct = await this.catalog.variantsByProductId(ctx, result.items.map(product => product.id), { includeDisabled: false });
+        return (0, list_helpers_1.page)(result.items.map(product => { var _a; return this.serializer.productListItem(product, (_a = variantsByProduct.get(String(product.id))) !== null && _a !== void 0 ? _a : []); }), result.totalItems, input);
+    }
+    findProducts(ctx, input, words, collectionId) {
+        return this.catalog.findPublicProducts(ctx, (0, product_search_query_1.publicProductListOptions)(input, words), collectionId);
+    }
+};
+exports.SearchProductsTool = SearchProductsTool;
+exports.SearchProductsTool = SearchProductsTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'search_products',
+        toolset: 'shop',
+        description: 'Find products by name, optionally within one collection. Every word must appear in the name ' +
+            'or slug, and descriptions are not searched. If nothing comes back, try fewer or more general words.',
+        keywords: [
+            'find a product',
+            'search the store',
+            'do you sell',
+            'look for an item by name',
+            'search for something to buy',
+            'hunt for a product',
+            'products in a category',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'readonly',
+        inputSchema: searchProductsInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.CollectionService,
+        catalog_query_service_1.McpCatalogQueryService,
+        serializer_service_1.McpToolSerializerService])
+], SearchProductsTool);
+//# sourceMappingURL=search-products.tool.js.map

package/lib/tools/built-in/shop/search-products.tool.js.map

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

package/lib/tools/built-in/shop/set-checkout-details.tool.d.ts

@@ -0,0 +1,56 @@
+import { ConfigService, OrderService, RequestContext, TransactionalConnection } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpActiveOrderService } from '../active-order.service';
+import { McpCustomFieldInputService } from '../custom-field-input.service';
+import { McpToolSerializerService } from '../serializer.service';
+declare const setCheckoutDetailsInput: z.ZodObject<{
+    shippingAddress: z.ZodOptional<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>>;
+    billingAddress: z.ZodOptional<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>>;
+    billingSameAsShipping: z.ZodOptional<z.ZodBoolean>;
+    customer: z.ZodOptional<z.ZodObject<{
+        emailAddress: z.ZodString;
+        firstName: z.ZodString;
+        lastName: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type SetCheckoutDetailsInput = z.infer<typeof setCheckoutDetailsInput>;
+export declare class SetCheckoutDetailsTool implements McpToolHandler<SetCheckoutDetailsInput> {
+    private readonly activeOrder;
+    private readonly orderService;
+    private readonly connection;
+    private readonly customFieldInput;
+    private readonly serializer;
+    private readonly configService;
+    constructor(activeOrder: McpActiveOrderService, orderService: OrderService, connection: TransactionalConnection, customFieldInput: McpCustomFieldInputService, serializer: McpToolSerializerService, configService: ConfigService);
+    execute(ctx: RequestContext, input: SetCheckoutDetailsInput): Promise<Record<string, unknown>>;
+    private setGuestCustomer;
+    private shippingMethodChange;
+}
+export {};

package/lib/tools/built-in/shop/set-checkout-details.tool.js

@@ -0,0 +1,187 @@
+"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.SetCheckoutDetailsTool = 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 custom_field_input_service_1 = require("../custom-field-input.service");
+const email_schema_1 = require("../email-schema");
+const serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const address_schema_1 = require("./address-schema");
+const setCheckoutDetailsInput = zod_1.z
+    .strictObject({
+    shippingAddress: address_schema_1.addressInputSchema.describe('Where the order is delivered.').optional(),
+    billingAddress: address_schema_1.addressInputSchema.describe('Where the invoice goes.').optional(),
+    billingSameAsShipping: zod_1.z
+        .boolean()
+        .describe('Use the shipping address as the billing address too. Copies shippingAddress from this ' +
+        'call, or the shipping address already on the cart. Cannot be combined with billingAddress.')
+        .optional(),
+    customer: zod_1.z
+        .strictObject({
+        emailAddress: email_schema_1.emailAddressSchema.describe('Buyer email address.'),
+        firstName: string_schemas_1.shortText.describe('Buyer first name.'),
+        lastName: string_schemas_1.shortText.describe('Buyer last name.'),
+    })
+        .describe('Who is buying, for a guest checkout. Not needed when the caller is a signed-in customer.')
+        .optional(),
+})
+    .refine(input => input.shippingAddress || input.billingAddress || input.billingSameAsShipping || input.customer, {
+    message: 'Pass shippingAddress, billingAddress, billingSameAsShipping: true, or customer.',
+})
+    .refine(input => !(input.billingAddress && input.billingSameAsShipping), {
+    message: 'billingAddress and billingSameAsShipping cannot both be given.',
+});
+let SetCheckoutDetailsTool = class SetCheckoutDetailsTool {
+    constructor(activeOrder, orderService, connection, customFieldInput, serializer, configService) {
+        this.activeOrder = activeOrder;
+        this.orderService = orderService;
+        this.connection = connection;
+        this.customFieldInput = customFieldInput;
+        this.serializer = serializer;
+        this.configService = configService;
+    }
+    async execute(ctx, input) {
+        var _a, _b;
+        // Core rejects this too, but with a less helpful error; this catches it earlier with a
+        // clearer message and before the cart is touched.
+        if (input.customer && ctx.activeUserId) {
+            throw new core_1.UserInputError('This call is signed in as a customer; omit customer.');
+        }
+        await this.customFieldInput.assertWritable(ctx, 'Address', (_a = input.shippingAddress) === null || _a === void 0 ? void 0 : _a.customFields);
+        await this.customFieldInput.assertWritable(ctx, 'Address', (_b = input.billingAddress) === null || _b === void 0 ? void 0 : _b.customFields);
+        const cart = await this.activeOrder.findEditable(ctx);
+        if ((0, core_1.isGraphQlErrorResult)(cart)) {
+            return this.serializer.orderOrError(cart);
+        }
+        return this.connection.withTransaction(cart.ctx, async (txCtx) => {
+            var _a;
+            // The customer relation is loaded so that the answer can show who the cart belongs to.
+            const before = await this.orderService.findOne(txCtx, cart.id, ['shippingLines', 'customer']);
+            if (!before) {
+                // The cart was there a moment ago, so only a concurrent deletion gets here.
+                throw new core_1.EntityNotFoundError('Order', cart.id);
+            }
+            const methodsBefore = shippingMethodIds(before);
+            let order = before;
+            // Done first: a returned error here doesn't roll back the transaction, so naming the
+            // buyer before writing the addresses avoids leaving only the addresses saved on a refusal.
+            if (input.customer) {
+                const withCustomer = await this.setGuestCustomer(txCtx, before, input.customer);
+                if ((0, core_1.isGraphQlErrorResult)(withCustomer)) {
+                    return this.serializer.orderOrError(withCustomer);
+                }
+                order = withCustomer;
+            }
+            if (input.shippingAddress) {
+                order = await this.orderService.setShippingAddress(txCtx, cart.id, input.shippingAddress);
+            }
+            const billingAddress = input.billingSameAsShipping
+                ? asBillingAddress((_a = input.shippingAddress) !== null && _a !== void 0 ? _a : order === null || order === void 0 ? void 0 : order.shippingAddress)
+                : input.billingAddress;
+            if (billingAddress) {
+                order = await this.orderService.setBillingAddress(txCtx, cart.id, billingAddress);
+            }
+            return Object.assign({ order: this.serializer.order(order) }, this.shippingMethodChange(methodsBefore, order));
+        });
+    }
+    // Saving the checkout address to the new guest Customer's address book happens in place_order.
+    async setGuestCustomer(ctx, order, input) {
+        const { guestCheckoutStrategy } = this.configService.orderOptions;
+        const customer = await guestCheckoutStrategy.setCustomerForOrder(ctx, order, input);
+        if ((0, core_1.isGraphQlErrorResult)(customer)) {
+            return customer;
+        }
+        return this.orderService.addCustomerToOrder(ctx, order.id, customer);
+    }
+    // Lets the agent tell the shopper when the address change swapped or dropped the shipping method.
+    shippingMethodChange(methodsBefore, after) {
+        const methodsAfter = shippingMethodIds(after);
+        const sameIds = methodsBefore.length === methodsAfter.length &&
+            methodsBefore.every((id, index) => id === methodsAfter[index]);
+        if (methodsBefore.length === 0 || sameIds) {
+            return undefined;
+        }
+        const message = methodsAfter.length === 0 ? shippingMethodRemovedMessage : shippingMethodReplacedMessage;
+        return { shippingMethodChanged: true, message };
+    }
+};
+exports.SetCheckoutDetailsTool = SetCheckoutDetailsTool;
+exports.SetCheckoutDetailsTool = SetCheckoutDetailsTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'set_checkout_details',
+        toolset: 'shop',
+        description: "Set the cart's shipping address, billing address, or both, and for a guest checkout the " +
+            "buyer's email and name, in one call. A guest checkout needs the buyer named here, through " +
+            'customer, before place_order will take a payment. Changing the shipping address can make ' +
+            'the chosen shipping method ineligible; the response then carries shippingMethodChanged: ' +
+            'true and a message saying whether the store swapped the method or dropped it.',
+        keywords: [
+            'enter my delivery address',
+            'where to ship my order',
+            'add my shipping details',
+            'set where I want it delivered',
+            'send it to this address',
+            'enter my billing address',
+            'where to send the invoice',
+            'set the address on my card',
+            'billing details for checkout',
+            'same address for billing and shipping',
+            'check out as a guest',
+            'buy without an account',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'mutating',
+        usesActiveOrder: true,
+        inputSchema: setCheckoutDetailsInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [active_order_service_1.McpActiveOrderService,
+        core_1.OrderService,
+        core_1.TransactionalConnection,
+        custom_field_input_service_1.McpCustomFieldInputService,
+        serializer_service_1.McpToolSerializerService,
+        core_1.ConfigService])
+], SetCheckoutDetailsTool);
+const shippingMethodReplacedMessage = 'The new shipping address made the chosen shipping method ineligible, so the store replaced it ' +
+    'with the cheapest eligible one (see order.shippingLines). Tell the shopper, or call ' +
+    'get_eligible_shipping_methods and set_shipping_method to pick another.';
+const shippingMethodRemovedMessage = 'The new shipping address made the chosen shipping method ineligible and no other method is ' +
+    'eligible, so the cart has no shipping method. Call get_eligible_shipping_methods and ' +
+    'set_shipping_method again before place_order.';
+function shippingMethodIds(order) {
+    var _a;
+    return ((_a = order === null || order === void 0 ? void 0 : order.shippingLines) !== null && _a !== void 0 ? _a : []).map(line => String(line.shippingMethodId)).sort();
+}
+function asBillingAddress(source) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    if (!(source === null || source === void 0 ? void 0 : source.streetLine1) || !source.countryCode) {
+        throw new core_1.UserInputError('billingSameAsShipping needs a shipping address: pass shippingAddress in the same call, or ' +
+            'set one first.');
+    }
+    return {
+        fullName: (_a = source.fullName) !== null && _a !== void 0 ? _a : undefined,
+        company: (_b = source.company) !== null && _b !== void 0 ? _b : undefined,
+        streetLine1: source.streetLine1,
+        streetLine2: (_c = source.streetLine2) !== null && _c !== void 0 ? _c : undefined,
+        city: (_d = source.city) !== null && _d !== void 0 ? _d : undefined,
+        province: (_e = source.province) !== null && _e !== void 0 ? _e : undefined,
+        postalCode: (_f = source.postalCode) !== null && _f !== void 0 ? _f : undefined,
+        countryCode: source.countryCode,
+        phoneNumber: (_g = source.phoneNumber) !== null && _g !== void 0 ? _g : undefined,
+        customFields: (_h = source.customFields) !== null && _h !== void 0 ? _h : undefined,
+    };
+}
+//# sourceMappingURL=set-checkout-details.tool.js.map

package/lib/tools/built-in/shop/set-checkout-details.tool.js.map

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

package/lib/tools/built-in/shop/set-shipping-method.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 setShippingMethodInput: z.ZodObject<{
+    methodId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+}, z.core.$strict>;
+type SetShippingMethodInput = z.infer<typeof setShippingMethodInput>;
+export declare class SetShippingMethodTool implements McpToolHandler<SetShippingMethodInput> {
+    private readonly activeOrder;
+    private readonly orderService;
+    private readonly serializer;
+    constructor(activeOrder: McpActiveOrderService, orderService: OrderService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: SetShippingMethodInput): Promise<Record<string, unknown>>;
+}
+export {};

package/lib/tools/built-in/shop/set-shipping-method.tool.js

@@ -0,0 +1,58 @@
+"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.SetShippingMethodTool = 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 serializer_service_1 = require("../serializer.service");
+const setShippingMethodInput = zod_1.z.strictObject({
+    methodId: id_schema_1.idSchema.describe('Shipping method ID.'),
+});
+let SetShippingMethodTool = class SetShippingMethodTool {
+    constructor(activeOrder, orderService, serializer) {
+        this.activeOrder = activeOrder;
+        this.orderService = orderService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        const order = await this.activeOrder.findOrThrow(ctx);
+        return this.serializer.orderOrError(await this.orderService.setShippingMethod(order.ctx, order.id, [input.methodId]));
+    }
+};
+exports.SetShippingMethodTool = SetShippingMethodTool;
+exports.SetShippingMethodTool = SetShippingMethodTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'set_shipping_method',
+        toolset: 'shop',
+        description: 'Set the shipping method for the active cart.',
+        keywords: [
+            'choose a delivery option',
+            'pick how it ships',
+            'select express or standard',
+            'set my postage choice',
+            'select a courier',
+            'how I want my order delivered',
+        ],
+        permissions: [core_1.Permission.Public],
+        behavior: 'mutating',
+        usesActiveOrder: true,
+        inputSchema: setShippingMethodInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [active_order_service_1.McpActiveOrderService,
+        core_1.OrderService,
+        serializer_service_1.McpToolSerializerService])
+], SetShippingMethodTool);
+//# sourceMappingURL=set-shipping-method.tool.js.map

package/lib/tools/built-in/shop/set-shipping-method.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-shipping-method.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/shop/set-shipping-method.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAAyE;AACzE,8CAA2D;AAC3D,6BAAwB;AAExB,kEAAgE;AAChE,4CAAwC;AACxC,8DAAiE;AAEjE,MAAM,sBAAsB,GAAG,OAAC,CAAC,YAAY,CAAC;IAC1C,QAAQ,EAAE,oBAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC;CACrD,CAAC,CAAC;AAsBI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAC9B,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,KAA6B;QAC5D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAC/B,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CACnF,CAAC;IACN,CAAC;CACJ,CAAA;AAbY,sDAAqB;gCAArB,qBAAqB;IAlBjC,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,8CAA8C;QAC3D,QAAQ,EAAE;YACN,0BAA0B;YAC1B,mBAAmB;YACnB,4BAA4B;YAC5B,uBAAuB;YACvB,kBAAkB;YAClB,+BAA+B;SAClC;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,sBAAsB;KACtC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAGyB,4CAAqB;QACpB,mBAAY;QACd,6CAAwB;GAJhD,qBAAqB,CAajC"}

package/lib/tools/built-in/shop/update-cart-line.tool.d.ts

@@ -0,0 +1,18 @@
+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 updateCartLineInput: z.ZodObject<{
+    orderLineId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    quantity: z.ZodNumber;
+}, z.core.$strict>;
+type UpdateCartLineInput = z.infer<typeof updateCartLineInput>;
+export declare class UpdateCartLineTool implements McpToolHandler<UpdateCartLineInput> {
+    private readonly activeOrder;
+    private readonly orderService;
+    private readonly serializer;
+    constructor(activeOrder: McpActiveOrderService, orderService: OrderService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: UpdateCartLineInput): Promise<Record<string, unknown>>;
+}
+export {};