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

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

@@ -0,0 +1,142 @@
+import { OrderService, RequestContext, TranslatorService } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpToolSerializerService } from '../serializer.service';
+declare const listOrdersInput: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodObject<{
+        code: z.ZodOptional<z.ZodObject<{
+            eq: z.ZodOptional<z.ZodString>;
+            contains: z.ZodOptional<z.ZodString>;
+            in: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        state: z.ZodOptional<z.ZodObject<{
+            eq: z.ZodOptional<z.ZodString>;
+            contains: z.ZodOptional<z.ZodString>;
+            in: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        active: z.ZodOptional<z.ZodObject<{
+            eq: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        customerLastName: z.ZodOptional<z.ZodObject<{
+            eq: z.ZodOptional<z.ZodString>;
+            contains: z.ZodOptional<z.ZodString>;
+            in: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        orderPlacedAt: z.ZodOptional<z.ZodObject<{
+            before: z.ZodOptional<z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>>;
+            after: z.ZodOptional<z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>>;
+        }, z.core.$strict>>;
+        updatedAt: z.ZodOptional<z.ZodObject<{
+            before: z.ZodOptional<z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>>;
+            after: z.ZodOptional<z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>>;
+        }, z.core.$strict>>;
+        totalWithTax: z.ZodOptional<z.ZodObject<{
+            eq: z.ZodOptional<z.ZodNumber>;
+            gte: z.ZodOptional<z.ZodNumber>;
+            lte: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    sortBy: z.ZodOptional<z.ZodEnum<{
+        createdAt: "createdAt";
+        updatedAt: "updatedAt";
+        orderPlacedAt: "orderPlacedAt";
+        total: "total";
+    }>>;
+    sortDirection: z.ZodOptional<z.ZodEnum<{
+        ASC: "ASC";
+        DESC: "DESC";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type ListOrdersInput = z.infer<typeof listOrdersInput>;
+export declare class ListOrdersTool implements McpToolHandler<ListOrdersInput> {
+    private readonly orderService;
+    private readonly translator;
+    private readonly serializer;
+    constructor(orderService: OrderService, translator: TranslatorService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: ListOrdersInput): 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/admin/list-orders.tool.js

@@ -0,0 +1,87 @@
+"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.ListOrdersTool = 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 listOrdersInput = zod_1.z.strictObject(Object.assign(Object.assign({}, (0, list_helpers_1.paginationFields)('orders')), { filter: zod_1.z
+        .strictObject({
+        code: list_helpers_1.stringFilter.optional(),
+        state: list_helpers_1.stringFilter
+            .describe('Order state, for example PaymentSettled or ArrangingPayment.')
+            .optional(),
+        active: list_helpers_1.booleanFilter
+            .describe('true for open carts, false for placed or cancelled orders.')
+            .optional(),
+        customerLastName: list_helpers_1.stringFilter.optional(),
+        orderPlacedAt: list_helpers_1.dateFilter.optional(),
+        updatedAt: list_helpers_1.dateFilter.optional(),
+        totalWithTax: list_helpers_1.numberFilter
+            .describe("Whole number in the currency's smallest unit, like every price these tools return.")
+            .optional(),
+    })
+        .describe('Conditions an order must meet; all of them apply together. Example: ' +
+        '{"state":{"eq":"ArrangingPayment"},"updatedAt":{"before":"2026-08-25T12:00:00Z"}} ' +
+        'finds orders stuck at payment since before noon.')
+        .optional(), sortBy: zod_1.z
+        .enum(order_list_helpers_1.ORDER_SORT_FIELDS)
+        .describe('Field to sort by. Defaults to updatedAt, most recently changed first. Open carts have ' +
+        'no orderPlacedAt, so when sorting by it filter active: false to see placed orders only.')
+        .optional(), sortDirection: order_list_helpers_1.sortDirection.describe('Sort direction. Defaults to DESC.').optional() }));
+let ListOrdersTool = class ListOrdersTool {
+    constructor(orderService, translator, serializer) {
+        this.orderService = orderService;
+        this.translator = translator;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        var _a;
+        const options = (0, order_list_helpers_1.orderListOptions)(input, 'updatedAt');
+        if (((_a = input.filter) === null || _a === void 0 ? void 0 : _a.active) === undefined) {
+            options.filter = Object.assign(Object.assign({}, options.filter), { active: { eq: false } });
+        }
+        const result = await this.orderService.findAll(ctx, options, 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.ListOrdersTool = ListOrdersTool;
+exports.ListOrdersTool = ListOrdersTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'list_orders',
+        toolset: 'admin',
+        description: 'List and filter orders for operations users, most recently updated first by default. ' +
+            'Unplaced carts are excluded unless you pass filter.active.',
+        keywords: [
+            'show all orders',
+            'recent orders in the store',
+            'browse the order queue',
+            'every order placed',
+            'orders dashboard for staff',
+            'pull the full order list',
+            'orders in a given state',
+            'find orders by customer last name',
+        ],
+        permissions: [core_1.Permission.ReadOrder],
+        behavior: 'readonly',
+        inputSchema: listOrdersInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.OrderService,
+        core_1.TranslatorService,
+        serializer_service_1.McpToolSerializerService])
+], ListOrdersTool);
+//# sourceMappingURL=list-orders.tool.js.map

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

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

package/lib/tools/built-in/admin/list-products.tool.d.ts

@@ -0,0 +1,63 @@
+import { ProductService, 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 listProductsInput: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodObject<{
+            eq: z.ZodOptional<z.ZodString>;
+            contains: z.ZodOptional<z.ZodString>;
+            in: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        slug: z.ZodOptional<z.ZodObject<{
+            eq: z.ZodOptional<z.ZodString>;
+            contains: z.ZodOptional<z.ZodString>;
+            in: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        sku: z.ZodOptional<z.ZodObject<{
+            eq: z.ZodOptional<z.ZodString>;
+            contains: z.ZodOptional<z.ZodString>;
+            in: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        enabled: z.ZodOptional<z.ZodObject<{
+            eq: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        updatedAt: z.ZodOptional<z.ZodObject<{
+            before: z.ZodOptional<z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>>;
+            after: z.ZodOptional<z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type ListProductsInput = z.infer<typeof listProductsInput>;
+export declare class ListProductsTool implements McpToolHandler<ListProductsInput> {
+    private readonly productService;
+    private readonly catalog;
+    private readonly serializer;
+    constructor(productService: ProductService, catalog: McpCatalogQueryService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: ListProductsInput): Promise<{
+        items: {
+            id: import("@vendure/core").ID;
+            name: import("@vendure/core").LocaleString;
+            slug: import("@vendure/core").LocaleString;
+            description: string;
+            enabled: boolean;
+            featuredAsset: {
+                id: import("@vendure/core").ID;
+                preview: string;
+            } | null;
+            priceRange: {
+                min: number;
+                minDecimal: string;
+                max: number;
+                maxDecimal: string;
+                currencyCode: import("@vendure/core").CurrencyCode;
+            } | null;
+        }[];
+        total: number;
+        hasMore: boolean;
+    }>;
+}
+export {};

package/lib/tools/built-in/admin/list-products.tool.js

@@ -0,0 +1,71 @@
+"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.ListProductsTool = 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 list_helpers_1 = require("../list-helpers");
+const serializer_service_1 = require("../serializer.service");
+const listProductsInput = zod_1.z.strictObject(Object.assign(Object.assign({}, (0, list_helpers_1.paginationFields)('products')), { filter: zod_1.z
+        .strictObject({
+        name: list_helpers_1.stringFilter.optional(),
+        slug: list_helpers_1.stringFilter.optional(),
+        sku: list_helpers_1.stringFilter
+            .describe("Matches any of the product's variant SKUs. The result lists products, not " +
+            'variants, so it does not show which variant matched.')
+            .optional(),
+        enabled: list_helpers_1.booleanFilter.optional(),
+        updatedAt: list_helpers_1.dateFilter.optional(),
+    })
+        .describe('Conditions a product must meet; all of them apply together. Example: ' +
+        '{"sku":{"contains":"L2201"}} finds the product a variant SKU belongs to.')
+        .optional() }));
+let ListProductsTool = class ListProductsTool {
+    constructor(productService, catalog, serializer) {
+        this.productService = productService;
+        this.catalog = catalog;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        const result = await this.productService.findAll(ctx, (0, list_helpers_1.listOptions)(input), ['featuredAsset']);
+        // Staff see the whole catalog, so the price range counts disabled variants too.
+        const variantsByProduct = await this.catalog.variantsByProductId(ctx, result.items.map(product => product.id), { includeDisabled: true });
+        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);
+    }
+};
+exports.ListProductsTool = ListProductsTool;
+exports.ListProductsTool = ListProductsTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'list_products',
+        toolset: 'admin',
+        description: "List and filter catalog products. Use get_product for a product's variant IDs.",
+        keywords: [
+            'show the whole catalog',
+            'list every product',
+            'browse all items we sell',
+            'full product list',
+            'see the inventory of products',
+            'catalog listing for staff',
+            'find product by sku',
+        ],
+        permissions: [core_1.Permission.ReadProduct],
+        behavior: 'readonly',
+        inputSchema: listProductsInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ProductService,
+        catalog_query_service_1.McpCatalogQueryService,
+        serializer_service_1.McpToolSerializerService])
+], ListProductsTool);
+//# sourceMappingURL=list-products.tool.js.map

package/lib/tools/built-in/admin/list-products.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-products.tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/admin/list-products.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,wCAAoF;AACpF,8CAA2D;AAC3D,6BAAwB;AAExB,oEAAkE;AAClE,kDAOyB;AACzB,8DAAiE;AAEjE,MAAM,iBAAiB,GAAG,OAAC,CAAC,YAAY,iCACjC,IAAA,+BAAgB,EAAC,UAAU,CAAC,KAC/B,MAAM,EAAE,OAAC;SACJ,YAAY,CAAC;QACV,IAAI,EAAE,2BAAY,CAAC,QAAQ,EAAE;QAC7B,IAAI,EAAE,2BAAY,CAAC,QAAQ,EAAE;QAC7B,GAAG,EAAE,2BAAY;aACZ,QAAQ,CACL,4EAA4E;YACxE,sDAAsD,CAC7D;aACA,QAAQ,EAAE;QACf,OAAO,EAAE,4BAAa,CAAC,QAAQ,EAAE;QACjC,SAAS,EAAE,yBAAU,CAAC,QAAQ,EAAE;KACnC,CAAC;SACD,QAAQ,CACL,uEAAuE;QACnE,0EAA0E,CACjF;SACA,QAAQ,EAAE,IACjB,CAAC;AAsBI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IACzB,YACqB,cAA8B,EAC9B,OAA+B,EAC/B,UAAoC;QAFpC,mBAAc,GAAd,cAAc,CAAgB;QAC9B,YAAO,GAAP,OAAO,CAAwB;QAC/B,eAAU,GAAV,UAAU,CAA0B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAmB,EAAE,KAAwB;QACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,IAAA,0BAAW,EAAU,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;QACtG,gFAAgF;QAChF,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAC5D,GAAG,EACH,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EACvC,EAAE,eAAe,EAAE,IAAI,EAAE,CAC5B,CAAC;QACF,OAAO,IAAA,mBAAI,EACP,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,WACvB,OAAA,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,OAAO,EAAE,MAAA,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,mCAAI,EAAE,CAAC,CAAA,EAAA,CAC5F,EACD,MAAM,CAAC,UAAU,EACjB,KAAK,CACR,CAAC;IACN,CAAC;CACJ,CAAA;AAvBY,4CAAgB;2BAAhB,gBAAgB;IAlB5B,IAAA,iBAAO,EAAC;QACL,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,gFAAgF;QAC7F,QAAQ,EAAE;YACN,wBAAwB;YACxB,oBAAoB;YACpB,0BAA0B;YAC1B,mBAAmB;YACnB,+BAA+B;YAC/B,2BAA2B;YAC3B,qBAAqB;SACxB;QACD,WAAW,EAAE,CAAC,iBAAU,CAAC,WAAW,CAAC;QACrC,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,iBAAiB;KACjC,CAAC;IACD,IAAA,mBAAU,GAAE;qCAG4B,qBAAc;QACrB,8CAAsB;QACnB,6CAAwB;GAJhD,gBAAgB,CAuB5B"}

package/lib/tools/built-in/admin/refund-order.tool.d.ts

@@ -0,0 +1,38 @@
+import { OrderService, RequestContext } from '@vendure/core';
+import { McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpToolSerializerService } from '../serializer.service';
+declare const refundOrderInput: z.ZodObject<{
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    reason: z.ZodOptional<z.ZodString>;
+    paymentId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strict>;
+type RefundOrderToolInput = z.infer<typeof refundOrderInput>;
+export declare class RefundOrderTool implements McpToolHandler<RefundOrderToolInput> {
+    private readonly orderService;
+    private readonly serializer;
+    constructor(orderService: OrderService, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: RefundOrderToolInput): Promise<import("@vendure/common/lib/generated-types").MultipleOrderError | import("@vendure/common/lib/generated-types").OrderStateTransitionError | import("@vendure/common/lib/generated-types").QuantityTooGreatError | import("@vendure/common/lib/generated-types").AlreadyRefundedError | import("@vendure/common/lib/generated-types").NothingToRefundError | import("@vendure/common/lib/generated-types").PaymentOrderMismatchError | import("@vendure/common/lib/generated-types").RefundAmountError | import("@vendure/common/lib/generated-types").RefundDestinationError | import("@vendure/common/lib/generated-types").RefundIncompleteError | import("@vendure/common/lib/generated-types").RefundOrderStateError | import("@vendure/common/lib/generated-types").RefundStateTransitionError | {
+        __typename: string;
+        errorCode: string;
+        message: string;
+        refund?: undefined;
+    } | {
+        refund: {
+            id: import("@vendure/core").ID;
+            state: import("@vendure/core").RefundState;
+            total: number;
+            totalDecimal: string;
+            currencyCode: import("@vendure/core").CurrencyCode;
+            reason: string;
+            paymentId: import("@vendure/core").ID;
+        };
+        __typename?: undefined;
+        errorCode?: undefined;
+        message?: undefined;
+    }>;
+    /** Why no payment was picked: the first Settled payment is already refunded, or there is none. */
+    private nothingToRefundMessage;
+}
+export {};

package/lib/tools/built-in/admin/refund-order.tool.js

@@ -0,0 +1,115 @@
+"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.RefundOrderTool = void 0;
+const common_1 = require("@nestjs/common");
+const shared_utils_1 = require("@vendure/common/lib/shared-utils");
+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 int32_schema_1 = require("../int32-schema");
+const order_list_helpers_1 = require("../order-list-helpers");
+const serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const refundOrderInput = zod_1.z.strictObject({
+    id: id_schema_1.idSchema.describe('Order ID.'),
+    amount: int32_schema_1.int32Schema
+        .min(1)
+        .describe('Amount to refund as a whole number of minor units. Defaults to the selected ' +
+        "payment's remaining refundable amount.")
+        .optional(),
+    reason: string_schemas_1.shortText.describe('Reason for the refund.').optional(),
+    paymentId: id_schema_1.idSchema
+        .describe("Payment to refund; must belong to this order. Defaults to the order's first Settled payment that still has a refundable amount.")
+        .optional(),
+});
+/** The refunds that count against a payment: a Failed refund returned no money. */
+function countedRefunds(payment) {
+    var _a, _b;
+    return (_b = (_a = payment.refunds) === null || _a === void 0 ? void 0 : _a.filter(refund => refund.state !== 'Failed')) !== null && _b !== void 0 ? _b : [];
+}
+function getRefundableAmount(payment) {
+    return payment.amount - (0, shared_utils_1.summate)(countedRefunds(payment), 'total');
+}
+let RefundOrderTool = class RefundOrderTool {
+    constructor(orderService, serializer) {
+        this.orderService = orderService;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input) {
+        var _a;
+        const order = await (0, order_list_helpers_1.findOrderOrThrow)(this.orderService, ctx, input.id, [
+            'payments',
+            'payments.refunds',
+        ]);
+        const payment = input.paymentId
+            ? order.payments.find(p => (0, core_1.idsAreEqual)(p.id, input.paymentId))
+            : order.payments.find(p => p.state === 'Settled' && getRefundableAmount(p) > 0);
+        if (!payment) {
+            // A bare Vendure error result: the registry reports it as a failed call.
+            return {
+                __typename: 'RefundPaymentIdMissingError',
+                errorCode: 'REFUND_PAYMENT_ID_MISSING_ERROR',
+                message: input.paymentId
+                    ? 'The requested payment was not found on this order.'
+                    : this.nothingToRefundMessage(order),
+            };
+        }
+        const refund = await this.orderService.refundOrder(ctx, {
+            paymentId: payment.id,
+            amount: (_a = input.amount) !== null && _a !== void 0 ? _a : getRefundableAmount(payment),
+            reason: input.reason,
+            shipping: 0,
+            adjustment: 0,
+        });
+        return (0, core_1.isGraphQlErrorResult)(refund)
+            ? refund
+            : { refund: this.serializer.refund(refund, order.currencyCode) };
+    }
+    /** Why no payment was picked: the first Settled payment is already refunded, or there is none. */
+    nothingToRefundMessage(order) {
+        const settled = order.payments.find(p => p.state === 'Settled');
+        if (!settled) {
+            return `Order ${order.code} has no Settled payment to refund.`;
+        }
+        const refunds = countedRefunds(settled);
+        const refunded = this.serializer.decimal((0, shared_utils_1.summate)(refunds, 'total'));
+        const states = refunds.map(refund => refund.state).join(', ');
+        return (`Payment ${String(settled.id)} has no refundable amount left: ${refunded} of ` +
+            `${this.serializer.decimal(settled.amount)} already refunded (${states}).`);
+    }
+};
+exports.RefundOrderTool = RefundOrderTool;
+exports.RefundOrderTool = RefundOrderTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'refund_order',
+        toolset: 'admin',
+        description: "Refund part or all of an order's payment. With amount, refunds that amount; without it, refunds " +
+            'the remaining refundable amount of the first Settled payment. Pass paymentId to pick a payment ' +
+            'when the order has several.',
+        keywords: [
+            'give the customer their money back',
+            'issue a refund',
+            'return the payment',
+            'reimburse a buyer',
+            'pay back an order',
+            'process a refund',
+        ],
+        permissions: [core_1.Permission.UpdateOrder],
+        behavior: 'destructive',
+        inputSchema: refundOrderInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.OrderService,
+        serializer_service_1.McpToolSerializerService])
+], RefundOrderTool);
+//# sourceMappingURL=refund-order.tool.js.map

package/lib/tools/built-in/admin/refund-order.tool.js.map

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

package/lib/tools/built-in/admin/set-active-channel.tool.d.ts

@@ -0,0 +1,22 @@
+import { ChannelService, RequestContext, TransactionalConnection } from '@vendure/core';
+import { McpCallerInfo, McpToolHandler } from '@vendure/mcp-sdk';
+import { z } from 'zod';
+import { McpToolSerializerService } from '../serializer.service';
+declare const setActiveChannelInput: z.ZodObject<{
+    channelToken: z.ZodString;
+}, z.core.$strict>;
+type SetActiveChannelInput = z.infer<typeof setActiveChannelInput>;
+export declare class SetActiveChannelTool implements McpToolHandler<SetActiveChannelInput> {
+    private readonly channelService;
+    private readonly connection;
+    private readonly serializer;
+    constructor(channelService: ChannelService, connection: TransactionalConnection, serializer: McpToolSerializerService);
+    execute(ctx: RequestContext, input: SetActiveChannelInput, caller?: McpCallerInfo): Promise<{
+        channel: {
+            id: import("@vendure/core").ID;
+            code: string;
+            token: string;
+        };
+    }>;
+}
+export {};

package/lib/tools/built-in/admin/set-active-channel.tool.js

@@ -0,0 +1,84 @@
+"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.SetActiveChannelTool = 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 mcp_oauth_grant_entity_1 = require("../../../entities/mcp-oauth-grant.entity");
+const serializer_service_1 = require("../serializer.service");
+const string_schemas_1 = require("../string-schemas");
+const channel_access_1 = require("./channel-access");
+const setActiveChannelInput = zod_1.z.strictObject({
+    channelToken: string_schemas_1.shortText.describe('Channel token of the channel to activate.'),
+});
+let SetActiveChannelTool = class SetActiveChannelTool {
+    constructor(channelService, connection, serializer) {
+        this.channelService = channelService;
+        this.connection = connection;
+        this.serializer = serializer;
+    }
+    async execute(ctx, input, caller) {
+        let channel;
+        try {
+            channel = await this.channelService.getChannelFromToken(ctx, input.channelToken);
+        }
+        catch (e) {
+            if (!(e instanceof core_1.ChannelNotFoundError))
+                throw e;
+            throw new core_1.UserInputError(`No channel with token "${input.channelToken}". Call list_channels for the tokens ` +
+                'you can use.');
+        }
+        const accessibleIds = (0, channel_access_1.userChannelIds)(ctx);
+        if (!accessibleIds.some(id => (0, core_1.idsAreEqual)(id, channel.id))) {
+            throw new core_1.ForbiddenError();
+        }
+        // Update only channelId so a concurrent token refresh cannot overwrite rotated hashes.
+        if (!(caller === null || caller === void 0 ? void 0 : caller.grant)) {
+            // An authenticated MCP caller always carries a grant; its absence means the caller info
+            // was not wired up, so fail loudly rather than report a switch that never persisted.
+            throw new core_1.InternalServerError('MCP set_active_channel requires an authenticated grant');
+        }
+        const result = await this.connection
+            .getRepository(ctx, mcp_oauth_grant_entity_1.McpOauthGrant)
+            .update({ id: caller.grant.id }, { channelId: channel.id });
+        if (result.affected === 0) {
+            throw new core_1.EntityNotFoundError('McpOauthGrant', caller.grant.id);
+        }
+        return { channel: this.serializer.channel(channel) };
+    }
+};
+exports.SetActiveChannelTool = SetActiveChannelTool;
+exports.SetActiveChannelTool = SetActiveChannelTool = __decorate([
+    (0, mcp_sdk_1.McpTool)({
+        name: 'set_active_channel',
+        toolset: 'admin',
+        description: 'Set the active channel for this MCP grant by channel token.',
+        keywords: [
+            'switch to another store',
+            'change the active channel',
+            'select which storefront to work in',
+            'set my current channel',
+            'switch channels',
+            "change the store I'm managing",
+        ],
+        permissions: [core_1.Permission.Authenticated],
+        // Every later write on this grant lands on the channel this picks, so it is confirmed first.
+        behavior: 'destructive',
+        inputSchema: setActiveChannelInput,
+    }),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ChannelService,
+        core_1.TransactionalConnection,
+        serializer_service_1.McpToolSerializerService])
+], SetActiveChannelTool);
+//# sourceMappingURL=set-active-channel.tool.js.map