@lehaotech/walmart-mcp 0.5.4

package/build/tools/definitions/pricing.js

@@ -0,0 +1,254 @@
+import { z } from 'zod';
+import { SkuSchema, MoneySchema, Iso8601UtcSchema, Iso4217CurrencySchema, ProcessModeSchema, } from './shared-schemas.js';
+// ---------- Standard (BASE) price feed (feedType=price, legacy v1.5) ----------
+// Walmart legacy price-feed body:
+//   { PriceHeader: {version}, Price: [{ itemIdentifier: {sku, productIdType, productId},
+//     pricingList: { pricing: [{ currentPrice: { value: {amount, currency} }, currentPriceType }] }
+//   }] }
+const LegacyPricingEntrySchema = z
+    .object({
+    itemIdentifier: z
+        .object({
+        sku: SkuSchema,
+        productIdType: z.literal('SKU').default('SKU'),
+        productId: z.string().min(1).optional(),
+    })
+        .strict(),
+    pricingList: z
+        .object({
+        pricing: z
+            .array(z
+            .object({
+            currentPrice: z
+                .object({
+                value: z
+                    .object({
+                    amount: z.number().positive(),
+                    currency: Iso4217CurrencySchema,
+                })
+                    .strict(),
+            })
+                .strict(),
+            currentPriceType: z.enum(['BASE', 'REDUCED', 'CLEARANCE']).default('BASE'),
+        })
+            .strict())
+            .min(1, 'Need at least 1 pricing entry per SKU'),
+    })
+        .strict(),
+})
+    .strict();
+const LegacyPriceFeedSchema = z
+    .object({
+    PriceHeader: z
+        .object({
+        version: z.string().default('1.5'),
+        feedDate: Iso8601UtcSchema.optional(),
+    })
+        .strict(),
+    Price: z
+        .array(LegacyPricingEntrySchema)
+        .min(1, 'Need at least 1 SKU in a price feed')
+        .max(10_000, 'Walmart caps price feeds at ~10000 SKUs per submission'),
+})
+    .strict();
+// ---------- MP_ITEM_PRICE_UPDATE feed (newer style) ----------
+const MpPriceEntrySchema = z
+    .object({
+    sku: SkuSchema,
+    pricing: z
+        .array(z
+        .object({
+        currentPrice: MoneySchema,
+        currentPriceType: z.enum(['BASE', 'REDUCED', 'CLEARANCE']).default('BASE'),
+        processMode: ProcessModeSchema.optional(),
+    })
+        .strict())
+        .min(1)
+        .max(10, 'Max 10 pricing entries per SKU'),
+})
+    .strict();
+const MpPriceFeedSchema = z
+    .object({
+    PriceHeader: z
+        .object({
+        version: z.string().default('1.5.1'),
+        feedDate: Iso8601UtcSchema.optional(),
+    })
+        .strict(),
+    Price: z
+        .array(MpPriceEntrySchema)
+        .min(1)
+        .max(10_000),
+})
+    .strict();
+// ---------- PROMO_PRICE feed body ----------
+const PromoPricingEntrySchema = z
+    .object({
+    currentPrice: MoneySchema,
+    currentPriceType: z.enum(['REDUCED', 'CLEARANCE']),
+    comparisonPrice: MoneySchema,
+    comparisonPriceType: z.literal('BASE'),
+    priceDisplayCodes: z.literal('CART').default('CART'),
+    effectiveDate: Iso8601UtcSchema,
+    expirationDate: Iso8601UtcSchema,
+    processMode: ProcessModeSchema,
+})
+    .strict()
+    .refine((p) => p.currentPrice.amount < p.comparisonPrice.amount, {
+    message: 'currentPrice.amount must be < comparisonPrice.amount',
+    path: ['currentPrice', 'amount'],
+})
+    .refine((p) => new Date(p.expirationDate).getTime() > new Date(p.effectiveDate).getTime(), {
+    message: 'expirationDate must be after effectiveDate',
+    path: ['expirationDate'],
+})
+    .refine((p) => {
+    const days = (new Date(p.expirationDate).getTime() - new Date(p.effectiveDate).getTime()) /
+        (24 * 60 * 60 * 1000);
+    return days <= 180;
+}, { message: 'Promo duration cannot exceed 180 days', path: ['expirationDate'] })
+    .refine((p) => new Date(p.effectiveDate).getTime() - Date.now() >= 4 * 60 * 60 * 1000, {
+    message: 'effectiveDate must be at least 4 hours from current UTC',
+    path: ['effectiveDate'],
+})
+    .refine((p) => p.currentPrice.currency === p.comparisonPrice.currency, {
+    message: 'currentPrice and comparisonPrice must use the same currency',
+    path: ['currentPrice', 'currency'],
+});
+const PromoPriceEntrySchema = z
+    .object({
+    sku: SkuSchema,
+    pricing: z
+        .array(PromoPricingEntrySchema)
+        .min(1, 'Need at least 1 pricing entry per SKU')
+        .max(10, 'Max 10 active promos per SKU'),
+})
+    .strict();
+const PromoPriceFeedSchema = z
+    .object({
+    PriceHeader: z
+        .object({
+        version: z.string().default('1.5.1'),
+        feedDate: Iso8601UtcSchema.optional(),
+    })
+        .strict(),
+    Price: z
+        .array(PromoPriceEntrySchema)
+        .min(1)
+        .max(10_000, 'Walmart caps PROMO_PRICE feeds at ~10000 SKUs per submission'),
+})
+    .strict();
+// ---------- Repricer strategy ----------
+// Walmart Repricer's strategy body shape varies and is sparsely documented.
+// We require the documented "must have a name + rules array" envelope and
+// passthrough the rest until Walmart publishes a public spec.
+const RepricerStrategySchema = z
+    .object({
+    strategyName: z.string().min(1).max(100),
+    description: z.string().max(500).optional(),
+    rules: z.array(z.unknown()).min(1, 'Repricer strategy must have at least 1 rule'),
+    minPrice: z.number().positive().optional(),
+    maxPrice: z.number().positive().optional(),
+})
+    .passthrough()
+    .refine((s) => !(s.minPrice != null && s.maxPrice != null) || s.minPrice <= s.maxPrice, { message: 'minPrice must be <= maxPrice', path: ['minPrice'] });
+// ---------- Strategy assignment ----------
+const StrategyAssignmentItemSchema = z
+    .object({
+    sku: SkuSchema,
+})
+    .passthrough();
+export const pricingTools = [
+    {
+        name: 'walmart_update_price',
+        description: 'Update the regular (BASE) price for a single item by SKU. Pass sku and amount; ' +
+            'the Walmart /v3/price payload is built for you. For promo/strikethrough pricing use ' +
+            'walmart_submit_promo_price_feed.',
+        inputSchema: {
+            sku: z.string().describe('Seller-defined SKU'),
+            amount: z.number().positive().describe('New price amount, e.g. 16.99'),
+            currency: z.string().length(3).optional().describe('ISO 4217 currency code (default USD)'),
+        },
+    },
+    {
+        name: 'walmart_submit_price_feed',
+        description: 'Submit a bulk legacy price update feed (feedType=price, spec 1.5). Payload: ' +
+            '{ PriceHeader: { version }, Price: [{ itemIdentifier: { sku, productIdType, productId }, ' +
+            'pricingList: { pricing: [{ currentPrice: { value: { amount, currency } }, ' +
+            'currentPriceType }] } }] }. Returns a feedId; poll walmart_get_feed_status.',
+        inputSchema: {
+            feedData: LegacyPriceFeedSchema,
+        },
+    },
+    {
+        name: 'walmart_submit_mp_price_feed',
+        description: 'Submit a marketplace price update feed (feedType=MP_ITEM_PRICE_UPDATE). Payload: ' +
+            '{ PriceHeader, Price: [{ sku, pricing: [{ currentPrice: { currency, amount }, ' +
+            'currentPriceType }] }] }. Returns a feedId.',
+        inputSchema: {
+            feedData: MpPriceFeedSchema,
+        },
+    },
+    {
+        name: 'walmart_submit_promo_price_feed',
+        description: 'Submit a promotional price feed (feedType=PROMO_PRICE). Walmart business rules enforced at ' +
+            'the schema layer BEFORE the API call: currentPrice < comparisonPrice, currency matches on ' +
+            'both, effectiveDate >= now + 4h, expirationDate > effectiveDate, duration <= 180 days, ' +
+            'max 10 promos per SKU, max 10000 SKUs per feed. Supports REDUCED and CLEARANCE ' +
+            'currentPriceType. Returns a feedId; poll walmart_get_feed_status until PROCESSED.',
+        inputSchema: {
+            feedData: PromoPriceFeedSchema,
+        },
+    },
+    {
+        name: 'walmart_get_repricer_strategies',
+        description: 'List all configured repricer strategies. Repricer automates price adjustments based on Buy Box competition.',
+        inputSchema: {},
+    },
+    {
+        name: 'walmart_create_repricer_strategy',
+        description: 'Create a new repricer strategy. Required: strategyName, rules (non-empty array). ' +
+            'Optional: description, minPrice / maxPrice (minPrice <= maxPrice).',
+        inputSchema: {
+            strategyData: RepricerStrategySchema,
+        },
+    },
+    {
+        name: 'walmart_update_repricer_strategy',
+        description: 'Update an existing repricer strategy. Same shape as create.',
+        inputSchema: {
+            strategyData: RepricerStrategySchema,
+        },
+    },
+    {
+        name: 'walmart_delete_repricer_strategy',
+        description: 'Delete a repricer strategy by ID.',
+        inputSchema: {
+            strategyId: z.string().describe('Repricer strategy ID to delete'),
+        },
+    },
+    {
+        name: 'walmart_assign_items_to_strategy',
+        description: 'Assign items to a repricer strategy. Pass items: [{ sku }, ...]. The repricer will then ' +
+            'automatically manage pricing for these SKUs.',
+        inputSchema: {
+            strategyId: z.string().describe('Repricer strategy ID'),
+            items: z
+                .array(StrategyAssignmentItemSchema)
+                .min(1, 'Need at least 1 item to assign')
+                .max(10_000, 'Assignment capped at 10000 SKUs per call'),
+        },
+    },
+    {
+        name: 'walmart_unassign_items_from_strategy',
+        description: 'Remove items from a repricer strategy. Items will return to manual pricing.',
+        inputSchema: {
+            strategyId: z.string().describe('Repricer strategy ID'),
+            skus: z
+                .array(SkuSchema)
+                .min(1)
+                .max(10_000)
+                .describe('Array of SKUs to unassign'),
+        },
+    },
+];

