@yoryoboy/bi-mcp 1.0.5 → 1.2.0

package/dist/src/tools/vtex/order-details.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/order-details.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getOrderDocumentsBatch } from \"../../services/vtex/vtex-orders.js\";\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { formatOrderDetails } from \"../../utils/format-order-details.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst MAX_ORDER_IDS = 50;\nconst MAX_CONCURRENT_REQUESTS = 10;\nconst MAX_RETRIES_PER_ORDER = 2;\n\nexport const orderDetailsSchema = z.object({\n  orderIds: z\n    .array(z.string().trim().min(3).describe(\"VTEX order identifier\"))\n    .min(1)\n    .max(MAX_ORDER_IDS)\n    .describe(\"List of VTEX order identifiers to fetch (up to 50 IDs)\"),\n  reason: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\"Optional reason for requesting unmasked PII data when required\"),\n});\n\nexport async function orderDetailsHandler({ orderIds, reason }: z.infer<typeof orderDetailsSchema>) {\n  try {\n    const uniqueOrderIds = Array.from(new Set(orderIds));\n    const batchResult = await getOrderDocumentsBatch(uniqueOrderIds, {\n      reason,\n      maxConcurrency: MAX_CONCURRENT_REQUESTS,\n      maxRetries: MAX_RETRIES_PER_ORDER,\n    });\n    \n    const formattedOrders = batchResult.successful.map(({ document }) => formatOrderDetails(document));\n\n    return object(\n      stripNulls({\n        metadata: {\n          requested: uniqueOrderIds.length,\n          successful: batchResult.successful.length,\n          failed: batchResult.failed.length,\n        },\n        schemas: {\n          item: [\"id\", \"ref\", \"name\", \"qty\", \"price\", \"list\"],\n          shipping: [\"carrier\", \"estimate\", \"delivery_date\"],\n          payment: [\"system\", \"installments\", \"value\"],\n          payment_validation: {\n            payments_total: \"Sum of all payment values\",\n            payment_delta: \"Difference between payments_total and order total\",\n            payment_mismatch: \"True if |payment_delta| > 0.5 (potential issue)\",\n          },\n        },\n        orders: formattedOrders,\n        failures: batchResult.failed.map((failure) => ({\n          order_id: failure.orderId,\n          message: failure.message,\n          status_code: failure.statusCode,\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, \"Failed to fetch order details batch\"));\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,8BAA8B;AACvC,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AACnC,SAAS,kBAAkB;AAE3B,MAAM,gBAAgB;AACtB,MAAM,0BAA0B;AAChC,MAAM,wBAAwB;AAEvB,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,UAAU,EACP,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,uBAAuB,CAAC,EAChE,IAAI,CAAC,EACL,IAAI,aAAa,EACjB,SAAS,wDAAwD;AAAA,EACpE,QAAQ,EACL,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT,SAAS,gEAAgE;AAC9E,CAAC;AAED,eAAsB,oBAAoB,EAAE,UAAU,OAAO,GAAuC;AAClG,MAAI;AACF,UAAM,iBAAiB,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC;AACnD,UAAM,cAAc,MAAM,uBAAuB,gBAAgB;AAAA,MAC/D;AAAA,MACA,gBAAgB;AAAA,MAChB,YAAY;AAAA,IACd,CAAC;AAED,UAAM,kBAAkB,YAAY,WAAW,IAAI,CAAC,EAAE,SAAS,MAAM,mBAAmB,QAAQ,CAAC;AAEjG,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,UACR,WAAW,eAAe;AAAA,UAC1B,YAAY,YAAY,WAAW;AAAA,UACnC,QAAQ,YAAY,OAAO;AAAA,QAC7B;AAAA,QACA,SAAS;AAAA,UACP,MAAM,CAAC,MAAM,OAAO,QAAQ,OAAO,SAAS,MAAM;AAAA,UAClD,UAAU,CAAC,WAAW,YAAY,eAAe;AAAA,UACjD,SAAS,CAAC,UAAU,gBAAgB,OAAO;AAAA,UAC3C,oBAAoB;AAAA,YAClB,gBAAgB;AAAA,YAChB,eAAe;AAAA,YACf,kBAAkB;AAAA,UACpB;AAAA,QACF;AAAA,QACA,QAAQ;AAAA,QACR,UAAU,YAAY,OAAO,IAAI,CAAC,aAAa;AAAA,UAC7C,UAAU,QAAQ;AAAA,UAClB,SAAS,QAAQ;AAAA,UACjB,aAAa,QAAQ;AAAA,QACvB,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,qCAAqC,CAAC;AAAA,EAC1E;AACF;",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getOrderDocumentsBatch } from \"../../services/vtex/vtex-orders.js\";\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { formatOrderDetails } from \"../../utils/format-order-details.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nconst MAX_ORDER_IDS = 50;\nconst MAX_CONCURRENT_REQUESTS = 10;\nconst MAX_RETRIES_PER_ORDER = 2;\n\nexport const orderDetailsSchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  orderIds: z\n    .array(z.string().trim().min(3).describe(\"VTEX order identifier\"))\n    .min(1)\n    .max(MAX_ORDER_IDS)\n    .describe(\"List of VTEX order identifiers to fetch (up to 50 IDs)\"),\n  reason: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\"Optional reason for requesting unmasked PII data when required\"),\n});\n\nexport async function orderDetailsHandler({\n  profileId,\n  orderIds,\n  reason,\n}: z.infer<typeof orderDetailsSchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const uniqueOrderIds = Array.from(new Set(orderIds));\n    const batchResult = await getOrderDocumentsBatch(resolvedProfileId, uniqueOrderIds, {\n      reason,\n      maxConcurrency: MAX_CONCURRENT_REQUESTS,\n      maxRetries: MAX_RETRIES_PER_ORDER,\n    });\n    \n    const formattedOrders = batchResult.successful.map(({ document }) => formatOrderDetails(document));\n\n    return object(\n      stripNulls({\n        metadata: {\n          profile_id: resolvedProfileId,\n          requested: uniqueOrderIds.length,\n          successful: batchResult.successful.length,\n          failed: batchResult.failed.length,\n        },\n        schemas: {\n          item: [\"id\", \"ref\", \"name\", \"qty\", \"price\", \"list\"],\n          shipping: [\"carrier\", \"estimate\", \"delivery_date\"],\n          payment: [\"system\", \"installments\", \"value\"],\n          payment_validation: {\n            payments_total: \"Sum of all payment values\",\n            payment_delta: \"Difference between payments_total and order total\",\n            payment_mismatch: \"True if |payment_delta| > 0.5 (potential issue)\",\n          },\n        },\n        orders: formattedOrders,\n        failures: batchResult.failed.map((failure) => ({\n          order_id: failure.orderId,\n          message: failure.message,\n          status_code: failure.statusCode,\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, \"Failed to fetch order details batch\"));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,8BAA8B;AACvC,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AACnC,SAAS,kBAAkB;AAC3B,SAAS,qCAAqC;AAE9C,MAAM,gBAAgB;AACtB,MAAM,0BAA0B;AAChC,MAAM,wBAAwB;AAEvB,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,UAAU,EACP,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,uBAAuB,CAAC,EAChE,IAAI,CAAC,EACL,IAAI,aAAa,EACjB,SAAS,wDAAwD;AAAA,EACpE,QAAQ,EACL,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT,SAAS,gEAAgE;AAC9E,CAAC;AAED,eAAsB,oBAAoB;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF,GAAuC;AACrC,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,iBAAiB,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC;AACnD,UAAM,cAAc,MAAM,uBAAuB,mBAAmB,gBAAgB;AAAA,MAClF;AAAA,MACA,gBAAgB;AAAA,MAChB,YAAY;AAAA,IACd,CAAC;AAED,UAAM,kBAAkB,YAAY,WAAW,IAAI,CAAC,EAAE,SAAS,MAAM,mBAAmB,QAAQ,CAAC;AAEjG,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,UACR,YAAY;AAAA,UACZ,WAAW,eAAe;AAAA,UAC1B,YAAY,YAAY,WAAW;AAAA,UACnC,QAAQ,YAAY,OAAO;AAAA,QAC7B;AAAA,QACA,SAAS;AAAA,UACP,MAAM,CAAC,MAAM,OAAO,QAAQ,OAAO,SAAS,MAAM;AAAA,UAClD,UAAU,CAAC,WAAW,YAAY,eAAe;AAAA,UACjD,SAAS,CAAC,UAAU,gBAAgB,OAAO;AAAA,UAC3C,oBAAoB;AAAA,YAClB,gBAAgB;AAAA,YAChB,eAAe;AAAA,YACf,kBAAkB;AAAA,UACpB;AAAA,QACF;AAAA,QACA,QAAQ;AAAA,QACR,UAAU,YAAY,OAAO,IAAI,CAAC,aAAa;AAAA,UAC7C,UAAU,QAAQ;AAAA,UAClB,SAAS,QAAQ;AAAA,UACjB,aAAa,QAAQ;AAAA,QACvB,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,qCAAqC,CAAC;AAAA,EAC1E;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/orders-summary.js

