@rahul_vendure/ai-chat-plugin 0.1.8 → 0.2.0

package/dist/services/admin-ai-chat.service.js

@@ -18,6 +18,7 @@ const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
 const ai_1 = require("ai");
 const openai_1 = require("@ai-sdk/openai");
+const azure_1 = require("@ai-sdk/azure");
 const zod_1 = require("zod");
 const core_2 = require("@vendure/core");
 const constants_1 = require("../constants");
@@ -37,9 +38,12 @@ const admin_settings_tools_1 = require("./admin-tools/admin-settings-tools");
 const admin_staff_tools_1 = require("./admin-tools/admin-staff-tools");
 const admin_promotion_tools_1 = require("./admin-tools/admin-promotion-tools");
 const admin_country_tools_1 = require("./admin-tools/admin-country-tools");
+const admin_asset_tools_1 = require("./admin-tools/admin-asset-tools");
+const admin_customer_group_tools_1 = require("./admin-tools/admin-customer-group-tools");
+const admin_stock_location_tools_1 = require("./admin-tools/admin-stock-location-tools");
 const admin_system_prompt_1 = require("./admin-system-prompt");
 let AdminAiChatService = AdminAiChatService_1 = class AdminAiChatService {
-    constructor(options, connection, moduleRef, configService, embeddingService, productEmbeddingService, collectionEmbeddingService) {
+    constructor(options, connection, moduleRef, configService, embeddingService, productEmbeddingService, collectionEmbeddingService, productService, productVariantService, productOptionGroupService, productOptionService, taxCategoryService, customerService, collectionService, facetService, facetValueService, shippingMethodService, paymentMethodService, taxRateService, zoneService, countryService, administratorService, roleService, channelService, sellerService, globalSettingsService, promotionService, assetService, customerGroupService, stockLocationService) {
         this.options = options;
         this.connection = connection;
         this.moduleRef = moduleRef;
@@ -47,12 +51,43 @@ let AdminAiChatService = AdminAiChatService_1 = class AdminAiChatService {
         this.embeddingService = embeddingService;
         this.productEmbeddingService = productEmbeddingService;
         this.collectionEmbeddingService = collectionEmbeddingService;
+        this.productService = productService;
+        this.productVariantService = productVariantService;
+        this.productOptionGroupService = productOptionGroupService;
+        this.productOptionService = productOptionService;
+        this.taxCategoryService = taxCategoryService;
+        this.customerService = customerService;
+        this.collectionService = collectionService;
+        this.facetService = facetService;
+        this.facetValueService = facetValueService;
+        this.shippingMethodService = shippingMethodService;
+        this.paymentMethodService = paymentMethodService;
+        this.taxRateService = taxRateService;
+        this.zoneService = zoneService;
+        this.countryService = countryService;
+        this.administratorService = administratorService;
+        this.roleService = roleService;
+        this.channelService = channelService;
+        this.sellerService = sellerService;
+        this.globalSettingsService = globalSettingsService;
+        this.promotionService = promotionService;
+        this.assetService = assetService;
+        this.customerGroupService = customerGroupService;
+        this.stockLocationService = stockLocationService;
         this.logger = new common_1.Logger(AdminAiChatService_1.name);
+        this.azure = null;
+        this.azureDeploymentName = '';
         this.assetUrlPrefix = '';
         this.openai = (0, openai_1.createOpenAI)({ apiKey: options.openaiApiKey });
+        if (options.azureOpenai) {
+            this.azure = (0, azure_1.createAzure)({
+                apiKey: options.azureOpenai.apiKey,
+                resourceName: options.azureOpenai.resourceName,
+            });
+            this.azureDeploymentName = options.azureOpenai.deploymentName;
+        }
     }
     async onModuleInit() {
-        // Resolve FulltextSearchService
         try {
             // eslint-disable-next-line @typescript-eslint/no-require-imports
             const mod = require('@vendure/core/dist/plugin/default-search-plugin/fulltext-search.service');
@@ -62,11 +97,8 @@ let AdminAiChatService = AdminAiChatService_1 = class AdminAiChatService {
         catch {
             this.logger.warn('FulltextSearchService not available for admin chat');
         }
-        // Resolve asset URL prefix
         if (this.options.assetBaseUrl) {
-            this.assetUrlPrefix = this.options.assetBaseUrl.endsWith('/')
-                ? this.options.assetBaseUrl
-                : this.options.assetBaseUrl + '/';
+            this.assetUrlPrefix = this.options.assetBaseUrl.endsWith('/') ? this.options.assetBaseUrl : this.options.assetBaseUrl + '/';
         }
         else {
             try {
@@ -79,198 +111,211 @@ let AdminAiChatService = AdminAiChatService_1 = class AdminAiChatService {
                 this.assetUrlPrefix = '/assets/';
             }
         }
-        // Initialize helpers
         this.mapper = new chat_result_mapper_1.ChatResultMapper(this.connection, this.assetUrlPrefix);
-        this.productTools = new admin_product_tools_1.AdminProductTools(this.connection, this.mapper, this.fulltextSearchService, this.embeddingService, this.productEmbeddingService, this.collectionEmbeddingService);
+        this.productTools = new admin_product_tools_1.AdminProductTools(this.connection, this.mapper, this.fulltextSearchService, this.embeddingService, this.productEmbeddingService, this.collectionEmbeddingService, this.productService, this.productVariantService, this.productOptionGroupService, this.productOptionService, this.taxCategoryService);
         this.orderTools = new admin_order_tools_1.AdminOrderTools(this.connection, this.mapper);
-        this.customerTools = new admin_customer_tools_1.AdminCustomerTools(this.connection);
-        this.collectionTools = new admin_collection_tools_1.AdminCollectionTools(this.connection);
-        this.shippingTools = new admin_shipping_tools_1.AdminShippingTools(this.connection);
-        this.paymentTools = new admin_payment_tools_1.AdminPaymentTools(this.connection);
-        this.taxTools = new admin_tax_tools_1.AdminTaxTools(this.connection);
-        this.facetTools = new admin_facet_tools_1.AdminFacetTools(this.connection);
-        this.settingsTools = new admin_settings_tools_1.AdminSettingsTools(this.connection);
-        this.staffTools = new admin_staff_tools_1.AdminStaffTools(this.connection);
-        this.promotionTools = new admin_promotion_tools_1.AdminPromotionTools(this.connection);
-        this.countryTools = new admin_country_tools_1.AdminCountryTools(this.connection);
+        this.customerTools = new admin_customer_tools_1.AdminCustomerTools(this.connection, this.customerService);
+        this.collectionTools = new admin_collection_tools_1.AdminCollectionTools(this.connection, this.collectionService);
+        this.shippingTools = new admin_shipping_tools_1.AdminShippingTools(this.connection, this.shippingMethodService);
+        this.paymentTools = new admin_payment_tools_1.AdminPaymentTools(this.connection, this.paymentMethodService);
+        this.taxTools = new admin_tax_tools_1.AdminTaxTools(this.connection, this.taxCategoryService, this.taxRateService, this.zoneService);
+        this.facetTools = new admin_facet_tools_1.AdminFacetTools(this.connection, this.facetService, this.facetValueService);
+        this.settingsTools = new admin_settings_tools_1.AdminSettingsTools(this.connection, this.globalSettingsService, this.channelService, this.sellerService);
+        this.staffTools = new admin_staff_tools_1.AdminStaffTools(this.connection, this.administratorService, this.roleService);
+        this.promotionTools = new admin_promotion_tools_1.AdminPromotionTools(this.connection, this.promotionService);
+        this.countryTools = new admin_country_tools_1.AdminCountryTools(this.connection, this.countryService);
+        this.assetTools = new admin_asset_tools_1.AdminAssetTools(this.connection, this.assetService);
+        this.customerGroupTools = new admin_customer_group_tools_1.AdminCustomerGroupTools(this.connection, this.customerGroupService);
+        this.stockLocationTools = new admin_stock_location_tools_1.AdminStockLocationTools(this.connection, this.stockLocationService);
     }
     buildTools(ctx) {
         return {
-            searchProducts: (0, ai_1.tool)({
-                description: 'Search products by keyword. Returns product cards with images, prices, stock levels, and admin details.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().describe('Search term or product name'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 10, max 25)'),
-                    includeDisabled: zod_1.z.boolean().optional().describe('Include disabled products (default false)'),
-                }),
-                execute: async (args) => this.productTools.searchProducts(ctx, args),
-            }),
-            vectorSearch: (0, ai_1.tool)({
-                description: 'Semantic/intent-based product search. Use for vague queries like "products for developers", "gaming accessories", "gifts for photographers". Falls back to this when keyword search returns no results.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().describe('The semantic search query'),
-                }),
-                execute: async (args) => this.productTools.vectorSearch(ctx, args),
-            }),
-            getProductDetails: (0, ai_1.tool)({
-                description: 'Get full details for a specific product including all variants with stock levels, prices, and SKUs.',
-                inputSchema: zod_1.z.object({
-                    productId: zod_1.z.string().optional().describe('Product ID'),
-                    slug: zod_1.z.string().optional().describe('Product slug'),
-                }),
-                execute: async (args) => this.productTools.getProductDetails(ctx, args),
-            }),
-            searchOrders: (0, ai_1.tool)({
-                description: 'Search orders across the store. Can filter by order code, customer name/email, or order state.',
-                inputSchema: zod_1.z.object({
-                    orderCode: zod_1.z.string().optional().describe('Order code to search for (partial match)'),
-                    customerName: zod_1.z.string().optional().describe('Customer name or email to filter by'),
-                    state: zod_1.z.string().optional().describe('Order state filter (e.g. PaymentSettled, Shipped, Delivered)'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 10, max 25)'),
-                }),
-                execute: async (args) => this.orderTools.searchOrders(ctx, args),
-            }),
-            searchCustomers: (0, ai_1.tool)({
-                description: 'Search customers by name or email. Returns customer details including order count and total spent.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().describe('Customer name or email to search for'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 10, max 25)'),
-                }),
-                execute: async (args) => this.customerTools.searchCustomers(ctx, args),
-            }),
-            getCollections: (0, ai_1.tool)({
-                description: 'List or search product collections/categories with product counts.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter collections'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 20, max 50)'),
-                }),
-                execute: async (args) => this.collectionTools.getCollections(ctx, args),
-            }),
-            getShippingMethods: (0, ai_1.tool)({
-                description: 'List all shipping methods configured in the store. Shows code, fulfillment handler, and channel assignments.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by name or code'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 20, max 50)'),
-                    includeDeleted: zod_1.z.boolean().optional().describe('Include soft-deleted shipping methods (default false)'),
-                }),
-                execute: async (args) => this.shippingTools.getShippingMethods(ctx, args),
-            }),
-            getPaymentMethods: (0, ai_1.tool)({
-                description: 'List all payment methods configured in the store. Shows handler, enabled status, and channel assignments.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by name or code'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 20, max 50)'),
-                }),
-                execute: async (args) => this.paymentTools.getPaymentMethods(ctx, args),
-            }),
-            getTaxRates: (0, ai_1.tool)({
-                description: 'List tax rates with their categories and zones. Shows rate percentage, enabled status, and associated zone/category.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by name, category, or zone'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 30, max 100)'),
-                }),
-                execute: async (args) => this.taxTools.getTaxRates(ctx, args),
-            }),
-            getTaxCategories: (0, ai_1.tool)({
-                description: 'List tax categories (e.g. Standard, Reduced, Zero-rated).',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by name'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 30, max 50)'),
-                }),
-                execute: async (args) => this.taxTools.getTaxCategories(ctx, args),
-            }),
-            getZones: (0, ai_1.tool)({
-                description: 'List tax/shipping zones with their member countries/regions.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by zone name'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 30, max 50)'),
-                }),
-                execute: async (args) => this.taxTools.getZones(ctx, args),
-            }),
-            getFacets: (0, ai_1.tool)({
-                description: 'List product facets (attributes like Color, Size, Brand) with their values. Useful for understanding product categorization.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by facet name or code'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 20, max 50)'),
-                }),
-                execute: async (args) => this.facetTools.getFacets(ctx, args),
-            }),
-            getFacetValues: (0, ai_1.tool)({
-                description: 'List facet values, optionally filtered by facet ID. E.g. for a "Color" facet: Red, Blue, Green.',
-                inputSchema: zod_1.z.object({
-                    facetId: zod_1.z.string().optional().describe('Filter values to a specific facet by ID'),
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by value name or code'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 30, max 100)'),
-                }),
-                execute: async (args) => this.facetTools.getFacetValues(ctx, args),
-            }),
-            getGlobalSettings: (0, ai_1.tool)({
-                description: 'Get global store settings including inventory tracking, out-of-stock threshold, and available languages.',
-                inputSchema: zod_1.z.object({}),
-                execute: async () => this.settingsTools.getGlobalSettings(ctx),
-            }),
-            getChannels: (0, ai_1.tool)({
-                description: 'List all sales channels with their currency, language, tax zone, shipping zone, and seller configuration.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by channel code or description'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 20, max 50)'),
-                }),
-                execute: async (args) => this.settingsTools.getChannels(ctx, args),
-            }),
-            getSellers: (0, ai_1.tool)({
-                description: 'List sellers (marketplace vendors) in the store.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by seller name'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 20, max 50)'),
-                }),
-                execute: async (args) => this.settingsTools.getSellers(ctx, args),
-            }),
-            getAdministrators: (0, ai_1.tool)({
-                description: 'List admin users with their roles and email addresses.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by name or email'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 20, max 50)'),
-                }),
-                execute: async (args) => this.staffTools.getAdministrators(ctx, args),
-            }),
-            getRoles: (0, ai_1.tool)({
-                description: 'List admin roles with their permissions and channel assignments.',
+            // ── Products (read) ──
+            searchProducts: (0, ai_1.tool)({ description: 'Search products by keyword, or list all products if no query given. Returns product cards.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional().describe('Search term. Omit to list all products.'), take: zod_1.z.number().optional(), includeDisabled: zod_1.z.boolean().optional() }), execute: async (a) => this.productTools.searchProducts(ctx, a) }),
+            vectorSearch: (0, ai_1.tool)({ description: 'Semantic product search for vague queries like "gifts for dad".', inputSchema: zod_1.z.object({ query: zod_1.z.string() }), execute: async (a) => this.productTools.vectorSearch(ctx, a) }),
+            getProductDetails: (0, ai_1.tool)({ description: 'Get full product details by ID or slug including all variants.', inputSchema: zod_1.z.object({ productId: zod_1.z.string().optional(), slug: zod_1.z.string().optional() }), execute: async (a) => this.productTools.getProductDetails(ctx, a) }),
+            // ── Products (write) ──
+            createProduct: (0, ai_1.tool)({ description: 'Create a simple product without variants. Use createProductWithVariants for full creation.', inputSchema: zod_1.z.object({ name: zod_1.z.string(), slug: zod_1.z.string().optional(), description: zod_1.z.string().optional(), enabled: zod_1.z.boolean().optional() }), execute: async (a) => this.productTools.createProduct(ctx, a) }),
+            updateProduct: (0, ai_1.tool)({ description: 'Update a product name, slug, description, or enabled status.', inputSchema: zod_1.z.object({ productId: zod_1.z.string(), name: zod_1.z.string().optional(), slug: zod_1.z.string().optional(), description: zod_1.z.string().optional(), enabled: zod_1.z.boolean().optional() }), execute: async (a) => this.productTools.updateProduct(ctx, a) }),
+            deleteProduct: (0, ai_1.tool)({ description: 'Soft-delete a product by ID.', inputSchema: zod_1.z.object({ productId: zod_1.z.string() }), execute: async (a) => this.productTools.deleteProduct(ctx, a) }),
+            createProductWithVariants: (0, ai_1.tool)({ description: 'Create a complete product with option groups and variants. Each variant needs unique option values. Prices in cents.', inputSchema: zod_1.z.object({ name: zod_1.z.string(), slug: zod_1.z.string().optional(), description: zod_1.z.string().optional(), enabled: zod_1.z.boolean().optional(), optionGroups: zod_1.z.array(zod_1.z.object({ name: zod_1.z.string(), values: zod_1.z.array(zod_1.z.string()) })).optional().describe('Option groups like Color, Size'), variants: zod_1.z.array(zod_1.z.object({ name: zod_1.z.string(), sku: zod_1.z.string(), price: zod_1.z.number().describe('Price in cents'), stockOnHand: zod_1.z.number().optional(), optionValues: zod_1.z.array(zod_1.z.string()).optional().describe('Option values matching the option groups') })) }), execute: async (a) => this.productTools.createProductWithVariants(ctx, a) }),
+            updateProductVariant: (0, ai_1.tool)({ description: 'Update a variant price (cents), SKU, stock, or enabled status.', inputSchema: zod_1.z.object({ variantId: zod_1.z.string(), price: zod_1.z.number().optional(), sku: zod_1.z.string().optional(), stockOnHand: zod_1.z.number().optional(), enabled: zod_1.z.boolean().optional() }), execute: async (a) => this.productTools.updateProductVariant(ctx, a) }),
+            deleteProductVariant: (0, ai_1.tool)({ description: 'Soft-delete a product variant.', inputSchema: zod_1.z.object({ variantId: zod_1.z.string() }), execute: async (a) => this.productTools.deleteProductVariant(ctx, a) }),
+            // ── Orders (read) ──
+            searchOrders: (0, ai_1.tool)({ description: 'Search orders by code, customer name/email, or state.', inputSchema: zod_1.z.object({ orderCode: zod_1.z.string().optional(), customerName: zod_1.z.string().optional(), state: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.orderTools.searchOrders(ctx, a) }),
+            getOrderDetails: (0, ai_1.tool)({ description: 'Get full order details including lines, payments, fulfillments, addresses.', inputSchema: zod_1.z.object({ orderId: zod_1.z.string().optional(), orderCode: zod_1.z.string().optional() }), execute: async (a) => this.orderTools.getOrderDetails(ctx, a) }),
+            // ── Customers (read) ──
+            searchCustomers: (0, ai_1.tool)({ description: 'Search customers by name or email, or list all customers if no query given.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional().describe('Search term. Omit to list all customers.'), take: zod_1.z.number().optional() }), execute: async (a) => this.customerTools.searchCustomers(ctx, a) }),
+            getCustomerDetails: (0, ai_1.tool)({ description: 'Get full customer details: addresses, orders, groups.', inputSchema: zod_1.z.object({ customerId: zod_1.z.string() }), execute: async (a) => this.customerTools.getCustomerDetails(ctx, a) }),
+            // ── Customers (write) ──
+            createCustomer: (0, ai_1.tool)({ description: 'Create a new customer.', inputSchema: zod_1.z.object({ firstName: zod_1.z.string(), lastName: zod_1.z.string(), emailAddress: zod_1.z.string(), phoneNumber: zod_1.z.string().optional(), title: zod_1.z.string().optional() }), execute: async (a) => this.customerTools.createCustomer(ctx, a) }),
+            updateCustomer: (0, ai_1.tool)({ description: 'Update customer details.', inputSchema: zod_1.z.object({ customerId: zod_1.z.string(), firstName: zod_1.z.string().optional(), lastName: zod_1.z.string().optional(), emailAddress: zod_1.z.string().optional(), phoneNumber: zod_1.z.string().optional() }), execute: async (a) => this.customerTools.updateCustomer(ctx, a) }),
+            deleteCustomer: (0, ai_1.tool)({ description: 'Soft-delete a customer.', inputSchema: zod_1.z.object({ customerId: zod_1.z.string() }), execute: async (a) => this.customerTools.deleteCustomer(ctx, a) }),
+            createCustomerAddress: (0, ai_1.tool)({ description: 'Create an address for a customer.', inputSchema: zod_1.z.object({ customerId: zod_1.z.string(), fullName: zod_1.z.string(), streetLine1: zod_1.z.string(), streetLine2: zod_1.z.string().optional(), city: zod_1.z.string(), province: zod_1.z.string(), postalCode: zod_1.z.string(), countryCode: zod_1.z.string(), phoneNumber: zod_1.z.string().optional(), company: zod_1.z.string().optional(), defaultShippingAddress: zod_1.z.boolean().optional(), defaultBillingAddress: zod_1.z.boolean().optional() }), execute: async (a) => this.customerTools.createCustomerAddress(ctx, a) }),
+            addNoteToCustomer: (0, ai_1.tool)({ description: 'Add a note to customer history.', inputSchema: zod_1.z.object({ customerId: zod_1.z.string(), note: zod_1.z.string(), isPublic: zod_1.z.boolean().optional() }), execute: async (a) => this.customerTools.addNoteToCustomer(ctx, a) }),
+            // ── Collections (read + write) ──
+            getCollections: (0, ai_1.tool)({ description: 'List or search collections.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.collectionTools.getCollections(ctx, a) }),
+            createCollection: (0, ai_1.tool)({ description: 'Create a new collection. Filters define which products are included (e.g. facet-value-filter).', inputSchema: zod_1.z.object({ name: zod_1.z.string(), slug: zod_1.z.string().optional(), description: zod_1.z.string().optional(), parentId: zod_1.z.string().optional(), isPrivate: zod_1.z.boolean().optional(), filters: zod_1.z.array(zod_1.z.object({ code: zod_1.z.string(), args: zod_1.z.record(zod_1.z.string(), zod_1.z.string()) })).optional() }), execute: async (a) => this.collectionTools.createCollection(ctx, a) }),
+            updateCollection: (0, ai_1.tool)({ description: 'Update a collection.', inputSchema: zod_1.z.object({ collectionId: zod_1.z.string(), name: zod_1.z.string().optional(), slug: zod_1.z.string().optional(), description: zod_1.z.string().optional(), isPrivate: zod_1.z.boolean().optional() }), execute: async (a) => this.collectionTools.updateCollection(ctx, a) }),
+            deleteCollection: (0, ai_1.tool)({ description: 'Delete a collection and its descendants.', inputSchema: zod_1.z.object({ collectionId: zod_1.z.string() }), execute: async (a) => this.collectionTools.deleteCollection(ctx, a) }),
+            moveCollection: (0, ai_1.tool)({ description: 'Move a collection to a different parent.', inputSchema: zod_1.z.object({ collectionId: zod_1.z.string(), parentId: zod_1.z.string(), index: zod_1.z.number() }), execute: async (a) => this.collectionTools.moveCollection(ctx, a) }),
+            // ── Facets (read + write) ──
+            getFacets: (0, ai_1.tool)({ description: 'List facets with values.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.facetTools.getFacets(ctx, a) }),
+            getFacetValues: (0, ai_1.tool)({ description: 'List facet values, optionally by facet ID.', inputSchema: zod_1.z.object({ facetId: zod_1.z.string().optional(), query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.facetTools.getFacetValues(ctx, a) }),
+            createFacet: (0, ai_1.tool)({ description: 'Create a new facet with optional initial values.', inputSchema: zod_1.z.object({ name: zod_1.z.string(), code: zod_1.z.string(), isPrivate: zod_1.z.boolean().optional(), values: zod_1.z.array(zod_1.z.object({ name: zod_1.z.string(), code: zod_1.z.string() })).optional() }), execute: async (a) => this.facetTools.createFacet(ctx, a) }),
+            updateFacet: (0, ai_1.tool)({ description: 'Update a facet name, code, or privacy.', inputSchema: zod_1.z.object({ facetId: zod_1.z.string(), name: zod_1.z.string().optional(), code: zod_1.z.string().optional(), isPrivate: zod_1.z.boolean().optional() }), execute: async (a) => this.facetTools.updateFacet(ctx, a) }),
+            deleteFacet: (0, ai_1.tool)({ description: 'Delete a facet. Use force=true to delete even if in use.', inputSchema: zod_1.z.object({ facetId: zod_1.z.string(), force: zod_1.z.boolean().optional() }), execute: async (a) => this.facetTools.deleteFacet(ctx, a) }),
+            createFacetValues: (0, ai_1.tool)({ description: 'Add values to an existing facet.', inputSchema: zod_1.z.object({ facetId: zod_1.z.string(), values: zod_1.z.array(zod_1.z.object({ name: zod_1.z.string(), code: zod_1.z.string() })) }), execute: async (a) => this.facetTools.createFacetValues(ctx, a) }),
+            updateFacetValue: (0, ai_1.tool)({ description: 'Update a facet value name or code.', inputSchema: zod_1.z.object({ facetValueId: zod_1.z.string(), name: zod_1.z.string().optional(), code: zod_1.z.string().optional() }), execute: async (a) => this.facetTools.updateFacetValue(ctx, a) }),
+            deleteFacetValues: (0, ai_1.tool)({ description: 'Delete facet values by IDs.', inputSchema: zod_1.z.object({ facetValueIds: zod_1.z.array(zod_1.z.string()), force: zod_1.z.boolean().optional() }), execute: async (a) => this.facetTools.deleteFacetValues(ctx, a) }),
+            // ── Shipping Methods ──
+            getShippingMethods: (0, ai_1.tool)({ description: 'List shipping methods.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional(), includeDeleted: zod_1.z.boolean().optional() }), execute: async (a) => this.shippingTools.getShippingMethods(ctx, a) }),
+            createShippingMethod: (0, ai_1.tool)({ description: 'Create a shipping method.', inputSchema: zod_1.z.object({ name: zod_1.z.string(), code: zod_1.z.string(), description: zod_1.z.string().optional(), fulfillmentHandler: zod_1.z.string().describe('e.g. manual-fulfillment') }), execute: async (a) => this.shippingTools.createShippingMethod(ctx, a) }),
+            updateShippingMethod: (0, ai_1.tool)({ description: 'Update a shipping method.', inputSchema: zod_1.z.object({ shippingMethodId: zod_1.z.string(), name: zod_1.z.string().optional(), code: zod_1.z.string().optional(), description: zod_1.z.string().optional() }), execute: async (a) => this.shippingTools.updateShippingMethod(ctx, a) }),
+            deleteShippingMethod: (0, ai_1.tool)({ description: 'Soft-delete a shipping method.', inputSchema: zod_1.z.object({ shippingMethodId: zod_1.z.string() }), execute: async (a) => this.shippingTools.deleteShippingMethod(ctx, a) }),
+            // ── Payment Methods ──
+            getPaymentMethods: (0, ai_1.tool)({ description: 'List payment methods.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.paymentTools.getPaymentMethods(ctx, a) }),
+            createPaymentMethod: (0, ai_1.tool)({ description: 'Create a payment method.', inputSchema: zod_1.z.object({ name: zod_1.z.string(), code: zod_1.z.string(), description: zod_1.z.string().optional(), enabled: zod_1.z.boolean().optional(), handlerCode: zod_1.z.string().describe('e.g. dummy-payment-handler') }), execute: async (a) => this.paymentTools.createPaymentMethod(ctx, a) }),
+            updatePaymentMethod: (0, ai_1.tool)({ description: 'Update a payment method.', inputSchema: zod_1.z.object({ paymentMethodId: zod_1.z.string(), name: zod_1.z.string().optional(), code: zod_1.z.string().optional(), description: zod_1.z.string().optional(), enabled: zod_1.z.boolean().optional() }), execute: async (a) => this.paymentTools.updatePaymentMethod(ctx, a) }),
+            deletePaymentMethod: (0, ai_1.tool)({ description: 'Delete a payment method.', inputSchema: zod_1.z.object({ paymentMethodId: zod_1.z.string(), force: zod_1.z.boolean().optional() }), execute: async (a) => this.paymentTools.deletePaymentMethod(ctx, a) }),
+            // ── Tax ──
+            getTaxRates: (0, ai_1.tool)({ description: 'List tax rates.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.taxTools.getTaxRates(ctx, a) }),
+            getTaxCategories: (0, ai_1.tool)({ description: 'List tax categories.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.taxTools.getTaxCategories(ctx, a) }),
+            getZones: (0, ai_1.tool)({ description: 'List zones with member countries.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.taxTools.getZones(ctx, a) }),
+            createTaxCategory: (0, ai_1.tool)({ description: 'Create a tax category.', inputSchema: zod_1.z.object({ name: zod_1.z.string(), isDefault: zod_1.z.boolean().optional() }), execute: async (a) => this.taxTools.createTaxCategory(ctx, a) }),
+            updateTaxCategory: (0, ai_1.tool)({ description: 'Update a tax category.', inputSchema: zod_1.z.object({ taxCategoryId: zod_1.z.string(), name: zod_1.z.string().optional(), isDefault: zod_1.z.boolean().optional() }), execute: async (a) => this.taxTools.updateTaxCategory(ctx, a) }),
+            deleteTaxCategory: (0, ai_1.tool)({ description: 'Delete a tax category.', inputSchema: zod_1.z.object({ taxCategoryId: zod_1.z.string() }), execute: async (a) => this.taxTools.deleteTaxCategory(ctx, a) }),
+            createTaxRate: (0, ai_1.tool)({ description: 'Create a tax rate. Value is percentage (e.g. 20 for 20%).', inputSchema: zod_1.z.object({ name: zod_1.z.string(), value: zod_1.z.number(), enabled: zod_1.z.boolean().optional(), categoryId: zod_1.z.string(), zoneId: zod_1.z.string(), customerGroupId: zod_1.z.string().optional() }), execute: async (a) => this.taxTools.createTaxRate(ctx, a) }),
+            updateTaxRate: (0, ai_1.tool)({ description: 'Update a tax rate.', inputSchema: zod_1.z.object({ taxRateId: zod_1.z.string(), name: zod_1.z.string().optional(), value: zod_1.z.number().optional(), enabled: zod_1.z.boolean().optional() }), execute: async (a) => this.taxTools.updateTaxRate(ctx, a) }),
+            deleteTaxRate: (0, ai_1.tool)({ description: 'Delete a tax rate.', inputSchema: zod_1.z.object({ taxRateId: zod_1.z.string() }), execute: async (a) => this.taxTools.deleteTaxRate(ctx, a) }),
+            createZone: (0, ai_1.tool)({ description: 'Create a zone with optional country member IDs.', inputSchema: zod_1.z.object({ name: zod_1.z.string(), memberIds: zod_1.z.array(zod_1.z.string()).optional() }), execute: async (a) => this.taxTools.createZone(ctx, a) }),
+            updateZone: (0, ai_1.tool)({ description: 'Update a zone name.', inputSchema: zod_1.z.object({ zoneId: zod_1.z.string(), name: zod_1.z.string().optional() }), execute: async (a) => this.taxTools.updateZone(ctx, a) }),
+            deleteZone: (0, ai_1.tool)({ description: 'Delete a zone.', inputSchema: zod_1.z.object({ zoneId: zod_1.z.string() }), execute: async (a) => this.taxTools.deleteZone(ctx, a) }),
+            addMembersToZone: (0, ai_1.tool)({ description: 'Add countries to a zone.', inputSchema: zod_1.z.object({ zoneId: zod_1.z.string(), memberIds: zod_1.z.array(zod_1.z.string()) }), execute: async (a) => this.taxTools.addMembersToZone(ctx, a) }),
+            removeMembersFromZone: (0, ai_1.tool)({ description: 'Remove countries from a zone.', inputSchema: zod_1.z.object({ zoneId: zod_1.z.string(), memberIds: zod_1.z.array(zod_1.z.string()) }), execute: async (a) => this.taxTools.removeMembersFromZone(ctx, a) }),
+            // ── Countries ──
+            getCountries: (0, ai_1.tool)({ description: 'List countries.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), enabledOnly: zod_1.z.boolean().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.countryTools.getCountries(ctx, a) }),
+            createCountry: (0, ai_1.tool)({ description: 'Create a country with ISO code.', inputSchema: zod_1.z.object({ code: zod_1.z.string().describe('ISO 2-letter code'), name: zod_1.z.string(), enabled: zod_1.z.boolean().optional() }), execute: async (a) => this.countryTools.createCountry(ctx, a) }),
+            updateCountry: (0, ai_1.tool)({ description: 'Update a country.', inputSchema: zod_1.z.object({ countryId: zod_1.z.string(), name: zod_1.z.string().optional(), code: zod_1.z.string().optional(), enabled: zod_1.z.boolean().optional() }), execute: async (a) => this.countryTools.updateCountry(ctx, a) }),
+            deleteCountry: (0, ai_1.tool)({ description: 'Delete a country.', inputSchema: zod_1.z.object({ countryId: zod_1.z.string() }), execute: async (a) => this.countryTools.deleteCountry(ctx, a) }),
+            // ── Administrators & Roles ──
+            getAdministrators: (0, ai_1.tool)({ description: 'List admin users.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.staffTools.getAdministrators(ctx, a) }),
+            getRoles: (0, ai_1.tool)({ description: 'List admin roles with permissions.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.staffTools.getRoles(ctx, a) }),
+            createAdministrator: (0, ai_1.tool)({ description: 'Create a new admin user.', inputSchema: zod_1.z.object({ firstName: zod_1.z.string(), lastName: zod_1.z.string(), emailAddress: zod_1.z.string(), password: zod_1.z.string(), roleIds: zod_1.z.array(zod_1.z.string()) }), execute: async (a) => this.staffTools.createAdministrator(ctx, a) }),
+            updateAdministrator: (0, ai_1.tool)({ description: 'Update an admin user.', inputSchema: zod_1.z.object({ administratorId: zod_1.z.string(), firstName: zod_1.z.string().optional(), lastName: zod_1.z.string().optional(), emailAddress: zod_1.z.string().optional(), password: zod_1.z.string().optional(), roleIds: zod_1.z.array(zod_1.z.string()).optional() }), execute: async (a) => this.staffTools.updateAdministrator(ctx, a) }),
+            deleteAdministrator: (0, ai_1.tool)({ description: 'Soft-delete an admin user.', inputSchema: zod_1.z.object({ administratorId: zod_1.z.string() }), execute: async (a) => this.staffTools.deleteAdministrator(ctx, a) }),
+            createRole: (0, ai_1.tool)({ description: 'Create a role with permissions. Valid permissions follow the pattern: Read/Create/Update/Delete + Entity (e.g. ReadProduct, CreateOrder, UpdateCustomer, DeleteCollection). Also: SuperAdmin, Authenticated, Owner, Public. Full list includes: ReadProduct, CreateProduct, UpdateProduct, DeleteProduct, ReadOrder, CreateOrder, UpdateOrder, DeleteOrder, ReadCustomer, CreateCustomer, UpdateCustomer, DeleteCustomer, ReadCatalog, CreateCatalog, UpdateCatalog, DeleteCatalog, ReadCollection, CreateCollection, etc.', inputSchema: zod_1.z.object({ code: zod_1.z.string(), description: zod_1.z.string(), permissions: zod_1.z.array(zod_1.z.string()).describe('e.g. ["ReadProduct","CreateProduct","ReadOrder","UpdateOrder"]'), channelIds: zod_1.z.array(zod_1.z.string()).optional() }), execute: async (a) => this.staffTools.createRole(ctx, a) }),
+            updateRole: (0, ai_1.tool)({ description: 'Update a role.', inputSchema: zod_1.z.object({ roleId: zod_1.z.string(), code: zod_1.z.string().optional(), description: zod_1.z.string().optional(), permissions: zod_1.z.array(zod_1.z.string()).optional() }), execute: async (a) => this.staffTools.updateRole(ctx, a) }),
+            deleteRole: (0, ai_1.tool)({ description: 'Delete a role.', inputSchema: zod_1.z.object({ roleId: zod_1.z.string() }), execute: async (a) => this.staffTools.deleteRole(ctx, a) }),
+            // ── Settings, Channels, Sellers ──
+            getStoreOverview: (0, ai_1.tool)({ description: 'Get a quick overview of the store: total counts for products, variants, orders, customers, collections, shipping methods, payment methods, tax rates, promotions, facets, and administrators. Use this when the user asks for a store summary or "how many products/customers/orders do we have".', inputSchema: zod_1.z.object({}), execute: async () => this.settingsTools.getStoreOverview(ctx) }),
+            getGlobalSettings: (0, ai_1.tool)({ description: 'Get global store settings.', inputSchema: zod_1.z.object({}), execute: async () => this.settingsTools.getGlobalSettings(ctx) }),
+            updateGlobalSettings: (0, ai_1.tool)({ description: 'Update global settings like inventory tracking.', inputSchema: zod_1.z.object({ trackInventory: zod_1.z.boolean().optional(), outOfStockThreshold: zod_1.z.number().optional(), availableLanguages: zod_1.z.array(zod_1.z.string()).optional() }), execute: async (a) => this.settingsTools.updateGlobalSettings(ctx, a) }),
+            getChannels: (0, ai_1.tool)({ description: 'List sales channels.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.settingsTools.getChannels(ctx, a) }),
+            createChannel: (0, ai_1.tool)({ description: 'Create a sales channel.', inputSchema: zod_1.z.object({ code: zod_1.z.string(), token: zod_1.z.string(), defaultLanguageCode: zod_1.z.string(), defaultCurrencyCode: zod_1.z.string(), pricesIncludeTax: zod_1.z.boolean() }), execute: async (a) => this.settingsTools.createChannel(ctx, a) }),
+            updateChannel: (0, ai_1.tool)({ description: 'Update a channel.', inputSchema: zod_1.z.object({ channelId: zod_1.z.string(), code: zod_1.z.string().optional(), defaultLanguageCode: zod_1.z.string().optional(), defaultCurrencyCode: zod_1.z.string().optional(), pricesIncludeTax: zod_1.z.boolean().optional() }), execute: async (a) => this.settingsTools.updateChannel(ctx, a) }),
+            deleteChannel: (0, ai_1.tool)({ description: 'Delete a channel.', inputSchema: zod_1.z.object({ channelId: zod_1.z.string() }), execute: async (a) => this.settingsTools.deleteChannel(ctx, a) }),
+            getSellers: (0, ai_1.tool)({ description: 'List sellers.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.settingsTools.getSellers(ctx, a) }),
+            createSeller: (0, ai_1.tool)({ description: 'Create a seller.', inputSchema: zod_1.z.object({ name: zod_1.z.string() }), execute: async (a) => this.settingsTools.createSeller(ctx, a) }),
+            updateSeller: (0, ai_1.tool)({ description: 'Update a seller.', inputSchema: zod_1.z.object({ sellerId: zod_1.z.string(), name: zod_1.z.string().optional() }), execute: async (a) => this.settingsTools.updateSeller(ctx, a) }),
+            deleteSeller: (0, ai_1.tool)({ description: 'Delete a seller.', inputSchema: zod_1.z.object({ sellerId: zod_1.z.string() }), execute: async (a) => this.settingsTools.deleteSeller(ctx, a) }),
+            // ── Promotions ──
+            getPromotions: (0, ai_1.tool)({ description: 'List promotions/discounts.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), activeOnly: zod_1.z.boolean().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.promotionTools.getPromotions(ctx, a) }),
+            getPromotionConditionsAndActions: (0, ai_1.tool)({ description: 'List all available promotion condition and action codes with their argument formats. ALWAYS call this before creating a promotion to get the correct codes and argument formats.', inputSchema: zod_1.z.object({}), execute: async () => this.promotionTools.getPromotionConditionsAndActions(ctx) }),
+            createPromotion: (0, ai_1.tool)({ description: 'Create a promotion. IMPORTANT: Call getPromotionConditionsAndActions first to get valid codes. Conditions: minimum_order_amount, customer_group, contains_products, at_least_n_with_facets, buy_x_get_y_free. Actions: order_percentage_discount, order_fixed_discount, products_percentage_discount, free_shipping, buy_x_get_y_free. All arg values must be strings.', inputSchema: zod_1.z.object({ name: zod_1.z.string(), enabled: zod_1.z.boolean().optional(), couponCode: zod_1.z.string().optional(), startsAt: zod_1.z.string().optional(), endsAt: zod_1.z.string().optional(), perCustomerUsageLimit: zod_1.z.number().optional(), usageLimit: zod_1.z.number().optional(), conditions: zod_1.z.array(zod_1.z.object({ code: zod_1.z.string(), args: zod_1.z.record(zod_1.z.string(), zod_1.z.string()) })).optional(), actions: zod_1.z.array(zod_1.z.object({ code: zod_1.z.string(), args: zod_1.z.record(zod_1.z.string(), zod_1.z.string()) })).optional() }), execute: async (a) => this.promotionTools.createPromotion(ctx, a) }),
+            updatePromotion: (0, ai_1.tool)({ description: 'Update a promotion.', inputSchema: zod_1.z.object({ promotionId: zod_1.z.string(), name: zod_1.z.string().optional(), enabled: zod_1.z.boolean().optional(), couponCode: zod_1.z.string().optional() }), execute: async (a) => this.promotionTools.updatePromotion(ctx, a) }),
+            deletePromotion: (0, ai_1.tool)({ description: 'Soft-delete a promotion.', inputSchema: zod_1.z.object({ promotionId: zod_1.z.string() }), execute: async (a) => this.promotionTools.deletePromotion(ctx, a) }),
+            // ── Assets ──
+            getAssets: (0, ai_1.tool)({ description: 'List assets (images, files). Filter by name or tags.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), tags: zod_1.z.array(zod_1.z.string()).optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.assetTools.getAssets(ctx, a) }),
+            deleteAsset: (0, ai_1.tool)({ description: 'Delete an asset. Use force=true to delete even if assigned.', inputSchema: zod_1.z.object({ assetId: zod_1.z.string(), force: zod_1.z.boolean().optional() }), execute: async (a) => this.assetTools.deleteAsset(ctx, a) }),
+            // ── Customer Groups ──
+            getCustomerGroups: (0, ai_1.tool)({ description: 'List customer groups with member counts.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.customerGroupTools.getCustomerGroups(ctx, a) }),
+            createCustomerGroup: (0, ai_1.tool)({ description: 'Create a customer group.', inputSchema: zod_1.z.object({ name: zod_1.z.string(), customerIds: zod_1.z.array(zod_1.z.string()).optional() }), execute: async (a) => this.customerGroupTools.createCustomerGroup(ctx, a) }),
+            updateCustomerGroup: (0, ai_1.tool)({ description: 'Rename a customer group.', inputSchema: zod_1.z.object({ customerGroupId: zod_1.z.string(), name: zod_1.z.string().optional() }), execute: async (a) => this.customerGroupTools.updateCustomerGroup(ctx, a) }),
+            deleteCustomerGroup: (0, ai_1.tool)({ description: 'Delete a customer group.', inputSchema: zod_1.z.object({ customerGroupId: zod_1.z.string() }), execute: async (a) => this.customerGroupTools.deleteCustomerGroup(ctx, a) }),
+            addCustomersToGroup: (0, ai_1.tool)({ description: 'Add customers to a group.', inputSchema: zod_1.z.object({ customerGroupId: zod_1.z.string(), customerIds: zod_1.z.array(zod_1.z.string()) }), execute: async (a) => this.customerGroupTools.addCustomersToGroup(ctx, a) }),
+            removeCustomersFromGroup: (0, ai_1.tool)({ description: 'Remove customers from a group.', inputSchema: zod_1.z.object({ customerGroupId: zod_1.z.string(), customerIds: zod_1.z.array(zod_1.z.string()) }), execute: async (a) => this.customerGroupTools.removeCustomersFromGroup(ctx, a) }),
+            // ── Stock Locations ──
+            getStockLocations: (0, ai_1.tool)({ description: 'List stock/warehouse locations.', inputSchema: zod_1.z.object({ query: zod_1.z.string().optional(), take: zod_1.z.number().optional() }), execute: async (a) => this.stockLocationTools.getStockLocations(ctx, a) }),
+            createStockLocation: (0, ai_1.tool)({ description: 'Create a stock location.', inputSchema: zod_1.z.object({ name: zod_1.z.string(), description: zod_1.z.string().optional() }), execute: async (a) => this.stockLocationTools.createStockLocation(ctx, a) }),
+            updateStockLocation: (0, ai_1.tool)({ description: 'Update a stock location.', inputSchema: zod_1.z.object({ stockLocationId: zod_1.z.string(), name: zod_1.z.string().optional(), description: zod_1.z.string().optional() }), execute: async (a) => this.stockLocationTools.updateStockLocation(ctx, a) }),
+            deleteStockLocation: (0, ai_1.tool)({ description: 'Delete a stock location. Optionally transfer stock to another location.', inputSchema: zod_1.z.object({ stockLocationId: zod_1.z.string(), transferToLocationId: zod_1.z.string().optional() }), execute: async (a) => this.stockLocationTools.deleteStockLocation(ctx, a) }),
+            // ── Navigation ──
+            navigateToPage: (0, ai_1.tool)({
+                description: `Navigate the admin user to a dashboard page. Use this when the user asks to "go to", "open", "show me", "take me to", or "navigate to" a page.
+IMPORTANT: Paths must NOT include /dashboard prefix. All routes are relative, flat paths.
+Available pages:
+- / — Dashboard home
+- /products — Products list
+- /products/{id} — Product detail (need product ID)
+- /orders — Orders list
+- /orders/{id} — Order detail (need order ID)
+- /customers — Customers list
+- /customers/{id} — Customer detail (need customer ID)
+- /collections — Collections list
+- /facets — Facets list
+- /assets — Assets list
+- /option-groups — Option groups
+- /promotions — Promotions list
+- /shipping-methods — Shipping methods
+- /payment-methods — Payment methods
+- /tax-categories — Tax categories
+- /tax-rates — Tax rates
+- /zones — Zones
+- /countries — Countries
+- /channels — Channels
+- /administrators — Administrators
+- /roles — Roles
+- /global-settings — Global settings
+- /sellers — Sellers
+- /stock-locations — Stock locations
+- /customer-groups — Customer groups
+- /extensions/pages — Page Builder
+- /extensions/ai-chat — AI Chat (full view)
+- /extensions/ai-dashboard — AI Dashboard
+If the user asks to go to a specific entity (e.g. "go to product Laptop"), first search for it to get the ID, then navigate to /products/{id}.`,
                 inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by role code or description'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 20, max 50)'),
+                    path: zod_1.z.string().describe('The relative path to navigate to, e.g. /products — do NOT include /dashboard prefix'),
+                    reason: zod_1.z.string().optional().describe('Brief reason for navigating'),
                 }),
-                execute: async (args) => this.staffTools.getRoles(ctx, args),
-            }),
-            getPromotions: (0, ai_1.tool)({
-                description: 'List promotions/discounts with their coupon codes, conditions, actions, and date ranges.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by name or coupon code'),
-                    activeOnly: zod_1.z.boolean().optional().describe('Only show currently active promotions (default false)'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 20, max 50)'),
-                }),
-                execute: async (args) => this.promotionTools.getPromotions(ctx, args),
-            }),
-            getCountries: (0, ai_1.tool)({
-                description: 'List countries configured in the store with their codes and enabled status.',
-                inputSchema: zod_1.z.object({
-                    query: zod_1.z.string().optional().describe('Optional search term to filter by country name or code'),
-                    enabledOnly: zod_1.z.boolean().optional().describe('Only show enabled countries (default false)'),
-                    take: zod_1.z.number().optional().describe('Number of results (default 30, max 100)'),
-                }),
-                execute: async (args) => this.countryTools.getCountries(ctx, args),
+                execute: async (a) => { var _a; return ({ navigateTo: a.path, reason: (_a = a.reason) !== null && _a !== void 0 ? _a : 'Navigating as requested' }); },
             }),
         };
     }
-    async chat(ctx, userMessage, conversationHistory = []) {
-        var _a, _b, _c, _d;
+    async chat(ctx, userMessage, conversationHistory = [], currentPage) {
+        let systemPrompt = admin_system_prompt_1.ADMIN_SYSTEM_PROMPT;
+        if (currentPage) {
+            systemPrompt += `\n\n## Current context\nThe admin user is currently viewing: ${currentPage}`;
+        }
         const messages = [
-            { role: 'system', content: admin_system_prompt_1.ADMIN_SYSTEM_PROMPT },
+            { role: 'system', content: systemPrompt },
             ...conversationHistory,
             { role: 'user', content: userMessage },
         ];
         const tools = this.buildTools(ctx);
+        // Try OpenAI first, fall back to Azure if available
+        try {
+            return await this.runChat(this.openai('gpt-4o-mini'), messages, tools);
+        }
+        catch (primaryError) {
+            this.logger.error(`Primary OpenAI failed: ${primaryError}`);
+            if (this.azure) {
+                this.logger.log('Falling back to Azure OpenAI...');
+                try {
+                    return await this.runChat(this.azure(this.azureDeploymentName), messages, tools);
+                }
+                catch (fallbackError) {
+                    this.logger.error(`Azure fallback also failed: ${fallbackError}`);
+                    throw fallbackError;
+                }
+            }
+            throw primaryError;
+        }
+    }
+    async runChat(model, messages, tools) {
+        var _a, _b, _c, _d, _e, _f, _g;
         const result = (0, ai_1.streamText)({
-            model: this.openai('gpt-4o-mini'),
+            model,
             messages,
             tools,
             stopWhen: (0, ai_1.stepCountIs)(5),
@@ -279,7 +324,7 @@ let AdminAiChatService = AdminAiChatService_1 = class AdminAiChatService {
             onStepFinish: (step) => {
                 if (step.toolResults && step.toolResults.length > 0) {
                     for (const tr of step.toolResults) {
-                        this.logger.debug(`Admin tool "${tr.toolName}" completed`);
+                        this.logger.log(`Admin tool "${tr.toolName}" completed`);
                     }
                 }
             },
@@ -287,11 +332,11 @@ let AdminAiChatService = AdminAiChatService_1 = class AdminAiChatService {
                 this.logger.error(`Admin chat streamText error: ${event.error}`);
             },
         });
-        const text = await result.text;
-        const steps = await result.steps;
+        const [text, steps, usage] = await Promise.all([result.text, result.steps, result.usage]);
         let allProducts = [];
         let allCollections = [];
         let allOrders = [];
+        let navigateTo;
         for (const step of steps) {
             for (const toolResult of step.toolResults) {
                 const data = (_a = toolResult.output) !== null && _a !== void 0 ? _a : toolResult.result;
@@ -306,6 +351,9 @@ let AdminAiChatService = AdminAiChatService_1 = class AdminAiChatService {
                 if (((_d = data.orders) === null || _d === void 0 ? void 0 : _d.length) > 0) {
                     allOrders = data.orders;
                 }
+                if (data.navigateTo) {
+                    navigateTo = data.navigateTo;
+                }
             }
         }
         return {
@@ -313,6 +361,12 @@ let AdminAiChatService = AdminAiChatService_1 = class AdminAiChatService {
             products: allProducts.slice(0, constants_1.MAX_CHAT_PRODUCTS),
             collections: allCollections.slice(0, 5),
             orders: allOrders.length > 0 ? allOrders : undefined,
+            navigateTo,
+            usage: {
+                inputTokens: (_e = usage.inputTokens) !== null && _e !== void 0 ? _e : 0,
+                outputTokens: (_f = usage.outputTokens) !== null && _f !== void 0 ? _f : 0,
+                totalTokens: (_g = usage.totalTokens) !== null && _g !== void 0 ? _g : 0,
+            },
         };
     }
 };
@@ -325,6 +379,29 @@ exports.AdminAiChatService = AdminAiChatService = AdminAiChatService_1 = __decor
         core_2.ConfigService,
         embedding_service_1.EmbeddingService,
         product_embedding_service_1.ProductEmbeddingService,
-        collection_embedding_service_1.CollectionEmbeddingService])
+        collection_embedding_service_1.CollectionEmbeddingService,
+        core_2.ProductService,
+        core_2.ProductVariantService,
+        core_2.ProductOptionGroupService,
+        core_2.ProductOptionService,
+        core_2.TaxCategoryService,
+        core_2.CustomerService,
+        core_2.CollectionService,
+        core_2.FacetService,
+        core_2.FacetValueService,
+        core_2.ShippingMethodService,
+        core_2.PaymentMethodService,
+        core_2.TaxRateService,
+        core_2.ZoneService,
+        core_2.CountryService,
+        core_2.AdministratorService,
+        core_2.RoleService,
+        core_2.ChannelService,
+        core_2.SellerService,
+        core_2.GlobalSettingsService,
+        core_2.PromotionService,
+        core_2.AssetService,
+        core_2.CustomerGroupService,
+        core_2.StockLocationService])
 ], AdminAiChatService);
 //# sourceMappingURL=admin-ai-chat.service.js.map