package/build/tools/definitions/reports.d.ts

@@ -0,0 +1,223 @@
+import { z } from 'zod';
+export declare const reportTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        reportData: z.ZodEffects<z.ZodObject<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            startDate: z.ZodOptional<z.ZodString>;
+            endDate: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            startDate: z.ZodOptional<z.ZodString>;
+            endDate: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            startDate: z.ZodOptional<z.ZodString>;
+            endDate: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            startDate: z.ZodOptional<z.ZodString>;
+            endDate: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            startDate: z.ZodOptional<z.ZodString>;
+            endDate: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>;
+        reportType?: undefined;
+        reportVersion?: undefined;
+        requestId?: undefined;
+        scheduleData?: undefined;
+        scheduleId?: undefined;
+        limit?: undefined;
+        offset?: undefined;
+        category?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        reportType: z.ZodOptional<z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>>;
+        reportVersion: z.ZodOptional<z.ZodString>;
+        reportData?: undefined;
+        requestId?: undefined;
+        scheduleData?: undefined;
+        scheduleId?: undefined;
+        limit?: undefined;
+        offset?: undefined;
+        category?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        requestId: z.ZodString;
+        reportData?: undefined;
+        reportType?: undefined;
+        reportVersion?: undefined;
+        scheduleData?: undefined;
+        scheduleId?: undefined;
+        limit?: undefined;
+        offset?: undefined;
+        category?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        requestId: z.ZodOptional<z.ZodString>;
+        reportType: z.ZodOptional<z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>>;
+        reportData?: undefined;
+        reportVersion?: undefined;
+        scheduleData?: undefined;
+        scheduleId?: undefined;
+        limit?: undefined;
+        offset?: undefined;
+        category?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        scheduleData: z.ZodObject<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            frequency: z.ZodEnum<["DAILY", "WEEKLY", "MONTHLY"]>;
+            timeOfDay: z.ZodOptional<z.ZodString>;
+            dayOfWeek: z.ZodOptional<z.ZodEnum<["MON", "TUE", "WED", "THU", "FRI", "SAT", "SUN"]>>;
+            dayOfMonth: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            frequency: z.ZodEnum<["DAILY", "WEEKLY", "MONTHLY"]>;
+            timeOfDay: z.ZodOptional<z.ZodString>;
+            dayOfWeek: z.ZodOptional<z.ZodEnum<["MON", "TUE", "WED", "THU", "FRI", "SAT", "SUN"]>>;
+            dayOfMonth: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            frequency: z.ZodEnum<["DAILY", "WEEKLY", "MONTHLY"]>;
+            timeOfDay: z.ZodOptional<z.ZodString>;
+            dayOfWeek: z.ZodOptional<z.ZodEnum<["MON", "TUE", "WED", "THU", "FRI", "SAT", "SUN"]>>;
+            dayOfMonth: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>;
+        reportData?: undefined;
+        reportType?: undefined;
+        reportVersion?: undefined;
+        requestId?: undefined;
+        scheduleId?: undefined;
+        limit?: undefined;
+        offset?: undefined;
+        category?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        reportType: z.ZodOptional<z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>>;
+        reportData?: undefined;
+        reportVersion?: undefined;
+        requestId?: undefined;
+        scheduleData?: undefined;
+        scheduleId?: undefined;
+        limit?: undefined;
+        offset?: undefined;
+        category?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        scheduleId: z.ZodString;
+        scheduleData: z.ZodObject<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            frequency: z.ZodEnum<["DAILY", "WEEKLY", "MONTHLY"]>;
+            timeOfDay: z.ZodOptional<z.ZodString>;
+            dayOfWeek: z.ZodOptional<z.ZodEnum<["MON", "TUE", "WED", "THU", "FRI", "SAT", "SUN"]>>;
+            dayOfMonth: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            frequency: z.ZodEnum<["DAILY", "WEEKLY", "MONTHLY"]>;
+            timeOfDay: z.ZodOptional<z.ZodString>;
+            dayOfWeek: z.ZodOptional<z.ZodEnum<["MON", "TUE", "WED", "THU", "FRI", "SAT", "SUN"]>>;
+            dayOfMonth: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            reportType: z.ZodEnum<["ITEM", "BUYBOX", "CANCELLATION", "DELIVERY_DEFECT", "CPA", "ITEM_PERFORMANCE", "RETURN_OVERRIDES", "PROMO", "INVENTORY", "SETTLEMENT", "PERFORMANCE", "ITEM_LISTING_AUDIT"]>;
+            reportVersion: z.ZodOptional<z.ZodString>;
+            frequency: z.ZodEnum<["DAILY", "WEEKLY", "MONTHLY"]>;
+            timeOfDay: z.ZodOptional<z.ZodString>;
+            dayOfWeek: z.ZodOptional<z.ZodEnum<["MON", "TUE", "WED", "THU", "FRI", "SAT", "SUN"]>>;
+            dayOfMonth: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>;
+        reportData?: undefined;
+        reportType?: undefined;
+        reportVersion?: undefined;
+        requestId?: undefined;
+        limit?: undefined;
+        offset?: undefined;
+        category?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        scheduleId: z.ZodString;
+        reportData?: undefined;
+        reportType?: undefined;
+        reportVersion?: undefined;
+        requestId?: undefined;
+        scheduleData?: undefined;
+        limit?: undefined;
+        offset?: undefined;
+        category?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        reportData?: undefined;
+        reportType?: undefined;
+        reportVersion?: undefined;
+        requestId?: undefined;
+        scheduleData?: undefined;
+        scheduleId?: undefined;
+        category?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        category: z.ZodOptional<z.ZodString>;
+        reportData?: undefined;
+        reportType?: undefined;
+        reportVersion?: undefined;
+        requestId?: undefined;
+        scheduleData?: undefined;
+        scheduleId?: undefined;
+        limit?: undefined;
+        offset?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        category: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        reportData?: undefined;
+        reportType?: undefined;
+        reportVersion?: undefined;
+        requestId?: undefined;
+        scheduleData?: undefined;
+        scheduleId?: undefined;
+    };
+})[];

