@datadive-tools/mcp 0.19.0 → 0.20.0

package/dist/index.js

@@ -27,7 +27,7 @@ function loadConfig(env = process.env) {
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // src/tools/list-niches.ts
-import { z } from "zod";
+import { z as z2 } from "zod";
 
 // src/http/errors.ts
 var KEY_HELP_URL2 = "https://2.datadive.tools/api-key";
@@ -144,7 +144,7 @@ function extractMessage(body) {
 }
 
 // package.json
-var version = "0.19.0";
+var version = "0.20.0";
 
 // src/http/client.ts
 var PKG_VERSION = version;
@@ -276,6 +276,10 @@ function buildUrl(baseUrl, path, query) {
   if (query) {
     for (const [k, v] of Object.entries(query)) {
       if (v === void 0 || v === null) continue;
+      if (Array.isArray(v)) {
+        for (const item of v) u.searchParams.append(k, String(item));
+        continue;
+      }
       u.searchParams.set(k, String(v));
     }
   }
@@ -308,24 +312,111 @@ function isObject(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
 
+// src/tools/niche-tag-ids.ts
+import { z } from "zod";
+
+// src/types/api.ts
+var ISO_8601 = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?)?$/;
+var SUPPORTED_MARKETPLACES = [
+  "com",
+  "ca",
+  "co.uk",
+  "com.mx",
+  "in",
+  "fr",
+  "de",
+  "es",
+  "it",
+  "co.jp"
+];
+var NICHE_TAG_IDS_MAX_PER_CALL = 100;
+var NICHE_KEYWORDS_MAX_PER_CALL = 100;
+var NICHE_KEYWORD_MAX_LENGTH = 255;
+var KEYWORD_EXCLUSIONS_MAX_PER_CALL = 100;
+var KEYWORD_EXCLUSIONS_MAX_PER_NICHE = 1e3;
+var RANK_RADAR_STATES = ["ACTIVE", "PAUSED", "ARCHIVED"];
+var RANK_RADAR_STATUSES = [...RANK_RADAR_STATES, "ALL"];
+var TAG_TITLE_MAX_LENGTH = 100;
+var TAG_KEYWORD_IDS_MAX = 1e3;
+var TAG_RESERVED_COLOR = "#EB5757";
+var TAG_HEX_COLOR_PATTERN = /^#[0-9A-Fa-f]{6}$/;
+var PPC_CAMPAIGN_BASE_SORT_BY = [
+  "name",
+  "state",
+  "bidStrategy",
+  "budget",
+  "impressions",
+  "clicks",
+  "ctr",
+  "cpc",
+  "spend",
+  "unitsSold",
+  "sales",
+  "acos",
+  "cvr",
+  "tosImpressionShare"
+];
+var PPC_CAMPAIGN_PLACEMENT_SORT_BY = [
+  ...["tos", "ros", "pp", "off"].flatMap(
+    (p) => ["Impressions", "Clicks", "Spend", "Sales", "UnitsSold", "Ctr", "Cpc", "Acos"].map(
+      (m) => `${p}${m}`
+    )
+  ),
+  "tosBidAdjustment",
+  "rosBidAdjustment",
+  "ppBidAdjustment"
+];
+var PPC_CAMPAIGN_STATES = ["ENABLED", "PAUSED"];
+var ALERT_STATUSES = ["active", "resolved", "all"];
+var BILLABLE_FEATURE_TYPES = [
+  "DIVED_ASINS",
+  "PRODUCT_BRIEF_ASINS",
+  "AI_COPYWRITER_PROMPTS",
+  "RANK_RADAR_KEYWORDS"
+];
+var CATALOG_STATUSES = ["Active", "all"];
+var LISTING_CHANGE_TYPES = ["Price", "Content", "Image"];
+var LISTING_CHANGE_SORT_BY = ["date", "type"];
+var SORT_ORDER = ["ASC", "DESC"];
+var ADD_SEARCH_TERMS_MAX = 1e3;
+var LISTING_COPY_STRATEGIES = ["cosmo", "ranking-juice", "nlp", "cosmo-rufus"];
+var FAST_KEYWORDS_MAX_PAGE_SIZE = 100;
+
+// src/tools/niche-tag-ids.ts
+var tagId = () => z.number().int().min(1);
+function unique(schema, field) {
+  return schema.refine((ids) => new Set(ids).size === ids.length, {
+    message: `${field} must not contain the same id twice`
+  });
+}
+var nicheTagIdList = (field) => unique(z.array(tagId()).min(1).max(NICHE_TAG_IDS_MAX_PER_CALL), field);
+var tagFilterIdList = (field) => unique(z.array(tagId()).max(NICHE_TAG_IDS_MAX_PER_CALL), field);
+var NICHE_TAG_WRITE_RULES = "Only the organization owner or a team admin can change a niche's Spaces and labels; anyone else is refused with a 403 (INSUFFICIENT_ROLE), so tell the user instead of retrying. A change is all or nothing: if any id is unknown, or a Space is one the user has only view rights on, the whole call fails and nothing changes (the error lists the offending ids). Ids already in the wanted state are counted, never errors, so a repeat is safe. Costs nothing. Limited to 2 calls per minute per niche, so put every id in one call.";
+
 // src/tools/list-niches.ts
 var LIST_NICHES_MAX_PAGE_SIZE = 50;
 var inputSchema = {
-  currentPage: z.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1. Keep requesting the next page while `hasNext` is true."),
-  pageSize: z.number().int().min(1).max(LIST_NICHES_MAX_PAGE_SIZE).optional().describe(`Items per page (max ${LIST_NICHES_MAX_PAGE_SIZE}). Defaults to 20.`),
-  searchText: z.string().trim().min(1).max(200).optional().describe(
+  currentPage: z2.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1. Keep requesting the next page while `hasNext` is true."),
+  pageSize: z2.number().int().min(1).max(LIST_NICHES_MAX_PAGE_SIZE).optional().describe(`Items per page (max ${LIST_NICHES_MAX_PAGE_SIZE}). Defaults to 20.`),
+  searchText: z2.string().trim().min(1).max(200).optional().describe(
     "Case-insensitive partial match on the niche label or hero keyword. Prefer this over paging through everything when the user names a niche."
   ),
-  searchAsin: z.string().trim().regex(/^[A-Za-z0-9]{10}$/, "must be a 10-character ASIN").optional().describe("Only niches whose competitor set contains this ASIN (10 characters, e.g. B08N5WRWNW)."),
-  orderBy: z.enum(["lastDived", "name"]).optional().describe(
+  searchAsin: z2.string().trim().regex(/^[A-Za-z0-9]{10}$/, "must be a 10-character ASIN").optional().describe("Only niches whose competitor set contains this ASIN (10 characters, e.g. B08N5WRWNW)."),
+  orderBy: z2.enum(["lastDived", "name"]).optional().describe(
     "Sort field: `lastDived` (by latestResearchDate, newest first by default) or `name` (by nicheLabel, A\u2192Z by default). Defaults to `lastDived`."
   ),
-  sortOrder: z.enum(["ASC", "DESC"]).optional().describe("Sort direction. Defaults to DESC for `lastDived` and ASC for `name`.")
+  sortOrder: z2.enum(["ASC", "DESC"]).optional().describe("Sort direction. Defaults to DESC for `lastDived` and ASC for `name`."),
+  spaces: tagFilterIdList("spaces").optional().describe(
+    "Only niches in at least one of these Spaces (ids from `list_spaces`, up to 100). Combines with `labels` and the other filters with AND."
+  ),
+  labels: tagFilterIdList("labels").optional().describe(
+    "Only niches with at least one of these labels (ids from `list_labels`, up to 100). Combines with `spaces` and the other filters with AND."
+  )
 };
 var listNichesTool = {
   name: "list_niches",
   title: "List DataDive Niches",
-  description: `Use this first when the user asks about their niches, or to find a \`nicheId\` for use with \`get_niche_keywords\`, \`get_niche_competitors\`, or \`get_ranking_juice\`. Retrieves a paginated list of Niches, newest dive first. Each Niche represents a market segment or product category being tracked. Returns nicheId, heroKeyword, nicheLabel, marketplace (com/uk/de/...), and latestResearchDate per niche, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev). Narrow with \`searchText\` (label/keyword) or \`searchAsin\` (a competitor ASIN) instead of scanning pages; a page holds at most ${LIST_NICHES_MAX_PAGE_SIZE} niches, so the full list of a large account needs several calls.`,
+  description: `Use this first when the user asks about their niches, or to find a \`nicheId\` for use with \`get_niche_keywords\`, \`get_niche_competitors\`, or \`get_ranking_juice\`. Retrieves a paginated list of Niches, newest dive first. Each Niche represents a market segment or product category being tracked. Returns nicheId, heroKeyword, nicheLabel, marketplace (com/uk/de/...), and latestResearchDate per niche, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev). Narrow with \`searchText\` (label/keyword) or \`searchAsin\` (a competitor ASIN), \`spaces\` or \`labels\` (ids from \`list_spaces\` / \`list_labels\`) instead of scanning pages; each niche lists the ids of its \`spaces\` and \`labels\`. A page holds at most ${LIST_NICHES_MAX_PAGE_SIZE} niches, so the full list of a large account needs several calls.`,
   inputSchema,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
@@ -338,185 +429,421 @@ var listNichesTool = {
         searchText: args.searchText,
         searchAsin: args.searchAsin,
         orderBy: args.orderBy,
-        sortOrder: args.sortOrder
+        sortOrder: args.sortOrder,
+        spaces: args.spaces,
+        labels: args.labels
       }
     );
   }
 };
 
-// src/tools/get-niche-keywords.ts
-import { z as z2 } from "zod";
+// src/tools/list-fast-keywords.ts
+import { z as z3 } from "zod";
 var inputSchema2 = {
-  nicheId: z2.string().min(1).describe("The unique identifier of the Niche (from `list_niches`).")
-};
-var getNicheKeywordsTool = {
-  name: "get_niche_keywords",
-  title: "Get Master Keyword List for a Niche",
-  description: 'Use this when the user asks about keywords, search terms, or search volume for a niche. Retrieves the master keyword list for the specified Niche \u2014 the relevant search terms monitored for ranking and performance metrics. For each keyword, returns search volume, relevancy (numeric score or "Outlier"), and competitor ASIN organic ranks (asinRanks: { ASIN -> rank | null }), plus `origin`: `mkl` (found by the dive), `manual` (added by hand with `add_niche_keywords`), `outlier` / `residue` (moved in from those lists). Only `manual`, `outlier` and `residue` keywords can be taken out with `remove_niche_keywords`. Keywords hidden by the niche\'s keyword exclusions are not listed; see `list_keyword_exclusions`. Also returns the latestResearchDate.',
+  currentPage: z3.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z3.number().int().min(1).max(FAST_KEYWORDS_MAX_PAGE_SIZE).optional().describe(`Items per page (max ${FAST_KEYWORDS_MAX_PAGE_SIZE}). Defaults to 20.`),
+  search: z3.string().trim().min(1).max(200).optional().describe("Case-insensitive partial match on ASIN, product title or brand."),
+  marketplace: z3.enum(SUPPORTED_MARKETPLACES).optional().describe("Only Fast Keywords runs from this marketplace.")
+};
+var listFastKeywordsTool = {
+  name: "list_fast_keywords",
+  title: "List Fast Keywords Runs",
+  description: "Use this first when the user asks about their Fast Keywords runs, or to find a `fastKeywordsId` for `get_fast_keywords`, `get_fast_keywords_keywords` or `refresh_fast_keywords`. Fast Keywords finds the keywords a product ranks for from just an ASIN, in minutes and for 1 Dive token, without a full niche dive. Lists the runs of the whole organization, newest request first: `fastKeywordsId`, `asin`, `parentAsin`, `marketplace`, `status` (`in-progress`, `success` or `failed`), `title`, `brand`, `price`, `keywordCount`, `totalSearchVolume`, `top10OrganicRankCount`, `rootCount`, `lastRefreshedAt` and `requestedAt`, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev). Narrow with `search` or `marketplace`.",
   inputSchema: inputSchema2,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
-    return await httpGet(
-      { config: ctx.config, toolName: "get_niche_keywords" },
-      `/v1/niches/${encodeURIComponent(args.nicheId)}/keywords`
-    );
+    return await httpGet({ config: ctx.config, toolName: "list_fast_keywords" }, "/v1/fast-keywords", {
+      currentPage: args.currentPage,
+      pageSize: args.pageSize,
+      search: args.search,
+      marketplace: args.marketplace
+    });
   }
 };
 
-// src/tools/list-keyword-exclusions.ts
-import { z as z3 } from "zod";
+// src/tools/get-fast-keywords.ts
+import { z as z4 } from "zod";
 var inputSchema3 = {
-  nicheId: z3.string().min(1).describe("The unique identifier of the Niche (from `list_niches`).")
+  fastKeywordsId: z4.number().int().min(1).describe("The Fast Keywords result id, from `run_fast_keywords`, `refresh_fast_keywords` or `list_fast_keywords`.")
 };
-var listKeywordExclusionsTool = {
-  name: "list_keyword_exclusions",
-  title: "List a Niche's Keyword Exclusions",
-  description: "Use this to see which keywords are hidden from a niche's Master Keyword List, e.g. when a keyword the user expects is missing from `get_niche_keywords`. Returns the same lists the DataDive web app shows, oldest first: `exact` \u2014 each entry hides the one keyword that matches it exactly, with that keyword's `searchVolume` (0 when the niche has no such keyword); `phrase` \u2014 each entry hides every keyword that contains the phrase, with `excludedKeywordsCount` and the total `searchVolume` of the keywords it hides (not counting ones already excluded exactly). Exclusions hide keywords wherever they come from: the dive, the Outliers and Residue lists, and hand-added ones. Change them with `add_keyword_exclusions` and `remove_keyword_exclusions`.",
+var getFastKeywordsTool = {
+  name: "get_fast_keywords",
+  title: "Get a Fast Keywords Result",
+  description: "Use this to poll a Fast Keywords run started with `run_fast_keywords` or `refresh_fast_keywords`, and to read its result. While `status` is `in-progress`, wait a few seconds and call again; stop at `success` or `failed`. On `failed`, `failureReason` and `failureMessage` say why (safe to show to the user). On `success` it returns the product (`title`, `brand`, `price`, `imageUrl`), its `variations`, `keywordCount`, `lastRefreshedAt`, the keyword `roots` (`root`, `aggregateSearchVolume`, `medianOrganicRank`, `keywords`) and the top 10 `competitors`. `insufficientKeywordData: true` means the run succeeded but found too few keywords to be useful. The keyword rows themselves are in `get_fast_keywords_keywords`.",
   inputSchema: inputSchema3,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
-      { config: ctx.config, toolName: "list_keyword_exclusions" },
-      `/v1/niches/${encodeURIComponent(args.nicheId)}/keyword-exclusions`
+      { config: ctx.config, toolName: "get_fast_keywords" },
+      `/v1/fast-keywords/${args.fastKeywordsId}`
     );
   }
 };
 
-// src/tools/get-niche-roots.ts
-import { z as z4 } from "zod";
+// src/tools/get-fast-keywords-keywords.ts
+import { z as z5 } from "zod";
 var inputSchema4 = {
-  nicheId: z4.string().min(1).describe("The unique identifier of the Niche (from `list_niches`).")
-};
-var getNicheRootsTool = {
-  name: "get_niche_roots",
-  title: "Get Keyword Roots for a Niche",
-  description: "Use this when the user wants to find the highest-impact words across a niche's keywords, asks about 'keyword roots', or wants to prioritize terms for a listing. Retrieves the keyword lexical roots for the Niche \u2014 individual words or word-combinations extracted from the Master Keyword List (e.g. 'bluetooth headphones' yields roots 'bluetooth', 'headphones', 'bluetooth headphones'). Returns `roots` and `normalizedRoots` tables, each item with root, frequency (how many keywords contain it), broadSearchVolume (summed search volume of those keywords), and broadSearchVolumeRatio (0-1, relative to the top root), plus the per-keyword breakdowns and latestResearchDate.",
+  fastKeywordsId: z5.number().int().min(1).describe("The Fast Keywords result id, from `run_fast_keywords` or `list_fast_keywords`."),
+  currentPage: z5.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z5.number().int().min(1).max(FAST_KEYWORDS_MAX_PAGE_SIZE).optional().describe(`Keywords per page (max ${FAST_KEYWORDS_MAX_PAGE_SIZE}). Defaults to 20.`)
+};
+var getFastKeywordsKeywordsTool = {
+  name: "get_fast_keywords_keywords",
+  title: "Get the Keywords of a Fast Keywords Result",
+  description: `Use this to read the keywords of a finished Fast Keywords run (check \`status\` is \`success\` with \`get_fast_keywords\` first). Returns \`keyword\`, \`searchVolume\`, \`organicRank\` and \`sponsoredRank\` per keyword, highest search volume first, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev). A page holds at most ${FAST_KEYWORDS_MAX_PAGE_SIZE} keywords; keep requesting the next page while \`hasNext\` is true.`,
   inputSchema: inputSchema4,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
-      { config: ctx.config, toolName: "get_niche_roots" },
-      `/v1/niches/${encodeURIComponent(args.nicheId)}/roots`
+      { config: ctx.config, toolName: "get_fast_keywords_keywords" },
+      `/v1/fast-keywords/${args.fastKeywordsId}/keywords`,
+      { currentPage: args.currentPage, pageSize: args.pageSize }
     );
   }
 };
 
