@yoryoboy/bi-mcp 1.7.0 → 1.9.0

package/dist/src/tools/mercadolibre/search-items.js

@@ -1,48 +1,167 @@
 import { error, object } from "mcp-use/server";
 import { z } from "zod";
 import { getMercadoLibreAccessForProfile } from "../../config/mercadolibre.js";
-import {
-  buildMercadoLibrePaginationMetadata,
-  formatMercadoLibreError,
-  normalizeMercadoLibrePaging
-} from "../../services/mercadolibre/mercadolibre-api.js";
+import { formatMercadoLibreError, normalizeMercadoLibrePaging } from "../../services/mercadolibre/mercadolibre-api.js";
 import {
   getMercadoLibreItemDetailsBatch,
-  searchMercadoLibreItems
+  getMercadoLibreItemDetailsWithFallbackBatch,
+  searchMercadoLibreItems,
+  searchMercadoLibreItemsBatch
 } from "../../services/mercadolibre/mercadolibre-items.js";
 import { stripNulls } from "../../utils/strip-payload.js";
-import { asArray, normalizeString, toNumber } from "./helpers.js";
+import { asArray, asRecord, normalizeString, toNumber } from "./helpers.js";
 import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
 import { mercadolibreProfileIdSchemaField } from "./write-helpers.js";
+const DEFAULT_STATUS = "active";
+const SEARCH_PAGE_LIMIT = 50;
+const DETAIL_BATCH_SIZE = 20;
+const PAGE_FETCH_CONCURRENCY = 15;
+const PAGE_FETCH_MAX_RETRIES = 2;
+const AVAILABLE_STATUS_FILTERS = [
+  "active",
+  "paused",
+  "closed",
+  "under_review",
+  "inactive",
+  "not_yet_active",
+  "payment_required",
+  "deleted"
+];
+const itemsSchema = [
+  "item_id",
+  "title",
+  "status",
+  "price",
+  "currency_id",
+  "available_quantity",
+  "sold_quantity",
+  "listing_type_id",
+  "category_id"
+];
 const meliSearchItemsSchema = z.object({
   profileId: mercadolibreProfileIdSchemaField,
-  status: z.string().trim().min(1).optional().describe("Optional item status filter."),
+  status: z.string().trim().min(1).optional().describe("Optional item status filter. Defaults to active when omitted."),
+  title: z.string().trim().min(1).optional().describe("Optional item title or text query. Maps to MercadoLibre q search."),
   category: z.string().trim().min(1).optional().describe("Optional category id filter."),
   listingTypeId: z.string().trim().min(1).optional().describe("Optional listing type filter."),
   orders: z.string().trim().min(1).optional().describe("Optional MercadoLibre sort expression for items search."),
-  includeDetails: z.boolean().optional().describe("Whether to multiget compact item details for returned item ids."),
-  limit: z.number().int().min(1).max(50).optional().describe("Results per page (1-50)."),
-  offset: z.number().int().min(0).max(5e3).optional().describe("Pagination offset.")
+  limit: z.number().int().min(1).max(50).optional().describe("Optional maximum detailed items to return. If omitted, returns the full matching universe from offset onward."),
+  offset: z.number().int().min(0).max(5e3).optional().describe("Pagination offset over the matching MercadoLibre items universe.")
 });
