@yoryoboy/bi-mcp 1.2.0 → 1.3.1

package/dist/src/tools/search-console/query-performance.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/search-console/query-performance.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  brandTermsSchemaField,\n  buildPaginationMetadata,\n  buildSearchConsoleQueryBody,\n  classifyBrandLabel,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  rowLimitSchemaField,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  startRowSchemaField,\n  sumSearchConsoleRows,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleQueryPerformanceSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  includeBrand: z\n    .enum([\"all\", \"only_brand\", \"only_non_brand\"])\n    .optional()\n    .describe(\"How to filter the query list when brandTerms are provided.\"),\n  rowLimit: rowLimitSchemaField,\n  startRow: startRowSchemaField,\n});\n\nexport async function searchConsoleQueryPerformanceHandler(\n  params: z.infer<typeof searchConsoleQueryPerformanceSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const response = await querySearchConsolePerformance(\n      siteUrl,\n      buildSearchConsoleQueryBody({\n        startDate: params.startDate,\n        endDate: params.endDate,\n        dimensions: [\"query\"],\n        searchType: params.searchType,\n        rowLimit: params.rowLimit,\n        startRow: params.startRow,\n      })\n    );\n\n    const includeBrand = params.includeBrand ?? \"all\";\n    const rows = (response.rows ?? [])\n      .map((row) => normalizeSearchConsoleRow(row, [\"query\"]))\n      .map((row) => ({\n        query: row.dimensions.query,\n        clicks: row.clicks,\n        impressions: row.impressions,\n        ctr_percent: row.ctr_percent,\n        position: row.position,\n        brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),\n      }))\n      .filter((row) => {\n        if (includeBrand === \"only_brand\") {\n          return row.brand_classification === \"brand\";\n        }\n\n        if (includeBrand === \"only_non_brand\") {\n          return row.brand_classification === \"non_brand\";\n        }\n\n        return true;\n      });\n\n    const totals = sumSearchConsoleRows(\n      rows.map((row) => ({\n        keys: [row.query],\n        dimensions: { query: row.query },\n        clicks: row.clicks,\n        impressions: row.impressions,\n        ctr_percent: row.ctr_percent,\n        position: row.position,\n      }))\n    );\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        filters: {\n          search_type: params.searchType ?? \"web\",\n          include_brand: includeBrand,\n          brand_terms: params.brandTerms,\n        },\n        overview: {\n          total_clicks: totals.clicks,\n          total_impressions: totals.impressions,\n          average_ctr_percent: totals.ctrPercent,\n          average_position: totals.averagePosition,\n        },\n        queries: rows,\n        metadata: buildPaginationMetadata({\n          startRow: params.startRow,\n          rowLimit: params.rowLimit,\n          returnedRows: response.rows?.length ?? 0,\n        }),\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Search Console query performance\"\n    );\n  }\n}\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  brandTermsSchemaField,\n  buildPaginationMetadata,\n  buildSearchConsoleQueryBody,\n  classifyBrandLabel,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  rowLimitSchemaField,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  startRowSchemaField,\n  sumSearchConsoleRows,\n  normalizeSearchConsoleRow,\n} from \"../../services/search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleQueryPerformanceSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  includeBrand: z\n    .enum([\"all\", \"only_brand\", \"only_non_brand\"])\n    .optional()\n    .describe(\"How to filter the query list when brandTerms are provided.\"),\n  rowLimit: rowLimitSchemaField,\n  startRow: startRowSchemaField,\n});\n\nexport async function searchConsoleQueryPerformanceHandler(\n  params: z.infer<typeof searchConsoleQueryPerformanceSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const response = await querySearchConsolePerformance(\n      siteUrl,\n      buildSearchConsoleQueryBody({\n        startDate: params.startDate,\n        endDate: params.endDate,\n        dimensions: [\"query\"],\n        searchType: params.searchType,\n        rowLimit: params.rowLimit,\n        startRow: params.startRow,\n      })\n    );\n\n    const includeBrand = params.includeBrand ?? \"all\";\n    const rows = (response.rows ?? [])\n      .map((row) => normalizeSearchConsoleRow(row, [\"query\"]))\n      .map((row) => ({\n        query: row.dimensions.query,\n        clicks: row.clicks,\n        impressions: row.impressions,\n        ctr_percent: row.ctr_percent,\n        position: row.position,\n        brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),\n      }))\n      .filter((row) => {\n        if (includeBrand === \"only_brand\") {\n          return row.brand_classification === \"brand\";\n        }\n\n        if (includeBrand === \"only_non_brand\") {\n          return row.brand_classification === \"non_brand\";\n        }\n\n        return true;\n      });\n\n    const totals = sumSearchConsoleRows(\n      rows.map((row) => ({\n        keys: [row.query],\n        dimensions: { query: row.query },\n        clicks: row.clicks,\n        impressions: row.impressions,\n        ctr_percent: row.ctr_percent,\n        position: row.position,\n      }))\n    );\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        filters: {\n          search_type: params.searchType ?? \"web\",\n          include_brand: includeBrand,\n          brand_terms: params.brandTerms,\n        },\n        overview: {\n          total_clicks: totals.clicks,\n          total_impressions: totals.impressions,\n          average_ctr_percent: totals.ctrPercent,\n          average_position: totals.averagePosition,\n        },\n        queries: rows,\n        metadata: buildPaginationMetadata({\n          startRow: params.startRow,\n          rowLimit: params.rowLimit,\n          returnedRows: response.rows?.length ?? 0,\n        }),\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Search Console query performance\"\n    );\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,qCAAqC;AAC9C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,sCAAsC,EAAE,OAAO;AAAA,EAC1D,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,cAAc,EACX,KAAK,CAAC,OAAO,cAAc,gBAAgB,CAAC,EAC5C,SAAS,EACT,SAAS,4DAA4D;AAAA,EACxE,UAAU;AAAA,EACV,UAAU;AACZ,CAAC;AAED,eAAsB,qCACpB,QACA;AACA,MAAI;AACF,UAAM,UAAU,4BAA4B,OAAO,SAAS,OAAO,SAAS;AAC5E,UAAM,WAAW,MAAM;AAAA,MACrB;AAAA,MACA,4BAA4B;AAAA,QAC1B,WAAW,OAAO;AAAA,QAClB,SAAS,OAAO;AAAA,QAChB,YAAY,CAAC,OAAO;AAAA,QACpB,YAAY,OAAO;AAAA,QACnB,UAAU,OAAO;AAAA,QACjB,UAAU,OAAO;AAAA,MACnB,CAAC;AAAA,IACH;AAEA,UAAM,eAAe,OAAO,gBAAgB;AAC5C,UAAM,QAAQ,SAAS,QAAQ,CAAC,GAC7B,IAAI,CAAC,QAAQ,0BAA0B,KAAK,CAAC,OAAO,CAAC,CAAC,EACtD,IAAI,CAAC,SAAS;AAAA,MACb,OAAO,IAAI,WAAW;AAAA,MACtB,QAAQ,IAAI;AAAA,MACZ,aAAa,IAAI;AAAA,MACjB,aAAa,IAAI;AAAA,MACjB,UAAU,IAAI;AAAA,MACd,sBAAsB,mBAAmB,IAAI,WAAW,OAAO,OAAO,UAAU;AAAA,IAClF,EAAE,EACD,OAAO,CAAC,QAAQ;AACf,UAAI,iBAAiB,cAAc;AACjC,eAAO,IAAI,yBAAyB;AAAA,MACtC;AAEA,UAAI,iBAAiB,kBAAkB;AACrC,eAAO,IAAI,yBAAyB;AAAA,MACtC;AAEA,aAAO;AAAA,IACT,CAAC;AAEH,UAAM,SAAS;AAAA,MACb,KAAK,IAAI,CAAC,SAAS;AAAA,QACjB,MAAM,CAAC,IAAI,KAAK;AAAA,QAChB,YAAY,EAAE,OAAO,IAAI,MAAM;AAAA,QAC/B,QAAQ,IAAI;AAAA,QACZ,aAAa,IAAI;AAAA,QACjB,aAAa,IAAI;AAAA,QACjB,UAAU,IAAI;AAAA,MAChB,EAAE;AAAA,IACJ;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,QACV,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,SAAS;AAAA,UACP,aAAa,OAAO,cAAc;AAAA,UAClC,eAAe;AAAA,UACf,aAAa,OAAO;AAAA,QACtB;AAAA,QACA,UAAU;AAAA,UACR,cAAc,OAAO;AAAA,UACrB,mBAAmB,OAAO;AAAA,UAC1B,qBAAqB,OAAO;AAAA,UAC5B,kBAAkB,OAAO;AAAA,QAC3B;AAAA,QACA,SAAS;AAAA,QACT,UAAU,wBAAwB;AAAA,UAChC,UAAU,OAAO;AAAA,UACjB,UAAU,OAAO;AAAA,UACjB,cAAc,SAAS,MAAM,UAAU;AAAA,QACzC,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/src/tools/search-console/quick-win-opportunities.js

@@ -14,7 +14,7 @@ import {
   siteUrlSchemaField,
   startDateSchemaField,
   normalizeSearchConsoleRow
-} from "../../search-console/search-console-utils.js";
+} from "../../services/search-console/search-console-utils.js";
 import { stripNulls } from "../../utils/strip-payload.js";
 const searchConsoleQuickWinOpportunitiesSchema = z.object({
   startDate: startDateSchemaField,

package/dist/src/tools/search-console/quick-win-opportunities.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/search-console/quick-win-opportunities.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  brandTermsSchemaField,\n  buildSearchConsoleQueryBody,\n  classifyBrandLabel,\n  classifyQuickWinType,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  scoreQuickWinOpportunity,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleQuickWinOpportunitiesSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum impressions required to consider a quick win.\"),\n  quickWinMode: z\n    .enum([\"ctr\", \"position\", \"mixed\"])\n    .optional()\n    .describe(\"Whether to prioritize CTR fixes, ranking improvements, or both.\"),\n});\n\nexport async function searchConsoleQuickWinOpportunitiesHandler(\n  params: z.infer<typeof searchConsoleQuickWinOpportunitiesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const minImpressions = params.minImpressions ?? 80;\n    const quickWinMode = params.quickWinMode ?? \"mixed\";\n\n    const response = await querySearchConsolePerformance(\n      siteUrl,\n      buildSearchConsoleQueryBody({\n        startDate: params.startDate,\n        endDate: params.endDate,\n        dimensions: [\"query\"],\n        searchType: params.searchType,\n        rowLimit: 250,\n      })\n    );\n\n    const opportunities = (response.rows ?? [])\n      .map((row) => normalizeSearchConsoleRow(row, [\"query\"]))\n      .filter((row) => row.impressions >= minImpressions)\n      .map((row) => {\n        const quickWinType = classifyQuickWinType(row.position, row.ctr_percent);\n        return {\n          query: row.dimensions.query,\n          clicks: row.clicks,\n          impressions: row.impressions,\n          ctr_percent: row.ctr_percent,\n          position: row.position,\n          quick_win_type: quickWinType,\n          brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),\n          opportunity_score: scoreQuickWinOpportunity({\n            impressions: row.impressions,\n            ctrPercent: row.ctr_percent,\n            position: row.position,\n          }),\n        };\n      })\n      .filter((row) => {\n        if (quickWinMode === \"mixed\") {\n          return row.position > 0 && row.position <= 20;\n        }\n\n        return row.quick_win_type === quickWinMode;\n      })\n      .sort((left, right) => right.opportunity_score - left.opportunity_score)\n      .map((row) => ({\n        ...row,\n        reason:\n          row.quick_win_type === \"ctr\"\n            ? \"The query already ranks fairly well, so a CTR lift is the fastest path.\"\n            : \"The query has traction, but ranking improvement appears to be the faster lever.\",\n      }));\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        thresholds: {\n          min_impressions: minImpressions,\n          quick_win_mode: quickWinMode,\n        },\n        opportunities,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to find Search Console quick-win opportunities\"\n    );\n  }\n}\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  brandTermsSchemaField,\n  buildSearchConsoleQueryBody,\n  classifyBrandLabel,\n  classifyQuickWinType,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  scoreQuickWinOpportunity,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../services/search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleQuickWinOpportunitiesSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum impressions required to consider a quick win.\"),\n  quickWinMode: z\n    .enum([\"ctr\", \"position\", \"mixed\"])\n    .optional()\n    .describe(\"Whether to prioritize CTR fixes, ranking improvements, or both.\"),\n});\n\nexport async function searchConsoleQuickWinOpportunitiesHandler(\n  params: z.infer<typeof searchConsoleQuickWinOpportunitiesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const minImpressions = params.minImpressions ?? 80;\n    const quickWinMode = params.quickWinMode ?? \"mixed\";\n\n    const response = await querySearchConsolePerformance(\n      siteUrl,\n      buildSearchConsoleQueryBody({\n        startDate: params.startDate,\n        endDate: params.endDate,\n        dimensions: [\"query\"],\n        searchType: params.searchType,\n        rowLimit: 250,\n      })\n    );\n\n    const opportunities = (response.rows ?? [])\n      .map((row) => normalizeSearchConsoleRow(row, [\"query\"]))\n      .filter((row) => row.impressions >= minImpressions)\n      .map((row) => {\n        const quickWinType = classifyQuickWinType(row.position, row.ctr_percent);\n        return {\n          query: row.dimensions.query,\n          clicks: row.clicks,\n          impressions: row.impressions,\n          ctr_percent: row.ctr_percent,\n          position: row.position,\n          quick_win_type: quickWinType,\n          brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),\n          opportunity_score: scoreQuickWinOpportunity({\n            impressions: row.impressions,\n            ctrPercent: row.ctr_percent,\n            position: row.position,\n          }),\n        };\n      })\n      .filter((row) => {\n        if (quickWinMode === \"mixed\") {\n          return row.position > 0 && row.position <= 20;\n        }\n\n        return row.quick_win_type === quickWinMode;\n      })\n      .sort((left, right) => right.opportunity_score - left.opportunity_score)\n      .map((row) => ({\n        ...row,\n        reason:\n          row.quick_win_type === \"ctr\"\n            ? \"The query already ranks fairly well, so a CTR lift is the fastest path.\"\n            : \"The query has traction, but ranking improvement appears to be the faster lever.\",\n      }));\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        thresholds: {\n          min_impressions: minImpressions,\n          quick_win_mode: quickWinMode,\n        },\n        opportunities,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to find Search Console quick-win opportunities\"\n    );\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,qCAAqC;AAC9C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,2CAA2C,EAAE,OAAO;AAAA,EAC/D,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,gBAAgB,EACb,OAAO,EACP,IAAI,CAAC,EACL,SAAS,EACT,SAAS,uDAAuD;AAAA,EACnE,cAAc,EACX,KAAK,CAAC,OAAO,YAAY,OAAO,CAAC,EACjC,SAAS,EACT,SAAS,iEAAiE;AAC/E,CAAC;AAED,eAAsB,0CACpB,QACA;AACA,MAAI;AACF,UAAM,UAAU,4BAA4B,OAAO,SAAS,OAAO,SAAS;AAC5E,UAAM,iBAAiB,OAAO,kBAAkB;AAChD,UAAM,eAAe,OAAO,gBAAgB;AAE5C,UAAM,WAAW,MAAM;AAAA,MACrB;AAAA,MACA,4BAA4B;AAAA,QAC1B,WAAW,OAAO;AAAA,QAClB,SAAS,OAAO;AAAA,QAChB,YAAY,CAAC,OAAO;AAAA,QACpB,YAAY,OAAO;AAAA,QACnB,UAAU;AAAA,MACZ,CAAC;AAAA,IACH;AAEA,UAAM,iBAAiB,SAAS,QAAQ,CAAC,GACtC,IAAI,CAAC,QAAQ,0BAA0B,KAAK,CAAC,OAAO,CAAC,CAAC,EACtD,OAAO,CAAC,QAAQ,IAAI,eAAe,cAAc,EACjD,IAAI,CAAC,QAAQ;AACZ,YAAM,eAAe,qBAAqB,IAAI,UAAU,IAAI,WAAW;AACvE,aAAO;AAAA,QACL,OAAO,IAAI,WAAW;AAAA,QACtB,QAAQ,IAAI;AAAA,QACZ,aAAa,IAAI;AAAA,QACjB,aAAa,IAAI;AAAA,QACjB,UAAU,IAAI;AAAA,QACd,gBAAgB;AAAA,QAChB,sBAAsB,mBAAmB,IAAI,WAAW,OAAO,OAAO,UAAU;AAAA,QAChF,mBAAmB,yBAAyB;AAAA,UAC1C,aAAa,IAAI;AAAA,UACjB,YAAY,IAAI;AAAA,UAChB,UAAU,IAAI;AAAA,QAChB,CAAC;AAAA,MACH;AAAA,IACF,CAAC,EACA,OAAO,CAAC,QAAQ;AACf,UAAI,iBAAiB,SAAS;AAC5B,eAAO,IAAI,WAAW,KAAK,IAAI,YAAY;AAAA,MAC7C;AAEA,aAAO,IAAI,mBAAmB;AAAA,IAChC,CAAC,EACA,KAAK,CAAC,MAAM,UAAU,MAAM,oBAAoB,KAAK,iBAAiB,EACtE,IAAI,CAAC,SAAS;AAAA,MACb,GAAG;AAAA,MACH,QACE,IAAI,mBAAmB,QACnB,4EACA;AAAA,IACR,EAAE;AAEJ,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,QACV,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,YAAY;AAAA,UACV,iBAAiB;AAAA,UACjB,gBAAgB;AAAA,QAClB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/src/tools/search-console/rising-non-brand-queries.js

@@ -16,7 +16,7 @@ import {
   searchTypeSchemaField,
   siteUrlSchemaField,
   normalizeSearchConsoleRow
-} from "../../search-console/search-console-utils.js";
+} from "../../services/search-console/search-console-utils.js";
 import { stripNulls } from "../../utils/strip-payload.js";
 const searchConsoleRisingNonBrandQueriesSchema = z.object({
   currentStartDate: currentStartDateSchemaField,

package/dist/src/tools/search-console/rising-non-brand-queries.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/search-console/rising-non-brand-queries.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  brandTermsSchemaField,\n  buildComparisonMap,\n  buildSearchConsoleQueryBody,\n  classifyBrandLabel,\n  computeChangePercent,\n  currentEndDateSchemaField,\n  currentStartDateSchemaField,\n  previousEndDateSchemaField,\n  previousStartDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleRisingNonBrandQueriesSchema = z.object({\n  currentStartDate: currentStartDateSchemaField,\n  currentEndDate: currentEndDateSchemaField,\n  previousStartDate: previousStartDateSchemaField,\n  previousEndDate: previousEndDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum current-period impressions required to include a query.\"),\n  minGrowthRate: z\n    .number()\n    .min(0)\n    .optional()\n    .describe(\"Minimum impressions growth percentage required to consider a query rising.\"),\n});\n\nexport async function searchConsoleRisingNonBrandQueriesHandler(\n  params: z.infer<typeof searchConsoleRisingNonBrandQueriesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const minImpressions = params.minImpressions ?? 50;\n    const minGrowthRate = params.minGrowthRate ?? 20;\n\n    const [currentResponse, previousResponse] = await Promise.all([\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.currentStartDate,\n          endDate: params.currentEndDate,\n          dimensions: [\"query\"],\n          searchType: params.searchType,\n          rowLimit: 250,\n        })\n      ),\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.previousStartDate,\n          endDate: params.previousEndDate,\n          dimensions: [\"query\"],\n          searchType: params.searchType,\n          rowLimit: 250,\n        })\n      ),\n    ]);\n\n    const currentRows = (currentResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"query\"])\n    );\n    const previousRows = (previousResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"query\"])\n    );\n    const previousMap = buildComparisonMap(previousRows, (row) => row.dimensions.query);\n\n    const risingQueries = currentRows\n      .map((row) => {\n        const previousRow = previousMap.get(row.dimensions.query);\n        return {\n          query: row.dimensions.query,\n          current_clicks: row.clicks,\n          previous_clicks: previousRow?.clicks ?? 0,\n          current_impressions: row.impressions,\n          previous_impressions: previousRow?.impressions ?? 0,\n          current_ctr_percent: row.ctr_percent,\n          previous_ctr_percent: previousRow?.ctr_percent ?? 0,\n          current_position: row.position,\n          previous_position: previousRow?.position ?? 0,\n          brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),\n        };\n      })\n      .filter((row) => row.brand_classification === \"non_brand\")\n      .filter((row) => row.current_impressions >= minImpressions)\n      .map((row) => ({\n        ...row,\n        impressions_growth_percent: computeChangePercent(\n          row.current_impressions,\n          row.previous_impressions\n        ),\n        clicks_growth_percent: computeChangePercent(row.current_clicks, row.previous_clicks),\n      }))\n      .filter((row) => (row.impressions_growth_percent ?? 0) >= minGrowthRate)\n      .sort(\n        (left, right) =>\n          (right.impressions_growth_percent ?? 0) - (left.impressions_growth_percent ?? 0)\n      );\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        comparison: {\n          current_period: {\n            start_date: params.currentStartDate,\n            end_date: params.currentEndDate,\n          },\n          previous_period: {\n            start_date: params.previousStartDate,\n            end_date: params.previousEndDate,\n          },\n        },\n        thresholds: {\n          min_impressions: minImpressions,\n          min_growth_rate_percent: minGrowthRate,\n        },\n        rising_queries: risingQueries,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to find Search Console rising non-brand queries\"\n    );\n  }\n}\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  brandTermsSchemaField,\n  buildComparisonMap,\n  buildSearchConsoleQueryBody,\n  classifyBrandLabel,\n  computeChangePercent,\n  currentEndDateSchemaField,\n  currentStartDateSchemaField,\n  previousEndDateSchemaField,\n  previousStartDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../services/search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleRisingNonBrandQueriesSchema = z.object({\n  currentStartDate: currentStartDateSchemaField,\n  currentEndDate: currentEndDateSchemaField,\n  previousStartDate: previousStartDateSchemaField,\n  previousEndDate: previousEndDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum current-period impressions required to include a query.\"),\n  minGrowthRate: z\n    .number()\n    .min(0)\n    .optional()\n    .describe(\"Minimum impressions growth percentage required to consider a query rising.\"),\n});\n\nexport async function searchConsoleRisingNonBrandQueriesHandler(\n  params: z.infer<typeof searchConsoleRisingNonBrandQueriesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const minImpressions = params.minImpressions ?? 50;\n    const minGrowthRate = params.minGrowthRate ?? 20;\n\n    const [currentResponse, previousResponse] = await Promise.all([\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.currentStartDate,\n          endDate: params.currentEndDate,\n          dimensions: [\"query\"],\n          searchType: params.searchType,\n          rowLimit: 250,\n        })\n      ),\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.previousStartDate,\n          endDate: params.previousEndDate,\n          dimensions: [\"query\"],\n          searchType: params.searchType,\n          rowLimit: 250,\n        })\n      ),\n    ]);\n\n    const currentRows = (currentResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"query\"])\n    );\n    const previousRows = (previousResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"query\"])\n    );\n    const previousMap = buildComparisonMap(previousRows, (row) => row.dimensions.query);\n\n    const risingQueries = currentRows\n      .map((row) => {\n        const previousRow = previousMap.get(row.dimensions.query);\n        return {\n          query: row.dimensions.query,\n          current_clicks: row.clicks,\n          previous_clicks: previousRow?.clicks ?? 0,\n          current_impressions: row.impressions,\n          previous_impressions: previousRow?.impressions ?? 0,\n          current_ctr_percent: row.ctr_percent,\n          previous_ctr_percent: previousRow?.ctr_percent ?? 0,\n          current_position: row.position,\n          previous_position: previousRow?.position ?? 0,\n          brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),\n        };\n      })\n      .filter((row) => row.brand_classification === \"non_brand\")\n      .filter((row) => row.current_impressions >= minImpressions)\n      .map((row) => ({\n        ...row,\n        impressions_growth_percent: computeChangePercent(\n          row.current_impressions,\n          row.previous_impressions\n        ),\n        clicks_growth_percent: computeChangePercent(row.current_clicks, row.previous_clicks),\n      }))\n      .filter((row) => (row.impressions_growth_percent ?? 0) >= minGrowthRate)\n      .sort(\n        (left, right) =>\n          (right.impressions_growth_percent ?? 0) - (left.impressions_growth_percent ?? 0)\n      );\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        comparison: {\n          current_period: {\n            start_date: params.currentStartDate,\n            end_date: params.currentEndDate,\n          },\n          previous_period: {\n            start_date: params.previousStartDate,\n            end_date: params.previousEndDate,\n          },\n        },\n        thresholds: {\n          min_impressions: minImpressions,\n          min_growth_rate_percent: minGrowthRate,\n        },\n        rising_queries: risingQueries,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to find Search Console rising non-brand queries\"\n    );\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/src/tools/search-console/search-performance.js

@@ -17,7 +17,7 @@ import {
   startRowSchemaField,
   sumSearchConsoleRows,
   normalizeSearchConsoleRow
-} from "../../search-console/search-console-utils.js";
+} from "../../services/search-console/search-console-utils.js";
 import { stripNulls } from "../../utils/strip-payload.js";
 const searchConsoleSearchPerformanceSchema = z.object({
   startDate: startDateSchemaField,

package/dist/src/tools/search-console/search-performance.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/search-console/search-performance.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  buildPaginationMetadata,\n  buildSearchConsoleQueryBody,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  rowLimitSchemaField,\n  searchConsoleAggregationTypes,\n  searchConsoleDimensionFilterSchema,\n  searchConsoleDimensions,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  startRowSchemaField,\n  sumSearchConsoleRows,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleSearchPerformanceSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  dimensions: z\n    .array(z.enum(searchConsoleDimensions))\n    .max(5)\n    .optional()\n    .describe(\"Dimensions to group the Search Console query by.\"),\n  searchType: searchTypeSchemaField,\n  dimensionFilters: z\n    .array(searchConsoleDimensionFilterSchema)\n    .max(10)\n    .optional()\n    .describe(\"Optional Search Console dimension filters.\"),\n  aggregationType: z\n    .enum(searchConsoleAggregationTypes)\n    .optional()\n    .describe(\"Aggregation type for the Search Console query.\"),\n  rowLimit: rowLimitSchemaField,\n  startRow: startRowSchemaField,\n});\n\nexport async function searchConsoleSearchPerformanceHandler(\n  params: z.infer<typeof searchConsoleSearchPerformanceSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const dimensions = params.dimensions ?? [];\n    const body = buildSearchConsoleQueryBody({\n      startDate: params.startDate,\n      endDate: params.endDate,\n      dimensions,\n      searchType: params.searchType,\n      dimensionFilters: params.dimensionFilters,\n      aggregationType: params.aggregationType,\n      rowLimit: params.rowLimit,\n      startRow: params.startRow,\n    });\n\n    const response = await querySearchConsolePerformance(siteUrl, body);\n    const rows = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, dimensions));\n    const totals = sumSearchConsoleRows(rows);\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        profile_id: params.profileId?.trim() || undefined,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        query: {\n          dimensions,\n          search_type: params.searchType ?? \"web\",\n          aggregation_type: params.aggregationType ?? response.responseAggregationType,\n          dimension_filters: params.dimensionFilters,\n        },\n        overview: {\n          total_clicks: totals.clicks,\n          total_impressions: totals.impressions,\n          average_ctr_percent: totals.ctrPercent,\n          average_position: totals.averagePosition,\n        },\n        rows,\n        metadata: buildPaginationMetadata({\n          startRow: params.startRow,\n          rowLimit: params.rowLimit,\n          returnedRows: rows.length,\n        }),\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Search Console search performance\"\n    );\n  }\n}\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  buildPaginationMetadata,\n  buildSearchConsoleQueryBody,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  rowLimitSchemaField,\n  searchConsoleAggregationTypes,\n  searchConsoleDimensionFilterSchema,\n  searchConsoleDimensions,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  startRowSchemaField,\n  sumSearchConsoleRows,\n  normalizeSearchConsoleRow,\n} from \"../../services/search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleSearchPerformanceSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  dimensions: z\n    .array(z.enum(searchConsoleDimensions))\n    .max(5)\n    .optional()\n    .describe(\"Dimensions to group the Search Console query by.\"),\n  searchType: searchTypeSchemaField,\n  dimensionFilters: z\n    .array(searchConsoleDimensionFilterSchema)\n    .max(10)\n    .optional()\n    .describe(\"Optional Search Console dimension filters.\"),\n  aggregationType: z\n    .enum(searchConsoleAggregationTypes)\n    .optional()\n    .describe(\"Aggregation type for the Search Console query.\"),\n  rowLimit: rowLimitSchemaField,\n  startRow: startRowSchemaField,\n});\n\nexport async function searchConsoleSearchPerformanceHandler(\n  params: z.infer<typeof searchConsoleSearchPerformanceSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const dimensions = params.dimensions ?? [];\n    const body = buildSearchConsoleQueryBody({\n      startDate: params.startDate,\n      endDate: params.endDate,\n      dimensions,\n      searchType: params.searchType,\n      dimensionFilters: params.dimensionFilters,\n      aggregationType: params.aggregationType,\n      rowLimit: params.rowLimit,\n      startRow: params.startRow,\n    });\n\n    const response = await querySearchConsolePerformance(siteUrl, body);\n    const rows = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, dimensions));\n    const totals = sumSearchConsoleRows(rows);\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        profile_id: params.profileId?.trim() || undefined,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        query: {\n          dimensions,\n          search_type: params.searchType ?? \"web\",\n          aggregation_type: params.aggregationType ?? response.responseAggregationType,\n          dimension_filters: params.dimensionFilters,\n        },\n        overview: {\n          total_clicks: totals.clicks,\n          total_impressions: totals.impressions,\n          average_ctr_percent: totals.ctrPercent,\n          average_position: totals.averagePosition,\n        },\n        rows,\n        metadata: buildPaginationMetadata({\n          startRow: params.startRow,\n          rowLimit: params.rowLimit,\n          returnedRows: rows.length,\n        }),\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Search Console search performance\"\n    );\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,qCAAqC;AAC9C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,uCAAuC,EAAE,OAAO;AAAA,EAC3D,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY,EACT,MAAM,EAAE,KAAK,uBAAuB,CAAC,EACrC,IAAI,CAAC,EACL,SAAS,EACT,SAAS,kDAAkD;AAAA,EAC9D,YAAY;AAAA,EACZ,kBAAkB,EACf,MAAM,kCAAkC,EACxC,IAAI,EAAE,EACN,SAAS,EACT,SAAS,4CAA4C;AAAA,EACxD,iBAAiB,EACd,KAAK,6BAA6B,EAClC,SAAS,EACT,SAAS,gDAAgD;AAAA,EAC5D,UAAU;AAAA,EACV,UAAU;AACZ,CAAC;AAED,eAAsB,sCACpB,QACA;AACA,MAAI;AACF,UAAM,UAAU,4BAA4B,OAAO,SAAS,OAAO,SAAS;AAC5E,UAAM,aAAa,OAAO,cAAc,CAAC;AACzC,UAAM,OAAO,4BAA4B;AAAA,MACvC,WAAW,OAAO;AAAA,MAClB,SAAS,OAAO;AAAA,MAChB;AAAA,MACA,YAAY,OAAO;AAAA,MACnB,kBAAkB,OAAO;AAAA,MACzB,iBAAiB,OAAO;AAAA,MACxB,UAAU,OAAO;AAAA,MACjB,UAAU,OAAO;AAAA,IACnB,CAAC;AAED,UAAM,WAAW,MAAM,8BAA8B,SAAS,IAAI;AAClE,UAAM,QAAQ,SAAS,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,0BAA0B,KAAK,UAAU,CAAC;AAC1F,UAAM,SAAS,qBAAqB,IAAI;AAExC,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,QACV,YAAY,OAAO,WAAW,KAAK,KAAK;AAAA,QACxC,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,OAAO;AAAA,UACL;AAAA,UACA,aAAa,OAAO,cAAc;AAAA,UAClC,kBAAkB,OAAO,mBAAmB,SAAS;AAAA,UACrD,mBAAmB,OAAO;AAAA,QAC5B;AAAA,QACA,UAAU;AAAA,UACR,cAAc,OAAO;AAAA,UACrB,mBAAmB,OAAO;AAAA,UAC1B,qBAAqB,OAAO;AAAA,UAC5B,kBAAkB,OAAO;AAAA,QAC3B;AAAA,QACA;AAAA,QACA,UAAU,wBAAwB;AAAA,UAChC,UAAU,OAAO;AAAA,UACjB,UAAU,OAAO;AAAA,UACjB,cAAc,KAAK;AAAA,QACrB,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/src/tools/search-console/site-context.js

@@ -6,7 +6,7 @@ import {
   profileIdSchemaField,
   resolveSearchConsoleSiteUrl,
   siteUrlSchemaField
-} from "../../search-console/search-console-utils.js";
+} from "../../services/search-console/search-console-utils.js";
 import { stripNulls } from "../../utils/strip-payload.js";
 const searchConsoleSiteContextSchema = z.object({
   siteUrl: siteUrlSchemaField,

package/dist/src/tools/search-console/site-context.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/search-console/site-context.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { listSearchConsoleSites } from \"../../services/search-console/search-console-client.js\";\nimport {\n  inferSearchConsolePropertyType,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  siteUrlSchemaField,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleSiteContextSchema = z.object({\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n});\n\nexport async function searchConsoleSiteContextHandler(\n  params: z.infer<typeof searchConsoleSiteContextSchema>\n) {\n  try {\n    const resolvedSiteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const sites = await listSearchConsoleSites();\n    const matchingSite = sites.find((site) => site.siteUrl === resolvedSiteUrl);\n\n    if (!matchingSite) {\n      throw new Error(\n        `Search Console site \"${resolvedSiteUrl}\" is not accessible with the current credentials. Call gsc_list_accessible_sites to see the available properties.`\n      );\n    }\n\n    return object(\n      stripNulls({\n        site_url: resolvedSiteUrl,\n        source: params.siteUrl?.trim() ? \"explicit_parameter\" : \"future_profile_resolution\",\n        property_type: inferSearchConsolePropertyType(resolvedSiteUrl),\n        permission_level: matchingSite.permissionLevel?.toLowerCase(),\n        profile_id: params.profileId?.trim() || undefined,\n        is_accessible: true,\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to resolve Search Console site context\");\n  }\n}\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { listSearchConsoleSites } from \"../../services/search-console/search-console-client.js\";\nimport {\n  inferSearchConsolePropertyType,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  siteUrlSchemaField,\n} from \"../../services/search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleSiteContextSchema = z.object({\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n});\n\nexport async function searchConsoleSiteContextHandler(\n  params: z.infer<typeof searchConsoleSiteContextSchema>\n) {\n  try {\n    const resolvedSiteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const sites = await listSearchConsoleSites();\n    const matchingSite = sites.find((site) => site.siteUrl === resolvedSiteUrl);\n\n    if (!matchingSite) {\n      throw new Error(\n        `Search Console site \"${resolvedSiteUrl}\" is not accessible with the current credentials. Call gsc_list_accessible_sites to see the available properties.`\n      );\n    }\n\n    return object(\n      stripNulls({\n        site_url: resolvedSiteUrl,\n        source: params.siteUrl?.trim() ? \"explicit_parameter\" : \"future_profile_resolution\",\n        property_type: inferSearchConsolePropertyType(resolvedSiteUrl),\n        permission_level: matchingSite.permissionLevel?.toLowerCase(),\n        profile_id: params.profileId?.trim() || undefined,\n        is_accessible: true,\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to resolve Search Console site context\");\n  }\n}\n"],
   "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,8BAA8B;AACvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,iCAAiC,EAAE,OAAO;AAAA,EACrD,SAAS;AAAA,EACT,WAAW;AACb,CAAC;AAED,eAAsB,gCACpB,QACA;AACA,MAAI;AACF,UAAM,kBAAkB,4BAA4B,OAAO,SAAS,OAAO,SAAS;AACpF,UAAM,QAAQ,MAAM,uBAAuB;AAC3C,UAAM,eAAe,MAAM,KAAK,CAAC,SAAS,KAAK,YAAY,eAAe;AAE1E,QAAI,CAAC,cAAc;AACjB,YAAM,IAAI;AAAA,QACR,wBAAwB,eAAe;AAAA,MACzC;AAAA,IACF;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,QACV,QAAQ,OAAO,SAAS,KAAK,IAAI,uBAAuB;AAAA,QACxD,eAAe,+BAA+B,eAAe;AAAA,QAC7D,kBAAkB,aAAa,iBAAiB,YAAY;AAAA,QAC5D,YAAY,OAAO,WAAW,KAAK,KAAK;AAAA,QACxC,eAAe;AAAA,MACjB,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,+CAA+C;AAAA,EACnG;AACF;",
   "names": []
 }

package/dist/src/tools/search-console/visibility-declines.js

@@ -14,7 +14,7 @@ import {
   searchTypeSchemaField,
   siteUrlSchemaField,
   normalizeSearchConsoleRow
-} from "../../search-console/search-console-utils.js";
+} from "../../services/search-console/search-console-utils.js";
 import { stripNulls } from "../../utils/strip-payload.js";
 const searchConsoleVisibilityDeclinesSchema = z.object({
   currentStartDate: currentStartDateSchemaField,

package/dist/src/tools/search-console/visibility-declines.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/search-console/visibility-declines.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  buildComparisonMap,\n  buildSearchConsoleQueryBody,\n  computeChangePercent,\n  currentEndDateSchemaField,\n  currentStartDateSchemaField,\n  previousEndDateSchemaField,\n  previousStartDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleVisibilityDeclinesSchema = z.object({\n  currentStartDate: currentStartDateSchemaField,\n  currentEndDate: currentEndDateSchemaField,\n  previousStartDate: previousStartDateSchemaField,\n  previousEndDate: previousEndDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  entityType: z\n    .enum([\"page\", \"pattern\"])\n    .optional()\n    .describe(\"Analyze individual pages or a filtered page pattern.\"),\n  pageContains: z\n    .string()\n    .optional()\n    .describe(\"Optional page substring filter to focus the visibility decline analysis.\"),\n  pageRegex: z\n    .string()\n    .optional()\n    .describe(\"Optional regex page filter to focus the decline analysis.\"),\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum previous-period impressions required to include an entity in the decline analysis.\"),\n});\n\nexport async function searchConsoleVisibilityDeclinesHandler(\n  params: z.infer<typeof searchConsoleVisibilityDeclinesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const entityType = params.entityType ?? \"page\";\n    const minImpressions = params.minImpressions ?? 50;\n    const dimensionFilters = [];\n\n    if (params.pageContains?.trim()) {\n      dimensionFilters.push({\n        dimension: \"page\",\n        operator: \"contains\",\n        expression: params.pageContains.trim(),\n      });\n    }\n\n    if (params.pageRegex?.trim()) {\n      dimensionFilters.push({\n        dimension: \"page\",\n        operator: \"includingRegex\",\n        expression: params.pageRegex.trim(),\n      });\n    }\n\n    const [currentResponse, previousResponse] = await Promise.all([\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.currentStartDate,\n          endDate: params.currentEndDate,\n          dimensions: [\"page\"],\n          searchType: params.searchType,\n          dimensionFilters,\n          rowLimit: 250,\n        })\n      ),\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.previousStartDate,\n          endDate: params.previousEndDate,\n          dimensions: [\"page\"],\n          searchType: params.searchType,\n          dimensionFilters,\n          rowLimit: 250,\n        })\n      ),\n    ]);\n\n    const currentRows = (currentResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"page\"])\n    );\n    const previousRows = (previousResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"page\"])\n    );\n    const previousMap = buildComparisonMap(previousRows, (row) => row.dimensions.page);\n\n    const currentMap = buildComparisonMap(currentRows, (row) => row.dimensions.page);\n    const allPages = new Set([\n      ...currentRows.map((row) => row.dimensions.page),\n      ...previousRows.map((row) => row.dimensions.page),\n    ]);\n\n    const declines = Array.from(allPages)\n      .map((page) => {\n        const currentRow = currentMap.get(page);\n        const previousRow = previousMap.get(page);\n        return {\n          page,\n          current_clicks: currentRow?.clicks ?? 0,\n          previous_clicks: previousRow?.clicks ?? 0,\n          current_impressions: currentRow?.impressions ?? 0,\n          previous_impressions: previousRow?.impressions ?? 0,\n          current_ctr_percent: currentRow?.ctr_percent ?? 0,\n          previous_ctr_percent: previousRow?.ctr_percent ?? 0,\n          current_position: currentRow?.position ?? 0,\n          previous_position: previousRow?.position ?? 0,\n        };\n      })\n      .filter((row) => row.previous_impressions >= minImpressions)\n      .map((row) => ({\n        ...row,\n        clicks_change_percent: computeChangePercent(row.current_clicks, row.previous_clicks),\n        impressions_change_percent: computeChangePercent(\n          row.current_impressions,\n          row.previous_impressions\n        ),\n        ctr_change_percent: computeChangePercent(row.current_ctr_percent, row.previous_ctr_percent),\n        position_change: row.current_position - row.previous_position,\n      }))\n      .filter(\n        (row) =>\n          (row.clicks_change_percent ?? 0) < 0 ||\n          (row.impressions_change_percent ?? 0) < 0 ||\n          row.position_change > 0\n      )\n      .sort((left, right) => (left.clicks_change_percent ?? 0) - (right.clicks_change_percent ?? 0));\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        comparison: {\n          current_period: {\n            start_date: params.currentStartDate,\n            end_date: params.currentEndDate,\n          },\n          previous_period: {\n            start_date: params.previousStartDate,\n            end_date: params.previousEndDate,\n          },\n        },\n        filters: {\n          entity_type: entityType,\n          page_contains: params.pageContains,\n          page_regex: params.pageRegex,\n          min_impressions: minImpressions,\n        },\n        declines,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to detect Search Console visibility declines\"\n    );\n  }\n}\n"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  buildComparisonMap,\n  buildSearchConsoleQueryBody,\n  computeChangePercent,\n  currentEndDateSchemaField,\n  currentStartDateSchemaField,\n  previousEndDateSchemaField,\n  previousStartDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../services/search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleVisibilityDeclinesSchema = z.object({\n  currentStartDate: currentStartDateSchemaField,\n  currentEndDate: currentEndDateSchemaField,\n  previousStartDate: previousStartDateSchemaField,\n  previousEndDate: previousEndDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  entityType: z\n    .enum([\"page\", \"pattern\"])\n    .optional()\n    .describe(\"Analyze individual pages or a filtered page pattern.\"),\n  pageContains: z\n    .string()\n    .optional()\n    .describe(\"Optional page substring filter to focus the visibility decline analysis.\"),\n  pageRegex: z\n    .string()\n    .optional()\n    .describe(\"Optional regex page filter to focus the decline analysis.\"),\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum previous-period impressions required to include an entity in the decline analysis.\"),\n});\n\nexport async function searchConsoleVisibilityDeclinesHandler(\n  params: z.infer<typeof searchConsoleVisibilityDeclinesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const entityType = params.entityType ?? \"page\";\n    const minImpressions = params.minImpressions ?? 50;\n    const dimensionFilters = [];\n\n    if (params.pageContains?.trim()) {\n      dimensionFilters.push({\n        dimension: \"page\",\n        operator: \"contains\",\n        expression: params.pageContains.trim(),\n      });\n    }\n\n    if (params.pageRegex?.trim()) {\n      dimensionFilters.push({\n        dimension: \"page\",\n        operator: \"includingRegex\",\n        expression: params.pageRegex.trim(),\n      });\n    }\n\n    const [currentResponse, previousResponse] = await Promise.all([\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.currentStartDate,\n          endDate: params.currentEndDate,\n          dimensions: [\"page\"],\n          searchType: params.searchType,\n          dimensionFilters,\n          rowLimit: 250,\n        })\n      ),\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.previousStartDate,\n          endDate: params.previousEndDate,\n          dimensions: [\"page\"],\n          searchType: params.searchType,\n          dimensionFilters,\n          rowLimit: 250,\n        })\n      ),\n    ]);\n\n    const currentRows = (currentResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"page\"])\n    );\n    const previousRows = (previousResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"page\"])\n    );\n    const previousMap = buildComparisonMap(previousRows, (row) => row.dimensions.page);\n\n    const currentMap = buildComparisonMap(currentRows, (row) => row.dimensions.page);\n    const allPages = new Set([\n      ...currentRows.map((row) => row.dimensions.page),\n      ...previousRows.map((row) => row.dimensions.page),\n    ]);\n\n    const declines = Array.from(allPages)\n      .map((page) => {\n        const currentRow = currentMap.get(page);\n        const previousRow = previousMap.get(page);\n        return {\n          page,\n          current_clicks: currentRow?.clicks ?? 0,\n          previous_clicks: previousRow?.clicks ?? 0,\n          current_impressions: currentRow?.impressions ?? 0,\n          previous_impressions: previousRow?.impressions ?? 0,\n          current_ctr_percent: currentRow?.ctr_percent ?? 0,\n          previous_ctr_percent: previousRow?.ctr_percent ?? 0,\n          current_position: currentRow?.position ?? 0,\n          previous_position: previousRow?.position ?? 0,\n        };\n      })\n      .filter((row) => row.previous_impressions >= minImpressions)\n      .map((row) => ({\n        ...row,\n        clicks_change_percent: computeChangePercent(row.current_clicks, row.previous_clicks),\n        impressions_change_percent: computeChangePercent(\n          row.current_impressions,\n          row.previous_impressions\n        ),\n        ctr_change_percent: computeChangePercent(row.current_ctr_percent, row.previous_ctr_percent),\n        position_change: row.current_position - row.previous_position,\n      }))\n      .filter(\n        (row) =>\n          (row.clicks_change_percent ?? 0) < 0 ||\n          (row.impressions_change_percent ?? 0) < 0 ||\n          row.position_change > 0\n      )\n      .sort((left, right) => (left.clicks_change_percent ?? 0) - (right.clicks_change_percent ?? 0));\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        comparison: {\n          current_period: {\n            start_date: params.currentStartDate,\n            end_date: params.currentEndDate,\n          },\n          previous_period: {\n            start_date: params.previousStartDate,\n            end_date: params.previousEndDate,\n          },\n        },\n        filters: {\n          entity_type: entityType,\n          page_contains: params.pageContains,\n          page_regex: params.pageRegex,\n          min_impressions: minImpressions,\n        },\n        declines,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to detect Search Console visibility declines\"\n    );\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

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

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import {
+  buildSkuUpdatePayload,
+  getSku,
+  updateSku
+} from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const activateSkuSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  skuId: z.string().min(1).describe("VTEX SKU identifier to activate.")
+});
+async function activateSkuHandler({
+  profileId,
+  skuId
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const beforeSku = await getSku(resolvedProfileId, skuId);
+    const afterSku = await updateSku(
+      resolvedProfileId,
+      skuId,
+      buildSkuUpdatePayload(beforeSku, { isActive: true })
+    );
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "activate_sku",
+      resourceId: skuId,
+      riskLevel: "low",
+      message: "SKU activated successfully.",
+      before: beforeSku,
+      after: afterSku,
+      details: {
+        sku_id: skuId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to activate SKU ${skuId}`);
+  }
+}
+export {
+  activateSkuHandler,
+  activateSkuSchema
+};
+//# sourceMappingURL=activate-sku.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/activate-sku.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  buildSkuUpdatePayload,\n  getSku,\n  updateSku,\n} from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const activateSkuSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  skuId: z.string().min(1).describe(\"VTEX SKU identifier to activate.\"),\n});\n\nexport async function activateSkuHandler({\n  profileId,\n  skuId,\n}: z.infer<typeof activateSkuSchema>) {\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 beforeSku = await getSku(resolvedProfileId, skuId);\n    const afterSku = await updateSku(\n      resolvedProfileId,\n      skuId,\n      buildSkuUpdatePayload(beforeSku, { isActive: true })\n    );\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"activate_sku\",\n      resourceId: skuId,\n      riskLevel: \"low\",\n      message: \"SKU activated successfully.\",\n      before: beforeSku,\n      after: afterSku,\n      details: {\n        sku_id: skuId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to activate SKU ${skuId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,kCAAkC;AACtE,CAAC;AAED,eAAsB,mBAAmB;AAAA,EACvC;AAAA,EACA;AACF,GAAsC;AACpC,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,YAAY,MAAM,OAAO,mBAAmB,KAAK;AACvD,UAAM,WAAW,MAAM;AAAA,MACrB;AAAA,MACA;AAAA,MACA,sBAAsB,WAAW,EAAE,UAAU,KAAK,CAAC;AAAA,IACrD;AAEA,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,0BAA0B,KAAK,EAAE;AAAA,EACpE;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/add-order-tracking.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import {
+  getOrderStateSnapshot,
+  updateOrderTrackingStatus,
+  updatePartialInvoiceTracking,
+  validateOrderForTracking
+} from "../../services/vtex/vtex-orders-write.js";
+import {
+  buildWriteSuccessResponse,
+  confirmationNoteSchemaField,
+  confirmationSchemaField,
+  handleVtexWriteError,
+  requireExplicitConfirmation,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const trackingEventSchema = z.object({
+  city: z.string().min(1).describe("Tracking event city."),
+  state: z.string().min(1).describe("Tracking event state."),
+  description: z.string().min(1).describe("Tracking event description."),
+  date: z.string().min(1).describe("Tracking event date string.")
+});
+const addOrderTrackingSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  orderId: z.string().min(1).describe("VTEX order identifier."),
+  invoiceNumber: z.string().min(1).describe("Invoice number that will receive tracking data."),
+  confirmed: confirmationSchemaField,
+  confirmationNote: confirmationNoteSchemaField,
+  trackingNumber: z.string().min(1).describe("Tracking number."),
+  trackingUrl: z.string().url().optional().describe("Tracking URL."),
+  courier: z.string().optional().describe("Carrier name."),
+  dispatchedDate: z.string().min(1).describe("Dispatch timestamp."),
+  isDelivered: z.boolean().optional().describe("Optional delivery status to send to VTEX tracking timeline."),
+  deliveredDate: z.string().optional().describe("Optional delivered date in `yyyy-mm-dd hh:mm` format."),
+  events: z.array(trackingEventSchema).optional().describe("Optional tracking events timeline.")
+});
+async function addOrderTrackingHandler({
+  profileId,
+  orderId,
+  invoiceNumber,
+  confirmed,
+  confirmationNote,
+  trackingNumber,
+  trackingUrl,
+  courier,
+  dispatchedDate,
+  isDelivered,
+  deliveredDate,
+  events
+}) {
+  const confirmationResponse = requireExplicitConfirmation(confirmed, "add_order_tracking", {
+    order_id: orderId,
+    invoice_number: invoiceNumber
+  });
+  if (confirmationResponse) {
+    return confirmationResponse;
+  }
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const beforeOrder = await validateOrderForTracking(resolvedProfileId, orderId, invoiceNumber);
+    await updatePartialInvoiceTracking(resolvedProfileId, orderId, invoiceNumber, {
+      trackingNumber,
+      trackingUrl,
+      courier,
+      dispatchedDate
+    });
+    if (events?.length || isDelivered !== void 0) {
+      await updateOrderTrackingStatus(resolvedProfileId, orderId, invoiceNumber, {
+        isDelivered: isDelivered ?? false,
+        deliveredDate: deliveredDate ?? null,
+        events: events ?? []
+      });
+    }
+    const afterOrder = await getOrderStateSnapshot(resolvedProfileId, orderId);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "add_order_tracking",
+      resourceId: orderId,
+      riskLevel: "high",
+      confirmed: true,
+      confirmationNote,
+      message: "Order tracking updated successfully.",
+      before: beforeOrder,
+      after: afterOrder,
+      details: {
+        order_id: orderId,
+        invoice_number: invoiceNumber,
+        tracking_number: trackingNumber
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to update tracking for order ${orderId}`);
+  }
+}
+export {
+  addOrderTrackingHandler,
+  addOrderTrackingSchema
+};
+//# sourceMappingURL=add-order-tracking.js.map

package/dist/src/tools/vtex/add-order-tracking.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/add-order-tracking.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  getOrderStateSnapshot,\n  updateOrderTrackingStatus,\n  updatePartialInvoiceTracking,\n  validateOrderForTracking,\n} from \"../../services/vtex/vtex-orders-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  confirmationNoteSchemaField,\n  confirmationSchemaField,\n  handleVtexWriteError,\n  requireExplicitConfirmation,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nconst trackingEventSchema = z.object({\n  city: z.string().min(1).describe(\"Tracking event city.\"),\n  state: z.string().min(1).describe(\"Tracking event state.\"),\n  description: z.string().min(1).describe(\"Tracking event description.\"),\n  date: z.string().min(1).describe(\"Tracking event date string.\"),\n});\n\nexport const addOrderTrackingSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  orderId: z.string().min(1).describe(\"VTEX order identifier.\"),\n  invoiceNumber: z.string().min(1).describe(\"Invoice number that will receive tracking data.\"),\n  confirmed: confirmationSchemaField,\n  confirmationNote: confirmationNoteSchemaField,\n  trackingNumber: z.string().min(1).describe(\"Tracking number.\"),\n  trackingUrl: z.string().url().optional().describe(\"Tracking URL.\"),\n  courier: z.string().optional().describe(\"Carrier name.\"),\n  dispatchedDate: z.string().min(1).describe(\"Dispatch timestamp.\"),\n  isDelivered: z\n    .boolean()\n    .optional()\n    .describe(\"Optional delivery status to send to VTEX tracking timeline.\"),\n  deliveredDate: z\n    .string()\n    .optional()\n    .describe(\"Optional delivered date in `yyyy-mm-dd hh:mm` format.\"),\n  events: z.array(trackingEventSchema).optional().describe(\"Optional tracking events timeline.\"),\n});\n\nexport async function addOrderTrackingHandler({\n  profileId,\n  orderId,\n  invoiceNumber,\n  confirmed,\n  confirmationNote,\n  trackingNumber,\n  trackingUrl,\n  courier,\n  dispatchedDate,\n  isDelivered,\n  deliveredDate,\n  events,\n}: z.infer<typeof addOrderTrackingSchema>) {\n  const confirmationResponse = requireExplicitConfirmation(confirmed, \"add_order_tracking\", {\n    order_id: orderId,\n    invoice_number: invoiceNumber,\n  });\n  if (confirmationResponse) {\n    return confirmationResponse;\n  }\n\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 beforeOrder = await validateOrderForTracking(resolvedProfileId, orderId, invoiceNumber);\n\n    await updatePartialInvoiceTracking(resolvedProfileId, orderId, invoiceNumber, {\n      trackingNumber,\n      trackingUrl,\n      courier,\n      dispatchedDate,\n    });\n\n    if (events?.length || isDelivered !== undefined) {\n      await updateOrderTrackingStatus(resolvedProfileId, orderId, invoiceNumber, {\n        isDelivered: isDelivered ?? false,\n        deliveredDate: deliveredDate ?? null,\n        events: events ?? [],\n      });\n    }\n\n    const afterOrder = await getOrderStateSnapshot(resolvedProfileId, orderId);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"add_order_tracking\",\n      resourceId: orderId,\n      riskLevel: \"high\",\n      confirmed: true,\n      confirmationNote,\n      message: \"Order tracking updated successfully.\",\n      before: beforeOrder as unknown as Record<string, unknown>,\n      after: afterOrder as unknown as Record<string, unknown>,\n      details: {\n        order_id: orderId,\n        invoice_number: invoiceNumber,\n        tracking_number: trackingNumber,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to update tracking for order ${orderId}`);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/vtex/associate-specification.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import {
+  associateProductSpecification,
+  associateSkuSpecification
+} from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const associateSpecificationSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  entityType: z.enum(["product", "sku"]).describe("Whether the specification should be associated to a product or an SKU."),
+  resourceId: z.string().min(1).describe("Product ID or SKU ID depending on entityType."),
+  fieldId: z.number().int().positive().describe("Specification field ID."),
+  fieldValueId: z.number().int().positive().optional().describe("Specification value ID. Required for combo, radio, and checkbox fields."),
+  text: z.string().optional().describe("Raw text value. Use for free text specifications instead of fieldValueId.")
+});
+async function associateSpecificationHandler({
+  profileId,
+  entityType,
+  resourceId,
+  fieldId,
+  fieldValueId,
+  text
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const payload = {
+      FieldId: fieldId
+    };
+    if (fieldValueId !== void 0) payload.FieldValueId = fieldValueId;
+    if (text !== void 0) payload.Text = text;
+    const association = entityType === "product" ? await associateProductSpecification(resolvedProfileId, resourceId, payload) : await associateSkuSpecification(resolvedProfileId, resourceId, payload);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "associate_specification",
+      resourceId,
+      riskLevel: "low",
+      message: "Specification associated successfully.",
+      before: null,
+      after: association,
+      details: {
+        entity_type: entityType
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to associate specification to ${entityType} ${resourceId}`);
+  }
+}
+export {
+  associateSpecificationHandler,
+  associateSpecificationSchema
+};
+//# sourceMappingURL=associate-specification.js.map

package/dist/src/tools/vtex/associate-specification.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/associate-specification.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  associateProductSpecification,\n  associateSkuSpecification,\n} from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const associateSpecificationSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  entityType: z.enum([\"product\", \"sku\"]).describe(\"Whether the specification should be associated to a product or an SKU.\"),\n  resourceId: z.string().min(1).describe(\"Product ID or SKU ID depending on entityType.\"),\n  fieldId: z.number().int().positive().describe(\"Specification field ID.\"),\n  fieldValueId: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\"Specification value ID. Required for combo, radio, and checkbox fields.\"),\n  text: z\n    .string()\n    .optional()\n    .describe(\"Raw text value. Use for free text specifications instead of fieldValueId.\"),\n});\n\nexport async function associateSpecificationHandler({\n  profileId,\n  entityType,\n  resourceId,\n  fieldId,\n  fieldValueId,\n  text,\n}: z.infer<typeof associateSpecificationSchema>) {\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 payload: Record<string, unknown> = {\n      FieldId: fieldId,\n    };\n    if (fieldValueId !== undefined) payload.FieldValueId = fieldValueId;\n    if (text !== undefined) payload.Text = text;\n\n    const association =\n      entityType === \"product\"\n        ? await associateProductSpecification(resolvedProfileId, resourceId, payload)\n        : await associateSkuSpecification(resolvedProfileId, resourceId, payload);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"associate_specification\",\n      resourceId,\n      riskLevel: \"low\",\n      message: \"Specification associated successfully.\",\n      before: null,\n      after: association,\n      details: {\n        entity_type: entityType,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to associate specification to ${entityType} ${resourceId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,+BAA+B,EAAE,OAAO;AAAA,EACnD,WAAW;AAAA,EACX,YAAY,EAAE,KAAK,CAAC,WAAW,KAAK,CAAC,EAAE,SAAS,wEAAwE;AAAA,EACxH,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,+CAA+C;AAAA,EACtF,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,yBAAyB;AAAA,EACvE,cAAc,EACX,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,yEAAyE;AAAA,EACrF,MAAM,EACH,OAAO,EACP,SAAS,EACT,SAAS,2EAA2E;AACzF,CAAC;AAED,eAAsB,8BAA8B;AAAA,EAClD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAiD;AAC/C,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,UAAmC;AAAA,MACvC,SAAS;AAAA,IACX;AACA,QAAI,iBAAiB,OAAW,SAAQ,eAAe;AACvD,QAAI,SAAS,OAAW,SAAQ,OAAO;AAEvC,UAAM,cACJ,eAAe,YACX,MAAM,8BAA8B,mBAAmB,YAAY,OAAO,IAC1E,MAAM,0BAA0B,mBAAmB,YAAY,OAAO;AAE5E,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX;AAAA,MACA,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,SAAS;AAAA,QACP,aAAa;AAAA,MACf;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,wCAAwC,UAAU,IAAI,UAAU,EAAE;AAAA,EACrG;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/attach-catalog-image.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { createSkuFile } from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const attachCatalogImageSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  skuId: z.string().min(1).describe("SKU identifier that will receive the image."),
+  name: z.string().min(1).describe("Image name."),
+  url: z.string().url().describe("Public image URL. VTEX expects http(s) and a valid image extension."),
+  isMain: z.boolean().optional().describe("Whether this image should be the main image."),
+  label: z.string().optional().describe("Optional image label."),
+  text: z.string().optional().describe("Optional image text."),
+  position: z.number().int().nonnegative().optional().describe("Image position in storefront.")
+});
+async function attachCatalogImageHandler({
+  profileId,
+  skuId,
+  name,
+  url,
+  isMain,
+  label,
+  text,
+  position
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const createdImage = await createSkuFile(resolvedProfileId, skuId, {
+      Name: name,
+      Url: url,
+      IsMain: isMain,
+      Label: label,
+      Text: text,
+      Position: position
+    });
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "attach_catalog_image",
+      resourceId: skuId,
+      riskLevel: "low",
+      message: "Catalog image attached successfully.",
+      before: null,
+      after: createdImage,
+      details: {
+        sku_id: skuId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to attach image to SKU ${skuId}`);
+  }
+}
+export {
+  attachCatalogImageHandler,
+  attachCatalogImageSchema
+};
+//# sourceMappingURL=attach-catalog-image.js.map

package/dist/src/tools/vtex/attach-catalog-image.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/attach-catalog-image.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport { createSkuFile } from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const attachCatalogImageSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  skuId: z.string().min(1).describe(\"SKU identifier that will receive the image.\"),\n  name: z.string().min(1).describe(\"Image name.\"),\n  url: z\n    .string()\n    .url()\n    .describe(\"Public image URL. VTEX expects http(s) and a valid image extension.\"),\n  isMain: z.boolean().optional().describe(\"Whether this image should be the main image.\"),\n  label: z.string().optional().describe(\"Optional image label.\"),\n  text: z.string().optional().describe(\"Optional image text.\"),\n  position: z.number().int().nonnegative().optional().describe(\"Image position in storefront.\"),\n});\n\nexport async function attachCatalogImageHandler({\n  profileId,\n  skuId,\n  name,\n  url,\n  isMain,\n  label,\n  text,\n  position,\n}: z.infer<typeof attachCatalogImageSchema>) {\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 createdImage = await createSkuFile(resolvedProfileId, skuId, {\n      Name: name,\n      Url: url,\n      IsMain: isMain,\n      Label: label,\n      Text: text,\n      Position: position,\n    });\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"attach_catalog_image\",\n      resourceId: skuId,\n      riskLevel: \"low\",\n      message: \"Catalog image attached successfully.\",\n      before: null,\n      after: createdImage,\n      details: {\n        sku_id: skuId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to attach image to SKU ${skuId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EAC/C,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,6CAA6C;AAAA,EAC/E,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,aAAa;AAAA,EAC9C,KAAK,EACF,OAAO,EACP,IAAI,EACJ,SAAS,qEAAqE;AAAA,EACjF,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,8CAA8C;AAAA,EACtF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,uBAAuB;AAAA,EAC7D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,sBAAsB;AAAA,EAC3D,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,+BAA+B;AAC9F,CAAC;AAED,eAAsB,0BAA0B;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA6C;AAC3C,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,eAAe,MAAM,cAAc,mBAAmB,OAAO;AAAA,MACjE,MAAM;AAAA,MACN,KAAK;AAAA,MACL,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,MAAM;AAAA,MACN,UAAU;AAAA,IACZ,CAAC;AAED,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,iCAAiC,KAAK,EAAE;AAAA,EAC3E;AACF;",
+  "names": []
+}