-// src/tools/get-niche-competitors.ts
-import { z as z5 } from "zod";
+// src/tools/run-fast-keywords.ts
+import { z as z6 } from "zod";
+
+// src/tools/confirm.ts
+function needsConfirmation(confirm, ctx) {
+  return !(confirm === true || ctx.config.autoConfirmWrites);
+}
+function confirmationRequired(costNote, warnings) {
+  return {
+    status: "confirmation_required",
+    message: "This action spends billable tokens and cannot be undone. Confirm the cost with the user, then call again with `confirm: true` to proceed.",
+    costNote,
+    ...warnings && warnings.length > 0 ? { warnings } : {}
+  };
+}
+function requireConfirmation(confirm, ctx, costNote) {
+  if (!needsConfirmation(confirm, ctx)) return null;
+  return confirmationRequired(costNote);
+}
+
+// src/tools/fast-keywords-run.ts
+function isRefreshConflict(body) {
+  if (!body || typeof body !== "object") return false;
+  const b = body;
+  return b.error === "IN_PROGRESS" || b.error === "COOLDOWN";
+}
+function toConflictError(err) {
+  const body = err.body;
+  if (!isRefreshConflict(body)) return err;
+  const message = body.error === "COOLDOWN" && body.nextEligibleAt ? `This Fast Keywords result was refreshed recently. It can be refreshed again from ${body.nextEligibleAt}. Nothing was run or charged; read the current result with \`get_fast_keywords\`.` : body.error === "IN_PROGRESS" ? "A run for this Fast Keywords result is already in progress. Nothing was charged: poll `get_fast_keywords` until it finishes instead of calling again." : `${body.message} Nothing was run or charged.`;
+  return new ApiError("http", 409, message, body);
+}
+async function runFastKeywords(ctx, request, path, body, confirm, what) {
+  const post = async (payload) => {
+    try {
+      return await httpPost(request, path, payload);
+    } catch (err) {
+      throw err instanceof ApiError && err.status === 409 ? toConflictError(err) : err;
+    }
+  };
+  if (needsConfirmation(confirm, ctx)) {
+    const preview = await post({ ...body, dryRun: true });
+    if ("fastKeywordsId" in preview) return preview;
+    const { tokenCost, hasEnoughTokens } = preview;
+    return {
+      ...confirmationRequired(
+        `${what} consumes ${tokenCost} Dive token${tokenCost === 1 ? "" : "s"}.` + (hasEnoughTokens ? "" : " The organization does not have enough Dive tokens left, so a confirmed call would be refused.")
+      ),
+      tokenCost,
+      hasEnoughTokens
+    };
+  }
+  return await post(body);
+}
+
+// src/tools/run-fast-keywords.ts
 var inputSchema5 = {
-  nicheId: z5.string().min(1).describe("The unique identifier of the Niche (from `list_niches`).")
+  marketplace: z6.enum(SUPPORTED_MARKETPLACES).describe(
+    "Amazon marketplace of the ASIN. Note these are full domain suffixes: com, ca, co.uk, com.mx, in, fr, de, es, it, co.jp (e.g. UK is `co.uk`, not `uk`)."
+  ),
+  asin: z6.string().min(1).describe("The ASIN to find keywords for (e.g. B08N5WRWNW)."),
+  confirm: z6.boolean().optional().describe(
+    "Leave unset on the first call. Set to true only after the user approved the Dive token cost from the `confirmation_required` response."
+  )
 };