package/build/tools/definitions/reports.js

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+import { Iso8601UtcSchema } from './shared-schemas.js';
+// Walmart on-demand report types.
+const ReportTypeSchema = z.enum([
+    'ITEM',
+    'BUYBOX',
+    'CANCELLATION',
+    'DELIVERY_DEFECT',
+    'CPA',
+    'ITEM_PERFORMANCE',
+    'RETURN_OVERRIDES',
+    'PROMO',
+    'INVENTORY',
+    'SETTLEMENT',
+    'PERFORMANCE',
+    'ITEM_LISTING_AUDIT',
+]);
+// Recurring schedule frequencies.
+const ScheduleFrequencySchema = z.enum(['DAILY', 'WEEKLY', 'MONTHLY']);
+// Create-report body. reportType required, rest passthrough so we don't
+// re-document every per-report-type filter set.
+const CreateReportBodySchema = z
+    .object({
+    reportType: ReportTypeSchema.describe('Walmart report type'),
+    reportVersion: z.string().optional().describe('Optional report version'),
+    startDate: Iso8601UtcSchema.optional().describe('Date-range start (ISO 8601)'),
+    endDate: Iso8601UtcSchema.optional().describe('Date-range end (ISO 8601)'),
+})
+    .passthrough()
+    .refine((r) => !(r.startDate && r.endDate) || new Date(r.endDate).getTime() >= new Date(r.startDate).getTime(), { message: 'endDate must be >= startDate', path: ['endDate'] });
+const CreateScheduleBodySchema = z
+    .object({
+    reportType: ReportTypeSchema,
+    reportVersion: z.string().optional(),
+    frequency: ScheduleFrequencySchema,
+    timeOfDay: z
+        .string()
+        .regex(/^([01][0-9]|2[0-3]):[0-5][0-9]$/, 'timeOfDay must be HH:MM (24-hour)')
+        .optional(),
+    dayOfWeek: z.enum(['MON', 'TUE', 'WED', 'THU', 'FRI', 'SAT', 'SUN']).optional(),
+    dayOfMonth: z.number().int().min(1).max(31).optional(),
+})
+    .passthrough();
+export const reportTools = [
+    // ===== Report Requests =====
+    {
+        name: 'walmart_create_report',
+        description: 'Request generation of a report. reportType is required; supported types: ITEM, BUYBOX, ' +
+            'CANCELLATION, DELIVERY_DEFECT, CPA, ITEM_PERFORMANCE, RETURN_OVERRIDES, PROMO, INVENTORY, ' +
+            'SETTLEMENT, PERFORMANCE, ITEM_LISTING_AUDIT. Optional startDate/endDate (ISO 8601). ' +
+            'Per-report-type extra filters pass through. Returns a requestId; poll walmart_get_report_status.',
+        inputSchema: {
+            reportData: CreateReportBodySchema,
+        },
+    },
+    {
+        name: 'walmart_get_report_requests',
+        description: 'List all report generation requests with optional filtering by type.',
+        inputSchema: {
+            reportType: ReportTypeSchema.optional().describe('Filter by report type'),
+            reportVersion: z.string().optional().describe('Filter by report version'),
+        },
+    },
+    {
+        name: 'walmart_get_report_status',
+        description: 'Check the status of a specific report request. Status: RECEIVED, INPROGRESS, READY, ERROR.',
+        inputSchema: {
+            requestId: z.string().describe('Report request ID'),
+        },
+    },
+    {
+        name: 'walmart_download_report',
+        description: 'Download a completed report. Report must be in READY status.',
+        inputSchema: {
+            requestId: z.string().optional().describe('Report request ID'),
+            reportType: ReportTypeSchema.optional().describe('Report type to download the latest for'),
+        },
+    },
+    // ===== Report Schedules =====
+    {
+        name: 'walmart_create_report_schedule',
+        description: 'Create a recurring report schedule. Required: reportType + frequency (DAILY/WEEKLY/MONTHLY). ' +
+            'Optional: timeOfDay (HH:MM 24h), dayOfWeek (MON-SUN), dayOfMonth (1-31). Walmart enforces ' +
+            'reportType + frequency combinations.',
+        inputSchema: {
+            scheduleData: CreateScheduleBodySchema,
+        },
+    },
+    {
+        name: 'walmart_get_report_schedules',
+        description: 'List all configured report schedules.',
+        inputSchema: {
+            reportType: ReportTypeSchema.optional().describe('Filter by report type'),
+        },
+    },
+    {
+        name: 'walmart_update_report_schedule',
+        description: 'Update an existing report schedule configuration.',
+        inputSchema: {
+            scheduleId: z.string().describe('Report schedule ID to update'),
+            scheduleData: CreateScheduleBodySchema,
+        },
+    },
+    {
+        name: 'walmart_delete_report_schedule',
+        description: 'Delete a recurring report schedule.',
+        inputSchema: {
+            scheduleId: z.string().describe('Report schedule ID to delete'),
+        },
+    },
+    // ===== Insights =====
+    {
+        name: 'walmart_get_unpublished_items',
+        description: 'Get items that are not published on Walmart.com with reasons. Helps fix listing issues.',
+        inputSchema: {
+            limit: z.number().int().min(1).max(200).optional().describe('Results per page'),
+            offset: z.number().int().min(0).optional().describe('Pagination offset'),
+        },
+    },
+    {
+        name: 'walmart_get_listing_quality',
+        description: 'Get overall listing quality score. Higher scores improve search visibility and Buy Box win rate.',
+        inputSchema: {
+            category: z.string().optional().describe('Filter by category'),
+        },
+    },
+    {
+        name: 'walmart_get_quality_categories',
+        description: 'Get listing quality issues grouped by category. Identifies which categories need improvement.',
+        inputSchema: {
+            limit: z.number().int().min(1).max(200).optional().describe('Results per page'),
+            offset: z.number().int().min(0).optional().describe('Pagination offset'),
+        },
+    },
+    {
+        name: 'walmart_get_item_quality_details',
+        description: 'Get item-level listing quality details. Shows specific quality issues per item for targeted fixes.',
+        inputSchema: {
+            category: z.string().optional().describe('Filter by category'),
+            limit: z.number().int().min(1).max(200).optional().describe('Results per page'),
+            offset: z.number().int().min(0).optional().describe('Pagination offset'),
+        },
+    },
+];