-async function meliSearchItemsHandler(params) {
-  try {
-    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
-    if (!profileResolution.ok) {
-      return profileResolution.response;
+function formatCompactItem(item) {
+  return [
+    normalizeString(item.id),
+    normalizeString(item.title),
+    normalizeString(item.status),
+    toNumber(item.price),
+    normalizeString(item.currency_id, "UNKNOWN"),
+    toNumber(item.available_quantity),
+    toNumber(item.sold_quantity),
+    normalizeString(item.listing_type_id),
+    normalizeString(item.category_id)
+  ];
+}
+function buildItemsMetadata(params) {
+  const nextOffset = params.offset + params.returned;
+  const hasMore = nextOffset < params.total;
+  let continuation = "No more pages for this query.";
+  if (params.pagesFailed > 0 || params.detailFailures > 0) {
+    continuation = hasMore ? `Se recuper\xF3 cobertura parcial. Reintentar la misma tool con offset=${params.offset} y limit=${params.limitWasExplicit ? params.effectiveLimit : 50}. Luego continuar con offset=${nextOffset} si hace falta.` : "Se recuper\xF3 cobertura parcial. Reintentar la misma tool con los mismos filtros si hace falta completar la cobertura.";
+  } else if (params.limitWasExplicit && hasMore) {
+    continuation = `Para continuar trayendo items, volver a invocar meli_search_items con los mismos filtros, offset=${nextOffset} y limit=${params.effectiveLimit}. Repetir hasta has_more=false.`;
+  }
+  return stripNulls({
+    total: params.total,
+    limit: params.effectiveLimit,
+    offset: params.offset,
+    returned: params.returned,
+    has_more: params.limitWasExplicit ? hasMore || params.pagesFailed > 0 || params.detailFailures > 0 : params.pagesFailed > 0 || params.detailFailures > 0,
+    next_offset: params.limitWasExplicit && hasMore ? nextOffset : void 0,
+    continuation,
+    applied_status: params.appliedStatus,
+    default_status_notice: params.usedDefaultStatus ? "Solo se devolvieron publicaciones active por default. Tambi\xE9n se puede pedir status expl\xEDcito como paused, closed, under_review, inactive, not_yet_active, payment_required o deleted." : void 0,
+    available_status_filters: AVAILABLE_STATUS_FILTERS,
+    detail_coverage: {
+      detail_failures: params.detailFailures,
+      details_complete: params.detailFailures === 0
+    },
+    pages_requested: params.pagesRequested,
+    pages_succeeded: params.pagesSucceeded,
+    pages_failed: params.pagesFailed,
+    universe_fully_fetched: params.universeFullyFetched
+  });
+}
+async function fetchAllMatchingItemIds(profileId, sellerId, params) {
+  const appliedStatus = params.status ?? DEFAULT_STATUS;
+  const firstResponse = await searchMercadoLibreItems(profileId, {
+    sellerId,
+    status: appliedStatus,
+    q: params.title,
+    category: params.category,
+    listingTypeId: params.listingTypeId,
+    orders: params.orders,
+    limit: SEARCH_PAGE_LIMIT,
+    offset: 0
+  });
+  const firstPaging = normalizeMercadoLibrePaging(asRecord(firstResponse.paging));
+  const total = firstPaging.total;
+  const effectiveLimit = firstPaging.limit || SEARCH_PAGE_LIMIT;
+  const ids = asArray(firstResponse.results).map((value) => normalizeString(value)).filter(Boolean);
+  const failedOffsets = [];
+  let pagesRequested = 1;
+  let pagesSucceeded = 1;
+  if (effectiveLimit > 0 && total > ids.length) {
+    const nextOffsets = [];
+    for (let nextOffset = effectiveLimit; nextOffset < total; nextOffset += effectiveLimit) {
+      nextOffsets.push(nextOffset);
     }
-    const profileId = profileResolution.value.profileId;
-    const access = await getMercadoLibreAccessForProfile(profileId);
-    const searchResponse = await searchMercadoLibreItems(profileId, {
-      sellerId: access.sellerId,
-      status: params.status,
-      category: params.category,
-      listingTypeId: params.listingTypeId,
-      orders: params.orders,
-      limit: params.limit ?? 20,
-      offset: params.offset ?? 0
-    });
-    const itemIds = asArray(searchResponse.results).map((value) => normalizeString(value)).filter(Boolean);
-    const compactItems = params.includeDetails ? await getMercadoLibreItemDetailsBatch(profileId, itemIds.slice(0, 20), [
+    pagesRequested += nextOffsets.length;
+    if (nextOffsets.length > 0) {
+      const batch = await searchMercadoLibreItemsBatch(
+        profileId,
+        {
+          sellerId,
+          status: appliedStatus,
+          q: params.title,
+          category: params.category,
+          listingTypeId: params.listingTypeId,
+          orders: params.orders,
+          limit: effectiveLimit
+        },
+        nextOffsets,
+        {
+          maxConcurrency: PAGE_FETCH_CONCURRENCY,
+          maxRetries: PAGE_FETCH_MAX_RETRIES
+        }
+      );
+      pagesSucceeded += batch.successful.length;
+      batch.successful.forEach((entry) => {
+        ids.push(...asArray(entry.document.results).map((value) => normalizeString(value)).filter(Boolean));
+      });
+      batch.failed.forEach((failure) => {
+        failedOffsets.push(Number(failure.id));
+      });
+    }
+  }
+  return {
+    ids,
+    total,
+    appliedStatus,
+    pagesRequested,
+    pagesSucceeded,
+    pagesFailed: failedOffsets.length,
+    universeFullyFetched: failedOffsets.length === 0 && ids.length >= total
+  };
+}
+async function fetchDetailedItems(profileId, itemIds) {
+  const details = {};
+  let detailFailures = 0;
+  for (let index = 0; index < itemIds.length; index += DETAIL_BATCH_SIZE) {
+    const chunk = itemIds.slice(index, index + DETAIL_BATCH_SIZE);
+    if (chunk.length === 0) {
+      continue;
+    }
+    const batch = await getMercadoLibreItemDetailsBatch(profileId, chunk, [
       "id",
       "title",
       "status",
@@ -51,33 +170,69 @@ async function meliSearchItemsHandler(params) {
       "available_quantity",
       "sold_quantity",
       "listing_type_id",
-      "permalink",
-      "thumbnail"
-    ]) : [];
-    const paging = normalizeMercadoLibrePaging(searchResponse.paging);
+      "category_id"
+    ]);
+    const foundIds = /* @__PURE__ */ new Set();
+    for (const item of batch) {
+      const itemId = normalizeString(item.id);
+      if (!itemId) {
+        continue;
+      }
+      foundIds.add(itemId);
+      details[itemId] = item;
+    }
+    const missingIds = chunk.filter((itemId) => !foundIds.has(itemId));
+    if (missingIds.length > 0) {
+      const fallback = await getMercadoLibreItemDetailsWithFallbackBatch(profileId, missingIds, {
+        maxConcurrency: 10,
+        maxRetries: 1
+      });
+      fallback.successful.forEach((entry) => {
+        details[entry.id] = entry.document;
+      });
+      detailFailures += fallback.failed.length;
+    }
+  }
+  return {
+    orderedItems: itemIds.map((itemId) => details[itemId]).filter(Boolean),
+    detailFailures
+  };
+}
+async function meliSearchItemsHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    const access = await getMercadoLibreAccessForProfile(profileId);
+    const requestedOffset = params.offset ?? 0;
+    const limitWasExplicit = typeof params.limit === "number";
+    const usedDefaultStatus = !params.status;
+    const { ids, total, appliedStatus, pagesRequested, pagesSucceeded, pagesFailed, universeFullyFetched } = await fetchAllMatchingItemIds(profileId, access.sellerId, params);
+    const pageIds = limitWasExplicit ? ids.slice(requestedOffset, requestedOffset + (params.limit ?? 0)) : ids.slice(requestedOffset);
+    const effectiveLimit = limitWasExplicit ? params.limit ?? pageIds.length : Math.max(pageIds.length, 0);
+    const { orderedItems, detailFailures } = await fetchDetailedItems(profileId, pageIds);
+    const compactItems = orderedItems.map((item) => formatCompactItem(item));
     return object(
       stripNulls({
         profile_id: profileId,
-        metadata: buildMercadoLibrePaginationMetadata({
-          total: paging.total,
-          limit: paging.limit || params.limit || itemIds.length,
-          offset: paging.offset || params.offset || 0,
-          returned: itemIds.length,
-          nextField: "offset"
+        metadata: buildItemsMetadata({
+          total,
+          effectiveLimit,
+          offset: requestedOffset,
+          returned: compactItems.length,
+          appliedStatus,
+          usedDefaultStatus,
+          detailFailures,
+          pagesRequested,
+          pagesSucceeded,
+          pagesFailed,
+          universeFullyFetched,
+          limitWasExplicit
         }),
-        item_ids: itemIds,
-        items: compactItems.map((item) => ({
-          item_id: normalizeString(item.id),
-          title: normalizeString(item.title),
-          status: normalizeString(item.status),
-          price: toNumber(item.price),
-          currency_id: normalizeString(item.currency_id, "UNKNOWN"),
-          available_quantity: toNumber(item.available_quantity),
-          sold_quantity: toNumber(item.sold_quantity),
-          listing_type_id: normalizeString(item.listing_type_id),
-          permalink: normalizeString(item.permalink),
-          thumbnail: normalizeString(item.thumbnail)
-        }))
+        items_schema: itemsSchema,
+        items: compactItems
       })
     );
   } catch (err) {

package/dist/src/tools/mercadolibre/search-items.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/search-items.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\nimport {\n  buildMercadoLibrePaginationMetadata,\n  formatMercadoLibreError,\n  normalizeMercadoLibrePaging,\n} from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport {\n  getMercadoLibreItemDetailsBatch,\n  searchMercadoLibreItems,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { asArray, normalizeString, toNumber } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nexport const meliSearchItemsSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  status: z.string().trim().min(1).optional().describe(\"Optional item status filter.\"),\n  category: z.string().trim().min(1).optional().describe(\"Optional category id filter.\"),\n  listingTypeId: z.string().trim().min(1).optional().describe(\"Optional listing type filter.\"),\n  orders: z.string().trim().min(1).optional().describe(\"Optional MercadoLibre sort expression for items search.\"),\n  includeDetails: z.boolean().optional().describe(\"Whether to multiget compact item details for returned item ids.\"),\n  limit: z.number().int().min(1).max(50).optional().describe(\"Results per page (1-50).\"),\n  offset: z.number().int().min(0).max(5000).optional().describe(\"Pagination offset.\"),\n});\n\nexport async function meliSearchItemsHandler(params: z.infer<typeof meliSearchItemsSchema>) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const access = await getMercadoLibreAccessForProfile(profileId);\n    const searchResponse = await searchMercadoLibreItems(profileId, {\n      sellerId: access.sellerId,\n      status: params.status,\n      category: params.category,\n      listingTypeId: params.listingTypeId,\n      orders: params.orders,\n      limit: params.limit ?? 20,\n      offset: params.offset ?? 0,\n    });\n\n    const itemIds = asArray<string>(searchResponse.results).map((value) => normalizeString(value)).filter(Boolean);\n    const compactItems = params.includeDetails\n      ? await getMercadoLibreItemDetailsBatch(profileId, itemIds.slice(0, 20), [\n          \"id\",\n          \"title\",\n          \"status\",\n          \"price\",\n          \"currency_id\",\n          \"available_quantity\",\n          \"sold_quantity\",\n          \"listing_type_id\",\n          \"permalink\",\n          \"thumbnail\",\n        ])\n      : [];\n\n    const paging = normalizeMercadoLibrePaging(searchResponse.paging as Record<string, unknown>);\n\n    return object(\n      stripNulls({\n        profile_id: profileId,\n        metadata: buildMercadoLibrePaginationMetadata({\n          total: paging.total,\n          limit: paging.limit || params.limit || itemIds.length,\n          offset: paging.offset || params.offset || 0,\n          returned: itemIds.length,\n          nextField: \"offset\",\n        }),\n        item_ids: itemIds,\n        items: compactItems.map((item) => ({\n          item_id: normalizeString(item.id),\n          title: normalizeString(item.title),\n          status: normalizeString(item.status),\n          price: toNumber(item.price),\n          currency_id: normalizeString(item.currency_id, \"UNKNOWN\"),\n          available_quantity: toNumber(item.available_quantity),\n          sold_quantity: toNumber(item.sold_quantity),\n          listing_type_id: normalizeString(item.listing_type_id),\n          permalink: normalizeString(item.permalink),\n          thumbnail: normalizeString(item.thumbnail),\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to search MercadoLibre items\"));\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\nimport { formatMercadoLibreError, normalizeMercadoLibrePaging } from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport {\n  getMercadoLibreItemDetailsBatch,\n  getMercadoLibreItemDetailsWithFallbackBatch,\n  searchMercadoLibreItems,\n  searchMercadoLibreItemsBatch,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { asArray, asRecord, normalizeString, toNumber } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nconst DEFAULT_STATUS = \"active\";\nconst SEARCH_PAGE_LIMIT = 50;\nconst DETAIL_BATCH_SIZE = 20;\nconst PAGE_FETCH_CONCURRENCY = 15;\nconst PAGE_FETCH_MAX_RETRIES = 2;\nconst AVAILABLE_STATUS_FILTERS = [\n  \"active\",\n  \"paused\",\n  \"closed\",\n  \"under_review\",\n  \"inactive\",\n  \"not_yet_active\",\n  \"payment_required\",\n  \"deleted\",\n];\n\nconst itemsSchema = [\n  \"item_id\",\n  \"title\",\n  \"status\",\n  \"price\",\n  \"currency_id\",\n  \"available_quantity\",\n  \"sold_quantity\",\n  \"listing_type_id\",\n  \"category_id\",\n] as const;\n\nexport const meliSearchItemsSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  status: z.string().trim().min(1).optional().describe(\"Optional item status filter. Defaults to active when omitted.\"),\n  title: z.string().trim().min(1).optional().describe(\"Optional item title or text query. Maps to MercadoLibre q search.\"),\n  category: z.string().trim().min(1).optional().describe(\"Optional category id filter.\"),\n  listingTypeId: z.string().trim().min(1).optional().describe(\"Optional listing type filter.\"),\n  orders: z.string().trim().min(1).optional().describe(\"Optional MercadoLibre sort expression for items search.\"),\n  limit: z.number().int().min(1).max(50).optional().describe(\"Optional maximum detailed items to return. If omitted, returns the full matching universe from offset onward.\"),\n  offset: z.number().int().min(0).max(5000).optional().describe(\"Pagination offset over the matching MercadoLibre items universe.\"),\n});\n\nfunction formatCompactItem(item: Record<string, unknown>) {\n  return [\n    normalizeString(item.id),\n    normalizeString(item.title),\n    normalizeString(item.status),\n    toNumber(item.price),\n    normalizeString(item.currency_id, \"UNKNOWN\"),\n    toNumber(item.available_quantity),\n    toNumber(item.sold_quantity),\n    normalizeString(item.listing_type_id),\n    normalizeString(item.category_id),\n  ];\n}\n\nfunction buildItemsMetadata(params: {\n  total: number;\n  effectiveLimit: number;\n  offset: number;\n  returned: number;\n  appliedStatus: string;\n  usedDefaultStatus: boolean;\n  detailFailures: number;\n  pagesRequested: number;\n  pagesSucceeded: number;\n  pagesFailed: number;\n  universeFullyFetched: boolean;\n  limitWasExplicit: boolean;\n}) {\n  const nextOffset = params.offset + params.returned;\n  const hasMore = nextOffset < params.total;\n\n  let continuation = \"No more pages for this query.\";\n  if (params.pagesFailed > 0 || params.detailFailures > 0) {\n    continuation = hasMore\n      ? `Se recuper\u00F3 cobertura parcial. Reintentar la misma tool con offset=${params.offset} y limit=${params.limitWasExplicit ? params.effectiveLimit : 50}. Luego continuar con offset=${nextOffset} si hace falta.`\n      : \"Se recuper\u00F3 cobertura parcial. Reintentar la misma tool con los mismos filtros si hace falta completar la cobertura.\";\n  } else if (params.limitWasExplicit && hasMore) {\n    continuation = `Para continuar trayendo items, volver a invocar meli_search_items con los mismos filtros, offset=${nextOffset} y limit=${params.effectiveLimit}. Repetir hasta has_more=false.`;\n  }\n\n  return stripNulls({\n    total: params.total,\n    limit: params.effectiveLimit,\n    offset: params.offset,\n    returned: params.returned,\n    has_more: params.limitWasExplicit ? hasMore || params.pagesFailed > 0 || params.detailFailures > 0 : params.pagesFailed > 0 || params.detailFailures > 0,\n    next_offset: params.limitWasExplicit && hasMore ? nextOffset : undefined,\n    continuation,\n    applied_status: params.appliedStatus,\n    default_status_notice: params.usedDefaultStatus\n      ? 'Solo se devolvieron publicaciones active por default. Tambi\u00E9n se puede pedir status expl\u00EDcito como paused, closed, under_review, inactive, not_yet_active, payment_required o deleted.'\n      : undefined,\n    available_status_filters: AVAILABLE_STATUS_FILTERS,\n    detail_coverage: {\n      detail_failures: params.detailFailures,\n      details_complete: params.detailFailures === 0,\n    },\n    pages_requested: params.pagesRequested,\n    pages_succeeded: params.pagesSucceeded,\n    pages_failed: params.pagesFailed,\n    universe_fully_fetched: params.universeFullyFetched,\n  });\n}\n\nasync function fetchAllMatchingItemIds(profileId: string, sellerId: string, params: z.infer<typeof meliSearchItemsSchema>) {\n  const appliedStatus = params.status ?? DEFAULT_STATUS;\n  const firstResponse = await searchMercadoLibreItems(profileId, {\n    sellerId,\n    status: appliedStatus,\n    q: params.title,\n    category: params.category,\n    listingTypeId: params.listingTypeId,\n    orders: params.orders,\n    limit: SEARCH_PAGE_LIMIT,\n    offset: 0,\n  });\n\n  const firstPaging = normalizeMercadoLibrePaging(asRecord(firstResponse.paging));\n  const total = firstPaging.total;\n  const effectiveLimit = firstPaging.limit || SEARCH_PAGE_LIMIT;\n  const ids = asArray<string>(firstResponse.results).map((value) => normalizeString(value)).filter(Boolean);\n  const failedOffsets: number[] = [];\n  let pagesRequested = 1;\n  let pagesSucceeded = 1;\n\n  if (effectiveLimit > 0 && total > ids.length) {\n    const nextOffsets: number[] = [];\n    for (let nextOffset = effectiveLimit; nextOffset < total; nextOffset += effectiveLimit) {\n      nextOffsets.push(nextOffset);\n    }\n\n    pagesRequested += nextOffsets.length;\n\n    if (nextOffsets.length > 0) {\n      const batch = await searchMercadoLibreItemsBatch(\n        profileId,\n        {\n          sellerId,\n          status: appliedStatus,\n          q: params.title,\n          category: params.category,\n          listingTypeId: params.listingTypeId,\n          orders: params.orders,\n          limit: effectiveLimit,\n        },\n        nextOffsets,\n        {\n          maxConcurrency: PAGE_FETCH_CONCURRENCY,\n          maxRetries: PAGE_FETCH_MAX_RETRIES,\n        }\n      );\n\n      pagesSucceeded += batch.successful.length;\n      batch.successful.forEach((entry) => {\n        ids.push(...asArray<string>(entry.document.results).map((value) => normalizeString(value)).filter(Boolean));\n      });\n      batch.failed.forEach((failure) => {\n        failedOffsets.push(Number(failure.id));\n      });\n    }\n  }\n\n  return {\n    ids,\n    total,\n    appliedStatus,\n    pagesRequested,\n    pagesSucceeded,\n    pagesFailed: failedOffsets.length,\n    universeFullyFetched: failedOffsets.length === 0 && ids.length >= total,\n  };\n}\n\nasync function fetchDetailedItems(profileId: string, itemIds: string[]) {\n  const details: Record<string, Record<string, unknown>> = {};\n  let detailFailures = 0;\n\n  for (let index = 0; index < itemIds.length; index += DETAIL_BATCH_SIZE) {\n    const chunk = itemIds.slice(index, index + DETAIL_BATCH_SIZE);\n    if (chunk.length === 0) {\n      continue;\n    }\n\n    const batch = await getMercadoLibreItemDetailsBatch(profileId, chunk, [\n      \"id\",\n      \"title\",\n      \"status\",\n      \"price\",\n      \"currency_id\",\n      \"available_quantity\",\n      \"sold_quantity\",\n      \"listing_type_id\",\n      \"category_id\",\n    ]);\n\n    const foundIds = new Set<string>();\n    for (const item of batch) {\n      const itemId = normalizeString(item.id);\n      if (!itemId) {\n        continue;\n      }\n      foundIds.add(itemId);\n      details[itemId] = item;\n    }\n\n    const missingIds = chunk.filter((itemId) => !foundIds.has(itemId));\n    if (missingIds.length > 0) {\n      const fallback = await getMercadoLibreItemDetailsWithFallbackBatch(profileId, missingIds, {\n        maxConcurrency: 10,\n        maxRetries: 1,\n      });\n      fallback.successful.forEach((entry) => {\n        details[entry.id] = entry.document;\n      });\n      detailFailures += fallback.failed.length;\n    }\n  }\n\n  return {\n    orderedItems: itemIds.map((itemId) => details[itemId]).filter(Boolean),\n    detailFailures,\n  };\n}\n\nexport async function meliSearchItemsHandler(params: z.infer<typeof meliSearchItemsSchema>) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const access = await getMercadoLibreAccessForProfile(profileId);\n    const requestedOffset = params.offset ?? 0;\n    const limitWasExplicit = typeof params.limit === \"number\";\n    const usedDefaultStatus = !params.status;\n\n    const { ids, total, appliedStatus, pagesRequested, pagesSucceeded, pagesFailed, universeFullyFetched } = await fetchAllMatchingItemIds(profileId, access.sellerId, params);\n\n    const pageIds = limitWasExplicit\n      ? ids.slice(requestedOffset, requestedOffset + (params.limit ?? 0))\n      : ids.slice(requestedOffset);\n    const effectiveLimit = limitWasExplicit ? params.limit ?? pageIds.length : Math.max(pageIds.length, 0);\n\n    const { orderedItems, detailFailures } = await fetchDetailedItems(profileId, pageIds);\n    const compactItems = orderedItems.map((item) => formatCompactItem(item));\n\n    return object(\n      stripNulls({\n        profile_id: profileId,\n        metadata: buildItemsMetadata({\n          total,\n          effectiveLimit,\n          offset: requestedOffset,\n          returned: compactItems.length,\n          appliedStatus,\n          usedDefaultStatus,\n          detailFailures,\n          pagesRequested,\n          pagesSucceeded,\n          pagesFailed,\n          universeFullyFetched,\n          limitWasExplicit,\n        }),\n        items_schema: itemsSchema,\n        items: compactItems,\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to search MercadoLibre items\"));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uCAAuC;AAChD,SAAS,yBAAyB,mCAAmC;AACrE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAC3B,SAAS,SAAS,UAAU,iBAAiB,gBAAgB;AAC7D,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAEjD,MAAM,iBAAiB;AACvB,MAAM,oBAAoB;AAC1B,MAAM,oBAAoB;AAC1B,MAAM,yBAAyB;AAC/B,MAAM,yBAAyB;AAC/B,MAAM,2BAA2B;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,cAAc;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,WAAW;AAAA,EACX,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,+DAA+D;AAAA,EACpH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,mEAAmE;AAAA,EACvH,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,8BAA8B;AAAA,EACrF,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,+BAA+B;AAAA,EAC3F,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,yDAAyD;AAAA,EAC9G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,+GAA+G;AAAA,EAC1K,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAI,EAAE,SAAS,EAAE,SAAS,kEAAkE;AAClI,CAAC;AAED,SAAS,kBAAkB,MAA+B;AACxD,SAAO;AAAA,IACL,gBAAgB,KAAK,EAAE;AAAA,IACvB,gBAAgB,KAAK,KAAK;AAAA,IAC1B,gBAAgB,KAAK,MAAM;AAAA,IAC3B,SAAS,KAAK,KAAK;AAAA,IACnB,gBAAgB,KAAK,aAAa,SAAS;AAAA,IAC3C,SAAS,KAAK,kBAAkB;AAAA,IAChC,SAAS,KAAK,aAAa;AAAA,IAC3B,gBAAgB,KAAK,eAAe;AAAA,IACpC,gBAAgB,KAAK,WAAW;AAAA,EAClC;AACF;AAEA,SAAS,mBAAmB,QAazB;AACD,QAAM,aAAa,OAAO,SAAS,OAAO;AAC1C,QAAM,UAAU,aAAa,OAAO;AAEpC,MAAI,eAAe;AACnB,MAAI,OAAO,cAAc,KAAK,OAAO,iBAAiB,GAAG;AACvD,mBAAe,UACX,yEAAsE,OAAO,MAAM,YAAY,OAAO,mBAAmB,OAAO,iBAAiB,EAAE,gCAAgC,UAAU,oBAC7L;AAAA,EACN,WAAW,OAAO,oBAAoB,SAAS;AAC7C,mBAAe,oGAAoG,UAAU,YAAY,OAAO,cAAc;AAAA,EAChK;AAEA,SAAO,WAAW;AAAA,IAChB,OAAO,OAAO;AAAA,IACd,OAAO,OAAO;AAAA,IACd,QAAQ,OAAO;AAAA,IACf,UAAU,OAAO;AAAA,IACjB,UAAU,OAAO,mBAAmB,WAAW,OAAO,cAAc,KAAK,OAAO,iBAAiB,IAAI,OAAO,cAAc,KAAK,OAAO,iBAAiB;AAAA,IACvJ,aAAa,OAAO,oBAAoB,UAAU,aAAa;AAAA,IAC/D;AAAA,IACA,gBAAgB,OAAO;AAAA,IACvB,uBAAuB,OAAO,oBAC1B,iMACA;AAAA,IACJ,0BAA0B;AAAA,IAC1B,iBAAiB;AAAA,MACf,iBAAiB,OAAO;AAAA,MACxB,kBAAkB,OAAO,mBAAmB;AAAA,IAC9C;AAAA,IACA,iBAAiB,OAAO;AAAA,IACxB,iBAAiB,OAAO;AAAA,IACxB,cAAc,OAAO;AAAA,IACrB,wBAAwB,OAAO;AAAA,EACjC,CAAC;AACH;AAEA,eAAe,wBAAwB,WAAmB,UAAkB,QAA+C;AACzH,QAAM,gBAAgB,OAAO,UAAU;AACvC,QAAM,gBAAgB,MAAM,wBAAwB,WAAW;AAAA,IAC7D;AAAA,IACA,QAAQ;AAAA,IACR,GAAG,OAAO;AAAA,IACV,UAAU,OAAO;AAAA,IACjB,eAAe,OAAO;AAAA,IACtB,QAAQ,OAAO;AAAA,IACf,OAAO;AAAA,IACP,QAAQ;AAAA,EACV,CAAC;AAED,QAAM,cAAc,4BAA4B,SAAS,cAAc,MAAM,CAAC;AAC9E,QAAM,QAAQ,YAAY;AAC1B,QAAM,iBAAiB,YAAY,SAAS;AAC5C,QAAM,MAAM,QAAgB,cAAc,OAAO,EAAE,IAAI,CAAC,UAAU,gBAAgB,KAAK,CAAC,EAAE,OAAO,OAAO;AACxG,QAAM,gBAA0B,CAAC;AACjC,MAAI,iBAAiB;AACrB,MAAI,iBAAiB;AAErB,MAAI,iBAAiB,KAAK,QAAQ,IAAI,QAAQ;AAC5C,UAAM,cAAwB,CAAC;AAC/B,aAAS,aAAa,gBAAgB,aAAa,OAAO,cAAc,gBAAgB;AACtF,kBAAY,KAAK,UAAU;AAAA,IAC7B;AAEA,sBAAkB,YAAY;AAE9B,QAAI,YAAY,SAAS,GAAG;AAC1B,YAAM,QAAQ,MAAM;AAAA,QAClB;AAAA,QACA;AAAA,UACE;AAAA,UACA,QAAQ;AAAA,UACR,GAAG,OAAO;AAAA,UACV,UAAU,OAAO;AAAA,UACjB,eAAe,OAAO;AAAA,UACtB,QAAQ,OAAO;AAAA,UACf,OAAO;AAAA,QACT;AAAA,QACA;AAAA,QACA;AAAA,UACE,gBAAgB;AAAA,UAChB,YAAY;AAAA,QACd;AAAA,MACF;AAEA,wBAAkB,MAAM,WAAW;AACnC,YAAM,WAAW,QAAQ,CAAC,UAAU;AAClC,YAAI,KAAK,GAAG,QAAgB,MAAM,SAAS,OAAO,EAAE,IAAI,CAAC,UAAU,gBAAgB,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC;AAAA,MAC5G,CAAC;AACD,YAAM,OAAO,QAAQ,CAAC,YAAY;AAChC,sBAAc,KAAK,OAAO,QAAQ,EAAE,CAAC;AAAA,MACvC,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa,cAAc;AAAA,IAC3B,sBAAsB,cAAc,WAAW,KAAK,IAAI,UAAU;AAAA,EACpE;AACF;AAEA,eAAe,mBAAmB,WAAmB,SAAmB;AACtE,QAAM,UAAmD,CAAC;AAC1D,MAAI,iBAAiB;AAErB,WAAS,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,mBAAmB;AACtE,UAAM,QAAQ,QAAQ,MAAM,OAAO,QAAQ,iBAAiB;AAC5D,QAAI,MAAM,WAAW,GAAG;AACtB;AAAA,IACF;AAEA,UAAM,QAAQ,MAAM,gCAAgC,WAAW,OAAO;AAAA,MACpE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,UAAM,WAAW,oBAAI,IAAY;AACjC,eAAW,QAAQ,OAAO;AACxB,YAAM,SAAS,gBAAgB,KAAK,EAAE;AACtC,UAAI,CAAC,QAAQ;AACX;AAAA,MACF;AACA,eAAS,IAAI,MAAM;AACnB,cAAQ,MAAM,IAAI;AAAA,IACpB;AAEA,UAAM,aAAa,MAAM,OAAO,CAAC,WAAW,CAAC,SAAS,IAAI,MAAM,CAAC;AACjE,QAAI,WAAW,SAAS,GAAG;AACzB,YAAM,WAAW,MAAM,4CAA4C,WAAW,YAAY;AAAA,QACxF,gBAAgB;AAAA,QAChB,YAAY;AAAA,MACd,CAAC;AACD,eAAS,WAAW,QAAQ,CAAC,UAAU;AACrC,gBAAQ,MAAM,EAAE,IAAI,MAAM;AAAA,MAC5B,CAAC;AACD,wBAAkB,SAAS,OAAO;AAAA,IACpC;AAAA,EACF;AAEA,SAAO;AAAA,IACL,cAAc,QAAQ,IAAI,CAAC,WAAW,QAAQ,MAAM,CAAC,EAAE,OAAO,OAAO;AAAA,IACrE;AAAA,EACF;AACF;AAEA,eAAsB,uBAAuB,QAA+C;AAC1F,MAAI;AACF,UAAM,oBAAoB,MAAM,sCAAsC,OAAO,SAAS;AACtF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,YAAY,kBAAkB,MAAM;AAC1C,UAAM,SAAS,MAAM,gCAAgC,SAAS;AAC9D,UAAM,kBAAkB,OAAO,UAAU;AACzC,UAAM,mBAAmB,OAAO,OAAO,UAAU;AACjD,UAAM,oBAAoB,CAAC,OAAO;AAElC,UAAM,EAAE,KAAK,OAAO,eAAe,gBAAgB,gBAAgB,aAAa,qBAAqB,IAAI,MAAM,wBAAwB,WAAW,OAAO,UAAU,MAAM;AAEzK,UAAM,UAAU,mBACZ,IAAI,MAAM,iBAAiB,mBAAmB,OAAO,SAAS,EAAE,IAChE,IAAI,MAAM,eAAe;AAC7B,UAAM,iBAAiB,mBAAmB,OAAO,SAAS,QAAQ,SAAS,KAAK,IAAI,QAAQ,QAAQ,CAAC;AAErG,UAAM,EAAE,cAAc,eAAe,IAAI,MAAM,mBAAmB,WAAW,OAAO;AACpF,UAAM,eAAe,aAAa,IAAI,CAAC,SAAS,kBAAkB,IAAI,CAAC;AAEvE,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,UAAU,mBAAmB;AAAA,UAC3B;AAAA,UACA;AAAA,UACA,QAAQ;AAAA,UACR,UAAU,aAAa;AAAA,UACvB;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF,CAAC;AAAA,QACD,cAAc;AAAA,QACd,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,qCAAqC,CAAC;AAAA,EAClF;AACF;",
   "names": []
 }

package/package.json

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