@unchainedshop/api 4.0.0-rc.15 → 4.0.0-rc.17

package/src/mcp/tools/product/handlers/addProductVariationOption.ts

@@ -1,3 +1,4 @@
+import { ProductVariation } from '@unchainedshop/core-products';
 import { Context } from '../../../../context.js';
 import { ProductVariationNotFoundError } from '../../../../errors.js';
 import { getNormalizedProductDetails } from '../../../utils/getNormalizedProductDetails.js';
@@ -13,9 +14,9 @@ export default async function addProductVariationOption(
   const variation = await modules.products.variations.findProductVariation({ productVariationId });
   if (!variation) throw new ProductVariationNotFoundError({ productVariationId });
 
-  const newOption = await modules.products.variations.addVariationOption(productVariationId, {
+  const newOption = (await modules.products.variations.addVariationOption(productVariationId, {
     value: option,
-  });
+  })) as ProductVariation;
 
   if (variationTexts && variationTexts.length > 0) {
     await modules.products.variations.texts.updateVariationTexts(

package/src/mcp/tools/product/handlers/createProductVariation.ts

@@ -23,6 +23,7 @@ export default async function createProductVariation(
 
   const newVariation = await modules.products.variations.create({
     options: [],
+    tags: [],
     productId,
     ...variation,
   });

package/src/mcp/tools/product/handlers/getCatalogPrice.ts

@@ -20,7 +20,9 @@ export default async function getCatalogPrice(context: Context, params: Params<'
   };
 
   const pricing = await services.products.simulateProductPricing(pricingContext as any);
-  const unitPrice = pricing?.unitPrice();
+  const unitPrice = pricing?.unitPrice({});
+
+  if (!pricing) return { price: null };
 
   const price = {
     ...unitPrice,

package/src/mcp/tools/product/handlers/getProductAssignments.ts

@@ -1,17 +1,17 @@
 import { Context } from '../../../../context.js';
 import { ProductTypes } from '@unchainedshop/core-products';
 import { ProductNotFoundError, ProductWrongTypeError } from '../../../../errors.js';
-import { getNormalizedProductDetails } from '../../../utils/getNormalizedProductDetails.js';
 import { Params } from '../schemas.js';
+import normalizeProxyAssignments from '../../../utils/normalizeProxyAssignments.js';
 
 export default async function getProductAssignments(
   context: Context,
   params: Params<'GET_ASSIGNMENTS'>,
 ) {
   const { modules } = context;
-  const { productId, includeInactive = false } = params;
+  const { productId } = params;
 
-  const product = await getNormalizedProductDetails(productId, context);
+  const product = await modules.products.findProduct({ productId });
   if (!product) throw new ProductNotFoundError({ productId });
 
   if (product.type !== ProductTypes.ConfigurableProduct) {
@@ -22,6 +22,10 @@ export default async function getProductAssignments(
     });
   }
 
-  const assignments = await modules.products.proxyAssignments(product, { includeInactive });
+  const assignments = await Promise.all(
+    (product?.proxy?.assignments || [])?.map(async (assignment) =>
+      normalizeProxyAssignments(assignment, context),
+    ),
+  );
   return { assignments };
 }

package/src/mcp/tools/product/handlers/index.ts

@@ -31,6 +31,7 @@ import getMediaTexts from './getMediaTexts.js';
 import getReviews from './getReviews.js';
 import countReviews from './countReviews.js';
 import getSiblings from './getSiblings.js';
+import updateProductTexts from './updateProductTexts.js';
 
 export const actionHandlers = {
   CREATE: createProduct,
@@ -66,4 +67,5 @@ export const actionHandlers = {
   GET_REVIEWS: getReviews,
   COUNT_REVIEWS: countReviews,
   GET_SIBLINGS: getSiblings,
+  UPDATE_PRODUCT_TEXTS: updateProductTexts,
 };

package/src/mcp/tools/product/handlers/removeProduct.ts

@@ -1,14 +1,34 @@
 import { Context } from '../../../../context.js';
-import { ProductNotFoundError } from '../../../../errors.js';
+import {
+  ProductLinkedToActiveBundleError,
+  ProductLinkedToActiveVariationError,
+  ProductLinkedToEnrollmentError,
+  ProductLinkedToQuotationError,
+  ProductNotFoundError,
+} from '../../../../errors.js';
 import { Params } from '../schemas.js';
 
 export default async function removeProduct(context: Context, params: Params<'REMOVE'>) {
-  const { modules } = context;
+  const { modules, services } = context;
   const { productId } = params;
 
   const product = await modules.products.findProduct({ productId });
   if (!product) throw new ProductNotFoundError({ productId });
+  const activeBundle = await modules.products.firstActiveProductBundle(productId);
+  if (activeBundle)
+    throw new ProductLinkedToActiveBundleError({ productId, bundleId: activeBundle._id });
+  const activeProxy = await modules.products.firstActiveProductProxy(productId);
+  if (activeProxy)
+    throw new ProductLinkedToActiveVariationError({ productId, proxyId: activeProxy._id });
+
+  const openQuotation = await modules.quotations.openQuotationWithProduct({ productId });
+  if (openQuotation)
+    throw new ProductLinkedToQuotationError({ productId, quotationId: openQuotation?._id });
+  const openEnrollment = await modules.enrollments.openEnrollmentWithProduct({ productId });
+  if (openEnrollment)
+    throw new ProductLinkedToEnrollmentError({ productId, enrollmentId: openEnrollment?._id });
+
+  await services.products.removeProduct({ productId });
 
-  await modules.products.delete(productId);
   return { success: true };
 }

package/src/mcp/tools/product/handlers/simulatePrice.ts

@@ -22,6 +22,8 @@ export default async function simulatePrice(context: Context, params: Params<'SI
   const pricing = await services.products.simulateProductPricing(pricingContext as any);
   const unitPrice = pricing?.unitPrice({ useNetPrice });
 
+  if (!pricing) return { price: null };
+
   const price = {
     ...unitPrice,
     isNetPrice: useNetPrice,

package/src/mcp/tools/product/handlers/simulatePriceRange.ts

@@ -31,6 +31,9 @@ export default async function simulatePriceRange(
   };
 
   const pricing = await services.products.simulateProductPricing(pricingContext as any);
+
+  if (!pricing) return { price: null };
+
   const minPrice = pricing?.unitPrice({ useNetPrice });
   const maxPrice = pricing?.unitPrice({ useNetPrice });
 

package/src/mcp/tools/product/handlers/updateProduct.ts

@@ -1,6 +1,8 @@
 import { Context } from '../../../../context.js';
 import { ProductTypes } from '@unchainedshop/core-products';
 import {
+  CountryNotFoundError,
+  CurrencyNotFoundError,
   ProductNotFoundError,
   ProductWrongStatusError,
   ProductWrongTypeError,
@@ -9,7 +11,7 @@ import { getNormalizedProductDetails } from '../../../utils/getNormalizedProduct
 import { Params } from '../schemas.js';
 
 export default async function updateProduct(context: Context, params: Params<'UPDATE'>) {
-  const { modules } = context;
+  const { modules, loaders } = context;
   const { productId, product } = params;
 
   const existingProduct = await modules.products.findProduct({ productId });
@@ -64,6 +66,15 @@ export default async function updateProduct(context: Context, params: Params<'UP
   }
 
   if (product.commerce !== undefined) {
+    await Promise.all(
+      product.commerce.pricing.map(async ({ countryCode, currencyCode }) => {
+        const currency = await loaders.currencyLoader.load({ isoCode: currencyCode });
+        if (!currency) throw new CurrencyNotFoundError({ currencyCode });
+
+        const country = await loaders.countryLoader.load({ isoCode: countryCode });
+        if (!country) throw new CountryNotFoundError({ countryCode });
+      }),
+    );
     updateData.commerce = product.commerce;
   }
 

package/src/mcp/tools/product/handlers/updateProductMediaTexts.ts

@@ -1,3 +1,4 @@
+import { ProductMediaText } from '@unchainedshop/core-products';
 import { Context } from '../../../../context.js';
 import { ProductMediaNotFoundError } from '../../../../errors.js';
 import { Params } from '../schemas.js';
@@ -12,6 +13,9 @@ export default async function updateProductMediaTexts(
   const media = await modules.products.media.findProductMedia({ productMediaId });
   if (!media) throw new ProductMediaNotFoundError({ productMediaId });
 
-  const texts = await modules.products.media.texts.updateMediaTexts(productMediaId, mediaTexts);
+  const texts = await modules.products.media.texts.updateMediaTexts(
+    productMediaId,
+    mediaTexts as ProductMediaText[], // TODO: Fix with correct zod schema
+  );
   return { texts };
 }

package/src/mcp/tools/product/handlers/updateProductTexts.ts

@@ -0,0 +1,16 @@
+import { Context } from '../../../../context.js';
+import { ProductNotFoundError } from '../../../../errors.js';
+import { Params } from '../schemas.js';
+
+export default async function updateProductTexts(
+  context: Context,
+  params: Params<'UPDATE_PRODUCT_TEXTS'>,
+) {
+  const { modules } = context;
+  const { productId, texts } = params;
+  const product = await modules.products.findProduct({ productId });
+  if (!product) throw new ProductNotFoundError({ productId });
+
+  const productTexts = await modules.products.texts.updateTexts(productId, texts as any);
+  return { texts: productTexts };
+}

package/src/mcp/tools/product/schemas.ts

@@ -104,22 +104,26 @@ export const ProductSchema = z.object({
               .min(3)
               .max(3)
               .describe(
-                'ISO currency code (e.g., USD, EUR) make sure the currency code provided exists in the system currencies before using it. if it does not exists prompt the user to add the currency. NEVER add it automatically',
+                'ISO currency code (e.g., USD, EUR). Must match an available currency from the shop currencies resource. If it does not exist, prompt the user to add the currency. NEVER add it automatically unless explicitly specified by the user.',
               ),
             countryCode: z
               .string()
               .min(2)
               .max(2)
               .describe(
-                'ISO country code (e.g., US, DE) make sure the country exists in the system before using it. if it does not exists prompt the user to add the country. NEVER add it automatically',
+                'ISO country code (e.g., US, DE). Must match an available country from the shop countries resource. If it does not exist, prompt the user to add the country. NEVER add it automatically unless explicitly specified by the user.',
               ),
           }),
         )
         .nonempty()
-        .describe('List of price configurations'),
+        .describe(
+          'List of price configurations. Use only countryCode and currencyCode values from the shop resources.',
+        ),
     })
     .optional()
-    .describe('Commerce info - Available for ALL except CONFIGURABLE_PRODUCT & BUNDLE_PRODUCT'),
+    .describe(
+      'Commerce info - Available for ALL except CONFIGURABLE_PRODUCT. Use only registered countries and currencies from shop resources.',
+    ),
 });
 
 export const actionValidators = {
@@ -140,7 +144,7 @@ export const actionValidators = {
       .string()
       .min(1)
       .describe(
-        'Product ID, (the product to remove must be inactive or in DRAFT state other wise it will throw error)',
+        'Product ID, (the product status to remove must be inactive or in DRAFT state other wise it will throw error) so if it is active please unpublish it first before removing the product',
       ),
   }),
 
@@ -265,7 +269,7 @@ export const actionValidators = {
   ADD_BUNDLE_ITEM: z.object({
     bundleId: z.string().min(1).describe('Bundle product ID'),
     bundleProductId: z.string().min(1).describe('Product to add to bundle'),
-    quantity: z.number().int().positive().optional().describe('Quantity'),
+    quantity: z.number().int().positive().default(1).describe('Quantity'),
   }),
 
   REMOVE_BUNDLE_ITEM: z.object({
@@ -329,6 +333,11 @@ export const actionValidators = {
     assortmentId: z.string().optional().describe('Assortment ID'),
     includeInactive: z.boolean().optional().describe('Include inactive products'),
   }),
+
+  UPDATE_PRODUCT_TEXTS: z.object({
+    productId: z.string().min(1).describe('Product ID'),
+    texts: z.array(ProductTextInputSchema).describe('Product texts to update'),
+  }),
 } as const;
 
 export const ProductManagementSchema = {
@@ -367,6 +376,7 @@ export const ProductManagementSchema = {
       'GET_REVIEWS',
       'COUNT_REVIEWS',
       'GET_SIBLINGS',
+      'UPDATE_PRODUCT_TEXTS',
     ])
     .describe('Product management action to perform'),
 
@@ -448,6 +458,9 @@ export const ProductManagementSchema = {
     .array(ProductAssignmentVectorSchema)
     .optional()
     .describe('Complete variation combination vectors'),
+
+  // eslint-disable-next-line
+  // @ts-expect-error
   includeInactive: z.boolean().optional().describe('Include inactive variants in results'),
 
   bundleId: z

package/src/mcp/tools/quotation/handlers/countQuotations.ts

@@ -0,0 +1,8 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+
+export default async function countQuotations(context: Context, params: Params<'COUNT'>) {
+  const { modules } = context;
+
+  return modules.quotations.count(params);
+}

package/src/mcp/tools/quotation/handlers/getQuotation.ts

@@ -0,0 +1,8 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+import { getNormalizedQuotationDetails } from '../../../utils/getNormalizedQuotationDetails.js';
+
+export default async function getQuotation(context: Context, params: Params<'GET'>) {
+  const { quotationId } = params;
+  return getNormalizedQuotationDetails(quotationId, context);
+}

package/src/mcp/tools/quotation/handlers/index.ts

@@ -0,0 +1,15 @@
+import listQuotations from './listQuotations.js';
+import getQuotation from './getQuotation.js';
+import countQuotations from './countQuotations.js';
+import verifyQuotation from './verifyQuotation.js';
+import makeQuotationProposal from './makeQuotationProposal.js';
+import rejectQuotation from './rejectQuotation.js';
+
+export default {
+  LIST: listQuotations,
+  GET: getQuotation,
+  COUNT: countQuotations,
+  VERIFY: verifyQuotation,
+  MAKE_PROPOSAL: makeQuotationProposal,
+  REJECT: rejectQuotation,
+};

package/src/mcp/tools/quotation/handlers/listQuotations.ts

@@ -0,0 +1,14 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+import { getNormalizedQuotationDetails } from '../../../utils/getNormalizedQuotationDetails.js';
+
+export default async function listQuotations(context: Context, params: Params<'LIST'>) {
+  const { modules } = context;
+  const quotations = await modules.quotations.findQuotations(params as any);
+
+  return {
+    quotations: await Promise.all(
+      quotations.map((quotation) => getNormalizedQuotationDetails(quotation._id, context)),
+    ),
+  };
+}

package/src/mcp/tools/quotation/handlers/makeQuotationProposal.ts

@@ -0,0 +1,23 @@
+import { QuotationStatus } from '@unchainedshop/core-quotations';
+import { Context } from '../../../../context.js';
+import { QuotationNotFoundError, QuotationWrongStatusError } from '../../../../errors.js';
+import { Params } from '../schemas.js';
+import { getNormalizedQuotationDetails } from '../../../utils/getNormalizedQuotationDetails.js';
+
+export default async function makeQuotationProposal(context: Context, params: Params<'MAKE_PROPOSAL'>) {
+  const { modules, services } = context;
+  const { quotationId, quotationContext } = params;
+  const quotation = await modules.quotations.findQuotation({ quotationId });
+  if (!quotation) throw new QuotationNotFoundError({ quotationId });
+
+  if (quotation.status !== QuotationStatus.PROCESSING) {
+    throw new QuotationWrongStatusError({ status: quotation.status });
+  }
+
+  const proposedQuotation = await services.quotations.proposeQuotation(
+    quotation,
+    quotationContext || {},
+  );
+
+  return getNormalizedQuotationDetails(proposedQuotation._id, context);
+}

package/src/mcp/tools/quotation/handlers/rejectQuotation.ts

@@ -0,0 +1,21 @@
+import { QuotationStatus } from '@unchainedshop/core-quotations';
+import { Context } from '../../../../context.js';
+import { QuotationNotFoundError, QuotationWrongStatusError } from '../../../../errors.js';
+import { Params } from '../schemas.js';
+import { getNormalizedQuotationDetails } from '../../../utils/getNormalizedQuotationDetails.js';
+
+export default async function rejectQuotation(context: Context, params: Params<'REJECT'>) {
+  const { modules, services } = context;
+  const { quotationId, quotationContext } = params;
+
+  const quotation = await modules.quotations.findQuotation({ quotationId });
+  if (!quotation) throw new QuotationNotFoundError({ quotationId });
+
+  if (quotation.status === QuotationStatus.FULLFILLED) {
+    throw new QuotationWrongStatusError({ status: quotation.status });
+  }
+
+  const rejectedQuotation = await services.quotations.rejectQuotation(quotation, quotationContext || {});
+
+  return getNormalizedQuotationDetails(rejectedQuotation._id, context);
+}

package/src/mcp/tools/quotation/handlers/verifyQuotation.ts

@@ -0,0 +1,21 @@
+import { QuotationStatus } from '@unchainedshop/core-quotations';
+import { Context } from '../../../../context.js';
+import { QuotationNotFoundError, QuotationWrongStatusError } from '../../../../errors.js';
+import { Params } from '../schemas.js';
+import { getNormalizedQuotationDetails } from '../../../utils/getNormalizedQuotationDetails.js';
+
+export default async function verifyQuotation(context: Context, params: Params<'VERIFY'>) {
+  const { modules, services } = context;
+  const { quotationId, quotationContext } = params;
+
+  const quotation = await modules.quotations.findQuotation({ quotationId });
+  if (!quotation) throw new QuotationNotFoundError({ quotationId });
+
+  if (quotation.status !== QuotationStatus.REQUESTED) {
+    throw new QuotationWrongStatusError({ status: quotation.status });
+  }
+
+  const verifiedQuotation = await services.quotations.verifyQuotation(quotation, quotationContext || {});
+
+  return getNormalizedQuotationDetails(verifiedQuotation._id, context);
+}

package/src/mcp/tools/quotation/index.ts

@@ -0,0 +1,12 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Context } from '../../../context.js';
+import { quotationManagement, QuotationManagementSchema } from './quotationManagement.js';
+
+export const registerQuotationTools = (server: McpServer, context: Context) => {
+  server.tool(
+    'quotation_management',
+    'Unified quotation management system. Supports: LIST (get quotations with filters and pagination), GET (single quotation by ID), COUNT (count quotations), REQUEST (create new quotation request for a product), VERIFY (verify a REQUESTED quotation), MAKE_PROPOSAL (create proposal for PROCESSING quotation), REJECT (reject any quotation except FULLFILLED). Quotations go through lifecycle: REQUESTED → PROCESSING → PROPOSED → FULLFILLED/REJECTED.',
+    QuotationManagementSchema,
+    async (params) => quotationManagement(context, params),
+  );
+};

package/src/mcp/tools/quotation/quotationManagement.ts

@@ -0,0 +1,34 @@
+import { Context } from '../../../context.js';
+import { log } from '@unchainedshop/logger';
+import {
+  actionValidators,
+  QuotationManagementSchema,
+  QuotationManagementZodSchema,
+  QuotationManagementParams,
+  ActionName,
+} from './schemas.js';
+import actionHandlers from './handlers/index.js';
+import { createMcpResponse, createMcpErrorResponse } from '../../utils/sharedSchemas.js';
+
+export { QuotationManagementSchema, QuotationManagementZodSchema, QuotationManagementParams };
+
+export async function quotationManagement(context: Context, params: QuotationManagementParams) {
+  const { action, ...actionParams } = params;
+  log('MCP handler quotationManagement ', { userId: context.userId, params });
+
+  try {
+    if (!(action in actionHandlers)) {
+      throw new Error(`Unknown action: ${action}`);
+    }
+
+    const parsedParams = actionValidators[action as ActionName].parse(actionParams);
+    const data = await actionHandlers[action as ActionName](context, parsedParams as never);
+
+    return createMcpResponse({
+      action,
+      data,
+    });
+  } catch (error) {
+    return createMcpErrorResponse(action, error);
+  }
+}

package/src/mcp/tools/quotation/schemas.ts

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+import {
+  PaginationSchema,
+  SortingSchema,
+  SearchSchema,
+  DateRangeSchema,
+} from '../../utils/sharedSchemas.js';
+
+export const QuotationStatusEnum = z.enum([
+  'REQUESTED',
+  'PROCESSING',
+  'PROPOSED',
+  'FULLFILLED',
+  'REJECTED',
+]);
+
+export const ProductConfigurationInput = z.object({
+  key: z.string().describe('Configuration key'),
+  value: z.string().describe('Configuration value'),
+});
+
+export const actionValidators = {
+  LIST: z
+    .object({
+      ...PaginationSchema,
+      ...SortingSchema,
+      ...SearchSchema,
+      ...DateRangeSchema,
+      status: QuotationStatusEnum.optional().describe('Filter by quotation status'),
+      userId: z.string().optional().describe('Filter by user ID'),
+      productId: z.string().optional().describe('Filter by product ID'),
+    })
+    .describe(
+      'Retrieves a list of quotations with optional filters. Supports pagination (limit/offset), sorting, text search (queryString), status filtering, and filtering by userId or productId.',
+    ),
+
+  GET: z
+    .object({
+      quotationId: z.string().min(1, 'quotationId is required').describe('Quotation ID to retrieve'),
+    })
+    .describe('Retrieves a single quotation by ID. Requirements: quotationId must be provided.'),
+
+  COUNT: z
+    .object({
+      ...SearchSchema,
+      ...DateRangeSchema,
+      status: QuotationStatusEnum.optional().describe('Filter by quotation status'),
+      userId: z.string().optional().describe('Filter by user ID'),
+      productId: z.string().optional().describe('Filter by product ID'),
+    })
+    .describe(
+      'Returns the total count of quotations matching the provided filters. Useful for pagination. Accepts same filter parameters as LIST.',
+    ),
+  VERIFY: z
+    .object({
+      quotationId: z
+        .string()
+        .min(1, 'quotationId is required')
+        .describe('Quotation ID to verify. Must be in REQUESTED status.'),
+      quotationContext: z
+        .record(z.any())
+        .optional()
+        .describe('Optional context for verification (e.g., verification notes, approval details)'),
+    })
+    .describe(
+      'Verifies a quotation and transitions it from REQUESTED to PROCESSING status. Requirements: quotation must exist AND current status must be REQUESTED.',
+    ),
+
+  MAKE_PROPOSAL: z
+    .object({
+      quotationId: z
+        .string()
+        .min(1, 'quotationId is required')
+        .describe('Quotation ID to create proposal for. Must be in PROCESSING status.'),
+      quotationContext: z
+        .record(z.any())
+        .optional()
+        .describe(
+          'Optional context for the proposal (e.g., pricing details, terms, delivery estimates)',
+        ),
+    })
+    .describe(
+      'Creates a proposal for a quotation and transitions it from PROCESSING to PROPOSED status. Requirements: quotation must exist AND current status must be PROCESSING.',
+    ),
+
+  REJECT: z
+    .object({
+      quotationId: z
+        .string()
+        .min(1, 'quotationId is required')
+        .describe('Quotation ID to reject. Cannot be FULLFILLED.'),
+      quotationContext: z
+        .record(z.any())
+        .optional()
+        .describe(
+          'Optional context for rejection (e.g., reason for rejection, alternative suggestions)',
+        ),
+    })
+    .describe(
+      'Rejects a quotation and transitions it to REJECTED status. Requirements: quotation must exist AND current status must NOT be FULLFILLED (cannot reject completed quotations). Sets rejected timestamp.',
+    ),
+} as const;
+
+export const QuotationManagementSchema = {
+  action: z
+    .enum(['LIST', 'GET', 'COUNT', 'VERIFY', 'MAKE_PROPOSAL', 'REJECT'])
+    .describe(
+      'Quotation action: LIST (get quotations with filters), GET (single quotation by ID), COUNT (count quotations), VERIFY (verify a REQUESTED quotation), MAKE_PROPOSAL (create proposal for PROCESSING quotation), REJECT (reject a quotation)',
+    ),
+
+  ...PaginationSchema,
+  ...SortingSchema,
+  ...SearchSchema,
+  ...DateRangeSchema,
+  status: QuotationStatusEnum.optional().describe('Filter by quotation status (LIST & COUNT only)'),
+  userId: z.string().optional().describe('Filter by user ID (LIST & COUNT only)'),
+  productId: z.string().optional().describe('Product ID (LIST, COUNT only)'),
+  quotationId: z.string().optional().describe('Quotation ID (GET, VERIFY, MAKE_PROPOSAL, REJECT only)'),
+  configuration: z
+    .array(ProductConfigurationInput)
+    .optional()
+    .describe(
+      'Use this to add any additional information for the quotation, it can be how many for when or price or anything a user might want to add',
+    ),
+  quotationContext: z
+    .record(z.any())
+    .optional()
+    .describe('Context object (VERIFY, MAKE_PROPOSAL, REJECT only)'),
+};
+
+export const QuotationManagementZodSchema = z.object(QuotationManagementSchema);
+export type QuotationManagementParams = z.infer<typeof QuotationManagementZodSchema>;
+
+export type ActionName = keyof typeof actionValidators;
+export type Params<T extends ActionName> = z.infer<(typeof actionValidators)[T]>;
+export type Handler<T extends ActionName> = (context: any, params: Params<T>) => Promise<unknown>;

package/src/mcp/tools/system/handlers/listWork.ts

@@ -1,13 +1,13 @@
 import { buildObfuscatedFieldsFilter } from '@unchainedshop/utils';
-import { Context } from '../../../../context.js';
 import { WorkListOptions } from '../types.js';
+import { UnchainedCore } from '@unchainedshop/core';
 
-const listWork = async (context: Context, options?: WorkListOptions) => {
+const listWork = async (context: UnchainedCore, options?: WorkListOptions) => {
   const { modules } = context;
   const removePrivateFieldsFromWork = buildObfuscatedFieldsFilter(
     context.options.worker?.blacklistedVariables,
   );
-  const { limit = 10, offset = 0, queryString, status, sort, types, created } = options || {};
+  const { limit = 10, offset = 0, queryString, status, sort, types, created } = options || ({} as any);
 
   const workQueue = await modules.worker.findWorkQueue({
     status,

package/src/mcp/tools/system/index.ts

@@ -6,7 +6,7 @@ import { SystemManagementSchema } from './schemas.js';
 export const registerSystemTools = (server: McpServer, context: Context) => {
   server.tool(
     'system_management',
-    'Comprehensive system management with unified system information, worker queue, and event operations. CRITICAL INSTRUCTION: When any operation requires locale, language, country, or currency information that is not provided by the user or cannot be derived from context, you MUST first call this tool with action "SHOP_INFO" to retrieve the authoritative default values, then use those defaults in subsequent operations. System actions: SHOP_INFO (MANDATORY first call when defaults needed - returns shop configuration including defaultLanguageIsoCode for language/locale fallback, country_isoCode for country fallback, and country_defaultCurrency for currency fallback). Worker actions: WORKER_ADD (add work items), WORKER_REMOVE (delete work items), WORKER_GET (retrieve work item), WORKER_LIST (search work items), WORKER_COUNT (count work items), WORKER_ALLOCATE (allocate work to workers), WORKER_FINISH_WORK (mark work complete), WORKER_PROCESS_NEXT (get next work item), WORKER_STATISTICS (work queue statistics), WORKER_ACTIVE_WORK_TYPES (get active work types). Event actions: EVENT_GET (retrieve event), EVENT_LIST (search events), EVENT_COUNT (count events), EVENT_STATISTICS (event analytics). FALLBACK BEHAVIOR: Always call SHOP_INFO first when user requests lack locale/language/country/currency context to ensure consistent default behavior. Use defaultLanguageIsoCode for missing language/locale, country_isoCode for missing country, country_defaultCurrency for missing currency.',
+    'Comprehensive system management with unified system information, worker queue, and event operations. System actions: SHOP_INFO (returns shop configuration including default locale settings). Worker actions: WORKER_ADD (add work items), WORKER_REMOVE (delete work items), WORKER_GET (retrieve work item), WORKER_LIST (search work items), WORKER_COUNT (count work items), WORKER_ALLOCATE (allocate work to workers), WORKER_FINISH_WORK (mark work complete), WORKER_PROCESS_NEXT (get next work item), WORKER_STATISTICS (work queue statistics), WORKER_ACTIVE_WORK_TYPES (get active work types). Event actions: EVENT_GET (retrieve event), EVENT_LIST (search events), EVENT_COUNT (count events), EVENT_STATISTICS (event analytics).',
     SystemManagementSchema,
     async (params) => systemManagement(context, params),
   );

package/src/mcp/tools/system/schemas.ts

@@ -14,7 +14,7 @@ export const actionValidators = {
   SHOP_INFO: z
     .object({})
     .describe(
-      'MANDATORY FIRST CALL when locale/language/country/currency defaults are needed. Get the authoritative shop configuration including defaultLanguageIsoCode (for language/locale fallback), country_isoCode (for country fallback), and country_defaultCurrency (for currency fallback). No parameters expected - returns system-wide defaults that must be used when user input lacks localization context.',
+      'Get shop configuration including default locale settings. No parameters expected - returns system-wide defaults.',
     ),
 
   WORKER_ADD: z.object({
@@ -232,7 +232,7 @@ export const SystemManagementSchema = {
       'EVENT_STATISTICS',
     ])
     .describe(
-      'Action to perform on the system. CRITICAL: SHOP_INFO (MANDATORY first call when locale/language/country/currency defaults are needed - returns authoritative fallbacks). Worker actions: WORKER_ADD (add work), WORKER_ALLOCATE (assign work), WORKER_REMOVE (delete work), WORKER_GET (retrieve work), WORKER_LIST (search work), WORKER_COUNT (count work), WORKER_FINISH_WORK (complete work), WORKER_PROCESS_NEXT (get next work), WORKER_STATISTICS (work stats), WORKER_ACTIVE_WORK_TYPES (get active work types). Event actions: EVENT_GET (retrieve event), EVENT_LIST (search events), EVENT_COUNT (count events), EVENT_STATISTICS (event stats). Always call SHOP_INFO first when user lacks localization context.',
+      'Action to perform on the system. System actions: SHOP_INFO (get shop configuration). Worker actions: WORKER_ADD (add work), WORKER_ALLOCATE (assign work), WORKER_REMOVE (delete work), WORKER_GET (retrieve work), WORKER_LIST (search work), WORKER_COUNT (count work), WORKER_FINISH_WORK (complete work), WORKER_PROCESS_NEXT (get next work), WORKER_STATISTICS (work stats), WORKER_ACTIVE_WORK_TYPES (get active work types). Event actions: EVENT_GET (retrieve event), EVENT_LIST (search events), EVENT_COUNT (count events), EVENT_STATISTICS (event stats).',
     ),
 
   type: z