@@ -7,6 +7,7 @@ import { moneyFromCents } from "../../utils/money.js";
 import { normalizeOrderStatus } from "../../utils/order-status.js";
 import { createPaginationMetadata } from "../../utils/pagination.js";
 import { stripNulls } from "../../utils/strip-payload.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
 const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
 function buildDateFilter(startDate, endDate) {
   return `creationDate:[${startDate}T00:00:00.000Z TO ${endDate}T23:59:59.999Z]`;
@@ -26,6 +27,9 @@ const metricsSchema = {
   breakdown: ["count", "revenue"]
 };
 const ordersSummarySchema = z.object({
+  profileId: z.string().trim().min(1).optional().describe(
+    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
+  ),
   startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format"),
   endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format"),
   page: z.number().int().min(1).max(30).optional().describe("Page number (1-30)"),
@@ -38,9 +42,14 @@ const ordersSummarySchema = z.object({
 });
 async function ordersSummaryHandler(params) {
   try {
+    const profileResolution = await resolveVtexProfileOrSelection(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
     const page = params.page ?? 1;
     const perPage = params.perPage ?? 100;
-    const ordersResponse = await listOrders({
+    const ordersResponse = await listOrders(profileId, {
       page,
       per_page: perPage,
       orderBy: params.orderBy,
@@ -66,6 +75,7 @@ async function ordersSummaryHandler(params) {
     return object(
       stripNulls({
         metadata,
+        profile_id: profileId,
         metrics_schema: metricsSchema,
         metrics,
         orders_schema: ordersSchema,

package/dist/src/tools/vtex/orders-summary.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/orders-summary.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { listOrders } from \"../../services/vtex/vtex-orders.js\";\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { buildCurrencyMetrics } from \"../../utils/currency.js\";\nimport { moneyFromCents } from \"../../utils/money.js\";\nimport { normalizeOrderStatus } from \"../../utils/order-status.js\";\nimport { createPaginationMetadata } from \"../../utils/pagination.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nfunction buildDateFilter(startDate: string, endDate: string): string {\n  return `creationDate:[${startDate}T00:00:00.000Z TO ${endDate}T23:59:59.999Z]`;\n}\n\nfunction formatCompactDate(dateTime?: string): string {\n  if (!dateTime) {\n    return \"\";\n  }\n\n  const match = dateTime.match(/^(\\d{4}-\\d{2}-\\d{2})T(\\d{2}:\\d{2})/);\n  if (!match) {\n    return dateTime;\n  }\n\n  return `${match[1]} ${match[2]}`;\n}\n\nconst ordersSchema = [\"id\", \"date\", \"status\", \"value\", \"currency\", \"payment\", \"channel\", \"items\"] as const;\nconst metricsSchema = {\n  breakdown: [\"count\", \"revenue\"] as const,\n};\n\nexport const ordersSummarySchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format\"),\n  page: z.number().int().min(1).max(30).optional().describe(\"Page number (1-30)\"),\n  perPage: z.number().int().min(1).max(100).optional().describe(\"Orders per page (1-100)\"),\n  status: z.string().optional().describe(\"Optional VTEX status filter (f_status)\"),\n  salesChannel: z.string().optional().describe(\"Optional sales channel filter (f_salesChannel)\"),\n  paymentName: z.string().optional().describe(\"Optional payment filter (f_paymentNames)\"),\n  utmSource: z.string().optional().describe(\"Optional UTM source filter (f_UtmSource)\"),\n  orderBy: z\n    .string()\n    .optional()\n    .describe(\"Sort order in VTEX format, e.g. creationDate,desc\"),\n});\n\nexport async function ordersSummaryHandler(params: z.infer<typeof ordersSummarySchema>) {\n  try {\n    const page = params.page ?? 1;\n    const perPage = params.perPage ?? 100;\n\n    const ordersResponse = await listOrders({\n      page,\n      per_page: perPage,\n      orderBy: params.orderBy,\n      f_creationDate: buildDateFilter(params.startDate, params.endDate),\n      f_status: params.status,\n      f_salesChannel: params.salesChannel,\n      f_paymentNames: params.paymentName,\n      f_UtmSource: params.utmSource,\n    });\n\n    const orders = Array.isArray(ordersResponse.list) ? ordersResponse.list : [];\n    const metadata = createPaginationMetadata(ordersResponse.paging ?? {}, perPage, orders.length);\n    const metrics = buildCurrencyMetrics(orders);\n    const compactOrders = orders.map((order) => [\n      order.orderId,\n      formatCompactDate(order.creationDate),\n      normalizeOrderStatus(order.status),\n      moneyFromCents(order.totalValue),\n      order.currencyCode ?? \"\",\n      order.paymentNames ?? \"\",\n      order.salesChannel ?? \"\",\n      Number(order.totalItems ?? 0),\n    ]);\n\n    return object(\n      stripNulls({\n        metadata,\n        metrics_schema: metricsSchema,\n        metrics,\n        orders_schema: ordersSchema,\n        orders: compactOrders,\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, \"Failed to fetch orders summary\"));\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { listOrders } from \"../../services/vtex/vtex-orders.js\";\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { buildCurrencyMetrics } from \"../../utils/currency.js\";\nimport { moneyFromCents } from \"../../utils/money.js\";\nimport { normalizeOrderStatus } from \"../../utils/order-status.js\";\nimport { createPaginationMetadata } from \"../../utils/pagination.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nconst dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nfunction buildDateFilter(startDate: string, endDate: string): string {\n  return `creationDate:[${startDate}T00:00:00.000Z TO ${endDate}T23:59:59.999Z]`;\n}\n\nfunction formatCompactDate(dateTime?: string): string {\n  if (!dateTime) {\n    return \"\";\n  }\n\n  const match = dateTime.match(/^(\\d{4}-\\d{2}-\\d{2})T(\\d{2}:\\d{2})/);\n  if (!match) {\n    return dateTime;\n  }\n\n  return `${match[1]} ${match[2]}`;\n}\n\nconst ordersSchema = [\"id\", \"date\", \"status\", \"value\", \"currency\", \"payment\", \"channel\", \"items\"] as const;\nconst metricsSchema = {\n  breakdown: [\"count\", \"revenue\"] as const,\n};\n\nexport const ordersSummarySchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format\"),\n  page: z.number().int().min(1).max(30).optional().describe(\"Page number (1-30)\"),\n  perPage: z.number().int().min(1).max(100).optional().describe(\"Orders per page (1-100)\"),\n  status: z.string().optional().describe(\"Optional VTEX status filter (f_status)\"),\n  salesChannel: z.string().optional().describe(\"Optional sales channel filter (f_salesChannel)\"),\n  paymentName: z.string().optional().describe(\"Optional payment filter (f_paymentNames)\"),\n  utmSource: z.string().optional().describe(\"Optional UTM source filter (f_UtmSource)\"),\n  orderBy: z\n    .string()\n    .optional()\n    .describe(\"Sort order in VTEX format, e.g. creationDate,desc\"),\n});\n\nexport async function ordersSummaryHandler(params: z.infer<typeof ordersSummarySchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const page = params.page ?? 1;\n    const perPage = params.perPage ?? 100;\n\n    const ordersResponse = await listOrders(profileId, {\n      page,\n      per_page: perPage,\n      orderBy: params.orderBy,\n      f_creationDate: buildDateFilter(params.startDate, params.endDate),\n      f_status: params.status,\n      f_salesChannel: params.salesChannel,\n      f_paymentNames: params.paymentName,\n      f_UtmSource: params.utmSource,\n    });\n\n    const orders = Array.isArray(ordersResponse.list) ? ordersResponse.list : [];\n    const metadata = createPaginationMetadata(ordersResponse.paging ?? {}, perPage, orders.length);\n    const metrics = buildCurrencyMetrics(orders);\n    const compactOrders = orders.map((order) => [\n      order.orderId,\n      formatCompactDate(order.creationDate),\n      normalizeOrderStatus(order.status),\n      moneyFromCents(order.totalValue),\n      order.currencyCode ?? \"\",\n      order.paymentNames ?? \"\",\n      order.salesChannel ?? \"\",\n      Number(order.totalItems ?? 0),\n    ]);\n\n    return object(\n      stripNulls({\n        metadata,\n        profile_id: profileId,\n        metrics_schema: metricsSchema,\n        metrics,\n        orders_schema: ordersSchema,\n        orders: compactOrders,\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, \"Failed to fetch orders summary\"));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,kBAAkB;AAC3B,SAAS,uBAAuB;AAChC,SAAS,4BAA4B;AACrC,SAAS,sBAAsB;AAC/B,SAAS,4BAA4B;AACrC,SAAS,gCAAgC;AACzC,SAAS,kBAAkB;AAC3B,SAAS,qCAAqC;AAE9C,MAAM,YAAY;AAElB,SAAS,gBAAgB,WAAmB,SAAyB;AACnE,SAAO,iBAAiB,SAAS,qBAAqB,OAAO;AAC/D;AAEA,SAAS,kBAAkB,UAA2B;AACpD,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,SAAS,MAAM,oCAAoC;AACjE,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,SAAO,GAAG,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;AAChC;AAEA,MAAM,eAAe,CAAC,MAAM,QAAQ,UAAU,SAAS,YAAY,WAAW,WAAW,OAAO;AAChG,MAAM,gBAAgB;AAAA,EACpB,WAAW,CAAC,SAAS,SAAS;AAChC;AAEO,MAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,iCAAiC;AAAA,EACjF,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,+BAA+B;AAAA,EAC7E,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,oBAAoB;AAAA,EAC9E,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,yBAAyB;AAAA,EACvF,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,wCAAwC;AAAA,EAC/E,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,gDAAgD;AAAA,EAC7F,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,0CAA0C;AAAA,EACtF,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,0CAA0C;AAAA,EACpF,SAAS,EACN,OAAO,EACP,SAAS,EACT,SAAS,mDAAmD;AACjE,CAAC;AAED,eAAsB,qBAAqB,QAA6C;AACtF,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,OAAO,SAAS;AAC9E,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,YAAY,kBAAkB,MAAM;AAC1C,UAAM,OAAO,OAAO,QAAQ;AAC5B,UAAM,UAAU,OAAO,WAAW;AAElC,UAAM,iBAAiB,MAAM,WAAW,WAAW;AAAA,MACjD;AAAA,MACA,UAAU;AAAA,MACV,SAAS,OAAO;AAAA,MAChB,gBAAgB,gBAAgB,OAAO,WAAW,OAAO,OAAO;AAAA,MAChE,UAAU,OAAO;AAAA,MACjB,gBAAgB,OAAO;AAAA,MACvB,gBAAgB,OAAO;AAAA,MACvB,aAAa,OAAO;AAAA,IACtB,CAAC;AAED,UAAM,SAAS,MAAM,QAAQ,eAAe,IAAI,IAAI,eAAe,OAAO,CAAC;AAC3E,UAAM,WAAW,yBAAyB,eAAe,UAAU,CAAC,GAAG,SAAS,OAAO,MAAM;AAC7F,UAAM,UAAU,qBAAqB,MAAM;AAC3C,UAAM,gBAAgB,OAAO,IAAI,CAAC,UAAU;AAAA,MAC1C,MAAM;AAAA,MACN,kBAAkB,MAAM,YAAY;AAAA,MACpC,qBAAqB,MAAM,MAAM;AAAA,MACjC,eAAe,MAAM,UAAU;AAAA,MAC/B,MAAM,gBAAgB;AAAA,MACtB,MAAM,gBAAgB;AAAA,MACtB,MAAM,gBAAgB;AAAA,MACtB,OAAO,MAAM,cAAc,CAAC;AAAA,IAC9B,CAAC;AAED,WAAO;AAAA,MACL,WAAW;AAAA,QACT;AAAA,QACA,YAAY;AAAA,QACZ,gBAAgB;AAAA,QAChB;AAAA,QACA,eAAe;AAAA,QACf,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,gCAAgC,CAAC;AAAA,EACrE;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/product-offers.js

@@ -4,15 +4,28 @@ import { formatVtexError } from "../../services/vtex/vtex-api.js";
 import { getProductOffers } from "../../services/vtex/vtex-catalog.js";
 import { toSnakeCaseKeys } from "../../utils/case-conversion.js";
 import { stripNulls } from "../../utils/strip-payload.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
 const productOffersSchema = z.object({
+  profileId: z.string().trim().min(1).optional().describe(
+    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
+  ),
   productId: z.string().min(1).describe("Product identifier")
 });
-async function productOffersHandler({ productId }) {
+async function productOffersHandler({
+  profileId,
+  productId
+}) {
   try {
-    const offers = await getProductOffers(productId);
+    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const offers = await getProductOffers(resolvedProfileId, productId);
     const normalizedOffers = toSnakeCaseKeys(offers);
     return object(
       stripNulls({
+        profile_id: resolvedProfileId,
         product_id: productId,
         offers: normalizedOffers
       })

package/dist/src/tools/vtex/product-offers.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/product-offers.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getProductOffers } from \"../../services/vtex/vtex-catalog.js\";\nimport { toSnakeCaseKeys } from \"../../utils/case-conversion.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const productOffersSchema = z.object({\n  productId: z.string().min(1).describe(\"Product identifier\"),\n});\n\nexport async function productOffersHandler({ productId }: z.infer<typeof productOffersSchema>) {\n  try {\n    const offers = await getProductOffers(productId);\n    const normalizedOffers = toSnakeCaseKeys(offers);\n\n    return object(\n      stripNulls({\n        product_id: productId,\n        offers: normalizedOffers,\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, `Failed to fetch product offers for ${productId}`));\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,oBAAoB;AAC5D,CAAC;AAED,eAAsB,qBAAqB,EAAE,UAAU,GAAwC;AAC7F,MAAI;AACF,UAAM,SAAS,MAAM,iBAAiB,SAAS;AAC/C,UAAM,mBAAmB,gBAAgB,MAAM;AAE/C,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,sCAAsC,SAAS,EAAE,CAAC;AAAA,EACtF;AACF;",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getProductOffers } from \"../../services/vtex/vtex-catalog.js\";\nimport { toSnakeCaseKeys } from \"../../utils/case-conversion.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const productOffersSchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  productId: z.string().min(1).describe(\"Product identifier\"),\n});\n\nexport async function productOffersHandler({\n  profileId,\n  productId,\n}: z.infer<typeof productOffersSchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const offers = await getProductOffers(resolvedProfileId, productId);\n    const normalizedOffers = toSnakeCaseKeys(offers);\n\n    return object(\n      stripNulls({\n        profile_id: resolvedProfileId,\n        product_id: productId,\n        offers: normalizedOffers,\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, `Failed to fetch product offers for ${productId}`));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAC3B,SAAS,qCAAqC;AAEvC,MAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,oBAAoB;AAC5D,CAAC;AAED,eAAsB,qBAAqB;AAAA,EACzC;AAAA,EACA;AACF,GAAwC;AACtC,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,SAAS,MAAM,iBAAiB,mBAAmB,SAAS;AAClE,UAAM,mBAAmB,gBAAgB,MAAM;AAE/C,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,sCAAsC,SAAS,EAAE,CAAC;AAAA,EACtF;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/profile-resolution.js

@@ -0,0 +1,57 @@
+import { object } from "mcp-use/server";
+import { getProfile, listProfiles } from "../../config/profile-store.js";
+function buildSelectionMessage(reason, profileId) {
+  switch (reason) {
+    case "missing_profile":
+      return "VTEX requiere seleccion explicita de profileId. Reenviar la misma tool con uno de los perfiles activos disponibles.";
+    case "profile_not_found":
+      return `El profileId "${profileId}" no existe. Reenviar la misma tool con uno de los perfiles activos disponibles.`;
+    case "profile_inactive":
+      return `El profileId "${profileId}" esta inactivo. Reenviar la misma tool con uno de los perfiles activos disponibles.`;
+  }
+}
+async function resolveVtexProfileOrSelection(profileId) {
+  const requestedProfileId = profileId?.trim();
+  if (!requestedProfileId) {
+    return {
+      ok: false,
+      response: await buildSelectionResponse("missing_profile")
+    };
+  }
+  const profile = await getProfile(requestedProfileId);
+  if (!profile) {
+    return {
+      ok: false,
+      response: await buildSelectionResponse("profile_not_found", requestedProfileId)
+    };
+  }
+  if (!profile.isActive) {
+    return {
+      ok: false,
+      response: await buildSelectionResponse("profile_inactive", requestedProfileId)
+    };
+  }
+  return {
+    ok: true,
+    value: {
+      profileId: profile.id
+    }
+  };
+}
+async function buildSelectionResponse(reason, profileId) {
+  const profiles = await listProfiles();
+  const availableProfiles = profiles.filter((profile) => profile.isActive).map((profile) => ({
+    profile_id: profile.id,
+    name: profile.name
+  }));
+  return object({
+    selection_required: true,
+    reason,
+    message: buildSelectionMessage(reason, profileId),
+    available_profiles: availableProfiles
+  });
+}
+export {
+  resolveVtexProfileOrSelection
+};
+//# sourceMappingURL=profile-resolution.js.map

package/dist/src/tools/vtex/profile-resolution.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/profile-resolution.ts"],
+  "sourcesContent": ["import { object } from \"mcp-use/server\";\n\nimport { getProfile, listProfiles } from \"../../config/profile-store.js\";\n\nexport type VtexProfileSelectionReason =\n  | \"missing_profile\"\n  | \"profile_not_found\"\n  | \"profile_inactive\";\n\nexport interface ResolvedVtexProfile {\n  profileId: string;\n}\n\ninterface VtexProfileSelectionPayload extends Record<string, unknown> {\n  selection_required: boolean;\n  reason: VtexProfileSelectionReason;\n  message: string;\n  available_profiles: Array<{\n    profile_id: string;\n    name: string;\n  }>;\n}\n\nfunction buildSelectionMessage(reason: VtexProfileSelectionReason, profileId?: string): string {\n  switch (reason) {\n    case \"missing_profile\":\n      return \"VTEX requiere seleccion explicita de profileId. Reenviar la misma tool con uno de los perfiles activos disponibles.\";\n    case \"profile_not_found\":\n      return `El profileId \"${profileId}\" no existe. Reenviar la misma tool con uno de los perfiles activos disponibles.`;\n    case \"profile_inactive\":\n      return `El profileId \"${profileId}\" esta inactivo. Reenviar la misma tool con uno de los perfiles activos disponibles.`;\n  }\n}\n\nexport async function resolveVtexProfileOrSelection(\n  profileId?: string\n): Promise<\n  | { ok: true; value: ResolvedVtexProfile }\n  | { ok: false; response: ReturnType<typeof object<Record<string, unknown>>> }\n> {\n  const requestedProfileId = profileId?.trim();\n\n  if (!requestedProfileId) {\n    return {\n      ok: false,\n      response: await buildSelectionResponse(\"missing_profile\"),\n    };\n  }\n\n  const profile = await getProfile(requestedProfileId);\n  if (!profile) {\n    return {\n      ok: false,\n      response: await buildSelectionResponse(\"profile_not_found\", requestedProfileId),\n    };\n  }\n\n  if (!profile.isActive) {\n    return {\n      ok: false,\n      response: await buildSelectionResponse(\"profile_inactive\", requestedProfileId),\n    };\n  }\n\n  return {\n    ok: true,\n    value: {\n      profileId: profile.id,\n    },\n  };\n}\n\nasync function buildSelectionResponse(\n  reason: VtexProfileSelectionReason,\n  profileId?: string\n) {\n  const profiles = await listProfiles();\n  const availableProfiles = profiles\n    .filter((profile) => profile.isActive)\n    .map((profile) => ({\n      profile_id: profile.id,\n      name: profile.name,\n    }));\n\n  return object({\n    selection_required: true,\n    reason,\n    message: buildSelectionMessage(reason, profileId),\n    available_profiles: availableProfiles,\n  });\n}\n"],
+  "mappings": "AAAA,SAAS,cAAc;AAEvB,SAAS,YAAY,oBAAoB;AAqBzC,SAAS,sBAAsB,QAAoC,WAA4B;AAC7F,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,iBAAiB,SAAS;AAAA,IACnC,KAAK;AACH,aAAO,iBAAiB,SAAS;AAAA,EACrC;AACF;AAEA,eAAsB,8BACpB,WAIA;AACA,QAAM,qBAAqB,WAAW,KAAK;AAE3C,MAAI,CAAC,oBAAoB;AACvB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,UAAU,MAAM,uBAAuB,iBAAiB;AAAA,IAC1D;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,WAAW,kBAAkB;AACnD,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,UAAU,MAAM,uBAAuB,qBAAqB,kBAAkB;AAAA,IAChF;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ,UAAU;AACrB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,UAAU,MAAM,uBAAuB,oBAAoB,kBAAkB;AAAA,IAC/E;AAAA,EACF;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,WAAW,QAAQ;AAAA,IACrB;AAAA,EACF;AACF;AAEA,eAAe,uBACb,QACA,WACA;AACA,QAAM,WAAW,MAAM,aAAa;AACpC,QAAM,oBAAoB,SACvB,OAAO,CAAC,YAAY,QAAQ,QAAQ,EACpC,IAAI,CAAC,aAAa;AAAA,IACjB,YAAY,QAAQ;AAAA,IACpB,MAAM,QAAQ;AAAA,EAChB,EAAE;AAEJ,SAAO,OAAO;AAAA,IACZ,oBAAoB;AAAA,IACpB;AAAA,IACA,SAAS,sBAAsB,QAAQ,SAAS;AAAA,IAChD,oBAAoB;AAAA,EACtB,CAAC;AACH;",
+  "names": []
+}

package/dist/src/tools/vtex/sku-offers.js

@@ -4,16 +4,30 @@ import { formatVtexError } from "../../services/vtex/vtex-api.js";
 import { getSkuOffers } from "../../services/vtex/vtex-catalog.js";
 import { toSnakeCaseKeys } from "../../utils/case-conversion.js";
 import { stripNulls } from "../../utils/strip-payload.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
 const skuOffersSchema = z.object({
+  profileId: z.string().trim().min(1).optional().describe(
+    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
+  ),
   productId: z.string().min(1).describe("Product identifier"),
   skuId: z.string().min(1).describe("SKU identifier")
 });
-async function skuOffersHandler({ productId, skuId }) {
+async function skuOffersHandler({
+  profileId,
+  productId,
+  skuId
+}) {
   try {
-    const offers = await getSkuOffers(productId, skuId);
+    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const offers = await getSkuOffers(resolvedProfileId, productId, skuId);
     const normalizedOffers = toSnakeCaseKeys(offers);
     return object(
       stripNulls({
+        profile_id: resolvedProfileId,
         product_id: productId,
         sku_id: skuId,
         offers: normalizedOffers

package/dist/src/tools/vtex/sku-offers.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/sku-offers.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getSkuOffers } from \"../../services/vtex/vtex-catalog.js\";\nimport { toSnakeCaseKeys } from \"../../utils/case-conversion.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const skuOffersSchema = z.object({\n  productId: z.string().min(1).describe(\"Product identifier\"),\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n});\n\nexport async function skuOffersHandler({ productId, skuId }: z.infer<typeof skuOffersSchema>) {\n  try {\n    const offers = await getSkuOffers(productId, skuId);\n    const normalizedOffers = toSnakeCaseKeys(offers);\n\n    return object(\n      stripNulls({\n        product_id: productId,\n        sku_id: skuId,\n        offers: normalizedOffers,\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, `Failed to fetch SKU offers for product ${productId} and sku ${skuId}`));\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,oBAAoB;AAAA,EAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AACpD,CAAC;AAED,eAAsB,iBAAiB,EAAE,WAAW,MAAM,GAAoC;AAC5F,MAAI;AACF,UAAM,SAAS,MAAM,aAAa,WAAW,KAAK;AAClD,UAAM,mBAAmB,gBAAgB,MAAM;AAE/C,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,0CAA0C,SAAS,YAAY,KAAK,EAAE,CAAC;AAAA,EAC3G;AACF;",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getSkuOffers } from \"../../services/vtex/vtex-catalog.js\";\nimport { toSnakeCaseKeys } from \"../../utils/case-conversion.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const skuOffersSchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  productId: z.string().min(1).describe(\"Product identifier\"),\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n});\n\nexport async function skuOffersHandler({\n  profileId,\n  productId,\n  skuId,\n}: z.infer<typeof skuOffersSchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const offers = await getSkuOffers(resolvedProfileId, productId, skuId);\n    const normalizedOffers = toSnakeCaseKeys(offers);\n\n    return object(\n      stripNulls({\n        profile_id: resolvedProfileId,\n        product_id: productId,\n        sku_id: skuId,\n        offers: normalizedOffers,\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, `Failed to fetch SKU offers for product ${productId} and sku ${skuId}`));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAC3B,SAAS,qCAAqC;AAEvC,MAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,oBAAoB;AAAA,EAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AACpD,CAAC;AAED,eAAsB,iBAAiB;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AACF,GAAoC;AAClC,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,SAAS,MAAM,aAAa,mBAAmB,WAAW,KAAK;AACrE,UAAM,mBAAmB,gBAAgB,MAAM;AAE/C,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,0CAA0C,SAAS,YAAY,KAAK,EAAE,CAAC;AAAA,EAC3G;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/sku-price.js

@@ -4,14 +4,24 @@ import { formatVtexError } from "../../services/vtex/vtex-api.js";
 import { getSkuPrice } from "../../services/vtex/vtex-pricing.js";
 import { moneyFromCentsOptional } from "../../utils/money.js";
 import { stripNulls } from "../../utils/strip-payload.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
 const skuPriceSchema = z.object({
+  profileId: z.string().trim().min(1).optional().describe(
+    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
+  ),
   itemId: z.string().min(1).describe("SKU item identifier")
 });
-async function skuPriceHandler({ itemId }) {
+async function skuPriceHandler({ profileId, itemId }) {
   try {
-    const price = await getSkuPrice(itemId);
+    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const price = await getSkuPrice(resolvedProfileId, itemId);
     return object(
       stripNulls({
+        profile_id: resolvedProfileId,
         item_id: price.itemId,
         list_price: moneyFromCentsOptional(price.listPrice),
         cost_price: moneyFromCentsOptional(price.costPrice),

package/dist/src/tools/vtex/sku-price.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/sku-price.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getSkuPrice } from \"../../services/vtex/vtex-pricing.js\";\nimport { moneyFromCentsOptional } from \"../../utils/money.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const skuPriceSchema = z.object({\n  itemId: z.string().min(1).describe(\"SKU item identifier\"),\n});\n\nexport async function skuPriceHandler({ itemId }: z.infer<typeof skuPriceSchema>) {\n  try {\n    const price = await getSkuPrice(itemId);\n\n    return object(\n      stripNulls({\n        item_id: price.itemId,\n        list_price: moneyFromCentsOptional(price.listPrice),\n        cost_price: moneyFromCentsOptional(price.costPrice),\n        base_price: moneyFromCentsOptional(price.basePrice),\n        markup: price.markup,\n        fixed_prices: Array.isArray(price.fixedPrices)\n          ? price.fixedPrices.map((fixedPrice) =>\n              stripNulls({\n                min_quantity: fixedPrice.minQuantity,\n                trade_policy_id: fixedPrice.tradePolicyId,\n                date_range: fixedPrice.dateRange\n                  ? {\n                      from: fixedPrice.dateRange.from,\n                      to: fixedPrice.dateRange.to,\n                    }\n                  : undefined,\n                value: moneyFromCentsOptional(fixedPrice.value),\n                list_price: moneyFromCentsOptional(fixedPrice.listPrice),\n              })\n            )\n          : undefined,\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, `Failed to fetch SKU price for item ${itemId}`));\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAC5B,SAAS,8BAA8B;AACvC,SAAS,kBAAkB;AAEpB,MAAM,iBAAiB,EAAE,OAAO;AAAA,EACrC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,qBAAqB;AAC1D,CAAC;AAED,eAAsB,gBAAgB,EAAE,OAAO,GAAmC;AAChF,MAAI;AACF,UAAM,QAAQ,MAAM,YAAY,MAAM;AAEtC,WAAO;AAAA,MACL,WAAW;AAAA,QACT,SAAS,MAAM;AAAA,QACf,YAAY,uBAAuB,MAAM,SAAS;AAAA,QAClD,YAAY,uBAAuB,MAAM,SAAS;AAAA,QAClD,YAAY,uBAAuB,MAAM,SAAS;AAAA,QAClD,QAAQ,MAAM;AAAA,QACd,cAAc,MAAM,QAAQ,MAAM,WAAW,IACzC,MAAM,YAAY;AAAA,UAAI,CAAC,eACrB,WAAW;AAAA,YACT,cAAc,WAAW;AAAA,YACzB,iBAAiB,WAAW;AAAA,YAC5B,YAAY,WAAW,YACnB;AAAA,cACE,MAAM,WAAW,UAAU;AAAA,cAC3B,IAAI,WAAW,UAAU;AAAA,YAC3B,IACA;AAAA,YACJ,OAAO,uBAAuB,WAAW,KAAK;AAAA,YAC9C,YAAY,uBAAuB,WAAW,SAAS;AAAA,UACzD,CAAC;AAAA,QACH,IACA;AAAA,MACN,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,sCAAsC,MAAM,EAAE,CAAC;AAAA,EACnF;AACF;",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getSkuPrice } from \"../../services/vtex/vtex-pricing.js\";\nimport { moneyFromCentsOptional } from \"../../utils/money.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const skuPriceSchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  itemId: z.string().min(1).describe(\"SKU item identifier\"),\n});\n\nexport async function skuPriceHandler({ profileId, itemId }: z.infer<typeof skuPriceSchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const price = await getSkuPrice(resolvedProfileId, itemId);\n\n    return object(\n      stripNulls({\n        profile_id: resolvedProfileId,\n        item_id: price.itemId,\n        list_price: moneyFromCentsOptional(price.listPrice),\n        cost_price: moneyFromCentsOptional(price.costPrice),\n        base_price: moneyFromCentsOptional(price.basePrice),\n        markup: price.markup,\n        fixed_prices: Array.isArray(price.fixedPrices)\n          ? price.fixedPrices.map((fixedPrice) =>\n              stripNulls({\n                min_quantity: fixedPrice.minQuantity,\n                trade_policy_id: fixedPrice.tradePolicyId,\n                date_range: fixedPrice.dateRange\n                  ? {\n                      from: fixedPrice.dateRange.from,\n                      to: fixedPrice.dateRange.to,\n                    }\n                  : undefined,\n                value: moneyFromCentsOptional(fixedPrice.value),\n                list_price: moneyFromCentsOptional(fixedPrice.listPrice),\n              })\n            )\n          : undefined,\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, `Failed to fetch SKU price for item ${itemId}`));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAC5B,SAAS,8BAA8B;AACvC,SAAS,kBAAkB;AAC3B,SAAS,qCAAqC;AAEvC,MAAM,iBAAiB,EAAE,OAAO;AAAA,EACrC,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,qBAAqB;AAC1D,CAAC;AAED,eAAsB,gBAAgB,EAAE,WAAW,OAAO,GAAmC;AAC3F,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,QAAQ,MAAM,YAAY,mBAAmB,MAAM;AAEzD,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,SAAS,MAAM;AAAA,QACf,YAAY,uBAAuB,MAAM,SAAS;AAAA,QAClD,YAAY,uBAAuB,MAAM,SAAS;AAAA,QAClD,YAAY,uBAAuB,MAAM,SAAS;AAAA,QAClD,QAAQ,MAAM;AAAA,QACd,cAAc,MAAM,QAAQ,MAAM,WAAW,IACzC,MAAM,YAAY;AAAA,UAAI,CAAC,eACrB,WAAW;AAAA,YACT,cAAc,WAAW;AAAA,YACzB,iBAAiB,WAAW;AAAA,YAC5B,YAAY,WAAW,YACnB;AAAA,cACE,MAAM,WAAW,UAAU;AAAA,cAC3B,IAAI,WAAW,UAAU;AAAA,YAC3B,IACA;AAAA,YACJ,OAAO,uBAAuB,WAAW,KAAK;AAAA,YAC9C,YAAY,uBAAuB,WAAW,SAAS;AAAA,UACzD,CAAC;AAAA,QACH,IACA;AAAA,MACN,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,sCAAsC,MAAM,EAAE,CAAC;AAAA,EACnF;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/update-inventory.js

@@ -2,7 +2,11 @@ import { error, object } from "mcp-use/server";
 import { z } from "zod";
 import { formatVtexError } from "../../services/vtex/vtex-api.js";
 import { updateInventoryQuantity } from "../../services/vtex/vtex-logistics.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
 const updateInventorySchema = z.object({
+  profileId: z.string().trim().min(1).optional().describe(
+    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
+  ),
   skuId: z.string().min(1).describe("SKU identifier"),
   warehouseId: z.string().min(1).describe("Warehouse identifier"),
   quantity: z.number().int().min(0).describe("Inventory quantity to set"),
@@ -10,6 +14,7 @@ const updateInventorySchema = z.object({
   dateUtcOnBalanceSystem: z.string().optional().describe("Optional UTC timestamp for inventory update synchronization")
 });
 async function updateInventoryHandler({
+  profileId,
   skuId,
   warehouseId,
   quantity,
@@ -17,13 +22,19 @@ async function updateInventoryHandler({
   dateUtcOnBalanceSystem
 }) {
   try {
-    await updateInventoryQuantity(skuId, warehouseId, {
+    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    await updateInventoryQuantity(resolvedProfileId, skuId, warehouseId, {
       quantity,
       unlimitedQuantity,
       dateUtcOnBalanceSystem
     });
     return object({
       success: true,
+      profile_id: resolvedProfileId,
       sku_id: skuId,
       warehouse_id: warehouseId,
       quantity,

package/dist/src/tools/vtex/update-inventory.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/update-inventory.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { updateInventoryQuantity } from \"../../services/vtex/vtex-logistics.js\";\n\nexport const updateInventorySchema = z.object({\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier\"),\n  quantity: z.number().int().min(0).describe(\"Inventory quantity to set\"),\n  unlimitedQuantity: z\n    .boolean()\n    .describe(\"When true, SKU remains available regardless of stock quantity\"),\n  dateUtcOnBalanceSystem: z\n    .string()\n    .optional()\n    .describe(\"Optional UTC timestamp for inventory update synchronization\"),\n});\n\nexport async function updateInventoryHandler({\n  skuId,\n  warehouseId,\n  quantity,\n  unlimitedQuantity,\n  dateUtcOnBalanceSystem,\n}: z.infer<typeof updateInventorySchema>) {\n  try {\n    await updateInventoryQuantity(skuId, warehouseId, {\n      quantity,\n      unlimitedQuantity,\n      dateUtcOnBalanceSystem,\n    });\n\n    return object({\n      success: true,\n      sku_id: skuId,\n      warehouse_id: warehouseId,\n      quantity,\n      unlimited_quantity: unlimitedQuantity,\n      message: \"Inventory quantity updated successfully\",\n    });\n  } catch (err) {\n    return error(\n      formatVtexError(err, `Failed to update inventory quantity for SKU ${skuId} in ${warehouseId}`)\n    );\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AAEjC,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAAA,EAC9D,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,2BAA2B;AAAA,EACtE,mBAAmB,EAChB,QAAQ,EACR,SAAS,+DAA+D;AAAA,EAC3E,wBAAwB,EACrB,OAAO,EACP,SAAS,EACT,SAAS,6DAA6D;AAC3E,CAAC;AAED,eAAsB,uBAAuB;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA0C;AACxC,MAAI;AACF,UAAM,wBAAwB,OAAO,aAAa;AAAA,MAChD;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO,OAAO;AAAA,MACZ,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,cAAc;AAAA,MACd;AAAA,MACA,oBAAoB;AAAA,MACpB,SAAS;AAAA,IACX,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,gBAAgB,KAAK,+CAA+C,KAAK,OAAO,WAAW,EAAE;AAAA,IAC/F;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { updateInventoryQuantity } from \"../../services/vtex/vtex-logistics.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const updateInventorySchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier\"),\n  quantity: z.number().int().min(0).describe(\"Inventory quantity to set\"),\n  unlimitedQuantity: z\n    .boolean()\n    .describe(\"When true, SKU remains available regardless of stock quantity\"),\n  dateUtcOnBalanceSystem: z\n    .string()\n    .optional()\n    .describe(\"Optional UTC timestamp for inventory update synchronization\"),\n});\n\nexport async function updateInventoryHandler({\n  profileId,\n  skuId,\n  warehouseId,\n  quantity,\n  unlimitedQuantity,\n  dateUtcOnBalanceSystem,\n}: z.infer<typeof updateInventorySchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n\n    await updateInventoryQuantity(resolvedProfileId, skuId, warehouseId, {\n      quantity,\n      unlimitedQuantity,\n      dateUtcOnBalanceSystem,\n    });\n\n    return object({\n      success: true,\n      profile_id: resolvedProfileId,\n      sku_id: skuId,\n      warehouse_id: warehouseId,\n      quantity,\n      unlimited_quantity: unlimitedQuantity,\n      message: \"Inventory quantity updated successfully\",\n    });\n  } catch (err) {\n    return error(\n      formatVtexError(err, `Failed to update inventory quantity for SKU ${skuId} in ${warehouseId}`)\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AACxC,SAAS,qCAAqC;AAEvC,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAAA,EAC9D,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,2BAA2B;AAAA,EACtE,mBAAmB,EAChB,QAAQ,EACR,SAAS,+DAA+D;AAAA,EAC3E,wBAAwB,EACrB,OAAO,EACP,SAAS,EACT,SAAS,6DAA6D;AAC3E,CAAC;AAED,eAAsB,uBAAuB;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA0C;AACxC,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAElD,UAAM,wBAAwB,mBAAmB,OAAO,aAAa;AAAA,MACnE;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO,OAAO;AAAA,MACZ,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,QAAQ;AAAA,MACR,cAAc;AAAA,MACd;AAAA,MACA,oBAAoB;AAAA,MACpB,SAAS;AAAA,IACX,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,gBAAgB,KAAK,+CAA+C,KAAK,OAAO,WAAW,EAAE;AAAA,IAC/F;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/update-lead-time.js

@@ -2,20 +2,31 @@ import { error, object } from "mcp-use/server";
 import { z } from "zod";
 import { formatVtexError } from "../../services/vtex/vtex-api.js";
 import { updateInventoryLeadTime } from "../../services/vtex/vtex-logistics.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
 const updateLeadTimeSchema = z.object({
+  profileId: z.string().trim().min(1).optional().describe(
+    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
+  ),
   skuId: z.string().min(1).describe("SKU identifier"),
   warehouseId: z.string().min(1).describe("Warehouse identifier"),
   leadTime: z.string().min(1).describe("Lead time value for the SKU in VTEX expected format (e.g. 1.00:00:00)")
 });
 async function updateLeadTimeHandler({
+  profileId,
   skuId,
   warehouseId,
   leadTime
 }) {
   try {
-    await updateInventoryLeadTime(skuId, warehouseId, { leadTime });
+    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    await updateInventoryLeadTime(resolvedProfileId, skuId, warehouseId, { leadTime });
     return object({
       success: true,
+      profile_id: resolvedProfileId,
       sku_id: skuId,
       warehouse_id: warehouseId,
       lead_time: leadTime,

package/dist/src/tools/vtex/update-lead-time.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/update-lead-time.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { updateInventoryLeadTime } from \"../../services/vtex/vtex-logistics.js\";\n\nexport const updateLeadTimeSchema = z.object({\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier\"),\n  leadTime: z\n    .string()\n    .min(1)\n    .describe(\"Lead time value for the SKU in VTEX expected format (e.g. 1.00:00:00)\"),\n});\n\nexport async function updateLeadTimeHandler({\n  skuId,\n  warehouseId,\n  leadTime,\n}: z.infer<typeof updateLeadTimeSchema>) {\n  try {\n    await updateInventoryLeadTime(skuId, warehouseId, { leadTime });\n\n    return object({\n      success: true,\n      sku_id: skuId,\n      warehouse_id: warehouseId,\n      lead_time: leadTime,\n      message: \"Lead time updated successfully\",\n    });\n  } catch (err) {\n    return error(formatVtexError(err, `Failed to update lead time for SKU ${skuId} in ${warehouseId}`));\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AAEjC,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAAA,EAC9D,UAAU,EACP,OAAO,EACP,IAAI,CAAC,EACL,SAAS,uEAAuE;AACrF,CAAC;AAED,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AACF,GAAyC;AACvC,MAAI;AACF,UAAM,wBAAwB,OAAO,aAAa,EAAE,SAAS,CAAC;AAE9D,WAAO,OAAO;AAAA,MACZ,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,cAAc;AAAA,MACd,WAAW;AAAA,MACX,SAAS;AAAA,IACX,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,sCAAsC,KAAK,OAAO,WAAW,EAAE,CAAC;AAAA,EACpG;AACF;",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { updateInventoryLeadTime } from \"../../services/vtex/vtex-logistics.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const updateLeadTimeSchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier\"),\n  leadTime: z\n    .string()\n    .min(1)\n    .describe(\"Lead time value for the SKU in VTEX expected format (e.g. 1.00:00:00)\"),\n});\n\nexport async function updateLeadTimeHandler({\n  profileId,\n  skuId,\n  warehouseId,\n  leadTime,\n}: z.infer<typeof updateLeadTimeSchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    await updateInventoryLeadTime(resolvedProfileId, skuId, warehouseId, { leadTime });\n\n    return object({\n      success: true,\n      profile_id: resolvedProfileId,\n      sku_id: skuId,\n      warehouse_id: warehouseId,\n      lead_time: leadTime,\n      message: \"Lead time updated successfully\",\n    });\n  } catch (err) {\n    return error(formatVtexError(err, `Failed to update lead time for SKU ${skuId} in ${warehouseId}`));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AACxC,SAAS,qCAAqC;AAEvC,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAAA,EAC9D,UAAU,EACP,OAAO,EACP,IAAI,CAAC,EACL,SAAS,uEAAuE;AACrF,CAAC;AAED,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAyC;AACvC,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,wBAAwB,mBAAmB,OAAO,aAAa,EAAE,SAAS,CAAC;AAEjF,WAAO,OAAO;AAAA,MACZ,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,QAAQ;AAAA,MACR,cAAc;AAAA,MACd,WAAW;AAAA,MACX,SAAS;AAAA,IACX,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,sCAAsC,KAAK,OAAO,WAAW,EAAE,CAAC;AAAA,EACpG;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/warehouse-inventory.js

@@ -3,16 +3,26 @@ import { z } from "zod";
 import { formatVtexError } from "../../services/vtex/vtex-api.js";
 import { getInventoryByWarehouse } from "../../services/vtex/vtex-logistics.js";
 import { stripNulls } from "../../utils/strip-payload.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
 const warehouseInventorySchema = z.object({
+  profileId: z.string().trim().min(1).optional().describe(
+    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
+  ),
   skuId: z.string().min(1).describe("SKU identifier"),
   warehouseId: z.string().min(1).describe("Warehouse identifier")
 });
 async function warehouseInventoryHandler({
+  profileId,
   skuId,
   warehouseId
 }) {
   try {
-    const inventory = await getInventoryByWarehouse(skuId, warehouseId);
+    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const inventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);
     const normalizedInventory = inventory.map((item) => ({
       sku_id: item.skuId,
       warehouse_id: item.warehouseId,
@@ -24,6 +34,7 @@ async function warehouseInventoryHandler({
     }));
     return object(
       stripNulls({
+        profile_id: resolvedProfileId,
         sku_id: skuId,
         warehouse_id: warehouseId,
         inventory: normalizedInventory

package/dist/src/tools/vtex/warehouse-inventory.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/warehouse-inventory.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getInventoryByWarehouse } from \"../../services/vtex/vtex-logistics.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const warehouseInventorySchema = z.object({\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier\"),\n});\n\nexport async function warehouseInventoryHandler({\n  skuId,\n  warehouseId,\n}: z.infer<typeof warehouseInventorySchema>) {\n  try {\n    const inventory = await getInventoryByWarehouse(skuId, warehouseId);\n\n    const normalizedInventory = inventory.map((item) => ({\n      sku_id: item.skuId,\n      warehouse_id: item.warehouseId,\n      total_quantity: item.totalQuantity,\n      reserved_quantity: item.reservedQuantity,\n      available_quantity: item.availableQuantity,\n      is_unlimited: item.isUnlimited,\n      keep_selling_after_expiration: item.keepSellingAfterExpiration,\n    }));\n\n    return object(\n      stripNulls({\n        sku_id: skuId,\n        warehouse_id: warehouseId,\n        inventory: normalizedInventory,\n      })\n    );\n  } catch (err) {\n    return error(\n      formatVtexError(err, `Failed to fetch inventory for SKU ${skuId} in warehouse ${warehouseId}`)\n    );\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AACxC,SAAS,kBAAkB;AAEpB,MAAM,2BAA2B,EAAE,OAAO;AAAA,EAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAChE,CAAC;AAED,eAAsB,0BAA0B;AAAA,EAC9C;AAAA,EACA;AACF,GAA6C;AAC3C,MAAI;AACF,UAAM,YAAY,MAAM,wBAAwB,OAAO,WAAW;AAElE,UAAM,sBAAsB,UAAU,IAAI,CAAC,UAAU;AAAA,MACnD,QAAQ,KAAK;AAAA,MACb,cAAc,KAAK;AAAA,MACnB,gBAAgB,KAAK;AAAA,MACrB,mBAAmB,KAAK;AAAA,MACxB,oBAAoB,KAAK;AAAA,MACzB,cAAc,KAAK;AAAA,MACnB,+BAA+B,KAAK;AAAA,IACtC,EAAE;AAEF,WAAO;AAAA,MACL,WAAW;AAAA,QACT,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,WAAW;AAAA,MACb,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,gBAAgB,KAAK,qCAAqC,KAAK,iBAAiB,WAAW,EAAE;AAAA,IAC/F;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getInventoryByWarehouse } from \"../../services/vtex/vtex-logistics.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const warehouseInventorySchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier\"),\n});\n\nexport async function warehouseInventoryHandler({\n  profileId,\n  skuId,\n  warehouseId,\n}: z.infer<typeof warehouseInventorySchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const inventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);\n\n    const normalizedInventory = inventory.map((item) => ({\n      sku_id: item.skuId,\n      warehouse_id: item.warehouseId,\n      total_quantity: item.totalQuantity,\n      reserved_quantity: item.reservedQuantity,\n      available_quantity: item.availableQuantity,\n      is_unlimited: item.isUnlimited,\n      keep_selling_after_expiration: item.keepSellingAfterExpiration,\n    }));\n\n    return object(\n      stripNulls({\n        profile_id: resolvedProfileId,\n        sku_id: skuId,\n        warehouse_id: warehouseId,\n        inventory: normalizedInventory,\n      })\n    );\n  } catch (err) {\n    return error(\n      formatVtexError(err, `Failed to fetch inventory for SKU ${skuId} in warehouse ${warehouseId}`)\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AACxC,SAAS,kBAAkB;AAC3B,SAAS,qCAAqC;AAEvC,MAAM,2BAA2B,EAAE,OAAO;AAAA,EAC/C,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAChE,CAAC;AAED,eAAsB,0BAA0B;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AACF,GAA6C;AAC3C,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,YAAY,MAAM,wBAAwB,mBAAmB,OAAO,WAAW;AAErF,UAAM,sBAAsB,UAAU,IAAI,CAAC,UAAU;AAAA,MACnD,QAAQ,KAAK;AAAA,MACb,cAAc,KAAK;AAAA,MACnB,gBAAgB,KAAK;AAAA,MACrB,mBAAmB,KAAK;AAAA,MACxB,oBAAoB,KAAK;AAAA,MACzB,cAAc,KAAK;AAAA,MACnB,+BAA+B,KAAK;AAAA,IACtC,EAAE;AAEF,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,WAAW;AAAA,MACb,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,gBAAgB,KAAK,qCAAqC,KAAK,iBAAiB,WAAW,EAAE;AAAA,IAC/F;AAAA,EACF;AACF;",
   "names": []
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yoryoboy/bi-mcp",
   "type": "module",
-  "version": "1.0.5",
+  "version": "1.2.0",
   "description": "MCP server: bi-mcp",
   "author": "",
   "license": "MIT",
@@ -36,6 +36,7 @@
     "cors": "^2.8.6",
     "express": "^5.2.1",
     "mcp-use": "^1.22.3",
+    "pg": "^8.20.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "react-router": "^7.13.0",
@@ -45,6 +46,7 @@
   "devDependencies": {
     "@tailwindcss/vite": "^4.2.0",
     "@types/node": "^25.3.0",
+    "@types/pg": "^8.20.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.1.4",
@@ -61,6 +63,14 @@
     "build": "mcp-use build",
     "dev": "mcp-use dev",
     "start": "mcp-use start",
-    "deploy": "mcp-use deploy"
+    "deploy": "mcp-use deploy",
+    "db:test": "pnpm exec tsx scripts/test-db-connection.ts",
+    "db:migrate": "pnpm exec tsx scripts/run-migrations.ts",
+    "admin:profile-upsert": "pnpm exec tsx scripts/admin-profile-upsert.ts",
+    "admin:profile-list": "pnpm exec tsx scripts/admin-profile-list.ts",
+    "admin:profile-delete": "pnpm exec tsx scripts/admin-profile-delete.ts",
+    "admin:vtex-upsert": "pnpm exec tsx scripts/admin-vtex-upsert.ts",
+    "admin:vtex-validate": "pnpm exec tsx scripts/admin-vtex-validate.ts",
+    "admin:vtex-list": "pnpm exec tsx scripts/admin-vtex-list.ts"
   }
 }