-var getNicheCompetitorsTool = {
-  name: "get_niche_competitors",
-  title: "Get Competitors and Niche Statistics",
-  description: "Use this for competitor ASINs, product titles, BSR, sales/revenue benchmarks, or niche opportunity scoring. Retrieves the list of Competitors within the specified Niche along with Niche statistics. For the Niche: keyword statistics, opportunity evaluation, benchmark median values, and overall competitor strength assessment. For each Competitor: ASIN, product title, BSR, category and full category tree, sales, revenue, ratings, reviews, price, number of variations, image URL, total Ranking Juice, and ranking data. BSR supports ranking Competitors by sales position within mentioned category. For the Ranking Juice breakdown by title, bullets and description, use `get_ranking_juice`.",
+var runFastKeywordsTool = {
+  name: "run_fast_keywords",
+  title: "Run Fast Keywords",
+  description: "Use this to find the keywords a product ranks for from just its ASIN \u2014 in minutes, without a full niche dive. \u26A0\uFE0F Spends 1 Dive token and cannot be undone. The first call checks eligibility and the Dive token balance, spends nothing and returns `confirmation_required` with `tokenCost` and `hasEnoughTokens`; call again with `confirm: true` only after the user approves. Not safe to retry: each confirmed call spends a token \u2014 if it errors or times out, check `list_fast_keywords` instead of re-calling. Returns `fastKeywordsId`, `requestId`, `status` and `estimatedCompletionDate`. Poll `get_fast_keywords` with the `fastKeywordsId` until `status` is `success` (right away when a fresh result for the same product already exists), then read the keywords with `get_fast_keywords_keywords`. To follow up with a full niche dive for the same product, pass the `requestId` to `create_niche_dive` as `fastKeywordsRequestId`. Run it again later with `refresh_fast_keywords`.",
   inputSchema: inputSchema5,
-  annotations: { readOnlyHint: true },
+  // Additive, but it spends a Dive token irreversibly, which is what clients need to prompt on. The confirm
+  // gate enforces it server-side regardless.
+  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
-    return await httpGet(
-      { config: ctx.config, toolName: "get_niche_competitors" },
-      `/v1/niches/${encodeURIComponent(args.nicheId)}/competitors`
+    return await runFastKeywords(
+      ctx,
+      { config: ctx.config, toolName: "run_fast_keywords" },
+      "/v1/fast-keywords",
+      { marketplace: args.marketplace, asin: args.asin },
+      args.confirm,
+      "Running Fast Keywords"
     );
   }
 };
 
-// src/tools/get-ranking-juice.ts
-import { z as z6 } from "zod";
+// src/tools/refresh-fast-keywords.ts
+import { z as z7 } from "zod";
 var inputSchema6 = {
-  nicheId: z6.string().min(1).describe("The unique identifier of the Niche (from `list_niches`).")
+  fastKeywordsId: z7.number().int().min(1).describe("The Fast Keywords result to refresh, from `run_fast_keywords` or `list_fast_keywords`."),
+  confirm: z7.boolean().optional().describe(
+    "Leave unset on the first call. Set to true only after the user approved the Dive token cost from the `confirmation_required` response."
+  )
 };
-var getRankingJuiceTool = {
-  name: "get_ranking_juice",
-  title: "Get Ranking Juices for a Niche",
-  description: "Use this when the user asks 'how do I rank higher', 'what's my ranking juice', or wants listing-optimization guidance. Retrieves the Ranking Juices for each Competitor within the specified Niche. Ranking Juice is DataDive's proprietary metric identifying the key factors driving search-ranking success for each Competitor's listing. Returns currentListing and optimizedListing breakdowns (rankingJuice + per-property contributions: title, bullets, description) plus per-competitor listing scores and the latestResearchDate.",
+var refreshFastKeywordsTool = {
+  name: "refresh_fast_keywords",
+  title: "Refresh Fast Keywords",
+  description: "Use this to re-run an existing Fast Keywords result with current data. \u26A0\uFE0F Spends 1 Dive token and cannot be undone. The first call checks eligibility and the Dive token balance, spends nothing and returns `confirmation_required` with `tokenCost` and `hasEnoughTokens`; call again with `confirm: true` only after the user approves. A result can be refreshed once every 24 hours, and not while a run is going: then the call fails with a message that says when it is refreshable again (or to poll `get_fast_keywords`), and nothing is charged. Not safe to retry after an error or timeout \u2014 check `get_fast_keywords` instead. Returns `fastKeywordsId`, `requestId`, `status` and `estimatedCompletionDate`; poll `get_fast_keywords` until `status` is `success`.",
   inputSchema: inputSchema6,
+  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+  handler: async (args, ctx) => {
+    return await runFastKeywords(
+      ctx,
+      { config: ctx.config, toolName: "refresh_fast_keywords" },
+      `/v1/fast-keywords/${args.fastKeywordsId}/refresh`,
+      {},
+      args.confirm,
+      "Refreshing Fast Keywords"
+    );
+  }
+};
+
+// src/tools/list-spaces.ts
+var inputSchema7 = {};
+var listSpacesTool = {
+  name: "list_spaces",
+  title: "List Spaces",
+  description: "Use this first when the user talks about Spaces, or to find the `id`s that `add_niche_spaces`, `remove_niche_spaces` and the `spaces` filter of `list_niches` and `list_rank_radars` take. Returns the Spaces as a tree: each node has `id`, `name`, `path` (names from the root joined with `/`), `parentId` and `children`. An MCP user sees only the Spaces they have rights on, so a Space that is missing from the tree is one they cannot use. Niches carry the ids of their Spaces in `spaces` / `labels` on `list_niches`.",
+  inputSchema: inputSchema7,
   annotations: { readOnlyHint: true },
+  handler: async (_args, ctx) => {
+    return await httpGet({ config: ctx.config, toolName: "list_spaces" }, "/v1/spaces");
+  }
+};
+
+// src/tools/list-labels.ts
+var inputSchema8 = {};
+var listLabelsTool = {
+  name: "list_labels",
+  title: "List Labels",
+  description: "Use this first when the user talks about labels, or to find the `id`s that `add_niche_labels`, `remove_niche_labels` and the `labels` filter of `list_niches` and `list_rank_radars` take. Returns the labels as a tree: each node has `id`, `name`, `path` (names from the root joined with `/`), `parentId` and `children`. Labels carry no access rights, so every label of the organization is listed. Niches carry the ids of their labels in `spaces` / `labels` on `list_niches`.",
+  inputSchema: inputSchema8,
+  annotations: { readOnlyHint: true },
+  handler: async (_args, ctx) => {
+    return await httpGet({ config: ctx.config, toolName: "list_labels" }, "/v1/labels");
+  }
+};
+
+// src/tools/add-niche-spaces.ts
+import { z as z8 } from "zod";
+var inputSchema9 = {
+  nicheId: z8.string().min(1).describe("The niche to change. Get one from `list_niches`."),
+  spaceIds: nicheTagIdList("spaceIds").describe(
+    "The ids of the Spaces to add the niche to, 1-100, unique. Get them from `list_spaces`."
+  )
+};
+var addNicheSpacesTool = {
+  name: "add_niche_spaces",
+  title: "Add a Niche to Spaces",
+  description: "Use this to put a niche in one or more Spaces (ids from `list_spaces`). A Space controls who can see the niche, so adding or removing one changes access. Returns `added` and `alreadyPresent`. Undo with `remove_niche_spaces`. " + NICHE_TAG_WRITE_RULES,
+  inputSchema: inputSchema9,
+  // Like every write tool here: clients prompt on destructiveHint. Changing a Space also changes who can see the niche.
+  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
-    return await httpGet(
-      { config: ctx.config, toolName: "get_ranking_juice" },
-      `/v1/niches/${encodeURIComponent(args.nicheId)}/ranking-juices`
+    return await httpPost(
+      { config: ctx.config, toolName: "add_niche_spaces" },
+      `/v1/niches/${encodeURIComponent(args.nicheId)}/spaces`,
+      { spaceIds: args.spaceIds }
     );
   }
 };
 
-// src/tools/list-rank-radars.ts
-import { z as z7 } from "zod";
+// src/tools/remove-niche-spaces.ts
+import { z as z9 } from "zod";
+var inputSchema10 = {
+  nicheId: z9.string().min(1).describe("The niche to change. Get one from `list_niches`."),
+  spaceIds: nicheTagIdList("spaceIds").describe(
+    "The ids of the Spaces to take the niche out of, 1-100, unique. Get them from `list_spaces`."
+  )
+};
+var removeNicheSpacesTool = {
+  name: "remove_niche_spaces",
+  title: "Remove a Niche from Spaces",
+  description: "Use this to take a niche out of one or more Spaces (ids from `list_spaces`). A Space controls who can see the niche, so adding or removing one changes access. Returns `removed` and `notPresent`. Undo with `add_niche_spaces`. " + NICHE_TAG_WRITE_RULES,
+  inputSchema: inputSchema10,
+  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+  handler: async (args, ctx) => {
+    return await httpPost(
+      { config: ctx.config, toolName: "remove_niche_spaces" },
+      `/v1/niches/${encodeURIComponent(args.nicheId)}/spaces/remove`,
+      { spaceIds: args.spaceIds }
+    );
+  }
+};
 
-// src/types/api.ts
-var ISO_8601 = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?)?$/;
-var SUPPORTED_MARKETPLACES = [
-  "com",
-  "ca",
-  "co.uk",
-  "com.mx",
-  "in",
-  "fr",
-  "de",
-  "es",
-  "it",
-  "co.jp"
-];
-var NICHE_KEYWORDS_MAX_PER_CALL = 100;
-var NICHE_KEYWORD_MAX_LENGTH = 255;
-var KEYWORD_EXCLUSIONS_MAX_PER_CALL = 100;
-var KEYWORD_EXCLUSIONS_MAX_PER_NICHE = 1e3;
-var RANK_RADAR_STATES = ["ACTIVE", "PAUSED", "ARCHIVED"];
-var RANK_RADAR_STATUSES = [...RANK_RADAR_STATES, "ALL"];
-var TAG_TITLE_MAX_LENGTH = 100;
-var TAG_KEYWORD_IDS_MAX = 1e3;
-var TAG_RESERVED_COLOR = "#EB5757";
-var TAG_HEX_COLOR_PATTERN = /^#[0-9A-Fa-f]{6}$/;
-var PPC_CAMPAIGN_BASE_SORT_BY = [
-  "name",
-  "state",
-  "bidStrategy",
-  "budget",
-  "impressions",
-  "clicks",
-  "ctr",
-  "cpc",
-  "spend",
-  "unitsSold",
-  "sales",
-  "acos",
-  "cvr",
-  "tosImpressionShare"
-];
-var PPC_CAMPAIGN_PLACEMENT_SORT_BY = [
-  ...["tos", "ros", "pp", "off"].flatMap(
-    (p) => ["Impressions", "Clicks", "Spend", "Sales", "UnitsSold", "Ctr", "Cpc", "Acos"].map(
-      (m) => `${p}${m}`
-    )
-  ),
-  "tosBidAdjustment",
-  "rosBidAdjustment",
-  "ppBidAdjustment"
-];
-var PPC_CAMPAIGN_STATES = ["ENABLED", "PAUSED"];
-var ALERT_STATUSES = ["active", "resolved", "all"];
-var BILLABLE_FEATURE_TYPES = [
-  "DIVED_ASINS",
-  "PRODUCT_BRIEF_ASINS",
-  "AI_COPYWRITER_PROMPTS",
-  "RANK_RADAR_KEYWORDS"
-];
-var CATALOG_STATUSES = ["Active", "all"];
-var LISTING_CHANGE_TYPES = ["Price", "Content", "Image"];
-var LISTING_CHANGE_SORT_BY = ["date", "type"];
-var SORT_ORDER = ["ASC", "DESC"];
-var ADD_SEARCH_TERMS_MAX = 1e3;
-var LISTING_COPY_STRATEGIES = ["cosmo", "ranking-juice", "nlp", "cosmo-rufus"];
+// src/tools/add-niche-labels.ts
+import { z as z10 } from "zod";
+var inputSchema11 = {
+  nicheId: z10.string().min(1).describe("The niche to change. Get one from `list_niches`."),
+  labelIds: nicheTagIdList("labelIds").describe(
+    "The ids of the labels to add the niche to, 1-100, unique. Get them from `list_labels`."
+  )
+};
+var addNicheLabelsTool = {
+  name: "add_niche_labels",
+  title: "Add Labels to a Niche",
+  description: "Use this to put a niche in one or more labels (ids from `list_labels`). Returns `added` and `alreadyPresent`. Undo with `remove_niche_labels`. " + NICHE_TAG_WRITE_RULES,
+  inputSchema: inputSchema11,
+  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+  handler: async (args, ctx) => {
+    return await httpPost(
+      { config: ctx.config, toolName: "add_niche_labels" },
+      `/v1/niches/${encodeURIComponent(args.nicheId)}/labels`,
+      { labelIds: args.labelIds }
+    );
+  }
+};
+
+// src/tools/remove-niche-labels.ts
+import { z as z11 } from "zod";
+var inputSchema12 = {
+  nicheId: z11.string().min(1).describe("The niche to change. Get one from `list_niches`."),
+  labelIds: nicheTagIdList("labelIds").describe(
+    "The ids of the labels to take the niche out of, 1-100, unique. Get them from `list_labels`."
+  )
+};
+var removeNicheLabelsTool = {
+  name: "remove_niche_labels",
+  title: "Remove Labels from a Niche",
+  description: "Use this to take a niche out of one or more labels (ids from `list_labels`). Returns `removed` and `notPresent`. Undo with `add_niche_labels`. " + NICHE_TAG_WRITE_RULES,
+  inputSchema: inputSchema12,
+  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+  handler: async (args, ctx) => {
+    return await httpPost(
+      { config: ctx.config, toolName: "remove_niche_labels" },
+      `/v1/niches/${encodeURIComponent(args.nicheId)}/labels/remove`,
+      { labelIds: args.labelIds }
+    );
+  }
+};
+
+// src/tools/get-niche-keywords.ts
+import { z as z12 } from "zod";
+var inputSchema13 = {
+  nicheId: z12.string().min(1).describe("The unique identifier of the Niche (from `list_niches`).")
+};
+var getNicheKeywordsTool = {
+  name: "get_niche_keywords",
+  title: "Get Master Keyword List for a Niche",
+  description: 'Use this when the user asks about keywords, search terms, or search volume for a niche. Retrieves the master keyword list for the specified Niche \u2014 the relevant search terms monitored for ranking and performance metrics. For each keyword, returns search volume, relevancy (numeric score or "Outlier"), and competitor ASIN organic ranks (asinRanks: { ASIN -> rank | null }), plus `origin`: `mkl` (found by the dive), `manual` (added by hand with `add_niche_keywords`), `outlier` / `residue` (moved in from those lists). Only `manual`, `outlier` and `residue` keywords can be taken out with `remove_niche_keywords`. Keywords hidden by the niche\'s keyword exclusions are not listed; see `list_keyword_exclusions`. Also returns the latestResearchDate.',
+  inputSchema: inputSchema13,
+  annotations: { readOnlyHint: true },
+  handler: async (args, ctx) => {
+    return await httpGet(
+      { config: ctx.config, toolName: "get_niche_keywords" },
+      `/v1/niches/${encodeURIComponent(args.nicheId)}/keywords`
+    );
+  }
+};
+
+// src/tools/list-keyword-exclusions.ts
+import { z as z13 } from "zod";
+var inputSchema14 = {
+  nicheId: z13.string().min(1).describe("The unique identifier of the Niche (from `list_niches`).")
+};
+var listKeywordExclusionsTool = {
+  name: "list_keyword_exclusions",
+  title: "List a Niche's Keyword Exclusions",
+  description: "Use this to see which keywords are hidden from a niche's Master Keyword List, e.g. when a keyword the user expects is missing from `get_niche_keywords`. Returns the same lists the DataDive web app shows, oldest first: `exact` \u2014 each entry hides the one keyword that matches it exactly, with that keyword's `searchVolume` (0 when the niche has no such keyword); `phrase` \u2014 each entry hides every keyword that contains the phrase, with `excludedKeywordsCount` and the total `searchVolume` of the keywords it hides (not counting ones already excluded exactly). Exclusions hide keywords wherever they come from: the dive, the Outliers and Residue lists, and hand-added ones. Change them with `add_keyword_exclusions` and `remove_keyword_exclusions`.",
+  inputSchema: inputSchema14,
+  annotations: { readOnlyHint: true },
+  handler: async (args, ctx) => {
+    return await httpGet(
+      { config: ctx.config, toolName: "list_keyword_exclusions" },
+      `/v1/niches/${encodeURIComponent(args.nicheId)}/keyword-exclusions`
+    );
+  }
+};
+
+// src/tools/get-niche-roots.ts
+import { z as z14 } from "zod";
+var inputSchema15 = {
+  nicheId: z14.string().min(1).describe("The unique identifier of the Niche (from `list_niches`).")
+};
+var getNicheRootsTool = {
+  name: "get_niche_roots",
+  title: "Get Keyword Roots for a Niche",
+  description: "Use this when the user wants to find the highest-impact words across a niche's keywords, asks about 'keyword roots', or wants to prioritize terms for a listing. Retrieves the keyword lexical roots for the Niche \u2014 individual words or word-combinations extracted from the Master Keyword List (e.g. 'bluetooth headphones' yields roots 'bluetooth', 'headphones', 'bluetooth headphones'). Returns `roots` and `normalizedRoots` tables, each item with root, frequency (how many keywords contain it), broadSearchVolume (summed search volume of those keywords), and broadSearchVolumeRatio (0-1, relative to the top root), plus the per-keyword breakdowns and latestResearchDate.",
+  inputSchema: inputSchema15,
+  annotations: { readOnlyHint: true },
+  handler: async (args, ctx) => {
+    return await httpGet(
+      { config: ctx.config, toolName: "get_niche_roots" },
+      `/v1/niches/${encodeURIComponent(args.nicheId)}/roots`
+    );
+  }
+};
+
+// src/tools/get-niche-competitors.ts
+import { z as z15 } from "zod";
+var inputSchema16 = {
+  nicheId: z15.string().min(1).describe("The unique identifier of the Niche (from `list_niches`).")
+};
+var getNicheCompetitorsTool = {
+  name: "get_niche_competitors",
+  title: "Get Competitors and Niche Statistics",
+  description: "Use this for competitor ASINs, product titles, BSR, sales/revenue benchmarks, or niche opportunity scoring. Retrieves the list of Competitors within the specified Niche along with Niche statistics. For the Niche: keyword statistics, opportunity evaluation, benchmark median values, and overall competitor strength assessment. For each Competitor: ASIN, product title, BSR, category and full category tree, sales, revenue, ratings, reviews, price, number of variations, image URL, total Ranking Juice, and ranking data. BSR supports ranking Competitors by sales position within mentioned category. For the Ranking Juice breakdown by title, bullets and description, use `get_ranking_juice`.",
+  inputSchema: inputSchema16,
+  annotations: { readOnlyHint: true },
+  handler: async (args, ctx) => {
+    return await httpGet(
+      { config: ctx.config, toolName: "get_niche_competitors" },
+      `/v1/niches/${encodeURIComponent(args.nicheId)}/competitors`
+    );
+  }
+};
+
+// src/tools/get-ranking-juice.ts
+import { z as z16 } from "zod";
+var inputSchema17 = {
+  nicheId: z16.string().min(1).describe("The unique identifier of the Niche (from `list_niches`).")
+};
+var getRankingJuiceTool = {
+  name: "get_ranking_juice",
+  title: "Get Ranking Juices for a Niche",
+  description: "Use this when the user asks 'how do I rank higher', 'what's my ranking juice', or wants listing-optimization guidance. Retrieves the Ranking Juices for each Competitor within the specified Niche. Ranking Juice is DataDive's proprietary metric identifying the key factors driving search-ranking success for each Competitor's listing. Returns currentListing and optimizedListing breakdowns (rankingJuice + per-property contributions: title, bullets, description) plus per-competitor listing scores and the latestResearchDate.",
+  inputSchema: inputSchema17,
+  annotations: { readOnlyHint: true },
+  handler: async (args, ctx) => {
+    return await httpGet(
+      { config: ctx.config, toolName: "get_ranking_juice" },
+      `/v1/niches/${encodeURIComponent(args.nicheId)}/ranking-juices`
+    );
+  }
+};
 
 // src/tools/list-rank-radars.ts
+import { z as z17 } from "zod";
 var LIST_RANK_RADARS_MAX_PAGE_SIZE = 50;
-var inputSchema7 = {
-  currentPage: z7.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z7.number().int().min(1).max(LIST_RANK_RADARS_MAX_PAGE_SIZE).optional().describe(`Items per page (max ${LIST_RANK_RADARS_MAX_PAGE_SIZE}). Defaults to 20.`),
-  nicheId: z7.string().min(1).optional().describe("Filter Rank Radars by Niche identifier. Use after `list_niches`."),
-  status: z7.enum(RANK_RADAR_STATUSES).optional().describe(
+var inputSchema18 = {
+  currentPage: z17.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z17.number().int().min(1).max(LIST_RANK_RADARS_MAX_PAGE_SIZE).optional().describe(`Items per page (max ${LIST_RANK_RADARS_MAX_PAGE_SIZE}). Defaults to 20.`),
+  nicheId: z17.string().min(1).optional().describe("Filter Rank Radars by Niche identifier. Use after `list_niches`."),
+  status: z17.enum(RANK_RADAR_STATUSES).optional().describe(
     "Which Rank Radars to return. ACTIVE (the default) are tracking; PAUSED have been stopped but keep their history and can be resumed; ARCHIVED have been deleted; ALL means active and paused together. Archived Rank Radars are returned only by an explicit ARCHIVED."
   ),
-  searchText: z7.string().optional().describe("Filter Rank Radars by ASIN or product title.")
+  searchText: z17.string().optional().describe("Filter Rank Radars by ASIN or product title."),
+  spaces: tagFilterIdList("spaces").optional().describe(
+    "Only Rank Radars whose niche is in at least one of these Spaces (ids from `list_spaces`, up to 100). Combines with `labels` and the other filters with AND."
+  ),
+  labels: tagFilterIdList("labels").optional().describe(
+    "Only Rank Radars whose niche has at least one of these labels (ids from `list_labels`, up to 100). Combines with `spaces` and the other filters with AND."
+  )
 };
 function minimize(item) {
   const { asin, ...rest } = item;
@@ -525,8 +852,8 @@ function minimize(item) {
 var listRankRadarsTool = {
   name: "list_rank_radars",
   title: "List Rank Radars",
-  description: `Use this to find a \`rankRadarId\` before calling \`get_rank_radar_data\`. Filter by \`nicheId\` if the user has already identified a niche. Retrieves a paginated list of Rank Radars \u2014 keyword-rank trackers monitoring organic and sponsored positions for specific ASINs over time. Each item includes id, status (ACTIVE, PAUSED or ARCHIVED), asin, marketplace, keywordCount, title, imageUrl, and summary metrics: top10KW, top10SV, top50KW, top50SV. Supports pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev); a page holds at most ${LIST_RANK_RADARS_MAX_PAGE_SIZE} Rank Radars, so a large account needs several calls.`,
-  inputSchema: inputSchema7,
+  description: `Use this to find a \`rankRadarId\` before calling \`get_rank_radar_data\`. Filter by \`nicheId\` if the user has already identified a niche, or by \`spaces\` / \`labels\` (ids from \`list_spaces\` / \`list_labels\`), which match through the Rank Radar's niche. Retrieves a paginated list of Rank Radars \u2014 keyword-rank trackers monitoring organic and sponsored positions for specific ASINs over time. Each item includes id, status (ACTIVE, PAUSED or ARCHIVED), asin, marketplace, keywordCount, title, imageUrl, and summary metrics: top10KW, top10SV, top50KW, top50SV. Supports pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev); a page holds at most ${LIST_RANK_RADARS_MAX_PAGE_SIZE} Rank Radars, so a large account needs several calls.`,
+  inputSchema: inputSchema18,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     const page = await httpGet(
@@ -537,7 +864,9 @@ var listRankRadarsTool = {
         pageSize: args.pageSize,
         nicheId: args.nicheId,
         status: args.status,
-        searchText: args.searchText
+        searchText: args.searchText,
+        spaces: args.spaces,
+        labels: args.labels
       }
     );
     return { ...page, data: (page.data ?? []).map(minimize) };
@@ -545,18 +874,18 @@ var listRankRadarsTool = {
 };
 
 // src/tools/rank-radar-keyword-query.ts
-import { z as z8 } from "zod";
+import { z as z18 } from "zod";
 var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
 var RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE = 100;
 var RANK_RADAR_MAX_DATE_RANGE_DAYS = 90;
 var rankRadarKeywordQueryInputSchema = {
-  rankRadarId: z8.string().uuid().describe("The Rank Radar UUID (from `list_rank_radars`)."),
-  startDate: z8.string().regex(ISO_DATE, "startDate must be in yyyy-mm-dd format").describe("Start date of the range, yyyy-mm-dd (e.g. 2024-03-26)."),
-  endDate: z8.string().regex(ISO_DATE, "endDate must be in yyyy-mm-dd format").describe(
+  rankRadarId: z18.string().uuid().describe("The Rank Radar UUID (from `list_rank_radars`)."),
+  startDate: z18.string().regex(ISO_DATE, "startDate must be in yyyy-mm-dd format").describe("Start date of the range, yyyy-mm-dd (e.g. 2024-03-26)."),
+  endDate: z18.string().regex(ISO_DATE, "endDate must be in yyyy-mm-dd format").describe(
     `End date of the range, yyyy-mm-dd (e.g. 2024-04-26). Must be on or after startDate, and at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days after it.`
   ),
-  currentPage: z8.number().int().min(1).optional().describe("Page of keywords, 1-indexed. Defaults to 1."),
-  pageSize: z8.number().int().min(1).max(RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE).optional().describe(`Keywords per page (max ${RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE}). Defaults to 20.`)
+  currentPage: z18.number().int().min(1).optional().describe("Page of keywords, 1-indexed. Defaults to 1."),
+  pageSize: z18.number().int().min(1).max(RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE).optional().describe(`Keywords per page (max ${RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE}). Defaults to 20.`)
 };
 var RANK_RADAR_KEYWORD_PAGING_NOTE = `Results are paged by keyword: \`data\` holds one page, and the response carries currentPage, pageSize, total, lastPage, hasNext and hasPrev. \`total\` is the Rank Radar's active keyword count; to read every keyword, call again with \`currentPage\` + 1 while \`hasNext\` is true, using \`pageSize\` ${RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE} for large Rank Radars. Paused keywords are not included.`;
 function rankRadarPath(rankRadarId, suffix = "") {
@@ -572,7 +901,7 @@ function rankRadarKeywordQuery(args) {
 }
 
 // src/tools/get-rank-radar-data.ts
-var inputSchema8 = rankRadarKeywordQueryInputSchema;
+var inputSchema19 = rankRadarKeywordQueryInputSchema;
 async function readAllKeywords(args, ctx) {
   const request = { config: ctx.config, toolName: "get_rank_radar_data" };
   const path = rankRadarPath(args.rankRadarId);
@@ -602,7 +931,7 @@ var getRankRadarDataTool = {
   name: "get_rank_radar_data",
   title: "Get Keyword Rankings for a Rank Radar",
   description: `Use this to analyze keyword ranking trends over time. Requires startDate and endDate (yyyy-mm-dd), at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days apart. Retrieves historical keyword ranking data for the specified Rank Radar within the date range. Without \`currentPage\` and \`pageSize\` it returns every active keyword in one result. To read one page instead \u2014 faster for large Rank Radars \u2014 pass \`currentPage\` and/or \`pageSize\` (max ${RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE}) and continue with \`currentPage\` + 1 while \`hasNext\` is true. The response carries currentPage, pageSize, total, lastPage, hasNext and hasPrev; \`total\` is the Rank Radar's active keyword count. Paused keywords are not included. Each keyword has id, keyword, searchVolume, relevancy, ranks (per-day { date, organicRank, sponsoredRank, impressionRank }), and \`highlights\` \u2014 the user tags on this keyword. Each \`highlights\` entry is the same object \`list_rank_radar_tags\` returns (id, title, color, description, startAt, endAt, type, krtId, krtKeywordId); its \`id\` is the \`tagId\` the tag-management tools take. A rank of 101 means the product was not in the top 100 results that day. For PPC metrics use \`get_rank_radar_ppc_data\`; for Search Query Performance use \`get_rank_radar_sqp_data\`. Use after \`list_rank_radars\` to discover a \`rankRadarId\`.`,
-  inputSchema: inputSchema8,
+  inputSchema: inputSchema19,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     if (args.currentPage === void 0 && args.pageSize === void 0) {
@@ -617,12 +946,12 @@ var getRankRadarDataTool = {
 };
 
 // src/tools/get-rank-radar-sqp-data.ts
-var inputSchema9 = rankRadarKeywordQueryInputSchema;
+var inputSchema20 = rankRadarKeywordQueryInputSchema;
 var getRankRadarSqpDataTool = {
   name: "get_rank_radar_sqp_data",
   title: "Get Search Query Performance for a Rank Radar",
   description: `Use this when the user asks how shoppers search, click, add to cart and buy for the keywords of a Rank Radar \u2014 Amazon's Search Query Performance (SQP) data, from Brand Analytics. Requires startDate and endDate (yyyy-mm-dd), at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days apart; 30 days or less keeps it fast. Each keyword's metrics are aggregated over the range: searchQueryVolume and searchQueryScore; impressions, clicks, cart adds and purchases, each as the total across all sellers (\`*TotalCount\`), this ASIN family's count (\`*AsinCount\`) and its share (\`*AsinShare\`); click, cart-add and purchase rates; and ctr/cvr for the market (\`*Total\`) and for this ASIN family (\`*Asin\`). \`numberOfDaysWithData\` says how many days of the range had SQP data; metrics are null when there is none, which is normal for low-volume keywords, recent dates (Amazon publishes SQP with a delay) and sellers without Brand Analytics. ${RANK_RADAR_KEYWORD_PAGING_NOTE} Each call counts toward API usage and is rate limited (about 60 requests/minute). Use after \`list_rank_radars\` to discover a \`rankRadarId\`.`,
-  inputSchema: inputSchema9,
+  inputSchema: inputSchema20,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -634,10 +963,10 @@ var getRankRadarSqpDataTool = {
 };
 
 // src/tools/get-rank-radar-ppc-data.ts
-import { z as z9 } from "zod";
-var inputSchema10 = {
+import { z as z19 } from "zod";
+var inputSchema21 = {
   ...rankRadarKeywordQueryInputSchema,
-  includeCampaigns: z9.boolean().optional().describe(
+  includeCampaigns: z19.boolean().optional().describe(
     "When true, each keyword also carries `campaigns`: the per-campaign/ad-group breakdown (campaign and ad group name, match type, targeting, spend, sales, clicks, impressions, orders, CPC, CTR, CVR, ACOS). Defaults to false; leave it off unless the user asks which campaigns drive a keyword."
   )
 };
@@ -645,7 +974,7 @@ var getRankRadarPpcDataTool = {
   name: "get_rank_radar_ppc_data",
   title: "Get PPC Data for a Rank Radar",
   description: `Use this when the user asks about advertising (Sponsored Products) performance for the keywords of a Rank Radar. Requires startDate and endDate (yyyy-mm-dd), at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days apart; 30 days or less keeps it fast. Each keyword's metrics are aggregated over the range: sponsoredRank (median; 101 means not in the top 100 sponsored results), impressionRank and impressionRankShare; how many exact, phrase, broad and auto campaigns target it; organicSales, ppcSales, ppcSpend, costPerClicks, clickThroughRate, conversionRate, totalClicks, totalImpressions, totalOrders and acos. Metrics are null or 0 when the seller runs no ads on a keyword. Set \`includeCampaigns\` for the per-campaign breakdown. ${RANK_RADAR_KEYWORD_PAGING_NOTE} Each call counts toward API usage and is rate limited (about 60 requests/minute). For the seller's campaigns as a whole, use \`list_ppc_campaigns\`. Use after \`list_rank_radars\` to discover a \`rankRadarId\`.`,
-  inputSchema: inputSchema10,
+  inputSchema: inputSchema21,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -657,32 +986,13 @@ var getRankRadarPpcDataTool = {
 };
 
 // src/tools/create-rank-radar.ts
-import { z as z10 } from "zod";
-
-// src/tools/confirm.ts
-function needsConfirmation(confirm, ctx) {
-  return !(confirm === true || ctx.config.autoConfirmWrites);
-}
-function confirmationRequired(costNote, warnings) {
-  return {
-    status: "confirmation_required",
-    message: "This action spends billable tokens and cannot be undone. Confirm the cost with the user, then call again with `confirm: true` to proceed.",
-    costNote,
-    ...warnings && warnings.length > 0 ? { warnings } : {}
-  };
-}
-function requireConfirmation(confirm, ctx, costNote) {
-  if (!needsConfirmation(confirm, ctx)) return null;
-  return confirmationRequired(costNote);
-}
-
-// src/tools/create-rank-radar.ts
+import { z as z20 } from "zod";
 var PATH = "/v1/niches/rank-radars";
-var inputSchema11 = {
-  asin: z10.string().min(1).describe("The ASIN to track keyword rankings for."),
-  numberOfKeywords: z10.number().int().min(1).describe("How many keywords to track (minimum 1). More keywords = broader tracking but more Search Term tokens."),
-  nicheId: z10.string().min(1).describe("The niche this Rank Radar belongs to. Get one from `list_niches`."),
-  confirm: z10.boolean().optional().describe(
+var inputSchema22 = {
+  asin: z20.string().min(1).describe("The ASIN to track keyword rankings for."),
+  numberOfKeywords: z20.number().int().min(1).describe("How many keywords to track (minimum 1). More keywords = broader tracking but more Search Term tokens."),
+  nicheId: z20.string().min(1).describe("The niche this Rank Radar belongs to. Get one from `list_niches`."),
+  confirm: z20.boolean().optional().describe(
     "Must be true to proceed \u2014 creating a Rank Radar spends Search Term tokens. Confirm the cost with the user first."
   )
 };
@@ -690,7 +1000,7 @@ var createRankRadarTool = {
   name: "create_rank_radar",
   title: "Create a Rank Radar",
   description: "Use this to start tracking organic and sponsored keyword rankings for an ASIN within a niche. \u26A0\uFE0F Spends Search Term tokens (cost scales with `numberOfKeywords`) and cannot be undone \u2014 set `confirm: true` only after the user approves the cost. Not safe to retry: each call spends tokens again and creates a separate Rank Radar \u2014 if a call errors or times out, check `list_rank_radars` instead of re-calling. The first call previews the creation and may return `warnings` alongside the cost note \u2014 for example that this product family is already tracked by another Rank Radar. Show every warning `message` to the user verbatim, before asking them to confirm; do not summarise it or decide on their behalf. A warning never blocks creation. Returns the new `rankRadarId`; read its data later with `get_rank_radar_data`. Requires `asin`, `numberOfKeywords` (min 1), and a `nicheId` from `list_niches`.",
-  inputSchema: inputSchema11,
+  inputSchema: inputSchema22,
   // destructiveHint is technically "additive" here (this creates a new Rank Radar, it
   // doesn't destroy data), but we flag it destructive so clients prompt before the
   // irreversible token spend. The confirm gate enforces this server-side regardless.
@@ -715,20 +1025,23 @@ var createRankRadarTool = {
 };
 
 // src/tools/create-niche-dive.ts
-import { z as z11 } from "zod";
-var inputSchema12 = {
-  marketplace: z11.enum(SUPPORTED_MARKETPLACES).describe(
+import { z as z21 } from "zod";
+var inputSchema23 = {
+  marketplace: z21.enum(SUPPORTED_MARKETPLACES).describe(
     "Amazon marketplace of the seed ASIN. Note these are full domain suffixes: com, ca, co.uk, com.mx, in, fr, de, es, it, co.jp (e.g. UK is `co.uk`, not `uk`)."
   ),
-  asin: z11.string().min(1).describe("The seed ASIN to start the dive from (e.g. B08N5WRWNW). Competitors are built around it."),
-  numberOfCompetitors: z11.number().int().min(2).describe("How many competitors to analyze (minimum 2). More competitors = deeper niche but more dive tokens."),
-  confirm: z11.boolean().optional().describe("Must be true to proceed \u2014 creating a dive spends dive tokens. Confirm the cost with the user first.")
+  asin: z21.string().min(1).describe("The seed ASIN to start the dive from (e.g. B08N5WRWNW). Competitors are built around it."),
+  numberOfCompetitors: z21.number().int().min(2).describe("How many competitors to analyze (minimum 2). More competitors = deeper niche but more dive tokens."),
+  fastKeywordsRequestId: z21.number().int().min(1).optional().describe(
+    "Links the dive to a Fast Keywords run for the same product: the `requestId` returned by `run_fast_keywords` or `refresh_fast_keywords`. Leave unset for a dive that follows no Fast Keywords run."
+  ),
+  confirm: z21.boolean().optional().describe("Must be true to proceed \u2014 creating a dive spends dive tokens. Confirm the cost with the user first.")
 };
 var createNicheDiveTool = {
   name: "create_niche_dive",
   title: "Create a Niche Dive",
-  description: "Use this to start new niche research from a seed ASIN. \u26A0\uFE0F Spends dive tokens (cost scales with `numberOfCompetitors`) and cannot be undone \u2014 set `confirm: true` only after the user approves the cost. Not safe to retry: each call spends tokens again and starts a separate dive \u2014 if a call errors or times out, poll `get_dive_status` (or check `list_niches`) instead of re-calling. The dive runs asynchronously: this returns immediately with a `diveId` and an `estimatedCompletionDate`. Poll `get_dive_status` with that `diveId` until it reports `success` (which carries the new `nicheId` for use with `list_niches`, `get_niche_keywords`, etc.). Requires `marketplace`, `asin`, and `numberOfCompetitors` (min 2).",
-  inputSchema: inputSchema12,
+  description: "Use this to start new niche research from a seed ASIN. \u26A0\uFE0F Spends dive tokens (cost scales with `numberOfCompetitors`) and cannot be undone \u2014 set `confirm: true` only after the user approves the cost. Not safe to retry: each call spends tokens again and starts a separate dive \u2014 if a call errors or times out, poll `get_dive_status` (or check `list_niches`) instead of re-calling. The dive runs asynchronously: this returns immediately with a `diveId` and an `estimatedCompletionDate`. Poll `get_dive_status` with that `diveId` until it reports `success` (which carries the new `nicheId` for use with `list_niches`, `get_niche_keywords`, etc.). Requires `marketplace`, `asin`, and `numberOfCompetitors` (min 2). After a Fast Keywords run for the same product, pass its `requestId` as `fastKeywordsRequestId` to link the dive to it.",
+  inputSchema: inputSchema23,
   // destructiveHint is technically "additive" here (a dive creates a new niche, it
   // doesn't destroy data), but we flag it destructive so clients prompt before the
   // irreversible token spend. The confirm gate enforces this server-side regardless.
@@ -746,27 +1059,29 @@ var createNicheDiveTool = {
       {
         marketplace: args.marketplace,
         asin: args.asin,
-        numberOfCompetitors: args.numberOfCompetitors
+        numberOfCompetitors: args.numberOfCompetitors,
+        // JSON.stringify drops it when unset, so a dive without a Fast Keywords run sends the old body.
+        fastKeywordsRequestId: args.fastKeywordsRequestId
       }
     );
   }
 };
 
 // src/tools/create-niche-dive-from-competitors-list.ts
-import { z as z12 } from "zod";
+import { z as z22 } from "zod";
 var DIVE_FROM_COMPETITORS_MIN_ASINS = 2;
 var DIVE_FROM_COMPETITORS_MAX_ASINS = 200;
-var normalizedAsins = z12.array(z12.string().trim().min(1).toUpperCase()).min(DIVE_FROM_COMPETITORS_MIN_ASINS).max(DIVE_FROM_COMPETITORS_MAX_ASINS).refine((asins) => new Set(asins).size === asins.length, {
+var normalizedAsins = z22.array(z22.string().trim().min(1).toUpperCase()).min(DIVE_FROM_COMPETITORS_MIN_ASINS).max(DIVE_FROM_COMPETITORS_MAX_ASINS).refine((asins) => new Set(asins).size === asins.length, {
   message: "asins must not contain the same ASIN twice"
 });
-var inputSchema13 = {
-  marketplace: z12.enum(SUPPORTED_MARKETPLACES).describe(
+var inputSchema24 = {
+  marketplace: z22.enum(SUPPORTED_MARKETPLACES).describe(
     "Amazon marketplace where the ASINs are listed. Full domain suffixes: com, ca, co.uk, com.mx, in, fr, de, es, it, co.jp (e.g. UK is `co.uk`, not `uk`)."
   ),
   asins: normalizedAsins.describe(
     `The exact competitor ASINs to build the niche from, ${DIVE_FROM_COMPETITORS_MIN_ASINS} to ${DIVE_FROM_COMPETITORS_MAX_ASINS}, each once. No other competitors are added.`
   ),
-  confirm: z12.boolean().optional().describe(
+  confirm: z22.boolean().optional().describe(
     "Must be true to proceed \u2014 this dive spends dive tokens for every ASIN. Confirm the cost with the user first."
   )
 };
@@ -774,7 +1089,7 @@ var createNicheDiveFromCompetitorsListTool = {
   name: "create_niche_dive_from_competitors_list",
   title: "Create a Niche Dive from a Competitor List",
   description: `Use this when the user already knows which products belong in the niche \u2014 e.g. they list competitor ASINs, or picked them from search results \u2014 and wants niche research on exactly those. Unlike \`create_niche_dive\`, which discovers competitors around one seed ASIN, this builds the niche from the given ASINs only (${DIVE_FROM_COMPETITORS_MIN_ASINS}-${DIVE_FROM_COMPETITORS_MAX_ASINS}). \u26A0\uFE0F Spends dive tokens for every ASIN and cannot be undone \u2014 set \`confirm: true\` only after the user approves the cost. Not safe to retry: each call spends tokens again and starts a separate dive \u2014 if a call errors or times out, poll \`get_dive_status\` (or check \`list_niches\`) instead of re-calling. Fails without spending tokens when the ASIN count is over the plan's limit, when the account is at its niche limit, or when Amazon product data cannot be found for enough of the ASINs. The dive runs asynchronously: this returns a \`diveId\` and an \`estimatedCompletionDate\`; poll \`get_dive_status\` with the \`diveId\` until it reports \`success\`, which carries the new \`nicheId\`.`,
-  inputSchema: inputSchema13,
+  inputSchema: inputSchema24,
   // Additive rather than destructive, but flagged destructive so clients prompt before the
   // irreversible token spend — same reasoning as create_niche_dive. The confirm gate enforces it.
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
@@ -794,23 +1109,23 @@ var createNicheDiveFromCompetitorsListTool = {
 };
 
 // src/tools/redive-niche.ts
-import { z as z13 } from "zod";
-var inputSchema14 = {
-  nicheId: z13.string().min(1).describe("The niche to re-dive. Get one from `list_niches`."),
-  mode: z13.enum(["same_competitors", "discover"]).describe(
+import { z as z23 } from "zod";
+var inputSchema25 = {
+  nicheId: z23.string().min(1).describe("The niche to re-dive. Get one from `list_niches`."),
+  mode: z23.enum(["same_competitors", "discover"]).describe(
     "How to pick the competitors for the refreshed dive. `same_competitors` re-runs the niche's current competitor set and takes no other argument \u2014 use it to refresh stale data. `discover` searches for a fresh competitor set, which is what you want when the niche has changed."
   ),
-  numberOfCompetitors: z13.number().int().min(2).optional().describe(
+  numberOfCompetitors: z23.number().int().min(2).optional().describe(
     "Total ASINs the refreshed dive should contain, including `lockedAsins`. Required in `discover` mode and rejected in `same_competitors` mode. Dive tokens are spent per ASIN."
   ),
-  heroAsin: z13.string().min(1).optional().describe(
+  heroAsin: z23.string().min(1).optional().describe(
     "`discover` mode only. Seed product the competitor discovery starts from. Defaults to the niche's highest-selling competitor, preferring one the user's own connected seller account owns."
   ),
-  lockedAsins: z13.array(z13.string().min(1)).optional().describe(
+  lockedAsins: z23.array(z23.string().min(1)).optional().describe(
     "`discover` mode only. ASINs that must stay in the competitor set regardless of what discovery finds. Cannot exceed `numberOfCompetitors`, and cannot overlap `excludedAsins`."
   ),
-  excludedAsins: z13.array(z13.string().min(1)).optional().describe("`discover` mode only. ASINs discovery must never select."),
-  confirm: z13.boolean().optional().describe(
+  excludedAsins: z23.array(z23.string().min(1)).optional().describe("`discover` mode only. ASINs discovery must never select."),
+  confirm: z23.boolean().optional().describe(
     "Must be true to proceed \u2014 a re-dive spends dive tokens. Confirm the cost with the user first."
   )
 };
@@ -818,7 +1133,7 @@ var rediveNicheTool = {
   name: "redive_niche",
   title: "Re-dive an Existing Niche",
   description: "Use this to refresh an existing niche's research with current Amazon data, instead of creating a new niche with `create_niche_dive`. \u26A0\uFE0F Spends dive tokens (one batch per ASIN dived) and cannot be undone \u2014 set `confirm: true` only after the user approves the cost. Not safe to retry: each call spends tokens again and starts a separate re-dive \u2014 if a call errors or times out, poll `get_dive_status` instead of re-calling. Two modes: `same_competitors` re-dives the niche's current competitor set (no other argument needed) and `discover` finds a fresh set, sized by `numberOfCompetitors` and steerable with `heroAsin` / `lockedAsins` / `excludedAsins`. Runs asynchronously: returns a `diveId` and an `estimatedCompletionDate` \u2014 poll `get_dive_status` with that `diveId` until it reports `success`. The niche keeps its `nicheId`, so existing rank radars and reports follow the refreshed data.",
-  inputSchema: inputSchema14,
+  inputSchema: inputSchema25,
   // Same reasoning as create_niche_dive: a re-dive is additive rather than destructive, but the
   // irreversible token spend is what clients need to prompt on. The confirm gate enforces it regardless.
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
@@ -851,9 +1166,9 @@ var rediveNicheTool = {
 };
 
 // src/tools/get-dive-status.ts
-import { z as z14 } from "zod";
-var inputSchema15 = {
-  diveId: z14.string().min(1).describe(
+import { z as z24 } from "zod";
+var inputSchema26 = {
+  diveId: z24.string().min(1).describe(
     "The dive identifier returned by `create_niche_dive`, `create_niche_dive_from_competitors_list` or `redive_niche`, or the `refresh.diveId` returned by `add_niche_keywords`."
   )
 };
@@ -861,7 +1176,7 @@ var getDiveStatusTool = {
   name: "get_dive_status",
   title: "Get Niche Dive Status",
   description: "Use this to poll a niche dive started with `create_niche_dive`, `create_niche_dive_from_competitors_list` or `redive_niche`, or the re-dive `add_niche_keywords` started on a stale niche, until it finishes. Returns one of three shapes keyed by `status`: `in_progress` (with `estimatedCompletionDate`), `success` (with the `nicheId` plus `tokensUsed`/`tokensLeft`), or `error` (with an `error` message). On `success`, use the `nicheId` with `list_niches`, `get_niche_keywords`, `get_niche_competitors`, etc. (for a re-dive it is the same niche you passed in, now carrying refreshed data). Re-poll periodically \u2014 dives can take minutes; the `estimatedCompletionDate` hints at when to check.",
-  inputSchema: inputSchema15,
+  inputSchema: inputSchema26,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -872,31 +1187,31 @@ var getDiveStatusTool = {
 };
 
 // src/tools/add-niche-keywords.ts
-import { z as z16 } from "zod";
+import { z as z26 } from "zod";
 
 // src/tools/niche-keyword-list.ts
-import { z as z15 } from "zod";
-var nicheKeyword = () => z15.string().trim().toLowerCase().min(1).max(NICHE_KEYWORD_MAX_LENGTH);
+import { z as z25 } from "zod";
+var nicheKeyword = () => z25.string().trim().toLowerCase().min(1).max(NICHE_KEYWORD_MAX_LENGTH);
 function uniqueKeywords(schema, field) {
   return schema.refine((keywords) => new Set(keywords).size === keywords.length, {
     message: `${field} must not contain the same keyword twice (compared lower-cased and trimmed)`
   });
 }
 var nicheKeywordList = uniqueKeywords(
-  z15.array(nicheKeyword()).min(1).max(NICHE_KEYWORDS_MAX_PER_CALL),
+  z25.array(nicheKeyword()).min(1).max(NICHE_KEYWORDS_MAX_PER_CALL),
   "keywords"
 );
 
 // src/tools/add-niche-keywords.ts
-var inputSchema16 = {
-  nicheId: z16.string().min(1).describe("The niche whose Master Keyword List to add to. Get one from `list_niches`."),
+var inputSchema27 = {
+  nicheId: z26.string().min(1).describe("The niche whose Master Keyword List to add to. Get one from `list_niches`."),
   keywords: nicheKeywordList.describe(
     `The keywords to add, 1\u2013${NICHE_KEYWORDS_MAX_PER_CALL} per call, at most 255 characters each. They are lower-cased and trimmed, and must be unique after that. Put every keyword in one call: this tool allows only 2 calls per minute per niche.`
   ),
-  confirm: z16.boolean().optional().describe(
+  confirm: z26.boolean().optional().describe(
     "Leave unset on the first call. Set to true only after the user approved the Dive token cost from a `confirmation_required` response \u2014 it lets the add re-dive a stale niche."
   ),
-  maxTokensUsed: z16.number().int().min(0).optional().describe(
+  maxTokensUsed: z26.number().int().min(0).optional().describe(
     "With `confirm: true`: the `tokenCost` the user approved. The call then fails with nothing saved or charged rather than spend more. Ignored without `confirm`, where the tool never spends anything."
   )
 };
@@ -909,7 +1224,7 @@ var addNicheKeywordsTool = {
   name: "add_niche_keywords",
   title: "Add Keywords to a Niche's Master Keyword List",
   description: "Use this to add keywords to a niche's Master Keyword List (MKL): the user's own search terms, or keywords from the niche's Outliers or Residue lists. Free while the niche is fresh (dived in the last 24 hours, or a dive is running): the first call adds the keywords at once and they are readable with `get_niche_keywords`. On a stale niche, any keyword new to the niche makes the add re-dive the whole niche with its current competitors, which spends one Dive token per competitor. The first call then saves and spends nothing and returns `confirmation_required` with `tokenCost`; after the user approves, call again with `confirm: true` and `maxTokensUsed` set to that `tokenCost`. Keywords moved in from Outliers or Residue never cost anything. Returns `originBreakdown` (`alreadyInMkl`, `takenFromOutliers`, `takenFromResidue`, `addedManually`) and `tokensUsed`. When `refresh` is present a re-dive is running: poll `get_dive_status` with `refresh.diveId`; the `addedManually` keywords show in the MKL once it succeeds. A confirmed call is not safe to retry: if it errors or times out, poll `get_dive_status` or re-read `get_niche_keywords` instead of re-calling. Limited to 2 calls per minute per niche, so batch keywords into one call. Undo with `remove_niche_keywords`. A keyword hidden by the niche's keyword exclusions stays hidden after an add: check `list_keyword_exclusions` and remove the exclusion with `remove_keyword_exclusions` first.",
-  inputSchema: inputSchema16,
+  inputSchema: inputSchema27,
   // Like redive_niche: additive, but it can spend Dive tokens irreversibly, which is what clients
   // need to prompt on. The confirm gate covers the paid path regardless.
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
@@ -943,9 +1258,9 @@ var addNicheKeywordsTool = {
 };
 
 // src/tools/remove-niche-keywords.ts
-import { z as z17 } from "zod";
-var inputSchema17 = {
-  nicheId: z17.string().min(1).describe("The niche whose Master Keyword List to remove from. Get one from `list_niches`."),
+import { z as z27 } from "zod";
+var inputSchema28 = {
+  nicheId: z27.string().min(1).describe("The niche whose Master Keyword List to remove from. Get one from `list_niches`."),
   keywords: nicheKeywordList.describe(
     `The keywords to take out, 1\u2013${NICHE_KEYWORDS_MAX_PER_CALL} per call, at most 255 characters each. They are lower-cased and trimmed, and must be unique after that. Put every keyword in one call: this tool allows only 2 calls per minute per niche.`
   )
@@ -954,7 +1269,7 @@ var removeNicheKeywordsTool = {
   name: "remove_niche_keywords",
   title: "Remove Keywords from a Niche's Master Keyword List",
   description: "Use this to undo `add_niche_keywords`: take keywords back out of a niche's Master Keyword List (MKL). Only keywords that were added to the MKL can be removed \u2014 `get_niche_keywords` shows each keyword's `origin`. What happens depends on that origin, and the response reports it per keyword: `removedManual` \u2014 added by hand (`manual`), deleted from the niche; `sentBackToOutliers` / `sentBackToResidue` \u2014 moved in from those lists (`outlier` / `residue`), listed there again with their data kept; `notRemovable` \u2014 found by the dive itself (`mkl`) or not in the niche, left unchanged. To hide a keyword the dive found, use `add_keyword_exclusions` instead. Free, and safe to repeat: a keyword already removed comes back under `notRemovable`. Adding a hand-added keyword back later re-dives the niche and costs Dive tokens if the niche is stale by then. Limited to 2 calls per minute per niche.",
-  inputSchema: inputSchema17,
+  inputSchema: inputSchema28,
   // Deletes hand-added keywords, and putting them back can cost Dive tokens on a stale niche.
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
@@ -967,10 +1282,10 @@ var removeNicheKeywordsTool = {
 };
 
 // src/tools/keyword-exclusions-input.ts
-import { z as z18 } from "zod";
-var entries = (field) => uniqueKeywords(z18.array(nicheKeyword()).max(KEYWORD_EXCLUSIONS_MAX_PER_CALL), field).optional();
+import { z as z28 } from "zod";
+var entries = (field) => uniqueKeywords(z28.array(nicheKeyword()).max(KEYWORD_EXCLUSIONS_MAX_PER_CALL), field).optional();
 var keywordExclusionsInputSchema = (verb) => ({
-  nicheId: z18.string().min(1).describe("The niche whose keyword exclusions to change. Get one from `list_niches`."),
+  nicheId: z28.string().min(1).describe("The niche whose keyword exclusions to change. Get one from `list_niches`."),
   exact: entries("exact").describe(
     `Exact-match entries to ${verb}: each one hides the single keyword that matches it exactly. At most 255 characters each; lower-cased and trimmed, and must be unique after that.`
   ),
@@ -990,12 +1305,12 @@ function assertExclusionCount(exact, phrase) {
 }
 
 // src/tools/add-keyword-exclusions.ts
-var inputSchema18 = keywordExclusionsInputSchema("exclude");
+var inputSchema29 = keywordExclusionsInputSchema("exclude");
 var addKeywordExclusionsTool = {
   name: "add_keyword_exclusions",
   title: "Exclude Keywords from a Niche",
   description: `Use this to hide irrelevant keywords from a niche's Master Keyword List \u2014 e.g. other brands, wrong product types. \`exact\` entries hide the one keyword that matches exactly; \`phrase\` entries hide every keyword containing the phrase, so prefer \`exact\` unless the user wants a whole family of keywords gone. The excluded keywords drop out of \`get_niche_keywords\` at once, wherever they come from: the dive, Outliers, Residue, or ones added with \`add_niche_keywords\`. Nothing is deleted: \`remove_keyword_exclusions\` brings them back. Only the exclusions change \u2014 every other niche setting is kept. Send 1\u2013${KEYWORD_EXCLUSIONS_MAX_PER_CALL} entries in total across \`exact\` and \`phrase\`; a niche can hold at most ${KEYWORD_EXCLUSIONS_MAX_PER_NICHE} exclusions. Free, no tokens, and safe to repeat: entries already excluded come back under \`unchanged\`. Returns \`added\`, \`unchanged\` and the full \`exact\` / \`phrase\` lists after the change. Limited to 30 calls per minute per niche, so batch entries into one call.`,
-  inputSchema: inputSchema18,
+  inputSchema: inputSchema29,
   // Hides data from every MKL-based view until undone; reversible, but clients should prompt on it.
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
@@ -1009,12 +1324,12 @@ var addKeywordExclusionsTool = {
 };
 
 // src/tools/remove-keyword-exclusions.ts
-var inputSchema19 = keywordExclusionsInputSchema("stop excluding");
+var inputSchema30 = keywordExclusionsInputSchema("stop excluding");
 var removeKeywordExclusionsTool = {
   name: "remove_keyword_exclusions",
   title: "Remove Keyword Exclusions from a Niche",
   description: `Use this to undo \`add_keyword_exclusions\`, so the keywords an exclusion hid show in the niche's Master Keyword List (\`get_niche_keywords\`) again. Pass the entries exactly as \`list_keyword_exclusions\` shows them, \`exact\` and \`phrase\` separately: removing a phrase does not touch an exact entry for the same text, and a keyword also hidden by another remaining exclusion stays hidden. Only the exclusions change \u2014 every other niche setting is kept. Send 1\u2013${KEYWORD_EXCLUSIONS_MAX_PER_CALL} entries in total across \`exact\` and \`phrase\`. Free, and safe to repeat: entries that are not excluded come back under \`unchanged\`. Returns \`removed\`, \`unchanged\` and the full \`exact\` / \`phrase\` lists after the change. Limited to 30 calls per minute per niche.`,
-  inputSchema: inputSchema19,
+  inputSchema: inputSchema30,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     assertExclusionCount(args.exact, args.phrase);
@@ -1027,10 +1342,10 @@ var removeKeywordExclusionsTool = {
 };
 
 // src/tools/delete-niche.ts
-import { z as z19 } from "zod";
-var inputSchema20 = {
-  nicheId: z19.string().min(1).describe("The niche to delete. Get one from `list_niches`."),
-  confirm: z19.boolean().optional().describe(
+import { z as z29 } from "zod";
+var inputSchema31 = {
+  nicheId: z29.string().min(1).describe("The niche to delete. Get one from `list_niches`."),
+  confirm: z29.boolean().optional().describe(
     "Must be true to proceed \u2014 deleting a niche destroys its keywords, competitors and dive history permanently. Confirm with the user first."
   )
 };
@@ -1038,7 +1353,7 @@ var deleteNicheTool = {
   name: "delete_niche",
   title: "Delete a Niche",
   description: "Use this to permanently remove a niche the user no longer needs. \u26A0\uFE0F Deletes the niche and everything attached to it \u2014 keywords, competitors, all dives and diveboxes \u2014 and cannot be undone; the dive tokens already spent on it are NOT refunded. Set `confirm: true` only after the user approves. A niche used by any Rank Radar cannot be deleted: the call fails with a conflict, so delete or archive those rank radars first (`list_rank_radars` with the `nicheId` filter shows them).",
-  inputSchema: inputSchema20,
+  inputSchema: inputSchema31,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     const pending = requireConfirmation(
@@ -1056,15 +1371,15 @@ var deleteNicheTool = {
 };
 
 // src/tools/pause-rank-radar.ts
-import { z as z20 } from "zod";
-var inputSchema21 = {
-  rankRadarId: z20.string().uuid().describe("The Rank Radar UUID to pause (from `list_rank_radars`).")
+import { z as z30 } from "zod";
+var inputSchema32 = {
+  rankRadarId: z30.string().uuid().describe("The Rank Radar UUID to pause (from `list_rank_radars`).")
 };
 var pauseRankRadarTool = {
   name: "pause_rank_radar",
   title: "Pause a Rank Radar",
   description: "Use this to pause tracking on a Rank Radar without losing anything \u2014 the action the DataDive API calls 'archiving', so when a user asks to archive a Rank Radar, this is the tool they mean. Tracking stops for all of its keywords and the Daily Tracked Keywords quota they held is freed for other Rank Radars, while the Rank Radar and its ranking history are kept. Fully reversible with `resume_rank_radar`, so it needs no `confirm` \u2014 prefer it over `delete_rank_radar` whenever the user may want the data back. Paused Rank Radars show up in `list_rank_radars` under `status: PAUSED` \u2014 not `ARCHIVED`, which covers Rank Radars removed with `delete_rank_radar`. Safe to repeat: pausing an already paused Rank Radar succeeds and changes nothing.",
-  inputSchema: inputSchema21,
+  inputSchema: inputSchema32,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     await httpPost(
@@ -1077,15 +1392,15 @@ var pauseRankRadarTool = {
 };
 
 // src/tools/resume-rank-radar.ts
-import { z as z21 } from "zod";
-var inputSchema22 = {
-  rankRadarId: z21.string().uuid().describe("The Rank Radar UUID to resume (from `list_rank_radars`).")
+import { z as z31 } from "zod";
+var inputSchema33 = {
+  rankRadarId: z31.string().uuid().describe("The Rank Radar UUID to resume (from `list_rank_radars`).")
 };
 var resumeRankRadarTool = {
   name: "resume_rank_radar",
   title: "Resume a Paused Rank Radar",
   description: "Use this to restart tracking on a Rank Radar that was paused with `pause_rank_radar` (shown by `list_rank_radars` under `status: PAUSED`; a deleted, `ARCHIVED` one cannot be resumed). Keywords are resumed as far as the available Daily Tracked Keywords quota allows, most relevant first \u2014 so with a tight quota only part of the original keyword set comes back; check `get_quota` first if that matters. Reversible with `pause_rank_radar`, so it needs no `confirm`. Fails with a bad-request error when there is no quota left at all. Safe to repeat: resuming an already active Rank Radar changes nothing.",
-  inputSchema: inputSchema22,
+  inputSchema: inputSchema33,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     await httpPost(
@@ -1098,10 +1413,10 @@ var resumeRankRadarTool = {
 };
 
 // src/tools/delete-rank-radar.ts
-import { z as z22 } from "zod";
-var inputSchema23 = {
-  rankRadarId: z22.string().uuid().describe("The Rank Radar UUID to delete (from `list_rank_radars`)."),
-  confirm: z22.boolean().optional().describe(
+import { z as z32 } from "zod";
+var inputSchema34 = {
+  rankRadarId: z32.string().uuid().describe("The Rank Radar UUID to delete (from `list_rank_radars`)."),
+  confirm: z32.boolean().optional().describe(
     "Must be true to proceed \u2014 deleting a Rank Radar destroys its ranking history permanently. Confirm with the user first."
   )
 };
@@ -1109,7 +1424,7 @@ var deleteRankRadarTool = {
   name: "delete_rank_radar",
   title: "Delete a Rank Radar",
   description: "Use this to permanently remove a Rank Radar and all of its keyword ranking history. \u26A0\uFE0F Cannot be undone \u2014 there is no restore endpoint; set `confirm: true` only after the user approves. It does free the Daily Tracked Keywords quota those keywords held. Deleted Rank Radars are what `list_rank_radars` returns for `status: ARCHIVED`. If the user only wants to stop tracking for a while and keep the history \u2014 or asks to 'archive' the Rank Radar, which is what the DataDive API calls pausing \u2014 use `pause_rank_radar` instead: it frees the same quota and is reversible with `resume_rank_radar`.",
-  inputSchema: inputSchema23,
+  inputSchema: inputSchema34,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     const pending = requireConfirmation(
@@ -1127,10 +1442,10 @@ var deleteRankRadarTool = {
 };
 
 // src/tools/add-rank-radar-search-terms.ts
-import { z as z23 } from "zod";
-var inputSchema24 = {
-  rankRadarId: z23.string().uuid().describe("The Rank Radar UUID to add the search terms to (from `list_rank_radars`)."),
-  searchTerms: z23.array(z23.string().min(1)).min(1).max(ADD_SEARCH_TERMS_MAX).describe(
+import { z as z33 } from "zod";
+var inputSchema35 = {
+  rankRadarId: z33.string().uuid().describe("The Rank Radar UUID to add the search terms to (from `list_rank_radars`)."),
+  searchTerms: z33.array(z33.string().min(1)).min(1).max(ADD_SEARCH_TERMS_MAX).describe(
     `The keywords to start tracking, 1\u2013${ADD_SEARCH_TERMS_MAX} per call. Must be unique. Amazon-ignored special characters (@, #, _, parentheses, \u2026) are rejected.`
   )
 };
@@ -1138,7 +1453,7 @@ var addRankRadarSearchTermsTool = {
   name: "add_rank_radar_search_terms",
   title: "Add Search Terms to a Rank Radar",
   description: "Use this to start tracking extra keywords on an existing Rank Radar, instead of creating a new one with `create_rank_radar`. New keywords are added to the niche and tracked from now on; any matching keyword that was previously paused is resumed. Each newly tracked keyword takes one Daily Tracked Keywords slot, and the call fails if the quota is exhausted \u2014 check `get_quota` first. Reversible with `pause_rank_radar_search_terms`, which frees the slots again, so it needs no `confirm`. Returns `originBreakdown` (where each submitted term ended up) and `keywordToRankRadarKeywordIdMap`, whose ids are what the pause/resume search-term tools take.",
-  inputSchema: inputSchema24,
+  inputSchema: inputSchema35,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     return await httpPost(
@@ -1150,10 +1465,10 @@ var addRankRadarSearchTermsTool = {
 };
 
 // src/tools/pause-rank-radar-search-terms.ts
-import { z as z24 } from "zod";
-var inputSchema25 = {
-  rankRadarId: z24.string().uuid().describe("The Rank Radar UUID the search terms belong to."),
-  rankRadarKeywordIds: z24.array(z24.string().uuid()).min(1).describe(
+import { z as z34 } from "zod";
+var inputSchema36 = {
+  rankRadarId: z34.string().uuid().describe("The Rank Radar UUID the search terms belong to."),
+  rankRadarKeywordIds: z34.array(z34.string().uuid()).min(1).describe(
     "The Rank Radar keyword ids to pause. These are the `id` values from `get_rank_radar_data`, or the values of `keywordToRankRadarKeywordIdMap` returned by `add_rank_radar_search_terms` \u2014 not the keyword text."
   )
 };
@@ -1161,7 +1476,7 @@ var pauseRankRadarSearchTermsTool = {
   name: "pause_rank_radar_search_terms",
   title: "Pause Search Terms of a Rank Radar",
   description: "Use this to stop tracking individual keywords on a Rank Radar while keeping the Rank Radar itself active \u2014 the way to trim a keyword set the user finds too broad. The DataDive API calls this 'archiving' the search terms; nothing is lost. The paused keywords keep their history and their Daily Tracked Keywords slots are freed for other keywords. Reversible with `resume_rank_radar_search_terms`, so it needs no `confirm`. Takes keyword ids, not keyword text: get them from `get_rank_radar_data`. Safe to repeat: already-paused terms are left unchanged.",
-  inputSchema: inputSchema25,
+  inputSchema: inputSchema36,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     await httpPost(
@@ -1178,10 +1493,10 @@ var pauseRankRadarSearchTermsTool = {
 };
 
 // src/tools/resume-rank-radar-search-terms.ts
-import { z as z25 } from "zod";
-var inputSchema26 = {
-  rankRadarId: z25.string().uuid().describe("The Rank Radar UUID the search terms belong to."),
-  rankRadarKeywordIds: z25.array(z25.string().uuid()).min(1).describe(
+import { z as z35 } from "zod";
+var inputSchema37 = {
+  rankRadarId: z35.string().uuid().describe("The Rank Radar UUID the search terms belong to."),
+  rankRadarKeywordIds: z35.array(z35.string().uuid()).min(1).describe(
     "The Rank Radar keyword ids to resume. These are the `id` values from `get_rank_radar_data`, or the values of `keywordToRankRadarKeywordIdMap` returned by `add_rank_radar_search_terms` \u2014 not the keyword text."
   )
 };
@@ -1189,7 +1504,7 @@ var resumeRankRadarSearchTermsTool = {
   name: "resume_rank_radar_search_terms",
   title: "Resume Paused Search Terms of a Rank Radar",
   description: "Use this to start tracking keywords again that were paused with `pause_rank_radar_search_terms`. Each resumed keyword takes back one Daily Tracked Keywords slot, and the call fails if the quota is exhausted \u2014 check `get_quota` first. Reversible with `pause_rank_radar_search_terms`, so it needs no `confirm`. Takes keyword ids, not keyword text: get them from `get_rank_radar_data`. Safe to repeat: already-active terms are left unchanged.",
-  inputSchema: inputSchema26,
+  inputSchema: inputSchema37,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     await httpPost(
@@ -1206,18 +1521,18 @@ var resumeRankRadarSearchTermsTool = {
 };
 
 // src/tools/list-rank-radar-tags.ts
-import { z as z26 } from "zod";
+import { z as z36 } from "zod";
 var LIST_RANK_RADAR_TAGS_MAX_PAGE_SIZE = 50;
-var inputSchema27 = {
-  rankRadarId: z26.string().uuid().describe("The Rank Radar UUID whose tags to list (from `list_rank_radars`)."),
-  currentPage: z26.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z26.number().int().min(1).max(LIST_RANK_RADAR_TAGS_MAX_PAGE_SIZE).optional().describe(`Items per page (max ${LIST_RANK_RADAR_TAGS_MAX_PAGE_SIZE}). Defaults to 20.`)
+var inputSchema38 = {
+  rankRadarId: z36.string().uuid().describe("The Rank Radar UUID whose tags to list (from `list_rank_radars`)."),
+  currentPage: z36.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z36.number().int().min(1).max(LIST_RANK_RADAR_TAGS_MAX_PAGE_SIZE).optional().describe(`Items per page (max ${LIST_RANK_RADAR_TAGS_MAX_PAGE_SIZE}). Defaults to 20.`)
 };
 var listRankRadarTagsTool = {
   name: "list_rank_radar_tags",
   title: "List Tags of a Rank Radar",
   description: `Use this to find a \`tagId\` before calling \`update_rank_radar_tag\`, \`delete_rank_radar_tag\`, \`add_rank_radar_tag_search_terms\` or \`remove_rank_radar_tag_search_terms\`. Returns the user tags ("highlights") on the specified Rank Radar, ordered by title (case-insensitive, ascending). Each row carries \`id\`, \`title\`, \`color\`, \`description\`, \`startAt\`, \`endAt\`, \`createdAt\`, and \`keywordCount\` \u2014 the number of Rank Radar keywords this tag is applied to. The system "paused" tag (the one the quota pauser writes with a reserved colour) is not listed and cannot be addressed from these tools. Supports pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev); a page holds at most ${LIST_RANK_RADAR_TAGS_MAX_PAGE_SIZE} tags.`,
-  inputSchema: inputSchema27,
+  inputSchema: inputSchema38,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -1232,19 +1547,19 @@ var listRankRadarTagsTool = {
 };
 
 // src/tools/create-rank-radar-tag.ts
-import { z as z27 } from "zod";
-var inputSchema28 = {
-  rankRadarId: z27.string().uuid().describe("The Rank Radar UUID to create the tag on (from `list_rank_radars`)."),
-  title: z27.string().min(1).max(TAG_TITLE_MAX_LENGTH).describe(
+import { z as z37 } from "zod";
+var inputSchema39 = {
+  rankRadarId: z37.string().uuid().describe("The Rank Radar UUID to create the tag on (from `list_rank_radars`)."),
+  title: z37.string().min(1).max(TAG_TITLE_MAX_LENGTH).describe(
     `Display title (1\u2013${TAG_TITLE_MAX_LENGTH} characters, trimmed on write). Must be unique on this Rank Radar, case-insensitive. A clash returns 409 with \`{ error: 'TAG_TITLE_EXISTS', existingTagId }\` \u2014 reuse that id instead of retrying.`
   ),
-  color: z27.string().regex(TAG_HEX_COLOR_PATTERN, "color must be in #RRGGBB form").optional().describe(
+  color: z37.string().regex(TAG_HEX_COLOR_PATTERN, "color must be in #RRGGBB form").optional().describe(
     `Hex colour in \`#RRGGBB\` form. Defaults to the UI grey when omitted. The reserved colour \`${TAG_RESERVED_COLOR}\` (used by the system "paused" tag) is rejected with 400.`
   ),
-  description: z27.string().optional().describe("Free-form description, e.g. 'Prime Day run-up'."),
-  startAt: z27.string().optional().describe("ISO 8601 start date, e.g. '2026-07-01'. Required if `endAt` is set; `endAt >= startAt`."),
-  endAt: z27.string().optional().describe("ISO 8601 end date, e.g. '2026-07-14'. Must be greater than or equal to `startAt`."),
-  rankRadarKeywordIds: z27.array(z27.string().uuid()).min(1).max(TAG_KEYWORD_IDS_MAX).optional().describe(
+  description: z37.string().optional().describe("Free-form description, e.g. 'Prime Day run-up'."),
+  startAt: z37.string().optional().describe("ISO 8601 start date, e.g. '2026-07-01'. Required if `endAt` is set; `endAt >= startAt`."),
+  endAt: z37.string().optional().describe("ISO 8601 end date, e.g. '2026-07-14'. Must be greater than or equal to `startAt`."),
+  rankRadarKeywordIds: z37.array(z37.string().uuid()).min(1).max(TAG_KEYWORD_IDS_MAX).optional().describe(
     `Optional: Rank Radar keyword ids to tag on creation (1\u2013${TAG_KEYWORD_IDS_MAX}). These are the \`id\` values from \`get_rank_radar_data\`; the ids must all belong to this Rank Radar. To attach more later, use \`add_rank_radar_tag_search_terms\`.`
   )
 };
@@ -1252,7 +1567,7 @@ var createRankRadarTagTool = {
   name: "create_rank_radar_tag",
   title: "Create a Rank Radar Tag",
   description: `Use this to create a new user tag ("highlight") on a Rank Radar \u2014 the way the UI marks a window on the ranking chart. Writing a tag costs nothing and is reversible with \`delete_rank_radar_tag\`, so no confirmation is required. Returns the new tag row (\`id\`, \`title\`, \`color\`, \`description\`, \`startAt\`, \`endAt\`, \`keywordCount\`, \`createdAt\`); the \`id\` is the \`tagId\` the other tag tools take. If the title clashes with an existing tag on this Rank Radar, the API answers 409 \`{ error: 'TAG_TITLE_EXISTS', existingTagId }\` so callers can reuse the existing tag without a follow-up \`list_rank_radar_tags\`. The reserved colour \`${TAG_RESERVED_COLOR}\` is rejected with 400. Pass \`rankRadarKeywordIds\` to tag a batch of keywords in the same call; otherwise create the tag and attach keywords later with \`add_rank_radar_tag_search_terms\`.`,
-  inputSchema: inputSchema28,
+  inputSchema: inputSchema39,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     const body = { title: args.title };
@@ -1270,23 +1585,23 @@ var createRankRadarTagTool = {
 };
 
 // src/tools/update-rank-radar-tag.ts
-import { z as z28 } from "zod";
-var inputSchema29 = {
-  rankRadarId: z28.string().uuid().describe("The Rank Radar UUID the tag belongs to (from `list_rank_radars`)."),
-  tagId: z28.string().uuid().describe("The tag UUID to update (the `id` from `list_rank_radar_tags` or `create_rank_radar_tag`)."),
-  title: z28.string().min(1).max(TAG_TITLE_MAX_LENGTH).optional().describe(
+import { z as z38 } from "zod";
+var inputSchema40 = {
+  rankRadarId: z38.string().uuid().describe("The Rank Radar UUID the tag belongs to (from `list_rank_radars`)."),
+  tagId: z38.string().uuid().describe("The tag UUID to update (the `id` from `list_rank_radar_tags` or `create_rank_radar_tag`)."),
+  title: z38.string().min(1).max(TAG_TITLE_MAX_LENGTH).optional().describe(
     `New title (1\u2013${TAG_TITLE_MAX_LENGTH} characters, trimmed on write). Must be unique on this Rank Radar, case-insensitive. A clash returns 409 with \`{ error: 'TAG_TITLE_EXISTS', existingTagId }\`.`
   ),
-  color: z28.string().regex(TAG_HEX_COLOR_PATTERN, "color must be in #RRGGBB form").optional().describe(`Hex colour in \`#RRGGBB\` form. The reserved colour \`${TAG_RESERVED_COLOR}\` is rejected with 400.`),
-  description: z28.string().optional().describe("Free-form description. Pass an empty string to clear."),
-  startAt: z28.string().optional().describe("ISO 8601 start date, e.g. '2026-07-01'. `endAt >= startAt`."),
-  endAt: z28.string().optional().describe("ISO 8601 end date, e.g. '2026-07-14'. `endAt >= startAt`.")
+  color: z38.string().regex(TAG_HEX_COLOR_PATTERN, "color must be in #RRGGBB form").optional().describe(`Hex colour in \`#RRGGBB\` form. The reserved colour \`${TAG_RESERVED_COLOR}\` is rejected with 400.`),
+  description: z38.string().optional().describe("Free-form description. Pass an empty string to clear."),
+  startAt: z38.string().optional().describe("ISO 8601 start date, e.g. '2026-07-01'. `endAt >= startAt`."),
+  endAt: z38.string().optional().describe("ISO 8601 end date, e.g. '2026-07-14'. `endAt >= startAt`.")
 };
 var updateRankRadarTagTool = {
   name: "update_rank_radar_tag",
   title: "Update a Rank Radar Tag",
   description: "Use this to change a tag's title, colour, description, or date window. Partial update: only the fields you pass are modified, the rest are left as they are. The system \"paused\" tag (reserved colour, written by the quota pauser) cannot be addressed from here \u2014 the API answers 404. Writing a tag costs nothing and is reversible, so no confirmation is required. Returns the updated tag row. Title clashes return 409 `{ error: 'TAG_TITLE_EXISTS', existingTagId }`; the reserved colour returns 400; and `endAt < startAt` returns 400 (for whichever side the body omits, the comparison uses the stored value).",
-  inputSchema: inputSchema29,
+  inputSchema: inputSchema40,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     const body = {};
@@ -1304,11 +1619,11 @@ var updateRankRadarTagTool = {
 };
 
 // src/tools/delete-rank-radar-tag.ts
-import { z as z29 } from "zod";
-var inputSchema30 = {
-  rankRadarId: z29.string().uuid().describe("The Rank Radar UUID the tag belongs to (from `list_rank_radars`)."),
-  tagId: z29.string().uuid().describe("The tag UUID to delete (the `id` from `list_rank_radar_tags`)."),
-  confirm: z29.boolean().optional().describe(
+import { z as z39 } from "zod";
+var inputSchema41 = {
+  rankRadarId: z39.string().uuid().describe("The Rank Radar UUID the tag belongs to (from `list_rank_radars`)."),
+  tagId: z39.string().uuid().describe("The tag UUID to delete (the `id` from `list_rank_radar_tags`)."),
+  confirm: z39.boolean().optional().describe(
     "Must be true to proceed. Confirm with the user first \u2014 the tag's keyword assignments are removed too and the tag cannot be recovered."
   )
 };
@@ -1316,7 +1631,7 @@ var deleteRankRadarTagTool = {
   name: "delete_rank_radar_tag",
   title: "Delete a Rank Radar Tag",
   description: 'Use this to permanently remove a tag from a Rank Radar. \u26A0\uFE0F The tag itself is gone and the assignments linking it to each tagged keyword are removed with it; the keywords themselves keep tracking. The deletion cannot be undone from this tool, so set `confirm: true` only after the user approves. The system "paused" tag (reserved colour, written by the quota pauser) cannot be addressed from here \u2014 the API answers 404. To remove just the assignments and keep the tag, use `remove_rank_radar_tag_search_terms` instead.',
-  inputSchema: inputSchema30,
+  inputSchema: inputSchema41,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     const pending = requireConfirmation(
@@ -1334,11 +1649,11 @@ var deleteRankRadarTagTool = {
 };
 
 // src/tools/add-rank-radar-tag-search-terms.ts
-import { z as z30 } from "zod";
-var inputSchema31 = {
-  rankRadarId: z30.string().uuid().describe("The Rank Radar UUID the tag belongs to (from `list_rank_radars`)."),
-  tagId: z30.string().uuid().describe("The tag UUID to attach keywords to (the `id` from `list_rank_radar_tags`)."),
-  rankRadarKeywordIds: z30.array(z30.string().uuid()).min(1).max(TAG_KEYWORD_IDS_MAX).describe(
+import { z as z40 } from "zod";
+var inputSchema42 = {
+  rankRadarId: z40.string().uuid().describe("The Rank Radar UUID the tag belongs to (from `list_rank_radars`)."),
+  tagId: z40.string().uuid().describe("The tag UUID to attach keywords to (the `id` from `list_rank_radar_tags`)."),
+  rankRadarKeywordIds: z40.array(z40.string().uuid()).min(1).max(TAG_KEYWORD_IDS_MAX).describe(
     `Rank Radar keyword ids to attach to this tag (1\u2013${TAG_KEYWORD_IDS_MAX} per call, unique). These are the \`id\` values from \`get_rank_radar_data\`; all ids must belong to this Rank Radar. Safe to repeat: keywords already attached are left unchanged.`
   )
 };
@@ -1346,7 +1661,7 @@ var addRankRadarTagSearchTermsTool = {
   name: "add_rank_radar_tag_search_terms",
   title: "Attach Search Terms to a Rank Radar Tag",
   description: `Use this to tag a batch of keywords on a Rank Radar \u2014 the same relation \`create_rank_radar_tag\` writes when \`rankRadarKeywordIds\` is passed on creation, so this is how you keep extending a tag's keyword set over time. Reversible with \`remove_rank_radar_tag_search_terms\`, so no confirmation is required. Idempotent: already-attached keywords are left unchanged, so re-sending the same ids after a timeout is safe. Up to ${TAG_KEYWORD_IDS_MAX} ids per call \u2014 split larger batches into multiple calls. The system "paused" tag (reserved colour, written by the quota pauser) is not addressable: the API answers 404.`,
-  inputSchema: inputSchema31,
+  inputSchema: inputSchema42,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     return await httpPost(
@@ -1358,11 +1673,11 @@ var addRankRadarTagSearchTermsTool = {
 };
 
 // src/tools/remove-rank-radar-tag-search-terms.ts
-import { z as z31 } from "zod";
-var inputSchema32 = {
-  rankRadarId: z31.string().uuid().describe("The Rank Radar UUID the tag belongs to (from `list_rank_radars`)."),
-  tagId: z31.string().uuid().describe("The tag UUID to detach keywords from (the `id` from `list_rank_radar_tags`)."),
-  rankRadarKeywordIds: z31.array(z31.string().uuid()).min(1).max(TAG_KEYWORD_IDS_MAX).describe(
+import { z as z41 } from "zod";
+var inputSchema43 = {
+  rankRadarId: z41.string().uuid().describe("The Rank Radar UUID the tag belongs to (from `list_rank_radars`)."),
+  tagId: z41.string().uuid().describe("The tag UUID to detach keywords from (the `id` from `list_rank_radar_tags`)."),
+  rankRadarKeywordIds: z41.array(z41.string().uuid()).min(1).max(TAG_KEYWORD_IDS_MAX).describe(
     `Rank Radar keyword ids to detach from this tag (1\u2013${TAG_KEYWORD_IDS_MAX} per call, unique). These are the \`id\` values from \`get_rank_radar_data\`. Safe to repeat: keywords that are not currently attached are left unchanged.`
   )
 };
@@ -1370,7 +1685,7 @@ var removeRankRadarTagSearchTermsTool = {
   name: "remove_rank_radar_tag_search_terms",
   title: "Detach Search Terms from a Rank Radar Tag",
   description: `Use this to remove keywords from a tag without deleting the tag itself. The tag keeps its title, colour and date window; only the keyword assignments listed are cleared. Reversible with \`add_rank_radar_tag_search_terms\`, so no confirmation is required. Idempotent: ids that are not currently attached are left unchanged, so re-sending the same ids after a timeout is safe. Up to ${TAG_KEYWORD_IDS_MAX} ids per call \u2014 split larger batches into multiple calls. To remove the tag itself, use \`delete_rank_radar_tag\`. The system "paused" tag (reserved colour, written by the quota pauser) is not addressable: the API answers 404.`,
-  inputSchema: inputSchema32,
+  inputSchema: inputSchema43,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     return await httpPost(
@@ -1382,16 +1697,16 @@ var removeRankRadarTagSearchTermsTool = {
 };
 
 // src/tools/generate-listing-copy.ts
-import { z as z32 } from "zod";
-var inputSchema33 = {
-  nicheId: z32.string().min(1).describe("The niche whose keyword data the copy is written from. Get one from `list_niches`."),
-  strategy: z32.enum(LISTING_COPY_STRATEGIES).describe(
+import { z as z42 } from "zod";
+var inputSchema44 = {
+  nicheId: z42.string().min(1).describe("The niche whose keyword data the copy is written from. Get one from `list_niches`."),
+  strategy: z42.enum(LISTING_COPY_STRATEGIES).describe(
     "Which generation strategy to use. `cosmo` targets Amazon's COSMO relevance model, `ranking-juice` optimises for DataDive's ranking-juice score, `nlp` writes for keyword coverage, and `cosmo-rufus` targets COSMO plus the Rufus shopping assistant. Ask the user if they have no preference."
   ),
-  currentListing: z32.record(z32.union([z32.string(), z32.array(z32.string())])).describe(
+  currentListing: z42.record(z42.union([z42.string(), z42.array(z42.string())])).describe(
     'The seller\'s existing listing to rewrite, as an object \u2014 e.g. `{ "title": "...", "description": "...", "bullets": ["...", "..."] }`. Pass what the user has; it is the starting point the generated copy builds on.'
   ),
-  confirm: z32.boolean().optional().describe(
+  confirm: z42.boolean().optional().describe(
     "Must be true to proceed \u2014 each generation spends one AI Copywriter prompt from the quota. Confirm the cost with the user first."
   )
 };
@@ -1399,7 +1714,7 @@ var generateListingCopyTool = {
   name: "generate_listing_copy",
   title: "Generate Listing Copy for a Niche",
   description: "Use this to draft an optimised Amazon listing \u2014 title, bullets and description \u2014 from a niche's keyword research and the seller's current listing. It writes text only: nothing is published to Amazon, and the user still has to paste the result into Seller Central. \u26A0\uFE0F Spends one AI Copywriter prompt from the quota per call and cannot be undone \u2014 set `confirm: true` only after the user approves. Not safe to retry: each call spends another prompt, so if a call errors or times out, poll `get_listing_copy_generation_status` instead of re-calling. Runs asynchronously: returns a `generationId` \u2014 poll `get_listing_copy_generation_status` with it until the status is `complete`.",
-  inputSchema: inputSchema33,
+  inputSchema: inputSchema44,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     const pending = requireConfirmation(
@@ -1417,16 +1732,16 @@ var generateListingCopyTool = {
 };
 
 // src/tools/get-listing-copy-generation-status.ts
-import { z as z33 } from "zod";
-var inputSchema34 = {
-  nicheId: z33.string().min(1).describe("The niche the generation was started for."),
-  generationId: z33.string().min(1).describe("The `generationId` returned by `generate_listing_copy`.")
+import { z as z43 } from "zod";
+var inputSchema45 = {
+  nicheId: z43.string().min(1).describe("The niche the generation was started for."),
+  generationId: z43.string().min(1).describe("The `generationId` returned by `generate_listing_copy`.")
 };
 var getListingCopyGenerationStatusTool = {
   name: "get_listing_copy_generation_status",
   title: "Get Listing Copy Generation Status",
   description: "Use this to poll a listing-copy draft started with `generate_listing_copy` until it finishes. Returns one of three shapes keyed by `status`: `generating` (still running \u2014 poll again in a few seconds), `complete` (with `result`, carrying the generated `title`, `bullets`, `description`, `itemHighlights` and its `rankingJuice` score), or `failed` (with an `error` message). Polling is free \u2014 it does not spend another AI Copywriter prompt, so always poll rather than re-calling `generate_listing_copy`.",
-  inputSchema: inputSchema34,
+  inputSchema: inputSchema45,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -1437,16 +1752,16 @@ var getListingCopyGenerationStatusTool = {
 };
 
 // src/tools/list-seller-profiles.ts
-import { z as z34 } from "zod";
-var inputSchema35 = {
-  currentPage: z34.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z34.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
+import { z as z44 } from "zod";
+var inputSchema46 = {
+  currentPage: z44.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z44.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
 };
 var listSellerProfilesTool = {
   name: "list_seller_profiles",
   title: "List Connected Amazon Seller Profiles",
   description: 'Use this when the user asks which Amazon seller accounts are connected, or as the discovery step to find the `sellerId` and `marketplace` required by `get_asin_inventory_distribution`, `get_seller_catalog`, `get_seller_listing_changes`, and the alert tools. Returns a paginated list of the organization\'s connected seller profiles \u2014 each item has sellerId, sellerName, marketplace (e.g. "com", "co.uk"), hasAdApi (whether Advertising API credentials are connected), and createdAt \u2014 plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev).',
-  inputSchema: inputSchema35,
+  inputSchema: inputSchema46,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -1461,15 +1776,15 @@ var listSellerProfilesTool = {
 };
 
 // src/tools/get-seller-catalog.ts
-import { z as z36 } from "zod";
+import { z as z46 } from "zod";
 
 // src/tools/seller-scoped.ts
-import { z as z35 } from "zod";
+import { z as z45 } from "zod";
 var sellerScopedInputSchema = {
-  sellerId: z35.string().min(1).describe(
+  sellerId: z45.string().min(1).describe(
     "Amazon seller account ID. Get it from `list_seller_profiles`, or find it on the Connections page at https://2.datadive.tools."
   ),
-  marketplace: z35.enum(SUPPORTED_MARKETPLACES).describe('Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.')
+  marketplace: z45.enum(SUPPORTED_MARKETPLACES).describe('Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.')
 };
 function sellerMarketplacePath(sellerId, marketplace, suffix) {
   return `/v1/seller_profiles/${encodeURIComponent(sellerId)}/marketplaces/${encodeURIComponent(
@@ -1478,19 +1793,19 @@ function sellerMarketplacePath(sellerId, marketplace, suffix) {
 }
 
 // src/tools/get-seller-catalog.ts
-var inputSchema36 = {
+var inputSchema47 = {
   ...sellerScopedInputSchema,
-  search: z36.string().min(1).optional().describe("Case-insensitive partial match on product title or brand."),
-  brand: z36.string().min(1).optional().describe("Case-insensitive partial match on brand name."),
-  status: z36.enum(CATALOG_STATUSES).optional().describe('Listing status filter. "Active" (default) or "all".'),
-  currentPage: z36.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z36.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
+  search: z46.string().min(1).optional().describe("Case-insensitive partial match on product title or brand."),
+  brand: z46.string().min(1).optional().describe("Case-insensitive partial match on brand name."),
+  status: z46.enum(CATALOG_STATUSES).optional().describe('Listing status filter. "Active" (default) or "all".'),
+  currentPage: z46.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z46.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
 };
 var getSellerCatalogTool = {
   name: "get_seller_catalog",
   title: "List Catalog ASINs for a Seller",
   description: "Use this when the user wants to browse or search a seller's own Amazon catalog \u2014 the products they sell on a given marketplace. Requires a `sellerId` + `marketplace` (use `list_seller_profiles` to discover them). Filter by `search` (title/brand), `brand`, and `status` (Active by default, or all). Returns a paginated list where each item has asin, title, parentAsin, brand, status, imageUrl, and hasVariations, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev).",
-  inputSchema: inputSchema36,
+  inputSchema: inputSchema47,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -1508,28 +1823,28 @@ var getSellerCatalogTool = {
 };
 
 // src/tools/get-seller-listing-changes.ts
-import { z as z37 } from "zod";
-var inputSchema37 = {
+import { z as z47 } from "zod";
+var inputSchema48 = {
   ...sellerScopedInputSchema,
-  types: z37.array(z37.enum(LISTING_CHANGE_TYPES)).min(1).optional().describe('Filter to specific change types. Omit for all. Any of "Price", "Content", "Image".'),
-  asin: z37.string().min(1).optional().describe("Filter to an exact ASIN or parent ASIN."),
-  brand: z37.string().min(1).optional().describe("Case-insensitive partial match on brand name."),
-  search: z37.string().min(1).optional().describe("Case-insensitive partial match on product title or brand."),
-  startDate: z37.string().regex(ISO_8601, "startDate must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe("ISO-8601 date/timestamp; return only changes detected on or after this time."),
-  endDate: z37.string().regex(ISO_8601, "endDate must be an ISO-8601 date or timestamp (e.g. 2026-05-31 or 2026-05-31T23:59:59Z)").optional().describe("ISO-8601 date/timestamp; return only changes detected on or before this time."),
-  sortBy: z37.enum(LISTING_CHANGE_SORT_BY).optional().describe('Sort field. "date" (default) or "type".'),
-  sortOrder: z37.enum(SORT_ORDER).optional().describe('Sort direction. "DESC" (default) or "ASC".'),
-  includeCorrelations: z37.boolean().optional().describe(
+  types: z47.array(z47.enum(LISTING_CHANGE_TYPES)).min(1).optional().describe('Filter to specific change types. Omit for all. Any of "Price", "Content", "Image".'),
+  asin: z47.string().min(1).optional().describe("Filter to an exact ASIN or parent ASIN."),
+  brand: z47.string().min(1).optional().describe("Case-insensitive partial match on brand name."),
+  search: z47.string().min(1).optional().describe("Case-insensitive partial match on product title or brand."),
+  startDate: z47.string().regex(ISO_8601, "startDate must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe("ISO-8601 date/timestamp; return only changes detected on or after this time."),
+  endDate: z47.string().regex(ISO_8601, "endDate must be an ISO-8601 date or timestamp (e.g. 2026-05-31 or 2026-05-31T23:59:59Z)").optional().describe("ISO-8601 date/timestamp; return only changes detected on or before this time."),
+  sortBy: z47.enum(LISTING_CHANGE_SORT_BY).optional().describe('Sort field. "date" (default) or "type".'),
+  sortOrder: z47.enum(SORT_ORDER).optional().describe('Sort direction. "DESC" (default) or "ASC".'),
+  includeCorrelations: z47.boolean().optional().describe(
     "When true, include the ranking/conversion `correlation` object per change (CVR and search-term movement before vs after). Defaults to false."
   ),
-  currentPage: z37.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z37.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
+  currentPage: z47.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z47.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
 };
 var getSellerListingChangesTool = {
   name: "get_seller_listing_changes",
   title: "List Listing Changes for a Seller",
   description: "Use this when the user asks what changed on their Amazon listings \u2014 price, content (title/bullets/description), or image edits \u2014 for a seller account. Requires a `sellerId` + `marketplace` (use `list_seller_profiles` to discover them). Filter by `types`, `asin`/parent ASIN, `brand`, `search`, and a `startDate`/`endDate` range; sort with `sortBy`/`sortOrder`. Set `includeCorrelations: true` to attach the ranking/conversion impact per change. Returns a paginated list where each item has asin, title, imageUrl, date, type, contentType, description, previousValue, newValue, and (optionally) correlation, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev).",
-  inputSchema: inputSchema37,
+  inputSchema: inputSchema48,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -1554,40 +1869,40 @@ var getSellerListingChangesTool = {
 };
 
 // src/tools/list-ppc-campaigns.ts
-import { z as z38 } from "zod";
+import { z as z48 } from "zod";
 var PPC_CAMPAIGNS_MAX_WINDOW_DAYS = 90;
 var PPC_CAMPAIGNS_MAX_PAGE_SIZE = 50;
-var inputSchema38 = {
+var inputSchema49 = {
   ...sellerScopedInputSchema,
-  startDate: z38.string().regex(
+  startDate: z48.string().regex(
     ISO_8601,
     "startDate must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)"
   ).optional().describe("Start of the reporting window, ISO-8601. Defaults to 30 days before endDate."),
-  endDate: z38.string().regex(
+  endDate: z48.string().regex(
     ISO_8601,
     "endDate must be an ISO-8601 date or timestamp (e.g. 2026-05-31 or 2026-05-31T23:59:59Z)"
   ).optional().describe(
     `End of the reporting window, ISO-8601. Defaults to now. At most ${PPC_CAMPAIGNS_MAX_WINDOW_DAYS} days after startDate.`
   ),
-  asin: z38.string().min(1).optional().describe("Only campaigns advertising this ASIN. Cannot be combined with parentAsin."),
-  parentAsin: z38.string().min(1).optional().describe("Only campaigns advertising any ASIN of this variation family. Cannot be combined with asin."),
-  search: z38.string().min(3).max(200).optional().describe("Partial match on campaign name or advertised ASIN. At least 3 characters."),
-  includePlacements: z38.boolean().optional().describe(
+  asin: z48.string().min(1).optional().describe("Only campaigns advertising this ASIN. Cannot be combined with parentAsin."),
+  parentAsin: z48.string().min(1).optional().describe("Only campaigns advertising any ASIN of this variation family. Cannot be combined with asin."),
+  search: z48.string().min(3).max(200).optional().describe("Partial match on campaign name or advertised ASIN. At least 3 characters."),
+  includePlacements: z48.boolean().optional().describe(
     "Include the per-placement breakdown (topOfSearch, restOfSearch, productPage, offAmazon, each with its bid adjustment). Defaults to true; set false for a smaller response when placements are not needed."
   ),
-  sortBy: z38.enum([...PPC_CAMPAIGN_BASE_SORT_BY, ...PPC_CAMPAIGN_PLACEMENT_SORT_BY]).optional().describe(
+  sortBy: z48.enum([...PPC_CAMPAIGN_BASE_SORT_BY, ...PPC_CAMPAIGN_PLACEMENT_SORT_BY]).optional().describe(
     `Sort field. Defaults to "name". Any of ${PPC_CAMPAIGN_BASE_SORT_BY.join(", ")}. The placement fields (e.g. "tosSpend", "tosAcos", "ppBidAdjustment") are only accepted when includePlacements is not false.`
   ),
-  sortOrder: z38.enum(SORT_ORDER).optional().describe('Sort direction. "ASC" (default) or "DESC".'),
-  state: z38.enum(PPC_CAMPAIGN_STATES).optional().describe("Only ENABLED or only PAUSED campaigns. Omit for both."),
-  currentPage: z38.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z38.number().int().min(1).max(PPC_CAMPAIGNS_MAX_PAGE_SIZE).optional().describe(`Campaigns per page (max ${PPC_CAMPAIGNS_MAX_PAGE_SIZE}). Defaults to 20.`)
+  sortOrder: z48.enum(SORT_ORDER).optional().describe('Sort direction. "ASC" (default) or "DESC".'),
+  state: z48.enum(PPC_CAMPAIGN_STATES).optional().describe("Only ENABLED or only PAUSED campaigns. Omit for both."),
+  currentPage: z48.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z48.number().int().min(1).max(PPC_CAMPAIGNS_MAX_PAGE_SIZE).optional().describe(`Campaigns per page (max ${PPC_CAMPAIGNS_MAX_PAGE_SIZE}). Defaults to 20.`)
 };
 var listPpcCampaignsTool = {
   name: "list_ppc_campaigns",
   title: "List PPC Campaigns for a Seller",
   description: `Use this when the user asks about their Sponsored Products campaigns \u2014 which campaigns spend the most, which have a high ACOS, how placements (top of search, rest of search, product pages) perform, or which campaigns advertise a given product. Requires a \`sellerId\` + \`marketplace\` (use \`list_seller_profiles\` to discover them). Narrow to one product with \`asin\`, or to a variation family with \`parentAsin\` (not both). The reporting window defaults to the last 30 days and cannot exceed ${PPC_CAMPAIGNS_MAX_WINDOW_DAYS} days. Returns a paginated list where each campaign has campaignId, name, type, state, targetingType, bidStrategy, budget { type, amount, currencyCode }, window totals (impressions, clicks, ctr, cpc, cvr, spend, unitsSold, orders, sales, tosImpressionShare, acos, roas, tacos), asinCount and, unless includePlacements is false, \`placements\`; plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev). To find the biggest spenders, sort with \`sortBy: "spend", sortOrder: "DESC"\` rather than paging through every campaign. Each call counts toward API usage and is rate limited (about 60 requests/minute). For per-keyword ad data of a Rank Radar, use \`get_rank_radar_ppc_data\`.`,
-  inputSchema: inputSchema38,
+  inputSchema: inputSchema49,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     if (args.asin && args.parentAsin) {
@@ -1618,13 +1933,13 @@ var listPpcCampaignsTool = {
 };
 
 // src/tools/get-asin-inventory-distribution.ts
-import { z as z39 } from "zod";
-var inputSchema39 = {
-  sellerId: z39.string().min(1).describe(
+import { z as z49 } from "zod";
+var inputSchema50 = {
+  sellerId: z49.string().min(1).describe(
     "Amazon seller account ID as connected to DataDive. Get it from `list_seller_profiles`, or find it on the Connections page at https://2.datadive.tools."
   ),
-  marketplace: z39.enum(SUPPORTED_MARKETPLACES).describe('Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.'),
-  asin: z39.string().regex(/^[A-Z0-9]{10}$/, "ASIN must be 10 uppercase alphanumeric characters (e.g. B08XYZ1234).").describe(
+  marketplace: z49.enum(SUPPORTED_MARKETPLACES).describe('Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.'),
+  asin: z49.string().regex(/^[A-Z0-9]{10}$/, "ASIN must be 10 uppercase alphanumeric characters (e.g. B08XYZ1234).").describe(
     "Amazon Standard Identification Number (10 uppercase alphanumeric characters, e.g. B08XYZ1234)."
   )
 };
@@ -1632,7 +1947,7 @@ var getAsinInventoryDistributionTool = {
   name: "get_asin_inventory_distribution",
   title: "Get Inventory Metrics and Fulfillment-Center Distribution for an ASIN",
   description: "Use this when the user asks about an ASIN's inventory: stock levels, days of stock or when it will run out, low-inventory or aged-inventory risk, low-inventory-level (LILF) or long-term storage (LTSF) fees, or where their units sit across Amazon's fulfillment network. Requires the Amazon sellerId (from `list_seller_profiles` or the user's DataDive Connections page at https://2.datadive.tools), the marketplace code, and the ASIN. Returns the metrics the DataDive Inventory page shows \u2014 fulfillableStock, totalStock, reservedStock, inboundStock, researchingStock, unfulfillableStock, daysOfStock (with daysOfStockSource AMAZON or ESTIMATE), daysOfStock30, daysOfStock90, inLowInventoryState, estWeeklyLilf, estLtsfNextAssessment, ltsfLastMonthActual, agedUnits, oldestUnitAgeDays, with fees in `currency` \u2014 plus totalSellableUnits and a per-FC `distribution` array (fc, state, availableStock, availableStockPercentage). A metric is null, never 0, when Amazon has no data (e.g. merchant-fulfilled); metrics the user's plan does not include are null and listed in `lockedFields` (say they need a plan upgrade, do not report them as zero). `lastUpdatedAt` dates the stock and metrics; `distributionLastUpdatedAt` dates the distribution, which is usually up to 2 days behind. Either may be null when no successful refresh happened in the last 30 days.",
-  inputSchema: inputSchema39,
+  inputSchema: inputSchema50,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -1645,18 +1960,18 @@ var getAsinInventoryDistributionTool = {
 };
 
 // src/tools/alert-query.ts
-import { z as z40 } from "zod";
+import { z as z50 } from "zod";
 var alertsQueryInputSchema = {
-  sellerId: z40.string().min(1).max(50).optional().describe('Filter to a single connected Amazon seller account ID, e.g. "A1B2C3D4E5".'),
-  marketplace: z40.enum(SUPPORTED_MARKETPLACES).optional().describe('Filter to a single Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.'),
-  status: z40.enum(ALERT_STATUSES).optional().describe(
+  sellerId: z50.string().min(1).max(50).optional().describe('Filter to a single connected Amazon seller account ID, e.g. "A1B2C3D4E5".'),
+  marketplace: z50.enum(SUPPORTED_MARKETPLACES).optional().describe('Filter to a single Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.'),
+  status: z50.enum(ALERT_STATUSES).optional().describe(
     "Lifecycle filter. `active` (default) returns unresolved alerts, `resolved` returns resolved alerts, `all` returns both. Dismissed alerts are never returned."
   ),
-  updatedSince: z40.string().regex(ISO_8601, "updatedSince must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe(
+  updatedSince: z50.string().regex(ISO_8601, "updatedSince must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe(
     "ISO-8601 timestamp; return only alerts surfaced at or after this time (filters on `lastAlertedAt`). Use it to incrementally sync since your last poll. Defaults to the last 30 days when omitted."
   ),
-  currentPage: z40.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z40.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
+  currentPage: z50.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z50.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
 };
 
 // src/tools/list-indexing-issue-alerts.ts
@@ -1706,12 +2021,12 @@ var listBlindSpendAlertsTool = {
 };
 
 // src/tools/get-quota.ts
-var inputSchema40 = {};
+var inputSchema51 = {};
 var getQuotaTool = {
   name: "get_quota",
   title: "Get Quota Usage",
   description: "Use this when the user asks how much quota or how many tokens they have left, or before creating a Niche Dive or Rank Radar to check remaining headroom. Returns current quota usage and capacity for each billable feature \u2014 DIVED_ASINS (Dive tokens), RANK_RADAR_KEYWORDS (tracked keywords), PRODUCT_BRIEF_ASINS, and AI_COPYWRITER_PROMPTS \u2014 each with `used` and `capacity` (null when unlimited / not applicable), plus `nextRefreshDate` (ISO-8601 timestamp of the next quota reset, or null). Takes no arguments.",
-  inputSchema: inputSchema40,
+  inputSchema: inputSchema51,
   annotations: { readOnlyHint: true },
   handler: async (_args, ctx) => {
     return await httpGet({ config: ctx.config, toolName: "get_quota" }, "/v1/quota");
@@ -1719,20 +2034,20 @@ var getQuotaTool = {
 };
 
 // src/tools/list-usage.ts
-import { z as z41 } from "zod";
-var inputSchema41 = {
-  type: z41.enum(BILLABLE_FEATURE_TYPES).optional().describe("Filter to a single billable feature type. Omit to return all types."),
-  search: z41.string().min(1).optional().describe("Case-insensitive partial match on the user's name or email."),
-  startDate: z41.string().regex(ISO_8601, "startDate must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe("ISO-8601 date/timestamp; return only usage logs recorded on or after this time."),
-  endDate: z41.string().regex(ISO_8601, "endDate must be an ISO-8601 date or timestamp (e.g. 2026-05-31 or 2026-05-31T23:59:59Z)").optional().describe("ISO-8601 date/timestamp; return only usage logs recorded on or before this time."),
-  currentPage: z41.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z41.number().int().min(1).max(200).optional().describe("Items per page (max 200). Defaults to 50.")
+import { z as z51 } from "zod";
+var inputSchema52 = {
+  type: z51.enum(BILLABLE_FEATURE_TYPES).optional().describe("Filter to a single billable feature type. Omit to return all types."),
+  search: z51.string().min(1).optional().describe("Case-insensitive partial match on the user's name or email."),
+  startDate: z51.string().regex(ISO_8601, "startDate must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe("ISO-8601 date/timestamp; return only usage logs recorded on or after this time."),
+  endDate: z51.string().regex(ISO_8601, "endDate must be an ISO-8601 date or timestamp (e.g. 2026-05-31 or 2026-05-31T23:59:59Z)").optional().describe("ISO-8601 date/timestamp; return only usage logs recorded on or before this time."),
+  currentPage: z51.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z51.number().int().min(1).max(200).optional().describe("Items per page (max 200). Defaults to 50.")
 };
 var listUsageTool = {
   name: "list_usage",
   title: "List Billable Usage Logs",
   description: "Use this when the user asks who consumed tokens, how their quota was spent, or wants an audit of billable activity over a date range. Retrieves a paginated list of billable feature usage logs for the organization \u2014 each entry is a token-consumption event (a dive, rank-radar creation, AI copywriter prompt, etc.). Filter by `type` (billable feature), `search` (user name/email), and `startDate`/`endDate`. Each item includes name, email, qty (tokens consumed), type, action (specific operation), nicheId/nicheName, rankRadarId, and date, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev).",
-  inputSchema: inputSchema41,
+  inputSchema: inputSchema52,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -1753,6 +2068,11 @@ var listUsageTool = {
 // src/tools/index.ts
 var allTools = [
   listNichesTool,
+  listFastKeywordsTool,
+  getFastKeywordsTool,
+  getFastKeywordsKeywordsTool,
+  listSpacesTool,
+  listLabelsTool,
   getNicheKeywordsTool,
   listKeywordExclusionsTool,
   getNicheRootsTool,
@@ -1764,6 +2084,8 @@ var allTools = [
   getRankRadarPpcDataTool,
   listRankRadarTagsTool,
   createRankRadarTool,
+  runFastKeywordsTool,
+  refreshFastKeywordsTool,
   createNicheDiveTool,
   createNicheDiveFromCompetitorsListTool,
   rediveNicheTool,
@@ -1772,6 +2094,10 @@ var allTools = [
   removeNicheKeywordsTool,
   addKeywordExclusionsTool,
   removeKeywordExclusionsTool,
+  addNicheSpacesTool,
+  removeNicheSpacesTool,
+  addNicheLabelsTool,
+  removeNicheLabelsTool,
   addRankRadarSearchTermsTool,
   pauseRankRadarSearchTermsTool,
   resumeRankRadarSearchTermsTool,
@@ -1799,6 +2125,20 @@ var allTools = [
 
 // src/whats-new.ts
 var WHATS_NEW = [
+  {
+    version: "0.20.1",
+    released: "2026-10-23",
+    items: [
+      "Run Fast Keywords from just an ASIN and read the result (`run_fast_keywords`, `get_fast_keywords`, `get_fast_keywords_keywords`, `list_fast_keywords`, `refresh_fast_keywords`). A run costs 1 Dive token and asks you to confirm first. A finished run can be refreshed once every 24 hours, and `create_niche_dive` can now link a full niche dive to the Fast Keywords run it follows."
+    ]
+  },
+  {
+    version: "0.20.0",
+    released: "2026-10-23",
+    items: [
+      "See your Spaces and labels (`list_spaces`, `list_labels`), put a niche into them or take it out (`add_niche_spaces`, `remove_niche_spaces`, `add_niche_labels`, `remove_niche_labels`), and filter `list_niches` and `list_rank_radars` by Space and label. Free. Changing a niche's Spaces and labels is for the organization owner or a team admin; a Space you only have view rights on is refused."
+    ]
+  },
   {
     version: "0.17.1",
     released: "2026-10-13",