@yoryoboy/bi-mcp 1.2.0 → 1.3.0

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

@@ -0,0 +1,81 @@
+import { z } from "zod";
+import { getSkuPrice } from "../../services/vtex/vtex-pricing.js";
+import { updateSkuPrice } from "../../services/vtex/vtex-pricing-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const fixedPriceSchema = z.object({
+  tradePolicyId: z.string().min(1).describe("Trade policy or price table identifier for the fixed price."),
+  value: z.number().nonnegative().describe("Fixed selling price."),
+  listPrice: z.number().nonnegative().optional().describe("Optional list price for the fixed price."),
+  minQuantity: z.number().int().positive().describe("Minimum quantity required for this fixed price."),
+  dateRange: z.object({
+    from: z.string().min(1).describe("RFC3339 start timestamp for the fixed price."),
+    to: z.string().min(1).describe("RFC3339 end timestamp for the fixed price.")
+  }).optional().describe("Optional validity window for the fixed price.")
+});
+const updateSkuPriceSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  skuId: z.string().min(1).describe("SKU item identifier used by VTEX Pricing."),
+  basePrice: z.number().nonnegative().optional().describe("New base price for the SKU."),
+  costPrice: z.number().nonnegative().optional().describe("New cost price for the SKU."),
+  markup: z.number().nonnegative().optional().describe("New markup percentage for the SKU."),
+  listPrice: z.number().nonnegative().optional().describe("New list price for the SKU."),
+  fixedPrices: z.array(fixedPriceSchema).optional().describe(
+    "Optional full fixed price list to persist together with the base price update. VTEX overwrites any existing fixed prices not included here."
+  )
+}).refine(
+  (value) => value.basePrice !== void 0 || value.costPrice !== void 0 || value.markup !== void 0 || value.listPrice !== void 0 || value.fixedPrices !== void 0,
+  {
+    message: "At least one pricing field must be provided.",
+    path: ["basePrice"]
+  }
+);
+async function updateSkuPriceHandler({
+  profileId,
+  skuId,
+  basePrice,
+  costPrice,
+  markup,
+  listPrice,
+  fixedPrices
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const beforePrice = await getSkuPrice(resolvedProfileId, skuId);
+    await updateSkuPrice(resolvedProfileId, skuId, {
+      basePrice,
+      costPrice,
+      markup,
+      listPrice,
+      fixedPrices
+    });
+    const afterPrice = await getSkuPrice(resolvedProfileId, skuId);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "update_sku_price",
+      resourceId: skuId,
+      riskLevel: "low",
+      message: "SKU price updated successfully.",
+      before: beforePrice,
+      after: afterPrice,
+      details: {
+        sku_id: skuId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to update price for SKU ${skuId}`);
+  }
+}
+export {
+  updateSkuPriceHandler,
+  updateSkuPriceSchema
+};
+//# sourceMappingURL=update-sku-price.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/update-sku-price.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport { getSkuPrice } from \"../../services/vtex/vtex-pricing.js\";\nimport { updateSkuPrice } from \"../../services/vtex/vtex-pricing-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nconst fixedPriceSchema = z.object({\n  tradePolicyId: z\n    .string()\n    .min(1)\n    .describe(\"Trade policy or price table identifier for the fixed price.\"),\n  value: z.number().nonnegative().describe(\"Fixed selling price.\"),\n  listPrice: z.number().nonnegative().optional().describe(\"Optional list price for the fixed price.\"),\n  minQuantity: z.number().int().positive().describe(\"Minimum quantity required for this fixed price.\"),\n  dateRange: z\n    .object({\n      from: z.string().min(1).describe(\"RFC3339 start timestamp for the fixed price.\"),\n      to: z.string().min(1).describe(\"RFC3339 end timestamp for the fixed price.\"),\n    })\n    .optional()\n    .describe(\"Optional validity window for the fixed price.\"),\n});\n\nexport const updateSkuPriceSchema = z\n  .object({\n    profileId: vtexProfileIdSchemaField,\n    skuId: z.string().min(1).describe(\"SKU item identifier used by VTEX Pricing.\"),\n    basePrice: z.number().nonnegative().optional().describe(\"New base price for the SKU.\"),\n    costPrice: z.number().nonnegative().optional().describe(\"New cost price for the SKU.\"),\n    markup: z.number().nonnegative().optional().describe(\"New markup percentage for the SKU.\"),\n    listPrice: z.number().nonnegative().optional().describe(\"New list price for the SKU.\"),\n    fixedPrices: z\n      .array(fixedPriceSchema)\n      .optional()\n      .describe(\n        \"Optional full fixed price list to persist together with the base price update. VTEX overwrites any existing fixed prices not included here.\"\n      ),\n  })\n  .refine(\n    (value) =>\n      value.basePrice !== undefined ||\n      value.costPrice !== undefined ||\n      value.markup !== undefined ||\n      value.listPrice !== undefined ||\n      value.fixedPrices !== undefined,\n    {\n      message: \"At least one pricing field must be provided.\",\n      path: [\"basePrice\"],\n    }\n  );\n\nexport async function updateSkuPriceHandler({\n  profileId,\n  skuId,\n  basePrice,\n  costPrice,\n  markup,\n  listPrice,\n  fixedPrices,\n}: z.infer<typeof updateSkuPriceSchema>) {\n  try {\n    const profileResolution = await resolveVtexWriteProfile(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const beforePrice = await getSkuPrice(resolvedProfileId, skuId);\n\n    await updateSkuPrice(resolvedProfileId, skuId, {\n      basePrice,\n      costPrice,\n      markup,\n      listPrice,\n      fixedPrices,\n    });\n\n    const afterPrice = await getSkuPrice(resolvedProfileId, skuId);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"update_sku_price\",\n      resourceId: skuId,\n      riskLevel: \"low\",\n      message: \"SKU price updated successfully.\",\n      before: beforePrice as unknown as Record<string, unknown>,\n      after: afterPrice as unknown as Record<string, unknown>,\n      details: {\n        sku_id: skuId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to update price for SKU ${skuId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,mBAAmB;AAC5B,SAAS,sBAAsB;AAC/B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,MAAM,mBAAmB,EAAE,OAAO;AAAA,EAChC,eAAe,EACZ,OAAO,EACP,IAAI,CAAC,EACL,SAAS,6DAA6D;AAAA,EACzE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,sBAAsB;AAAA,EAC/D,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,0CAA0C;AAAA,EAClG,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,iDAAiD;AAAA,EACnG,WAAW,EACR,OAAO;AAAA,IACN,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,8CAA8C;AAAA,IAC/E,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,4CAA4C;AAAA,EAC7E,CAAC,EACA,SAAS,EACT,SAAS,+CAA+C;AAC7D,CAAC;AAEM,MAAM,uBAAuB,EACjC,OAAO;AAAA,EACN,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,2CAA2C;AAAA,EAC7E,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,6BAA6B;AAAA,EACrF,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,6BAA6B;AAAA,EACrF,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,oCAAoC;AAAA,EACzF,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,6BAA6B;AAAA,EACrF,aAAa,EACV,MAAM,gBAAgB,EACtB,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC,EACA;AAAA,EACC,CAAC,UACC,MAAM,cAAc,UACpB,MAAM,cAAc,UACpB,MAAM,WAAW,UACjB,MAAM,cAAc,UACpB,MAAM,gBAAgB;AAAA,EACxB;AAAA,IACE,SAAS;AAAA,IACT,MAAM,CAAC,WAAW;AAAA,EACpB;AACF;AAEF,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAyC;AACvC,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,cAAc,MAAM,YAAY,mBAAmB,KAAK;AAE9D,UAAM,eAAe,mBAAmB,OAAO;AAAA,MAC7C;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,UAAM,aAAa,MAAM,YAAY,mBAAmB,KAAK;AAE7D,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,SAAS;AAAA,QACP,QAAQ;AAAA,MACV;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,kCAAkC,KAAK,EAAE;AAAA,EAC5E;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/upsert-fixed-price.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { getSkuPrice } from "../../services/vtex/vtex-pricing.js";
+import { upsertFixedPricesForPriceTable } from "../../services/vtex/vtex-pricing-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const fixedPriceEntrySchema = z.object({
+  value: z.number().nonnegative().describe("Fixed selling price."),
+  listPrice: z.number().nonnegative().optional().describe("Optional fixed list price."),
+  minQuantity: z.number().int().positive().describe("Minimum quantity for the fixed price."),
+  dateRange: z.object({
+    from: z.string().min(1).describe("RFC3339 start timestamp."),
+    to: z.string().min(1).describe("RFC3339 end timestamp.")
+  }).optional().describe("Optional validity window for this fixed price.")
+});
+const upsertFixedPriceSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  skuId: z.string().min(1).describe("SKU item identifier used by VTEX Pricing."),
+  priceTableId: z.string().min(1).describe("Trade policy or price table identifier."),
+  fixedPrices: z.array(fixedPriceEntrySchema).min(1).describe("Fixed prices to create or replace inside the selected price table.")
+});
+async function upsertFixedPriceHandler({
+  profileId,
+  skuId,
+  priceTableId,
+  fixedPrices
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const beforePrice = await getSkuPrice(resolvedProfileId, skuId);
+    await upsertFixedPricesForPriceTable(
+      resolvedProfileId,
+      skuId,
+      priceTableId,
+      fixedPrices
+    );
+    const afterPrice = await getSkuPrice(resolvedProfileId, skuId);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "upsert_fixed_price",
+      resourceId: skuId,
+      riskLevel: "low",
+      message: "Fixed prices updated successfully for the selected price table.",
+      before: beforePrice,
+      after: afterPrice,
+      details: {
+        sku_id: skuId,
+        price_table_id: priceTableId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(
+      err,
+      `Failed to update fixed prices for SKU ${skuId} on price table ${priceTableId}`
+    );
+  }
+}
+export {
+  upsertFixedPriceHandler,
+  upsertFixedPriceSchema
+};
+//# sourceMappingURL=upsert-fixed-price.js.map

package/dist/src/tools/vtex/upsert-fixed-price.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/upsert-fixed-price.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport { getSkuPrice } from \"../../services/vtex/vtex-pricing.js\";\nimport { upsertFixedPricesForPriceTable } from \"../../services/vtex/vtex-pricing-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nconst fixedPriceEntrySchema = z.object({\n  value: z.number().nonnegative().describe(\"Fixed selling price.\"),\n  listPrice: z.number().nonnegative().optional().describe(\"Optional fixed list price.\"),\n  minQuantity: z.number().int().positive().describe(\"Minimum quantity for the fixed price.\"),\n  dateRange: z\n    .object({\n      from: z.string().min(1).describe(\"RFC3339 start timestamp.\"),\n      to: z.string().min(1).describe(\"RFC3339 end timestamp.\"),\n    })\n    .optional()\n    .describe(\"Optional validity window for this fixed price.\"),\n});\n\nexport const upsertFixedPriceSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  skuId: z.string().min(1).describe(\"SKU item identifier used by VTEX Pricing.\"),\n  priceTableId: z.string().min(1).describe(\"Trade policy or price table identifier.\"),\n  fixedPrices: z\n    .array(fixedPriceEntrySchema)\n    .min(1)\n    .describe(\"Fixed prices to create or replace inside the selected price table.\"),\n});\n\nexport async function upsertFixedPriceHandler({\n  profileId,\n  skuId,\n  priceTableId,\n  fixedPrices,\n}: z.infer<typeof upsertFixedPriceSchema>) {\n  try {\n    const profileResolution = await resolveVtexWriteProfile(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const beforePrice = await getSkuPrice(resolvedProfileId, skuId);\n\n    await upsertFixedPricesForPriceTable(\n      resolvedProfileId,\n      skuId,\n      priceTableId,\n      fixedPrices\n    );\n\n    const afterPrice = await getSkuPrice(resolvedProfileId, skuId);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"upsert_fixed_price\",\n      resourceId: skuId,\n      riskLevel: \"low\",\n      message: \"Fixed prices updated successfully for the selected price table.\",\n      before: beforePrice as unknown as Record<string, unknown>,\n      after: afterPrice as unknown as Record<string, unknown>,\n      details: {\n        sku_id: skuId,\n        price_table_id: priceTableId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(\n      err,\n      `Failed to update fixed prices for SKU ${skuId} on price table ${priceTableId}`\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,mBAAmB;AAC5B,SAAS,sCAAsC;AAC/C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,MAAM,wBAAwB,EAAE,OAAO;AAAA,EACrC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,sBAAsB;AAAA,EAC/D,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,4BAA4B;AAAA,EACpF,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,uCAAuC;AAAA,EACzF,WAAW,EACR,OAAO;AAAA,IACN,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,0BAA0B;AAAA,IAC3D,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,wBAAwB;AAAA,EACzD,CAAC,EACA,SAAS,EACT,SAAS,gDAAgD;AAC9D,CAAC;AAEM,MAAM,yBAAyB,EAAE,OAAO;AAAA,EAC7C,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,2CAA2C;AAAA,EAC7E,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,yCAAyC;AAAA,EAClF,aAAa,EACV,MAAM,qBAAqB,EAC3B,IAAI,CAAC,EACL,SAAS,oEAAoE;AAClF,CAAC;AAED,eAAsB,wBAAwB;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA2C;AACzC,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,cAAc,MAAM,YAAY,mBAAmB,KAAK;AAE9D,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,UAAM,aAAa,MAAM,YAAY,mBAAmB,KAAK;AAE7D,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,SAAS;AAAA,QACP,QAAQ;AAAA,QACR,gBAAgB;AAAA,MAClB;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO;AAAA,MACL;AAAA,MACA,yCAAyC,KAAK,mBAAmB,YAAY;AAAA,IAC/E;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/write-helpers.js

@@ -0,0 +1,73 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { formatVtexError } from "../../services/vtex/vtex-api.js";
+import {
+  VtexOperationError,
+  buildConfirmationRequiredResult,
+  buildWriteSuccessResult
+} from "../../services/vtex/vtex-write.js";
+import { toSnakeCaseKeys } from "../../utils/case-conversion.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
+const vtexProfileIdSchemaField = 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."
+);
+const confirmationSchemaField = z.boolean().optional().describe(
+  "Set to true only after the assistant has explained the impact of this operation and the user has explicitly confirmed they want to proceed."
+);
+const confirmationNoteSchemaField = z.string().trim().min(1).optional().describe("Optional note summarizing the user's explicit confirmation in natural language.");
+async function resolveVtexWriteProfile(profileId) {
+  const profileResolution = await resolveVtexProfileOrSelection(profileId);
+  if (!profileResolution.ok) {
+    return profileResolution;
+  }
+  return {
+    ok: true,
+    value: {
+      profileId: profileResolution.value.profileId
+    }
+  };
+}
+function requireExplicitConfirmation(confirmed, operation, details) {
+  if (confirmed === true) {
+    return null;
+  }
+  return object(buildConfirmationRequiredResult(operation, details));
+}
+function toWriteSummary(before, after) {
+  return {
+    before: before ? toSnakeCaseKeys(before) : before,
+    after: after ? toSnakeCaseKeys(after) : after
+  };
+}
+function buildWriteSuccessResponse(params) {
+  return object(
+    buildWriteSuccessResult({
+      profileId: params.profileId,
+      operation: params.operation,
+      resourceId: params.resourceId,
+      riskLevel: params.riskLevel,
+      confirmed: params.confirmed,
+      confirmationNote: params.confirmationNote,
+      message: params.message,
+      summary: toWriteSummary(params.before, params.after),
+      details: params.details ? toSnakeCaseKeys(params.details) : void 0
+    })
+  );
+}
+function handleVtexWriteError(err, fallback) {
+  if (err instanceof VtexOperationError) {
+    return error(err.message);
+  }
+  return error(formatVtexError(err, fallback));
+}
+export {
+  buildWriteSuccessResponse,
+  confirmationNoteSchemaField,
+  confirmationSchemaField,
+  handleVtexWriteError,
+  requireExplicitConfirmation,
+  resolveVtexWriteProfile,
+  toWriteSummary,
+  vtexProfileIdSchemaField
+};
+//# sourceMappingURL=write-helpers.js.map

package/dist/src/tools/vtex/write-helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/write-helpers.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport {\n  VtexOperationError,\n  buildConfirmationRequiredResult,\n  buildWriteSuccessResult,\n  type VtexWriteRiskLevel,\n} from \"../../services/vtex/vtex-write.js\";\nimport { toSnakeCaseKeys } from \"../../utils/case-conversion.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const vtexProfileIdSchemaField = 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\nexport const confirmationSchemaField = z\n  .boolean()\n  .optional()\n  .describe(\n    \"Set to true only after the assistant has explained the impact of this operation and the user has explicitly confirmed they want to proceed.\"\n  );\n\nexport const confirmationNoteSchemaField = z\n  .string()\n  .trim()\n  .min(1)\n  .optional()\n  .describe(\"Optional note summarizing the user's explicit confirmation in natural language.\");\n\nexport async function resolveVtexWriteProfile(profileId?: string) {\n  const profileResolution = await resolveVtexProfileOrSelection(profileId);\n  if (!profileResolution.ok) {\n    return profileResolution;\n  }\n\n  return {\n    ok: true as const,\n    value: {\n      profileId: profileResolution.value.profileId,\n    },\n  };\n}\n\nexport function requireExplicitConfirmation(\n  confirmed: boolean | undefined,\n  operation: string,\n  details?: Record<string, unknown>\n) {\n  if (confirmed === true) {\n    return null;\n  }\n\n  return object(buildConfirmationRequiredResult(operation, details));\n}\n\nexport function toWriteSummary(\n  before?: Record<string, unknown> | null,\n  after?: Record<string, unknown> | null\n) {\n  return {\n    before: before ? (toSnakeCaseKeys(before) as Record<string, unknown>) : before,\n    after: after ? (toSnakeCaseKeys(after) as Record<string, unknown>) : after,\n  };\n}\n\nexport function buildWriteSuccessResponse(params: {\n  profileId: string;\n  operation: string;\n  resourceId?: string;\n  riskLevel: VtexWriteRiskLevel;\n  confirmed?: boolean;\n  confirmationNote?: string;\n  message: string;\n  before?: Record<string, unknown> | null;\n  after?: Record<string, unknown> | null;\n  details?: Record<string, unknown>;\n}) {\n  return object(\n    buildWriteSuccessResult({\n      profileId: params.profileId,\n      operation: params.operation,\n      resourceId: params.resourceId,\n      riskLevel: params.riskLevel,\n      confirmed: params.confirmed,\n      confirmationNote: params.confirmationNote,\n      message: params.message,\n      summary: toWriteSummary(params.before, params.after),\n      details: params.details ? (toSnakeCaseKeys(params.details) as Record<string, unknown>) : undefined,\n    })\n  );\n}\n\nexport function handleVtexWriteError(err: unknown, fallback: string) {\n  if (err instanceof VtexOperationError) {\n    return error(err.message);\n  }\n\n  return error(formatVtexError(err, fallback));\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,uBAAuB;AAChC,SAAS,qCAAqC;AAEvC,MAAM,2BAA2B,EACrC,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,EACC;AACF;AAEK,MAAM,0BAA0B,EACpC,QAAQ,EACR,SAAS,EACT;AAAA,EACC;AACF;AAEK,MAAM,8BAA8B,EACxC,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT,SAAS,iFAAiF;AAE7F,eAAsB,wBAAwB,WAAoB;AAChE,QAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,MAAI,CAAC,kBAAkB,IAAI;AACzB,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,WAAW,kBAAkB,MAAM;AAAA,IACrC;AAAA,EACF;AACF;AAEO,SAAS,4BACd,WACA,WACA,SACA;AACA,MAAI,cAAc,MAAM;AACtB,WAAO;AAAA,EACT;AAEA,SAAO,OAAO,gCAAgC,WAAW,OAAO,CAAC;AACnE;AAEO,SAAS,eACd,QACA,OACA;AACA,SAAO;AAAA,IACL,QAAQ,SAAU,gBAAgB,MAAM,IAAgC;AAAA,IACxE,OAAO,QAAS,gBAAgB,KAAK,IAAgC;AAAA,EACvE;AACF;AAEO,SAAS,0BAA0B,QAWvC;AACD,SAAO;AAAA,IACL,wBAAwB;AAAA,MACtB,WAAW,OAAO;AAAA,MAClB,WAAW,OAAO;AAAA,MAClB,YAAY,OAAO;AAAA,MACnB,WAAW,OAAO;AAAA,MAClB,WAAW,OAAO;AAAA,MAClB,kBAAkB,OAAO;AAAA,MACzB,SAAS,OAAO;AAAA,MAChB,SAAS,eAAe,OAAO,QAAQ,OAAO,KAAK;AAAA,MACnD,SAAS,OAAO,UAAW,gBAAgB,OAAO,OAAO,IAAgC;AAAA,IAC3F,CAAC;AAAA,EACH;AACF;AAEO,SAAS,qBAAqB,KAAc,UAAkB;AACnE,MAAI,eAAe,oBAAoB;AACrC,WAAO,MAAM,IAAI,OAAO;AAAA,EAC1B;AAEA,SAAO,MAAM,gBAAgB,KAAK,QAAQ,CAAC;AAC7C;",
+  "names": []
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yoryoboy/bi-mcp",
   "type": "module",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "MCP server: bi-mcp",
   "author": "",
   "license": "MIT",