@lightsage/mcp 0.4.17 → 0.4.18

package/bin/mcp-server.js

@@ -26195,7 +26195,8 @@ var require_formats = __commonJS(function(exports, module) {
   var percentTwenties = /%20/g;
   var Format = {
     RFC1738: "RFC1738",
-    RFC3986: "RFC3986"
+    RFC3986: "RFC3986",
+    WHATWG: "WHATWG"
   };
   module.exports = {
     default: Format.RFC3986,
@@ -26205,10 +26206,14 @@ var require_formats = __commonJS(function(exports, module) {
       },
       RFC3986: function(value) {
         return String(value);
+      },
+      WHATWG: function(value) {
+        return replace.call(value, percentTwenties, "+");
       }
     },
     RFC1738: Format.RFC1738,
-    RFC3986: Format.RFC3986
+    RFC3986: Format.RFC3986,
+    WHATWG: Format.WHATWG
   };
 });
 
@@ -26512,7 +26517,7 @@ var require_utils2 = __commonJS(function(exports, module) {
       var arr = [];
       for (var i = 0;i < segment.length; ++i) {
         var c = segment.charCodeAt(i);
-        if (c === 45 || c === 46 || c === 95 || c === 126 || c >= 48 && c <= 57 || c >= 65 && c <= 90 || c >= 97 && c <= 122 || format === formats.RFC1738 && (c === 40 || c === 41)) {
+        if (c === 45 || c === 46 || c === 95 || c === 126 && format !== formats.WHATWG || c >= 48 && c <= 57 || c >= 65 && c <= 90 || c >= 97 && c <= 122 || format === formats.RFC1738 && (c === 40 || c === 41) || format === formats.WHATWG && c === 42) {
           arr[arr.length] = segment.charAt(i);
           continue;
         }
@@ -26528,9 +26533,14 @@ var require_utils2 = __commonJS(function(exports, module) {
           arr[arr.length] = hexTable[224 | c >> 12] + hexTable[128 | c >> 6 & 63] + hexTable[128 | c & 63];
           continue;
         }
-        i += 1;
-        c = 65536 + ((c & 1023) << 10 | segment.charCodeAt(i) & 1023);
-        arr[arr.length] = hexTable[240 | c >> 18] + hexTable[128 | c >> 12 & 63] + hexTable[128 | c >> 6 & 63] + hexTable[128 | c & 63];
+        var next = segment.charCodeAt(i + 1);
+        if (c <= 56319 && next >= 56320 && next <= 57343) {
+          i += 1;
+          c = 65536 + ((c & 1023) << 10 | next & 1023);
+          arr[arr.length] = hexTable[240 | c >> 18] + hexTable[128 | c >> 12 & 63] + hexTable[128 | c >> 6 & 63] + hexTable[128 | c & 63];
+        } else {
+          arr[arr.length] = "%EF%BF%BD";
+        }
       }
       out += arr.join("");
     }
@@ -26610,6 +26620,7 @@ var require_utils2 = __commonJS(function(exports, module) {
     markOverflow,
     maybeMap,
     merge,
+    setProperty,
     toCoercible
   };
 });
@@ -26734,7 +26745,7 @@ var require_stringify = __commonJS(function(exports, module) {
     var encodedPrefix = String(prefix);
     var adjustedPrefix = commaRoundTrip && isArray(obj) && obj.length === 1 ? encodedPrefix + "[]" : encodedPrefix;
     if (allowEmptyArrays && isArray(obj) && obj.length === 0 && Object.keys(obj).length === 0) {
-      return adjustedPrefix + "[]";
+      return formatter(encoder && !encodeValuesOnly ? encoder(adjustedPrefix, defaults.encoder, charset, "key", format) : adjustedPrefix) + "[]";
     }
     for (var j = 0;j < objKeys.length; ++j) {
       var key = objKeys[j];
@@ -26824,7 +26835,7 @@ var require_stringify = __commonJS(function(exports, module) {
       filter = options.filter;
       obj = filter("", obj);
     } else if (isArray(options.filter)) {
-      filter = options.filter;
+      filter = options.filter.slice();
       objKeys = filter;
     }
     var keys = [];
@@ -26850,7 +26861,7 @@ var require_stringify = __commonJS(function(exports, module) {
         continue;
       }
       var encodedKey = options.encodeDotInKeys ? String(key).replace(/\./g, "%2E") : String(key);
-      pushToArray(keys, stringify(value, encodedKey, generateArrayPrefix, commaRoundTrip, options.allowEmptyArrays, options.strictNullHandling, options.skipNulls, options.encodeDotInKeys, options.encode ? options.encoder : null, options.filter, options.sort, options.allowDots, options.serializeDate, options.format, options.formatter, options.encodeValuesOnly, options.charset, sideChannel, options.depth, 0));
+      pushToArray(keys, stringify(value, encodedKey, generateArrayPrefix, commaRoundTrip, options.allowEmptyArrays, options.strictNullHandling, options.skipNulls, options.encodeDotInKeys, options.encode ? options.encoder : null, filter, options.sort, options.allowDots, options.serializeDate, options.format, options.formatter, options.encodeValuesOnly, options.charset, sideChannel, options.depth, 0));
     }
     var joined = keys.join(options.delimiter);
     var prefix = options.addQueryPrefix === true ? "?" : "";
@@ -26906,9 +26917,9 @@ var require_parse = __commonJS(function(exports, module) {
             copies.set(value, copy);
             queue[queue.length] = { source: value, target: copy };
           }
-          target[keys[j]] = copies.get(value);
+          utils.setProperty(target, keys[j], copies.get(value));
         } else {
-          target[keys[j]] = value;
+          utils.setProperty(target, keys[j], value);
         }
       }
     }
@@ -26958,7 +26969,7 @@ var require_parse = __commonJS(function(exports, module) {
       }
       return val.split(",");
     }
-    if (options.throwOnLimitExceeded && currentArrayLength >= options.arrayLimit) {
+    if (options.throwOnLimitExceeded && currentArrayLength >= options.arrayLimit && currentArrayLength > 0) {
       throw new RangeError("Array limit exceeded. Only " + options.arrayLimit + " element" + (options.arrayLimit === 1 ? "" : "s") + " allowed in an array.");
     }
     return val;
@@ -27006,13 +27017,15 @@ var require_parse = __commonJS(function(exports, module) {
       } else {
         key = options.decoder(part.slice(0, pos), defaults.decoder, charset, "key");
         if (key !== null) {
-          val = utils.maybeMap(parseArrayValue(part.slice(pos + 1), options, isArray(obj[key]) ? obj[key].length : 0), function(encodedVal) {
+          val = utils.maybeMap(parseArrayValue(part.slice(pos + 1), options, isArray(obj[key]) && (options.duplicates === "combine" || isEmptyBracketKey) ? obj[key].length : 0), function(encodedVal) {
             return options.decoder(encodedVal, defaults.decoder, charset, "value");
           });
         }
       }
       if (val && options.interpretNumericEntities && charset === "iso-8859-1") {
-        val = interpretNumericEntities(String(val));
+        val = utils.maybeMap(val, function(value) {
+          return value ? interpretNumericEntities(String(value)) : value;
+        });
       }
       if (isEmptyBracketKey) {
         val = isArray(val) ? [val] : val;
@@ -27050,7 +27063,7 @@ var require_parse = __commonJS(function(exports, module) {
       } else {
         obj = options.plainObjects ? { __proto__: null } : {};
         var cleanRoot = root.charAt(0) === "[" && root.charAt(root.length - 1) === "]" ? root.slice(1, -1) : root;
-        var decodedRoot = options.decodeDotInKeys ? cleanRoot.replace(/%2E/g, ".") : cleanRoot;
+        var decodedRoot = options.decodeDotInKeys ? cleanRoot.replace(/%2E/gi, ".") : cleanRoot;
         var index = parseInt(decodedRoot, 10);
         var isValidArrayIndex = !isNaN(index) && root !== decodedRoot && String(index) === decodedRoot && index >= 0 && options.parseArrays;
         if (!options.parseArrays && decodedRoot === "") {
@@ -53715,9 +53728,9 @@ var init_config = __esm(() => {
   SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "0.4.17",
+    sdkVersion: "0.4.18",
     genVersion: "2.948.4",
-    userAgent: "speakeasy-sdk/mcp-typescript 0.4.17 2.948.4 1.0.0 @lightsage/mcp"
+    userAgent: "speakeasy-sdk/mcp-typescript 0.4.18 2.948.4 1.0.0 @lightsage/mcp"
   };
 });
 
@@ -55217,14 +55230,33 @@ var init_publicagentcountry = __esm(() => {
   });
 });
 
+// src/models/publicresolvedperiod.ts
+var PublicResolvedPeriod$zodSchema;
+var init_publicresolvedperiod = __esm(() => {
+  init_zod();
+  PublicResolvedPeriod$zodSchema = object({
+    days: int().describe("Days in the period, counting both ends."),
+    end_date: string2().describe("Last day of the period (UTC), inclusive."),
+    name: string2().nullable().optional().describe("The `period` requested, or null when the range came from `start_date` and `end_date`."),
+    partial: boolean2().describe("Whether the period includes today, so its last day is still in progress."),
+    previous_days: int().describe("Days in the previous period."),
+    previous_end_date: string2().describe("Last day of the previous period. While a calendar week, month, or quarter is in progress, the previous one is cut to the same number of days."),
+    previous_start_date: string2().describe("First day of the previous period it is compared with."),
+    start_date: string2().describe("First day of the period (UTC), inclusive."),
+    timezone: literal("UTC").default("UTC")
+  });
+});
+
 // src/models/publicagentanalyticscountrylistresponse.ts
 var PublicAgentAnalyticsCountryListResponse$zodSchema;
 var init_publicagentanalyticscountrylistresponse = __esm(() => {
   init_zod();
   init_publicagentcountry();
+  init_publicresolvedperiod();
   PublicAgentAnalyticsCountryListResponse$zodSchema = object({
     countries: array(PublicAgentCountry$zodSchema).optional().describe("Visits from coding agents and AI assistants per country, most visits first. The country is located from the IP address the request came from. For hosted assistants such as ChatGPT that is usually the provider's servers, not the person who asked; for coding agents it is usually the developer's machine."),
     end_date: string2().date(),
+    period: PublicResolvedPeriod$zodSchema.nullable().optional().describe("The resolved period and the previous period it is compared with."),
     site_id: string2(),
     start_date: string2().date()
   });
@@ -55239,6 +55271,7 @@ var init_v2agentanalyticscountrieslistop = __esm(() => {
   V2AgentAnalyticsCountriesListRequest$zodSchema = object({
     end_date: string2().date().describe("Inclusive range end in UTC; defaults to today.").optional(),
     limit: int().default(20),
+    period: string2().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
     site_id: string2(),
     start_date: string2().date().describe("Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.").optional()
   });
@@ -55298,6 +55331,7 @@ async function $do(client$, request, options) {
   const query$ = encodeFormQuery({
     end_date: payload$.end_date,
     limit: payload$.limit,
+    period: payload$.period,
     start_date: payload$.start_date
   });
   const headers$ = new Headers(compactMap({
@@ -55442,9 +55476,11 @@ var PublicAgentAnalyticsErrorPageListResponse$zodSchema;
 var init_publicagentanalyticserrorpagelistresponse = __esm(() => {
   init_zod();
   init_publicagenterrorpage();
+  init_publicresolvedperiod();
   PublicAgentAnalyticsErrorPageListResponse$zodSchema = object({
     end_date: string2().date(),
     pages: array(PublicAgentErrorPage$zodSchema).optional().describe("Most error requests first."),
+    period: PublicResolvedPeriod$zodSchema.nullable().optional().describe("The resolved period and the previous period it is compared with."),
     site_id: string2(),
     start_date: string2().date(),
     status_codes_tracked: boolean2().describe("Whether any request to the site in the date range reported a status code. Status codes come from server-side tracking such as a log drain or middleware; when this is false, an empty `pages` list does not mean there were no errors.")
@@ -55468,6 +55504,7 @@ var init_v2agentanalyticserrorpageslistop = __esm(() => {
   V2AgentAnalyticsErrorPagesListRequest$zodSchema = object({
     end_date: string2().date().describe("Inclusive range end in UTC; defaults to today.").optional(),
     limit: int().default(50),
+    period: string2().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
     site_id: string2(),
     start_date: string2().date().describe("Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.").optional(),
     status: int().describe("Only this status code, such as 404.").optional(),
@@ -55500,6 +55537,7 @@ async function $do2(client$, request, options) {
   const query$ = encodeFormQuery({
     end_date: payload$.end_date,
     limit: payload$.limit,
+    period: payload$.period,
     start_date: payload$.start_date,
     status: payload$.status,
     type: payload$.type
@@ -55622,10 +55660,12 @@ var PublicAgentAnalyticsPageListResponse$zodSchema;
 var init_publicagentanalyticspagelistresponse = __esm(() => {
   init_zod();
   init_publicagenttrafficpage();
+  init_publicresolvedperiod();
   PublicAgentAnalyticsPageListResponse$zodSchema = object({
     agent: string2().nullable().optional().describe("The coding agent the pages were filtered to, when `agent` was set. Its visits are in `coding` and `ai_total`; the other counts are 0."),
     end_date: string2().date(),
     pages: array(PublicAgentTrafficPage$zodSchema).optional(),
+    period: PublicResolvedPeriod$zodSchema.nullable().optional().describe("The resolved period and the previous period it is compared with."),
     site_id: string2(),
     start_date: string2().date()
   });
@@ -55659,6 +55699,7 @@ var init_v2agentanalyticspageslistop = __esm(() => {
     agent: string2().describe("Only pages this coding agent read, by the `name` the sources list gives it, such as `codex` or `cursor`.").optional(),
     end_date: string2().date().describe("Inclusive range end in UTC; defaults to today.").optional(),
     limit: int().default(20),
+    period: string2().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
     search: string2().describe("Only pages whose path contains this text.").optional(),
     site_id: string2(),
     sort: Sort$zodSchema.default("ai_total").describe("Traffic type to sort by, most visits first, or `last_seen` for the latest visit first."),
@@ -55693,6 +55734,7 @@ async function $do3(client$, request, options) {
     agent: payload$.agent,
     end_date: payload$.end_date,
     limit: payload$.limit,
+    period: payload$.period,
     search: payload$.search,
     sort: payload$.sort,
     start_date: payload$.start_date,
@@ -55918,8 +55960,10 @@ var PublicAgentAnalyticsSourceListResponse$zodSchema;
 var init_publicagentanalyticssourcelistresponse = __esm(() => {
   init_zod();
   init_publicagenttrafficsource();
+  init_publicresolvedperiod();
   PublicAgentAnalyticsSourceListResponse$zodSchema = object({
     end_date: string2().date(),
+    period: PublicResolvedPeriod$zodSchema.nullable().optional().describe("The resolved period and the previous period it is compared with."),
     site_id: string2(),
     sources: array(PublicAgentTrafficSource$zodSchema).optional().describe("Most visits first."),
     start_date: string2().date()
@@ -55934,6 +55978,7 @@ var init_v2agentanalyticssourceslistop = __esm(() => {
   init_publicagentanalyticssourcelistresponse();
   V2AgentAnalyticsSourcesListRequest$zodSchema = object({
     end_date: string2().date().describe("Inclusive range end in UTC; defaults to today.").optional(),
+    period: string2().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
     site_id: string2(),
     start_date: string2().date().describe("Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.").optional()
   });
@@ -55963,6 +56008,7 @@ async function $do5(client$, request, options) {
   const path$ = pathToFunc("/v2/agent-analytics/sites/{site_id}/sources")(pathParams$);
   const query$ = encodeFormQuery({
     end_date: payload$.end_date,
+    period: payload$.period,
     start_date: payload$.start_date
   });
   const headers$ = new Headers(compactMap({
@@ -56082,9 +56128,11 @@ var PublicAgentAnalyticsSummary$zodSchema;
 var init_publicagentanalyticssummary = __esm(() => {
   init_zod();
   init_publicagenttraffictotals();
+  init_publicresolvedperiod();
   PublicAgentAnalyticsSummary$zodSchema = object({
     current: PublicAgentTrafficTotals$zodSchema,
     end_date: string2().date(),
+    period: PublicResolvedPeriod$zodSchema.nullable().optional().describe("The resolved period and the previous period it is compared with."),
     previous: PublicAgentTrafficTotals$zodSchema,
     site_id: string2(),
     start_date: string2().date()
@@ -56099,6 +56147,7 @@ var init_v2agentanalyticssummaryretrieveop = __esm(() => {
   init_publicagentanalyticssummary();
   V2AgentAnalyticsSummaryRetrieveRequest$zodSchema = object({
     end_date: string2().date().describe("Inclusive range end in UTC; defaults to today.").optional(),
+    period: string2().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
     site_id: string2(),
     start_date: string2().date().describe("Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.").optional()
   });
@@ -56128,6 +56177,7 @@ async function $do6(client$, request, options) {
   const path$ = pathToFunc("/v2/agent-analytics/sites/{site_id}/summary")(pathParams$);
   const query$ = encodeFormQuery({
     end_date: payload$.end_date,
+    period: payload$.period,
     start_date: payload$.start_date
   });
   const headers$ = new Headers(compactMap({
@@ -56204,7 +56254,7 @@ var init_agentAnalyticsSummaryRetrieve2 = __esm(() => {
     name: "agent-analytics-summary-retrieve",
     description: `Retrieve Agent Analytics Summary
 
-Returns a site's visits by traffic type (coding agents, user-requested AI fetches, AI search, AI training, other bots, and people) for the date range and for the same number of days before it.`,
+Returns a site's visits by traffic type (coding agents, user-requested AI fetches, AI search, AI training, other bots, and people) for the date range and for the previous period (the same number of days before it, or the previous calendar week, month, or quarter for a named \`period\`).`,
     annotations: {
       title: "",
       destructiveHint: false,
@@ -57419,7 +57469,7 @@ var init_agentsList2 = __esm(() => {
     name: "agents-list",
     description: `List Agents
 
-Returns the harness-and-model combinations your plan can run, as single agent IDs for use in eval runs.`,
+Returns the coding-agent harness-and-model combinations your plan can run, as single agent IDs. Pass them as \`agent\` to \`POST /v2/prompts/runs\` to see how coding agents answer your prompts, with mentions and citations; to \`POST /v2/agent-preference/evals\` to see whether agents recommend your company over one competitor; or to \`POST /v2/evals\` and \`POST /v2/eval-runs\` to measure how well agents complete tasks with your product.`,
     annotations: {
       title: "",
       destructiveHint: false,
@@ -58954,7 +59004,9 @@ var init_evalsCreate2 = __esm(() => {
     name: "evals-create",
     description: `Create Eval
 
-Creates a reusable simulation definition with one or more task prompts and judges. Optional agents, persona, CLI installations, MCP servers, setup commands, cleanup commands, grounding policy, repeat count, and tags are saved with the eval. \`search_grounding\` supports \`disabled\`, \`enabled\`, and \`default\`; \`default\` preserves normal platform behavior. Creating the eval does not start a run and does not accept secret environment values.`,
+Creates a reusable simulation definition with one or more task prompts and judges. Optional agents, persona, CLI installations, MCP servers, setup commands, cleanup commands, grounding policy, repeat count, and tags are saved with the eval. \`search_grounding\` supports \`disabled\`, \`enabled\`, and \`default\`; \`default\` preserves normal platform behavior. Creating the eval does not start a run and does not accept secret environment values.
+
+Evals measure how well agents complete tasks with your product. To track how agents and answer engines answer research questions, including which brands they mention and cite, run prompts with \`POST /v2/prompts/runs\` instead.`,
     annotations: {
       title: "",
       destructiveHint: false,
@@ -59772,6 +59824,8 @@ var init_evalsRun2 = __esm(() => {
 
 Queues a durable eval job and returns immediately with a polling ID. Poll \`GET /v2/eval-runs/{run_id}\` until its status reaches a terminal value; once finished it also returns the results and analysis. Follow a run live with the monitor operation.
 
+Eval runs measure how well agents complete tasks with your product. To compare how coding agents and answer engines answer the same research question, with mentions and citations, use \`POST /v2/prompts/runs\` with \`agent\` instead.
+
 Send one of these flat request forms:
 
 - **Saved eval:** provide \`eval_id\`; optionally replace its prompts, persona, agents, CLIs, MCPs, setup commands, cleanup commands, or runs for this launch. A saved configuration can still provide repository, environment, skills, and legacy tool selections.
@@ -61460,7 +61514,7 @@ var init_createv2promptrequest = __esm(() => {
   init_zod();
   init_v2promptrunsettingsinput();
   CreateV2PromptRequest$zodSchema = object({
-    platform_ids: array(string2()).optional().describe("Answer-platform IDs from the prompt configuration. Omit to attach none."),
+    platform_ids: array(string2()).optional().describe("Platform IDs, as returned in `platforms` on `GET /v2/prompts`. Omit to attach none. To choose which coding-agent models a run uses, pass `agent` to `POST /v2/prompts/runs`."),
     run_settings: V2PromptRunSettingsInput$zodSchema.nullable().optional().describe("Run settings that apply to coding-agent runs of this prompt. Omitted fields keep their current or default values."),
     text: string2(),
     topic_id: string2().describe("Prompt topic ID from `GET /v2/prompts/topics`.")
@@ -62081,7 +62135,8 @@ var CreateV2PromptRunRequest$zodSchema;
 var init_createv2promptrunrequest = __esm(() => {
   init_zod();
   CreateV2PromptRunRequest$zodSchema = object({
-    force: boolean2().default(false).describe("Run even when a prompt already ran today on the configured platform and model."),
+    agent: array(string2()).nullable().optional().describe("Runnable agents from `GET /v2/agents`, each a coding-agent harness and model such as `claude-code:claude-opus-5-5`. Every selected prompt runs once on each agent, so you can compare how several coding tools and models answer the same question. When set, this run uses only these agents instead of the organization's configured targets, including answer engines. Omit it to use the configured targets. CLI clients expose repeatable `--agent`."),
+    force: boolean2().default(false).describe("Run even when a prompt already ran today on the same platform and model."),
     prompt_ids: array(string2()).nullable().optional().describe("Prompt IDs from `GET /v2/prompts`. Omit this field to run all active prompts.")
   });
 });
@@ -62172,11 +62227,15 @@ var init_promptsRun2 = __esm(() => {
     name: "prompts-run",
     description: `Run Prompts
 
-Queue saved prompts using the organization's configured targets.
+Queue saved prompts on answer engines and coding agents.
 
 Provide \`prompt_ids\` to run selected prompts, or omit them to run all active
-prompts. Saved prompt run settings apply to coding-agent targets. The
-response returns a run ID to poll with
+prompts. By default the run uses the organization's configured targets.
+Provide \`agent\` with IDs from \`GET /v2/agents\` to run the prompts on
+specific coding-agent harnesses and models instead, for example to compare
+how several coding tools answer the same developer question. Results
+include mentions and citations. Saved prompt run settings apply to
+coding-agent targets. The response returns a run ID to poll with
 \`GET /v2/prompts/runs/{run_id}/status\`.`,
     annotations: {
       title: "",
@@ -62199,6 +62258,190 @@ response returns a run ID to poll with
   };
 });
 
+// src/models/v2promptrunjobresponse.ts
+var V2PromptRunJobResponseStatusEnum$zodSchema, Status$zodSchema, V2PromptRunJobResponse$zodSchema;
+var init_v2promptrunjobresponse = __esm(() => {
+  init_zod();
+  init_publicevalrunprogress();
+  V2PromptRunJobResponseStatusEnum$zodSchema = _enum([
+    "pending",
+    "running",
+    "summarizing",
+    "completed",
+    "failed",
+    "cancelled",
+    "interrupted"
+  ]);
+  Status$zodSchema = union([
+    V2PromptRunJobResponseStatusEnum$zodSchema,
+    string2()
+  ]).describe("Terminal values: `completed`, `failed`, and `cancelled`. Recoverable interruptions are reported as `running` with stage `retrying`.");
+  V2PromptRunJobResponse$zodSchema = object({
+    completed_at: string2().nullable().optional().describe("Can be set while `status` is still `summarizing`; use `status` to detect completion."),
+    created_at: string2().nullable().optional(),
+    dispatch_id: string2().nullable().optional(),
+    error: string2().nullable().optional(),
+    estimated_cost: number2().nullable().optional().describe("The estimated credit cost for prompt jobs or estimated USD cost for API Performance jobs. Null when no estimate is available."),
+    eval_count: int().nullable().optional(),
+    id: string2().describe("Run ID to poll with `GET /v2/prompts/runs/{run_id}/status`."),
+    job_id: string2().describe("Parent job ID. It currently matches `id`."),
+    model_count: int().nullable().optional(),
+    progress: PublicEvalRunProgress$zodSchema.optional(),
+    source_type: literal("prompts").default("prompts").optional(),
+    stage: string2().nullable().optional().describe("Current lifecycle stage, including `retrying` while interrupted child jobs wait to be reclaimed."),
+    started_at: string2().nullable().optional(),
+    status: union([
+      V2PromptRunJobResponseStatusEnum$zodSchema,
+      string2()
+    ]).describe("Terminal values: `completed`, `failed`, and `cancelled`. Recoverable interruptions are reported as `running` with stage `retrying`."),
+    type: literal("prompts").default("prompts").optional()
+  });
+});
+
+// src/models/v2promptrunscancelop.ts
+var V2PromptRunsCancelRequest$zodSchema, V2PromptRunsCancelServiceUnavailableResponseBody$zodSchema, V2PromptRunsCancelConflictResponseBody$zodSchema, V2PromptRunsCancelNotFoundResponseBody$zodSchema, V2PromptRunsCancelBadRequestResponseBody$zodSchema, V2PromptRunsCancelResponse$zodSchema;
+var init_v2promptrunscancelop = __esm(() => {
+  init_zod();
+  init_httpvalidationerror();
+  init_v2promptrunjobresponse();
+  V2PromptRunsCancelRequest$zodSchema = object({
+    run_id: string2().describe("Run ID returned by `POST /v2/prompts/runs`, not a stored prompt result ID.")
+  });
+  V2PromptRunsCancelServiceUnavailableResponseBody$zodSchema = object({
+    detail: string2()
+  }).describe("Prompt run cancellation is temporarily unavailable.");
+  V2PromptRunsCancelConflictResponseBody$zodSchema = object({
+    detail: string2()
+  }).describe("The prompt run has already completed or failed.");
+  V2PromptRunsCancelNotFoundResponseBody$zodSchema = object({
+    detail: string2()
+  }).describe("Prompt run not found. Use the run ID returned when you started the prompt run.");
+  V2PromptRunsCancelBadRequestResponseBody$zodSchema = object({
+    detail: string2()
+  }).describe("The prompt run ID is not a valid UUID.");
+  V2PromptRunsCancelResponse$zodSchema = union([
+    V2PromptRunJobResponse$zodSchema,
+    lazy(() => V2PromptRunsCancelBadRequestResponseBody$zodSchema),
+    lazy(() => V2PromptRunsCancelNotFoundResponseBody$zodSchema),
+    lazy(() => V2PromptRunsCancelConflictResponseBody$zodSchema),
+    lazy(() => V2PromptRunsCancelServiceUnavailableResponseBody$zodSchema),
+    HTTPValidationError$zodSchema
+  ]);
+});
+
+// src/funcs/promptsRunCancel.ts
+function promptsRunCancel(client$, request, options) {
+  return new APIPromise($do47(client$, request, options));
+}
+async function $do47(client$, request, options) {
+  const parsed$ = safeParse4(request, (value$) => V2PromptRunsCancelRequest$zodSchema.parse(value$), "Input validation failed");
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+  const pathParams$ = {
+    run_id: encodeSimple("run_id", payload$.run_id, {
+      explode: false,
+      charEncoding: "percent"
+    })
+  };
+  const path$ = pathToFunc("/v2/prompts/runs/{run_id}/cancel")(pathParams$);
+  const headers$ = new Headers(compactMap({
+    Accept: "application/json"
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "v2_prompt_runs_cancel",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries || client$._options.retryConfig || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504"
+    ]
+  };
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs || -1
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    request: req$,
+    response: doResult.value
+  }];
+}
+var init_promptsRunCancel = __esm(() => {
+  init_encodings();
+  init_primitives();
+  init_schemas4();
+  init_security();
+  init_url();
+  init_v2promptrunscancelop();
+  init_async();
+});
+
+// src/mcp-server/tools/promptsRunCancel.ts
+var args38, tool$promptsRunCancel;
+var init_promptsRunCancel2 = __esm(() => {
+  init_promptsRunCancel();
+  init_v2promptrunscancelop();
+  init_tools();
+  args38 = {
+    request: V2PromptRunsCancelRequest$zodSchema
+  };
+  tool$promptsRunCancel = {
+    name: "prompts-run-cancel",
+    description: `Cancel a prompt run
+
+Marks an active prompt run as cancelled and prevents queued prompts from starting. Running coding-agent attempts are stopped asynchronously. Requests already sent to an answer platform cannot be recalled, so prompts already in progress may still finish and store their results, but the run stays cancelled. Prompts that never start use no usage-based credits. The response has the same shape as the status operation, with cancelled prompts counted in \`progress.cancelled\`. Repeating this request for an already-cancelled run is safe.`,
+    annotations: {
+      title: "",
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false,
+      readOnlyHint: false
+    },
+    args: args38,
+    tool: async (client, args, ctx) => {
+      const [result] = await promptsRunCancel(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true
+        };
+      }
+      return formatResult(result.value);
+    }
+  };
+});
+
 // src/models/v2promptrunplatform.ts
 var V2PromptRunPlatform$zodSchema;
 var init_v2promptrunplatform = __esm(() => {
@@ -62299,9 +62542,9 @@ var init_v2promptrunslistop = __esm(() => {
 
 // src/funcs/promptsRunsList.ts
 function promptsRunsList(client$, request, options) {
-  return new APIPromise($do47(client$, request, options));
+  return new APIPromise($do48(client$, request, options));
 }
-async function $do47(client$, request, options) {
+async function $do48(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2PromptRunsListRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -62379,12 +62622,12 @@ var init_promptsRunsList = __esm(() => {
 });
 
 // src/mcp-server/tools/promptsRunsList.ts
-var args38, tool$promptsRunsList;
+var args39, tool$promptsRunsList;
 var init_promptsRunsList2 = __esm(() => {
   init_promptsRunsList();
   init_v2promptrunslistop();
   init_tools();
-  args38 = {
+  args39 = {
     request: V2PromptRunsListRequest$zodSchema.optional()
   };
   tool$promptsRunsList = {
@@ -62399,7 +62642,7 @@ Returns stored prompt runs with limit-and-offset pagination, without exposing ra
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args38,
+    args: args39,
     tool: async (client, args, ctx) => {
       const [result] = await promptsRunsList(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -62512,9 +62755,9 @@ var init_v2promptrunsretrieveop = __esm(() => {
 
 // src/funcs/promptsRunsRetrieve.ts
 function promptsRunsRetrieve(client$, request, options) {
-  return new APIPromise($do48(client$, request, options));
+  return new APIPromise($do49(client$, request, options));
 }
-async function $do48(client$, request, options) {
+async function $do49(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2PromptRunsRetrieveRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -62589,12 +62832,12 @@ var init_promptsRunsRetrieve = __esm(() => {
 });
 
 // src/mcp-server/tools/promptsRunsRetrieve.ts
-var args39, tool$promptsRunsRetrieve;
+var args40, tool$promptsRunsRetrieve;
 var init_promptsRunsRetrieve2 = __esm(() => {
   init_promptsRunsRetrieve();
   init_v2promptrunsretrieveop();
   init_tools();
-  args39 = {
+  args40 = {
     request: V2PromptRunsRetrieveRequest$zodSchema
   };
   tool$promptsRunsRetrieve = {
@@ -62609,7 +62852,7 @@ Returns one stored prompt run, including mentions, citations, and any sanitized
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args39,
+    args: args40,
     tool: async (client, args, ctx) => {
       const [result] = await promptsRunsRetrieve(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -62623,46 +62866,6 @@ Returns one stored prompt run, including mentions, citations, and any sanitized
   };
 });
 
-// src/models/v2promptrunjobresponse.ts
-var V2PromptRunJobResponseStatusEnum$zodSchema, Status$zodSchema, V2PromptRunJobResponse$zodSchema;
-var init_v2promptrunjobresponse = __esm(() => {
-  init_zod();
-  init_publicevalrunprogress();
-  V2PromptRunJobResponseStatusEnum$zodSchema = _enum([
-    "pending",
-    "running",
-    "summarizing",
-    "completed",
-    "failed",
-    "cancelled",
-    "interrupted"
-  ]);
-  Status$zodSchema = union([
-    V2PromptRunJobResponseStatusEnum$zodSchema,
-    string2()
-  ]).describe("Terminal values: `completed`, `failed`, and `cancelled`. Recoverable interruptions are reported as `running` with stage `retrying`.");
-  V2PromptRunJobResponse$zodSchema = object({
-    completed_at: string2().nullable().optional().describe("Can be set while `status` is still `summarizing`; use `status` to detect completion."),
-    created_at: string2().nullable().optional(),
-    dispatch_id: string2().nullable().optional(),
-    error: string2().nullable().optional(),
-    estimated_cost: number2().nullable().optional().describe("The estimated credit cost for prompt jobs or estimated USD cost for API Performance jobs. Null when no estimate is available."),
-    eval_count: int().nullable().optional(),
-    id: string2().describe("Run ID to poll with `GET /v2/prompts/runs/{run_id}/status`."),
-    job_id: string2().describe("Parent job ID. It currently matches `id`."),
-    model_count: int().nullable().optional(),
-    progress: PublicEvalRunProgress$zodSchema.optional(),
-    source_type: literal("prompts").default("prompts").optional(),
-    stage: string2().nullable().optional().describe("Current lifecycle stage, including `retrying` while interrupted child jobs wait to be reclaimed."),
-    started_at: string2().nullable().optional(),
-    status: union([
-      V2PromptRunJobResponseStatusEnum$zodSchema,
-      string2()
-    ]).describe("Terminal values: `completed`, `failed`, and `cancelled`. Recoverable interruptions are reported as `running` with stage `retrying`."),
-    type: literal("prompts").default("prompts").optional()
-  });
-});
-
 // src/models/v2promptrunstatusretrieveop.ts
 var V2PromptRunStatusRetrieveRequest$zodSchema, V2PromptRunStatusRetrieveNotFoundResponseBody$zodSchema, V2PromptRunStatusRetrieveBadRequestResponseBody$zodSchema, V2PromptRunStatusRetrieveResponse$zodSchema;
 var init_v2promptrunstatusretrieveop = __esm(() => {
@@ -62688,9 +62891,9 @@ var init_v2promptrunstatusretrieveop = __esm(() => {
 
 // src/funcs/promptsRunStatus.ts
 function promptsRunStatus(client$, request, options) {
-  return new APIPromise($do49(client$, request, options));
+  return new APIPromise($do50(client$, request, options));
 }
-async function $do49(client$, request, options) {
+async function $do50(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2PromptRunStatusRetrieveRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -62765,12 +62968,12 @@ var init_promptsRunStatus = __esm(() => {
 });
 
 // src/mcp-server/tools/promptsRunStatus.ts
-var args40, tool$promptsRunStatus;
+var args41, tool$promptsRunStatus;
 var init_promptsRunStatus2 = __esm(() => {
   init_promptsRunStatus();
   init_v2promptrunstatusretrieveop();
   init_tools();
-  args40 = {
+  args41 = {
     request: V2PromptRunStatusRetrieveRequest$zodSchema
   };
   tool$promptsRunStatus = {
@@ -62788,7 +62991,7 @@ Individual stored results are available from \`GET /v2/prompts/runs\`.`,
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args40,
+    args: args41,
     tool: async (client, args, ctx) => {
       const [result] = await promptsRunStatus(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -62813,9 +63016,9 @@ var init_createprompttopicrequest = __esm(() => {
 
 // src/funcs/promptsTopicsCreate.ts
 function promptsTopicsCreate(client$, request, options) {
-  return new APIPromise($do50(client$, request, options));
+  return new APIPromise($do51(client$, request, options));
 }
-async function $do50(client$, request, options) {
+async function $do51(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => CreatePromptTopicRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -62885,12 +63088,12 @@ var init_promptsTopicsCreate = __esm(() => {
 });
 
 // src/mcp-server/tools/promptsTopicsCreate.ts
-var args41, tool$promptsTopicsCreate;
+var args42, tool$promptsTopicsCreate;
 var init_promptsTopicsCreate2 = __esm(() => {
   init_promptsTopicsCreate();
   init_createprompttopicrequest();
   init_tools();
-  args41 = {
+  args42 = {
     request: CreatePromptTopicRequest$zodSchema
   };
   tool$promptsTopicsCreate = {
@@ -62905,7 +63108,7 @@ Creates a prompt topic and returns the saved topic.`,
       openWorldHint: false,
       readOnlyHint: false
     },
-    args: args41,
+    args: args42,
     tool: async (client, args, ctx) => {
       const [result] = await promptsTopicsCreate(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -62937,9 +63140,9 @@ var init_v2prompttopicsdeleteop = __esm(() => {
 
 // src/funcs/promptsTopicsDelete.ts
 function promptsTopicsDelete(client$, request, options) {
-  return new APIPromise($do51(client$, request, options));
+  return new APIPromise($do52(client$, request, options));
 }
-async function $do51(client$, request, options) {
+async function $do52(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2PromptTopicsDeleteRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -63018,12 +63221,12 @@ var init_promptsTopicsDelete = __esm(() => {
 });
 
 // src/mcp-server/tools/promptsTopicsDelete.ts
-var args42, tool$promptsTopicsDelete;
+var args43, tool$promptsTopicsDelete;
 var init_promptsTopicsDelete2 = __esm(() => {
   init_promptsTopicsDelete();
   init_v2prompttopicsdeleteop();
   init_tools();
-  args42 = {
+  args43 = {
     request: V2PromptTopicsDeleteRequest$zodSchema
   };
   tool$promptsTopicsDelete = {
@@ -63038,7 +63241,7 @@ Archives a prompt topic. Set \`archive_prompts\` to archive remaining prompts; o
       openWorldHint: false,
       readOnlyHint: false
     },
-    args: args42,
+    args: args43,
     tool: async (client, args, ctx) => {
       const [result] = await promptsTopicsDelete(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -63054,9 +63257,9 @@ Archives a prompt topic. Set \`archive_prompts\` to archive remaining prompts; o
 
 // src/funcs/promptsTopicsList.ts
 function promptsTopicsList(client$, options) {
-  return new APIPromise($do52(client$, options));
+  return new APIPromise($do53(client$, options));
 }
-async function $do52(client$, options) {
+async function $do53(client$, options) {
   const path$ = pathToFunc("/v2/prompts/topics")();
   const headers$ = new Headers(compactMap({
     Accept: "application/json"
@@ -63172,9 +63375,9 @@ var init_v2prompttopicsupdateop = __esm(() => {
 
 // src/funcs/promptsTopicsUpdate.ts
 function promptsTopicsUpdate(client$, request, options) {
-  return new APIPromise($do53(client$, request, options));
+  return new APIPromise($do54(client$, request, options));
 }
-async function $do53(client$, request, options) {
+async function $do54(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2PromptTopicsUpdateRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -63250,12 +63453,12 @@ var init_promptsTopicsUpdate = __esm(() => {
 });
 
 // src/mcp-server/tools/promptsTopicsUpdate.ts
-var args43, tool$promptsTopicsUpdate;
+var args44, tool$promptsTopicsUpdate;
 var init_promptsTopicsUpdate2 = __esm(() => {
   init_promptsTopicsUpdate();
   init_v2prompttopicsupdateop();
   init_tools();
-  args43 = {
+  args44 = {
     request: V2PromptTopicsUpdateRequest$zodSchema
   };
   tool$promptsTopicsUpdate = {
@@ -63270,7 +63473,7 @@ Renames a prompt topic and returns the updated topic.`,
       openWorldHint: false,
       readOnlyHint: false
     },
-    args: args43,
+    args: args44,
     tool: async (client, args, ctx) => {
       const [result] = await promptsTopicsUpdate(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -63295,7 +63498,7 @@ var init_updatev2promptrequest = __esm(() => {
   ]);
   UpdateV2PromptRequest$zodSchema = object({
     is_branded: boolean2().optional().describe("Marks the prompt as branded or unbranded. Omit to keep the current value; changing `text` does not change it."),
-    platform_ids: array(string2()).nullable().optional().describe("Replacement list of answer-platform IDs."),
+    platform_ids: array(string2()).nullable().optional().describe("Replacement list of platform IDs, as returned in `platforms` on `GET /v2/prompts`."),
     run_settings: V2PromptRunSettingsInput$zodSchema.nullable().optional().describe("Run settings that apply to coding-agent runs of this prompt. Omitted fields keep their current or default values."),
     status: UpdateV2PromptRequestStatus$zodSchema.optional(),
     text: string2().optional(),
@@ -63322,9 +63525,9 @@ var init_v2promptsupdateop = __esm(() => {
 
 // src/funcs/promptsUpdate.ts
 function promptsUpdate(client$, request, options) {
-  return new APIPromise($do54(client$, request, options));
+  return new APIPromise($do55(client$, request, options));
 }
-async function $do54(client$, request, options) {
+async function $do55(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2PromptsUpdateRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -63400,12 +63603,12 @@ var init_promptsUpdate = __esm(() => {
 });
 
 // src/mcp-server/tools/promptsUpdate.ts
-var args44, tool$promptsUpdate;
+var args45, tool$promptsUpdate;
 var init_promptsUpdate2 = __esm(() => {
   init_promptsUpdate();
   init_v2promptsupdateop();
   init_tools();
-  args44 = {
+  args45 = {
     request: V2PromptsUpdateRequest$zodSchema
   };
   tool$promptsUpdate = {
@@ -63420,7 +63623,7 @@ Updates a prompt's text, topic, platforms, lifecycle status, or coding-agent run
       openWorldHint: false,
       readOnlyHint: false
     },
-    args: args44,
+    args: args45,
     tool: async (client, args, ctx) => {
       const [result] = await promptsUpdate(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -63463,9 +63666,9 @@ var init_createv2repositoryrequest = __esm(() => {
 
 // src/funcs/repositoriesCreate.ts
 function repositoriesCreate(client$, request, options) {
-  return new APIPromise($do55(client$, request, options));
+  return new APIPromise($do56(client$, request, options));
 }
-async function $do55(client$, request, options) {
+async function $do56(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => CreateV2RepositoryRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -63535,12 +63738,12 @@ var init_repositoriesCreate = __esm(() => {
 });
 
 // src/mcp-server/tools/repositoriesCreate.ts
-var args45, tool$repositoriesCreate;
+var args46, tool$repositoriesCreate;
 var init_repositoriesCreate2 = __esm(() => {
   init_repositoriesCreate();
   init_createv2repositoryrequest();
   init_tools();
-  args45 = {
+  args46 = {
     request: CreateV2RepositoryRequest$zodSchema
   };
   tool$repositoriesCreate = {
@@ -63555,7 +63758,7 @@ Adds a reusable Git repository workspace for eval configurations.`,
       openWorldHint: false,
       readOnlyHint: false
     },
-    args: args45,
+    args: args46,
     tool: async (client, args, ctx) => {
       const [result] = await repositoriesCreate(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -63621,9 +63824,9 @@ var init_v2repositoriesdeleteop = __esm(() => {
 
 // src/funcs/repositoriesDelete.ts
 function repositoriesDelete(client$, request, options) {
-  return new APIPromise($do56(client$, request, options));
+  return new APIPromise($do57(client$, request, options));
 }
-async function $do56(client$, request, options) {
+async function $do57(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2RepositoriesDeleteRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -63698,12 +63901,12 @@ var init_repositoriesDelete = __esm(() => {
 });
 
 // src/mcp-server/tools/repositoriesDelete.ts
-var args46, tool$repositoriesDelete;
+var args47, tool$repositoriesDelete;
 var init_repositoriesDelete2 = __esm(() => {
   init_repositoriesDelete();
   init_v2repositoriesdeleteop();
   init_tools();
-  args46 = {
+  args47 = {
     request: V2RepositoriesDeleteRequest$zodSchema
   };
   tool$repositoriesDelete = {
@@ -63718,7 +63921,7 @@ Permanently deletes a repository workspace and returns its last saved state.`,
       openWorldHint: false,
       readOnlyHint: false
     },
-    args: args46,
+    args: args47,
     tool: async (client, args, ctx) => {
       const [result] = await repositoriesDelete(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -63734,9 +63937,9 @@ Permanently deletes a repository workspace and returns its last saved state.`,
 
 // src/funcs/repositoriesList.ts
 function repositoriesList(client$, options) {
-  return new APIPromise($do57(client$, options));
+  return new APIPromise($do58(client$, options));
 }
-async function $do57(client$, options) {
+async function $do58(client$, options) {
   const path$ = pathToFunc("/v2/repositories")();
   const headers$ = new Headers(compactMap({
     Accept: "application/json"
@@ -63841,9 +64044,9 @@ var init_v2repositoriesretrieveop = __esm(() => {
 
 // src/funcs/repositoriesRetrieve.ts
 function repositoriesRetrieve(client$, request, options) {
-  return new APIPromise($do58(client$, request, options));
+  return new APIPromise($do59(client$, request, options));
 }
-async function $do58(client$, request, options) {
+async function $do59(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2RepositoriesRetrieveRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -63918,12 +64121,12 @@ var init_repositoriesRetrieve = __esm(() => {
 });
 
 // src/mcp-server/tools/repositoriesRetrieve.ts
-var args47, tool$repositoriesRetrieve;
+var args48, tool$repositoriesRetrieve;
 var init_repositoriesRetrieve2 = __esm(() => {
   init_repositoriesRetrieve();
   init_v2repositoriesretrieveop();
   init_tools();
-  args47 = {
+  args48 = {
     request: V2RepositoriesRetrieveRequest$zodSchema
   };
   tool$repositoriesRetrieve = {
@@ -63938,7 +64141,7 @@ Returns one reusable repository workspace.`,
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args47,
+    args: args48,
     tool: async (client, args, ctx) => {
       const [result] = await repositoriesRetrieve(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -63998,9 +64201,9 @@ var init_v2repositoriesupdateop = __esm(() => {
 
 // src/funcs/repositoriesUpdate.ts
 function repositoriesUpdate(client$, request, options) {
-  return new APIPromise($do59(client$, request, options));
+  return new APIPromise($do60(client$, request, options));
 }
-async function $do59(client$, request, options) {
+async function $do60(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2RepositoriesUpdateRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -64076,12 +64279,12 @@ var init_repositoriesUpdate = __esm(() => {
 });
 
 // src/mcp-server/tools/repositoriesUpdate.ts
-var args48, tool$repositoriesUpdate;
+var args49, tool$repositoriesUpdate;
 var init_repositoriesUpdate2 = __esm(() => {
   init_repositoriesUpdate();
   init_v2repositoriesupdateop();
   init_tools();
-  args48 = {
+  args49 = {
     request: V2RepositoriesUpdateRequest$zodSchema
   };
   tool$repositoriesUpdate = {
@@ -64096,7 +64299,7 @@ Updates a repository workspace; omitted fields remain unchanged.`,
       openWorldHint: false,
       readOnlyHint: false
     },
-    args: args48,
+    args: args49,
     tool: async (client, args, ctx) => {
       const [result] = await repositoriesUpdate(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -64112,9 +64315,9 @@ Updates a repository workspace; omitted fields remain unchanged.`,
 
 // src/funcs/siteAuditsList.ts
 function siteAuditsList(client$, options) {
-  return new APIPromise($do60(client$, options));
+  return new APIPromise($do61(client$, options));
 }
-async function $do60(client$, options) {
+async function $do61(client$, options) {
   const path$ = pathToFunc("/v2/site-audits")();
   const headers$ = new Headers(compactMap({
     Accept: "application/json"
@@ -64255,9 +64458,9 @@ var init_v2siteauditsretrieveop = __esm(() => {
 
 // src/funcs/siteAuditsRetrieve.ts
 function siteAuditsRetrieve(client$, request, options) {
-  return new APIPromise($do61(client$, request, options));
+  return new APIPromise($do62(client$, request, options));
 }
-async function $do61(client$, request, options) {
+async function $do62(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2SiteAuditsRetrieveRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -64332,12 +64535,12 @@ var init_siteAuditsRetrieve = __esm(() => {
 });
 
 // src/mcp-server/tools/siteAuditsRetrieve.ts
-var args49, tool$siteAuditsRetrieve;
+var args50, tool$siteAuditsRetrieve;
 var init_siteAuditsRetrieve2 = __esm(() => {
   init_siteAuditsRetrieve();
   init_v2siteauditsretrieveop();
   init_tools();
-  args49 = {
+  args50 = {
     request: V2SiteAuditsRetrieveRequest$zodSchema
   };
   tool$siteAuditsRetrieve = {
@@ -64352,7 +64555,7 @@ Returns one audited page with its score, priority, supporting evidence, and reco
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args49,
+    args: args50,
     tool: async (client, args, ctx) => {
       const [result] = await siteAuditsRetrieve(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -64368,9 +64571,9 @@ Returns one audited page with its score, priority, supporting evidence, and reco
 
 // src/funcs/skillsList.ts
 function skillsList(client$, options) {
-  return new APIPromise($do62(client$, options));
+  return new APIPromise($do63(client$, options));
 }
-async function $do62(client$, options) {
+async function $do63(client$, options) {
   const path$ = pathToFunc("/v2/skills")();
   const headers$ = new Headers(compactMap({
     Accept: "application/json"
@@ -64460,9 +64663,9 @@ Returns reusable skills available to workflows and eval configurations.`,
 
 // src/funcs/statusAuthStatusGet.ts
 function statusAuthStatusGet(client$, options) {
-  return new APIPromise($do63(client$, options));
+  return new APIPromise($do64(client$, options));
 }
-async function $do63(client$, options) {
+async function $do64(client$, options) {
   const path$ = pathToFunc("/v2/auth/status")();
   const headers$ = new Headers(compactMap({
     Accept: "application/json"
@@ -64552,9 +64755,9 @@ Validates the API key and returns its organization ID, API key ID, scopes, and a
 
 // src/funcs/statusGet.ts
 function statusGet(client$, options) {
-  return new APIPromise($do64(client$, options));
+  return new APIPromise($do65(client$, options));
 }
-async function $do64(client$, options) {
+async function $do65(client$, options) {
   const path$ = pathToFunc("/v2/status")();
   const headers$ = new Headers(compactMap({
     Accept: "application/json"
@@ -64683,9 +64886,9 @@ var init_createtaskrequest = __esm(() => {
 
 // src/funcs/tasksCreate.ts
 function tasksCreate(client$, request, options) {
-  return new APIPromise($do65(client$, request, options));
+  return new APIPromise($do66(client$, request, options));
 }
-async function $do65(client$, request, options) {
+async function $do66(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => CreateTaskRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -64755,12 +64958,12 @@ var init_tasksCreate = __esm(() => {
 });
 
 // src/mcp-server/tools/tasksCreate.ts
-var args50, tool$tasksCreate;
+var args51, tool$tasksCreate;
 var init_tasksCreate2 = __esm(() => {
   init_tasksCreate();
   init_createtaskrequest();
   init_tools();
-  args50 = {
+  args51 = {
     request: CreateTaskRequest$zodSchema
   };
   tool$tasksCreate = {
@@ -64775,7 +64978,7 @@ Adds a task to today's queue and returns it with its execution prompt. New tasks
       openWorldHint: false,
       readOnlyHint: false
     },
-    args: args50,
+    args: args51,
     tool: async (client, args, ctx) => {
       const [result] = await tasksCreate(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -64935,9 +65138,9 @@ var init_v2taskslistop = __esm(() => {
 
 // src/funcs/tasksList.ts
 function tasksList(client$, request, options) {
-  return new APIPromise($do66(client$, request, options));
+  return new APIPromise($do67(client$, request, options));
 }
-async function $do66(client$, request, options) {
+async function $do67(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2TasksListRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -65011,12 +65214,12 @@ var init_tasksList = __esm(() => {
 });
 
 // src/mcp-server/tools/tasksList.ts
-var args51, tool$tasksList;
+var args52, tool$tasksList;
 var init_tasksList2 = __esm(() => {
   init_tasksList();
   init_v2taskslistop();
   init_tools();
-  args51 = {
+  args52 = {
     request: V2TasksListRequest$zodSchema.optional()
   };
   tool$tasksList = {
@@ -65031,7 +65234,7 @@ Returns persisted daily tasks with execution instructions. Includes per-status c
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args51,
+    args: args52,
     tool: async (client, args, ctx) => {
       const [result] = await tasksList(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -65062,9 +65265,9 @@ var init_v2tasksretrieveop = __esm(() => {
 
 // src/funcs/tasksRetrieve.ts
 function tasksRetrieve(client$, request, options) {
-  return new APIPromise($do67(client$, request, options));
+  return new APIPromise($do68(client$, request, options));
 }
-async function $do67(client$, request, options) {
+async function $do68(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2TasksRetrieveRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -65139,12 +65342,12 @@ var init_tasksRetrieve = __esm(() => {
 });
 
 // src/mcp-server/tools/tasksRetrieve.ts
-var args52, tool$tasksRetrieve;
+var args53, tool$tasksRetrieve;
 var init_tasksRetrieve2 = __esm(() => {
   init_tasksRetrieve();
   init_v2tasksretrieveop();
   init_tools();
-  args52 = {
+  args53 = {
     request: V2TasksRetrieveRequest$zodSchema
   };
   tool$tasksRetrieve = {
@@ -65159,7 +65362,7 @@ Returns one persisted task and its execution prompt.`,
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args52,
+    args: args53,
     tool: async (client, args, ctx) => {
       const [result] = await tasksRetrieve(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -65222,9 +65425,9 @@ var init_v2tasksupdateop = __esm(() => {
 
 // src/funcs/tasksUpdate.ts
 function tasksUpdate(client$, request, options) {
-  return new APIPromise($do68(client$, request, options));
+  return new APIPromise($do69(client$, request, options));
 }
-async function $do68(client$, request, options) {
+async function $do69(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2TasksUpdateRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -65300,12 +65503,12 @@ var init_tasksUpdate = __esm(() => {
 });
 
 // src/mcp-server/tools/tasksUpdate.ts
-var args53, tool$tasksUpdate;
+var args54, tool$tasksUpdate;
 var init_tasksUpdate2 = __esm(() => {
   init_tasksUpdate();
   init_v2tasksupdateop();
   init_tools();
-  args53 = {
+  args54 = {
     request: V2TasksUpdateRequest$zodSchema
   };
   tool$tasksUpdate = {
@@ -65320,7 +65523,7 @@ Updates a task's status, priority, assignee, or action type. Only sent fields ar
       openWorldHint: false,
       readOnlyHint: false
     },
-    args: args53,
+    args: args54,
     tool: async (client, args, ctx) => {
       const [result] = await tasksUpdate(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -65361,24 +65564,127 @@ var init_publiccitedurldaterange = __esm(() => {
   });
 });
 
+// src/models/publiccoverageday.ts
+var Period$zodSchema, PublicCoverageDayStatus$zodSchema, PublicCoverageDay$zodSchema;
+var init_publiccoverageday = __esm(() => {
+  init_zod();
+  Period$zodSchema = _enum([
+    "current",
+    "previous"
+  ]);
+  PublicCoverageDayStatus$zodSchema = _enum([
+    "ok",
+    "short",
+    "missing",
+    "in_progress",
+    "not_expected"
+  ]).describe("`missing`: no runs on a day that expected some. `short`: under half the expected runs. `in_progress`: today, before its runs finished.");
+  PublicCoverageDay$zodSchema = object({
+    date: string2(),
+    expected_runs: int().describe("Median daily runs over the 7 days before; 0 when no daily runs are expected."),
+    period: Period$zodSchema,
+    runs: int().describe("Successful prompt runs of active prompts that day."),
+    status: PublicCoverageDayStatus$zodSchema.describe("`missing`: no runs on a day that expected some. `short`: under half the expected runs. `in_progress`: today, before its runs finished.")
+  });
+});
+
+// src/models/publicperiodcoverage.ts
+var PublicPeriodCoverage$zodSchema;
+var init_publicperiodcoverage = __esm(() => {
+  init_zod();
+  PublicPeriodCoverage$zodSchema = object({
+    complete_days: int().describe("Days in the period other than today in progress."),
+    end_date: string2(),
+    expected_runs: int(),
+    missing_days: array(string2()).optional(),
+    runs: int(),
+    runs_per_day: number2().nullable().optional().describe("Runs per complete day."),
+    short_days: array(string2()).optional(),
+    start_date: string2()
+  });
+});
+
+// src/models/publiccoverage.ts
+var PublicCoverage$zodSchema;
+var init_publiccoverage = __esm(() => {
+  init_zod();
+  init_publiccoverageday();
+  init_publicperiodcoverage();
+  PublicCoverage$zodSchema = object({
+    comparable: boolean2().describe("Whether totals can be compared between the two periods. False when either period has a missing or short day or runs per day differ by more than 20%; compare per-run rates instead."),
+    current: PublicPeriodCoverage$zodSchema,
+    days: array(PublicCoverageDay$zodSchema).optional(),
+    notes: array(string2()).optional().describe("Why the periods are not comparable, in plain sentences."),
+    previous: PublicPeriodCoverage$zodSchema
+  });
+});
+
+// src/models/publicperiodrates.ts
+var PublicPeriodRates$zodSchema;
+var init_publicperiodrates = __esm(() => {
+  init_zod();
+  PublicPeriodRates$zodSchema = object({
+    brand_mention_runs: int().describe("Runs that mention the primary company."),
+    mention_rate: number2().nullable().optional().describe("Share of runs that mention the primary company, from 0 to 1."),
+    owned_citations: int().describe("Citations of the organization's own domains."),
+    owned_citations_per_run: number2().nullable().optional(),
+    runs: int()
+  });
+});
+
+// src/models/publicratechanges.ts
+var PublicRateChanges$zodSchema;
+var init_publicratechanges = __esm(() => {
+  init_zod();
+  PublicRateChanges$zodSchema = object({
+    mention_rate: number2().nullable().optional().describe("Relative change from the previous period."),
+    owned_citations: number2().nullable().optional().describe("Relative change from the previous period; 0.25 means 25% higher."),
+    owned_citations_per_run: number2().nullable().optional().describe("Relative change from the previous period.")
+  });
+});
+
+// src/models/publicrates.ts
+var PublicRatesHeadlineMetric$zodSchema, PublicRates$zodSchema;
+var init_publicrates = __esm(() => {
+  init_zod();
+  init_publicperiodrates();
+  init_publicratechanges();
+  PublicRatesHeadlineMetric$zodSchema = _enum([
+    "owned_citations",
+    "owned_citations_per_run"
+  ]).describe("The number to lead with: owned citations when the periods are comparable, otherwise owned citations per run.");
+  PublicRates$zodSchema = object({
+    change: PublicRateChanges$zodSchema,
+    current: PublicPeriodRates$zodSchema,
+    headline_metric: PublicRatesHeadlineMetric$zodSchema.describe("The number to lead with: owned citations when the periods are comparable, otherwise owned citations per run."),
+    previous: PublicPeriodRates$zodSchema
+  });
+});
+
 // src/models/publictopcitedurlsresponse.ts
-var SourceType$zodSchema, PublicTopCitedUrlsResponse$zodSchema;
+var PublicTopCitedUrlsResponseSourceType$zodSchema, PublicTopCitedUrlsResponse$zodSchema;
 var init_publictopcitedurlsresponse = __esm(() => {
   init_zod();
   init_publiccitedurl();
   init_publiccitedurldaterange();
-  SourceType$zodSchema = _enum([
+  init_publiccoverage();
+  init_publicrates();
+  init_publicresolvedperiod();
+  PublicTopCitedUrlsResponseSourceType$zodSchema = _enum([
     "all",
     "owned",
     "external"
   ]).describe("Whether the results include all, owned, or external URLs.");
   PublicTopCitedUrlsResponse$zodSchema = object({
     count: int().describe("Number of URL rows returned."),
+    coverage: PublicCoverage$zodSchema.nullable().optional().describe("Runs per day against expected runs for both periods. Check `comparable` before comparing totals."),
     data: array(PublicCitedUrl$zodSchema).optional().describe("Cited URLs ranked by citation count in descending order."),
     date_range: PublicCitedUrlDateRange$zodSchema,
     has_data: boolean2().describe("Whether any citations matched the selected filters."),
+    period: PublicResolvedPeriod$zodSchema.nullable().optional().describe("The resolved period and the previous period it is compared with."),
     platform: string2().nullable().optional().describe("Platform selector applied to the results, or null for all platforms."),
-    source_type: SourceType$zodSchema.describe("Whether the results include all, owned, or external URLs.")
+    rates: PublicRates$zodSchema.nullable().optional().describe("Runs, owned citations, and per-run rates for both periods. Lead with `headline_metric`."),
+    source_type: PublicTopCitedUrlsResponseSourceType$zodSchema.describe("Whether the results include all, owned, or external URLs.")
   });
 });
 
@@ -65396,6 +65702,7 @@ var init_v2visibilitycitationslistop = __esm(() => {
   V2VisibilityCitationsListRequest$zodSchema = object({
     end_date: string2().date().describe("Inclusive range end; defaults to today.").optional(),
     limit: int().default(20),
+    period: string2().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
     platform: string2().describe("Optional answer-platform ID, name, or slug.").optional(),
     source_type: V2VisibilityCitationsListSourceType$zodSchema.default("all"),
     start_date: string2().date().describe("Inclusive range start.").optional()
@@ -65408,9 +65715,9 @@ var init_v2visibilitycitationslistop = __esm(() => {
 
 // src/funcs/visibilityCitationsList.ts
 function visibilityCitationsList(client$, request, options) {
-  return new APIPromise($do69(client$, request, options));
+  return new APIPromise($do70(client$, request, options));
 }
-async function $do69(client$, request, options) {
+async function $do70(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2VisibilityCitationsListRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -65421,6 +65728,7 @@ async function $do69(client$, request, options) {
   const query$ = encodeFormQuery({
     end_date: payload$?.end_date,
     limit: payload$?.limit,
+    period: payload$?.period,
     platform: payload$?.platform,
     source_type: payload$?.source_type,
     start_date: payload$?.start_date
@@ -65487,19 +65795,19 @@ var init_visibilityCitationsList = __esm(() => {
 });
 
 // src/mcp-server/tools/visibilityCitationsList.ts
-var args54, tool$visibilityCitationsList;
+var args55, tool$visibilityCitationsList;
 var init_visibilityCitationsList2 = __esm(() => {
   init_visibilityCitationsList();
   init_v2visibilitycitationslistop();
   init_tools();
-  args54 = {
+  args55 = {
     request: V2VisibilityCitationsListRequest$zodSchema.optional()
   };
   tool$visibilityCitationsList = {
     name: "visibility-citations-list",
     description: `List Top Cited Urls
 
-Returns URL-level citation counts ranked from most to least cited. Results can be filtered by platform and to owned or external sources.`,
+Returns URL-level citation counts ranked from most to least cited. Results can be filtered by platform and to owned or external sources. For totals by URL prefix, domain, or day compared with the previous period, use the citations summary.`,
     annotations: {
       title: "",
       destructiveHint: false,
@@ -65507,7 +65815,7 @@ Returns URL-level citation counts ranked from most to least cited. Results can b
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args54,
+    args: args55,
     tool: async (client, args, ctx) => {
       const [result] = await visibilityCitationsList(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -65521,6 +65829,233 @@ Returns URL-level citation counts ranked from most to least cited. Results can b
   };
 });
 
+// src/models/publiccitationsummarygroup.ts
+var PublicCitationSummaryGroup$zodSchema;
+var init_publiccitationsummarygroup = __esm(() => {
+  init_zod();
+  PublicCitationSummaryGroup$zodSchema = object({
+    change: number2().nullable().optional().describe("Relative change in citations; 0.25 means 25% higher."),
+    citation_count: int().describe("Citations in the period."),
+    citations_per_run: number2().nullable().optional(),
+    is_company_link: boolean2().describe("Whether the group includes an owned company domain."),
+    key: string2().describe("The group: a URL prefix (domain and first path segment, such as `example.com/blog`), a normalized URL, a domain, or a day (YYYY-MM-DD)."),
+    per_run_change: number2().nullable().optional().describe("Relative change in citations per run."),
+    previous_citation_count: int().describe("Citations in the previous period. For `day` groups, the matching day of the previous period."),
+    previous_citations_per_run: number2().nullable().optional(),
+    prompt_count: int().describe("Distinct active prompts that cited the group in the period."),
+    title: string2().nullable().optional().describe("Page title, for `url` groups."),
+    url: string2().nullable().optional().describe("Most frequently observed variant of the URL, for `url` groups."),
+    url_count: int().describe("Distinct URLs in the group in the period.")
+  });
+});
+
+// src/models/publiccitationsummarytotals.ts
+var PublicCitationSummaryTotals$zodSchema;
+var init_publiccitationsummarytotals = __esm(() => {
+  init_zod();
+  PublicCitationSummaryTotals$zodSchema = object({
+    change: number2().nullable().optional().describe("Relative change in citations; 0.25 means 25% higher."),
+    citation_count: int(),
+    citations_per_run: number2().nullable().optional(),
+    per_run_change: number2().nullable().optional().describe("Relative change in citations per run."),
+    previous_citation_count: int(),
+    previous_citations_per_run: number2().nullable().optional(),
+    previous_run_count: int(),
+    run_count: int().describe("Successful runs of active prompts in the period, after the platform filter."),
+    url_count: int().describe("Distinct cited URLs in the period.")
+  });
+});
+
+// src/models/publiccitationsummaryresponse.ts
+var GroupBy$zodSchema, PublicCitationSummaryResponseSourceType$zodSchema, PublicCitationSummaryResponseHeadlineMetric$zodSchema, PublicCitationSummaryResponse$zodSchema;
+var init_publiccitationsummaryresponse = __esm(() => {
+  init_zod();
+  init_publiccitationsummarygroup();
+  init_publiccitationsummarytotals();
+  init_publiccoverage();
+  init_publicresolvedperiod();
+  GroupBy$zodSchema = _enum([
+    "url_prefix",
+    "url",
+    "domain",
+    "day"
+  ]);
+  PublicCitationSummaryResponseSourceType$zodSchema = _enum([
+    "all",
+    "owned",
+    "external"
+  ]);
+  PublicCitationSummaryResponseHeadlineMetric$zodSchema = _enum([
+    "citation_count",
+    "citations_per_run"
+  ]).describe("The number to lead with: citation counts when the periods are comparable, otherwise citations per run.");
+  PublicCitationSummaryResponse$zodSchema = object({
+    count: int().describe("Groups returned."),
+    coverage: PublicCoverage$zodSchema,
+    group_by: GroupBy$zodSchema,
+    group_count: int().describe("Groups matching the filters, before `limit`."),
+    groups: array(PublicCitationSummaryGroup$zodSchema).optional().describe("Groups by citation count, most first; `day` groups are in date order."),
+    has_data: boolean2(),
+    headline_metric: PublicCitationSummaryResponseHeadlineMetric$zodSchema.describe("The number to lead with: citation counts when the periods are comparable, otherwise citations per run."),
+    period: PublicResolvedPeriod$zodSchema,
+    platform: string2().nullable().optional(),
+    source_type: PublicCitationSummaryResponseSourceType$zodSchema,
+    totals: PublicCitationSummaryTotals$zodSchema,
+    url_prefix: string2().nullable().optional().describe("URL prefix filter applied, if any.")
+  });
+});
+
+// src/models/v2visibilitycitationssummaryretrieveop.ts
+var V2VisibilityCitationsSummaryRetrieveGroupBy$zodSchema, V2VisibilityCitationsSummaryRetrieveSourceType$zodSchema, V2VisibilityCitationsSummaryRetrieveRequest$zodSchema, V2VisibilityCitationsSummaryRetrieveResponse$zodSchema;
+var init_v2visibilitycitationssummaryretrieveop = __esm(() => {
+  init_zod();
+  init_httpvalidationerror();
+  init_publiccitationsummaryresponse();
+  V2VisibilityCitationsSummaryRetrieveGroupBy$zodSchema = _enum([
+    "url_prefix",
+    "url",
+    "domain",
+    "day"
+  ]).describe("How to group citations.");
+  V2VisibilityCitationsSummaryRetrieveSourceType$zodSchema = _enum([
+    "all",
+    "owned",
+    "external"
+  ]).describe("All citations, only owned company domains, or only external ones.");
+  V2VisibilityCitationsSummaryRetrieveRequest$zodSchema = object({
+    end_date: string2().date().describe("Inclusive range end; defaults to today.").optional(),
+    group_by: V2VisibilityCitationsSummaryRetrieveGroupBy$zodSchema.default("url_prefix").describe("How to group citations."),
+    limit: int().default(20).describe("Groups to return; `day` groups return every day."),
+    period: string2().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
+    platform: string2().describe("Optional answer-platform ID, name, or slug.").optional(),
+    source_type: V2VisibilityCitationsSummaryRetrieveSourceType$zodSchema.default("all").describe("All citations, only owned company domains, or only external ones."),
+    start_date: string2().date().describe("Inclusive range start; defaults to 30 days before the end date. The range may span at most 90 days.").optional(),
+    url_prefix: string2().describe("Only citations under this URL prefix, such as `https://example.com/blog/`. Scheme and `www.` are ignored.").optional()
+  });
+  V2VisibilityCitationsSummaryRetrieveResponse$zodSchema = union([
+    PublicCitationSummaryResponse$zodSchema,
+    HTTPValidationError$zodSchema
+  ]);
+});
+
+// src/funcs/visibilityCitationsSummaryRetrieve.ts
+function visibilityCitationsSummaryRetrieve(client$, request, options) {
+  return new APIPromise($do71(client$, request, options));
+}
+async function $do71(client$, request, options) {
+  const parsed$ = safeParse4(request, (value$) => V2VisibilityCitationsSummaryRetrieveRequest$zodSchema.optional().parse(value$), "Input validation failed");
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+  const path$ = pathToFunc("/v2/visibility/citations/summary")();
+  const query$ = encodeFormQuery({
+    end_date: payload$?.end_date,
+    group_by: payload$?.group_by,
+    limit: payload$?.limit,
+    period: payload$?.period,
+    platform: payload$?.platform,
+    source_type: payload$?.source_type,
+    start_date: payload$?.start_date,
+    url_prefix: payload$?.url_prefix
+  });
+  const headers$ = new Headers(compactMap({
+    Accept: "application/json"
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "v2_visibility_citations_summary_retrieve",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries || client$._options.retryConfig || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504"
+    ]
+  };
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    query: query$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs || -1
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    request: req$,
+    response: doResult.value
+  }];
+}
+var init_visibilityCitationsSummaryRetrieve = __esm(() => {
+  init_encodings();
+  init_primitives();
+  init_schemas4();
+  init_security();
+  init_url();
+  init_v2visibilitycitationssummaryretrieveop();
+  init_async();
+});
+
+// src/mcp-server/tools/visibilityCitationsSummaryRetrieve.ts
+var args56, tool$visibilityCitationsSummaryRetrieve;
+var init_visibilityCitationsSummaryRetrieve2 = __esm(() => {
+  init_visibilityCitationsSummaryRetrieve();
+  init_v2visibilitycitationssummaryretrieveop();
+  init_tools();
+  args56 = {
+    request: V2VisibilityCitationsSummaryRetrieveRequest$zodSchema.optional()
+  };
+  tool$visibilityCitationsSummaryRetrieve = {
+    name: "visibility-citations-summary-retrieve",
+    description: `Retrieve Citation Summary
+
+Returns citation totals grouped by URL prefix (domain and first path segment, such as \`example.com/blog\`), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with \`url_prefix\`, for example \`https://example.com/blog/\`. Aggregated in one call; use it instead of paging the citations list.`,
+    annotations: {
+      title: "",
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false,
+      readOnlyHint: true
+    },
+    args: args56,
+    tool: async (client, args, ctx) => {
+      const [result] = await visibilityCitationsSummaryRetrieve(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true
+        };
+      }
+      return formatResult(result.value);
+    }
+  };
+});
+
 // src/models/publiccompany.ts
 var PublicCompany$zodSchema;
 var init_publiccompany = __esm(() => {
@@ -65533,19 +66068,40 @@ var init_publiccompany = __esm(() => {
   });
 });
 
+// src/models/publicpreviousvisibility.ts
+var PublicPreviousVisibility$zodSchema;
+var init_publicpreviousvisibility = __esm(() => {
+  init_zod();
+  PublicPreviousVisibility$zodSchema = object({
+    average_position: number2().nullable().optional(),
+    has_data: boolean2().default(false),
+    recommendation_score: number2().nullable().optional().describe("Mean recommendation strength across successful prompt runs, from 0 to 1. Each run contributes the company's recommendation strength (0 to 1) when it is mentioned and 0 when it is not. Failed provider runs are excluded. `null` unless the organization turns on Recommendation Score under Settings › Navigation."),
+    share_of_voice: number2().nullable().optional().describe("The company's share of all mentions of tracked companies (your company plus configured competitors) in the same prompt runs, from 0 to 1; tracked companies add up to 1. Each company counts once per run. `null` for companies you do not track. Not the `share_of_voice` field removed in October 2026, which held the mention rate now returned as `visibility_score`."),
+    visibility_score: number2().nullable().optional().describe("Fraction of successful prompt runs that mention the company, from 0 to 1; for example, 0.25 means one in four runs. Failed provider runs are excluded.")
+  });
+});
+
 // src/models/publiccurrentvisibilityresponse.ts
 var PublicCurrentVisibilityResponse$zodSchema;
 var init_publiccurrentvisibilityresponse = __esm(() => {
   init_zod();
   init_publiccompany();
+  init_publiccoverage();
+  init_publicpreviousvisibility();
+  init_publicrates();
+  init_publicresolvedperiod();
   PublicCurrentVisibilityResponse$zodSchema = object({
     active_prompts_only: boolean2().default(true),
     average_position: number2().nullable().optional().describe("Mean mention position in AI responses; 1 is first and lower is better."),
     average_position_rank: int().nullable().optional(),
     company: PublicCompany$zodSchema,
+    coverage: PublicCoverage$zodSchema.nullable().optional().describe("Runs per day against expected runs for both periods. Check `comparable` before comparing totals."),
     date: string2().nullable().optional().describe("Latest prompt-run date in the range."),
     end_date: string2(),
     has_data: boolean2(),
+    period: PublicResolvedPeriod$zodSchema.nullable().optional().describe("The resolved period and the previous period it is compared with."),
+    previous: PublicPreviousVisibility$zodSchema.nullable().optional().describe("The same metrics for the previous period."),
+    rates: PublicRates$zodSchema.nullable().optional().describe("Runs, owned citations, and per-run rates for both periods. Lead with `headline_metric`."),
     recommendation_score: number2().nullable().optional().describe("Mean recommendation strength across successful prompt runs, from 0 to 1. Each run contributes the company's recommendation strength (0 to 1) when it is mentioned and 0 when it is not. Failed provider runs are excluded. `null` unless the organization turns on Recommendation Score under Settings › Navigation."),
     recommendation_score_rank: int().nullable().optional(),
     share_of_voice: number2().nullable().optional().describe("The company's share of all mentions of tracked companies (your company plus configured competitors) in the same prompt runs, from 0 to 1; tracked companies add up to 1. Each company counts once per run. `null` for companies you do not track. Not the `share_of_voice` field removed in October 2026, which held the mention rate now returned as `visibility_score`."),
@@ -65564,6 +66120,7 @@ var init_v2visibilitycurrentretrieveop = __esm(() => {
   init_publiccurrentvisibilityresponse();
   V2VisibilityCurrentRetrieveRequest$zodSchema = object({
     end_date: string2().date().describe("Inclusive range end; defaults to today.").optional(),
+    period: string2().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
     start_date: string2().date().describe("Inclusive range start; defaults to 30 days before the end date. The range may span at most 90 days.").optional()
   });
   V2VisibilityCurrentRetrieveResponse$zodSchema = union([
@@ -65574,9 +66131,9 @@ var init_v2visibilitycurrentretrieveop = __esm(() => {
 
 // src/funcs/visibilityCurrentRetrieve.ts
 function visibilityCurrentRetrieve(client$, request, options) {
-  return new APIPromise($do70(client$, request, options));
+  return new APIPromise($do72(client$, request, options));
 }
-async function $do70(client$, request, options) {
+async function $do72(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2VisibilityCurrentRetrieveRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -65586,6 +66143,7 @@ async function $do70(client$, request, options) {
   const path$ = pathToFunc("/v2/visibility/current")();
   const query$ = encodeFormQuery({
     end_date: payload$?.end_date,
+    period: payload$?.period,
     start_date: payload$?.start_date
   });
   const headers$ = new Headers(compactMap({
@@ -65650,19 +66208,19 @@ var init_visibilityCurrentRetrieve = __esm(() => {
 });
 
 // src/mcp-server/tools/visibilityCurrentRetrieve.ts
-var args55, tool$visibilityCurrentRetrieve;
+var args57, tool$visibilityCurrentRetrieve;
 var init_visibilityCurrentRetrieve2 = __esm(() => {
   init_visibilityCurrentRetrieve();
   init_v2visibilitycurrentretrieveop();
   init_tools();
-  args55 = {
+  args57 = {
     request: V2VisibilityCurrentRetrieveRequest$zodSchema.optional()
   };
   tool$visibilityCurrentRetrieve = {
     name: "visibility-current-retrieve",
     description: `Retrieve Current Visibility
 
-Returns recommendation score, visibility score, ranks, and date-range metadata for the configured primary company. Metrics are computed from active prompts only; when no data exists, values are \`null\`.`,
+Returns recommendation score, visibility score, ranks, and date-range metadata for the configured primary company, with the same metrics for the previous period, run coverage, and per-run rates. Metrics are computed from active prompts only; when no data exists, values are \`null\`. Pass \`period\` (for example \`last_30_days\` or \`2026Q4\`) instead of computing dates.`,
     annotations: {
       title: "",
       destructiveHint: false,
@@ -65670,7 +66228,7 @@ Returns recommendation score, visibility score, ranks, and date-range metadata f
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args55,
+    args: args57,
     tool: async (client, args, ctx) => {
       const [result] = await visibilityCurrentRetrieve(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -65786,6 +66344,9 @@ var init_publicvisibilityoverviewresponse = __esm(() => {
   init_zod();
   init_publiccompany();
   init_publiccompetitorrow();
+  init_publiccoverage();
+  init_publicrates();
+  init_publicresolvedperiod();
   init_publicvisibilitybyplatform();
   init_publicvisibilitydaterange();
   init_publicvisibilitysnapshot();
@@ -65794,8 +66355,11 @@ var init_publicvisibilityoverviewresponse = __esm(() => {
     by_platform: PublicVisibilityByPlatform$zodSchema,
     company: PublicCompany$zodSchema,
     competitors: array(PublicCompetitorRow$zodSchema).optional().describe("Includes the primary company."),
+    coverage: PublicCoverage$zodSchema.nullable().optional().describe("Runs per day against expected runs for both periods. Check `comparable` before comparing totals."),
     date_range: PublicVisibilityDateRange$zodSchema,
     has_data: boolean2(),
+    period: PublicResolvedPeriod$zodSchema.nullable().optional().describe("The resolved period and the previous period it is compared with."),
+    rates: PublicRates$zodSchema.nullable().optional().describe("Runs, owned citations, and per-run rates for both periods. Lead with `headline_metric`."),
     snapshot: PublicVisibilitySnapshot$zodSchema,
     timeseries: PublicVisibilityTimeseries$zodSchema
   });
@@ -65809,6 +66373,7 @@ var init_v2visibilityoverviewretrieveop = __esm(() => {
   init_publicvisibilityoverviewresponse();
   V2VisibilityOverviewRetrieveRequest$zodSchema = object({
     end_date: string2().date().describe("Inclusive range end; defaults to today.").optional(),
+    period: string2().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
     start_date: string2().date().describe("Inclusive range start; defaults to 30 days before the end date. The range may span at most 90 days.").optional()
   });
   V2VisibilityOverviewRetrieveResponse$zodSchema = union([
@@ -65819,9 +66384,9 @@ var init_v2visibilityoverviewretrieveop = __esm(() => {
 
 // src/funcs/visibilityOverviewRetrieve.ts
 function visibilityOverviewRetrieve(client$, request, options) {
-  return new APIPromise($do71(client$, request, options));
+  return new APIPromise($do73(client$, request, options));
 }
-async function $do71(client$, request, options) {
+async function $do73(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2VisibilityOverviewRetrieveRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -65831,6 +66396,7 @@ async function $do71(client$, request, options) {
   const path$ = pathToFunc("/v2/visibility/overview")();
   const query$ = encodeFormQuery({
     end_date: payload$?.end_date,
+    period: payload$?.period,
     start_date: payload$?.start_date
   });
   const headers$ = new Headers(compactMap({
@@ -65895,19 +66461,19 @@ var init_visibilityOverviewRetrieve = __esm(() => {
 });
 
 // src/mcp-server/tools/visibilityOverviewRetrieve.ts
-var args56, tool$visibilityOverviewRetrieve;
+var args58, tool$visibilityOverviewRetrieve;
 var init_visibilityOverviewRetrieve2 = __esm(() => {
   init_visibilityOverviewRetrieve();
   init_v2visibilityoverviewretrieveop();
   init_tools();
-  args56 = {
+  args58 = {
     request: V2VisibilityOverviewRetrieveRequest$zodSchema.optional()
   };
   tool$visibilityOverviewRetrieve = {
     name: "visibility-overview-retrieve",
     description: `Retrieve Visibility Overview
 
-Returns aggregate snapshot, daily trends, per-platform breakdowns, and competitor comparison. Calculated from active prompts only.`,
+Returns aggregate snapshot, daily trends, per-platform breakdowns, and competitor comparison, with run coverage and per-run rates against the previous period. Calculated from active prompts only.`,
     annotations: {
       title: "",
       destructiveHint: false,
@@ -65915,7 +66481,7 @@ Returns aggregate snapshot, daily trends, per-platform breakdowns, and competito
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args56,
+    args: args58,
     tool: async (client, args, ctx) => {
       const [result] = await visibilityOverviewRetrieve(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -66000,13 +66566,19 @@ var PublicPromptVisibilityReportResponse$zodSchema;
 var init_publicpromptvisibilityreportresponse = __esm(() => {
   init_zod();
   init_publiccompany();
+  init_publiccoverage();
   init_publicpromptvisibilitydaterange();
   init_publicpromptvisibilitysummary();
+  init_publicrates();
+  init_publicresolvedperiod();
   init_publictopicvisibilityrow();
   PublicPromptVisibilityReportResponse$zodSchema = object({
     company: PublicCompany$zodSchema,
+    coverage: PublicCoverage$zodSchema.nullable().optional().describe("Runs per day against expected runs for both periods. Check `comparable` before comparing totals."),
     date_range: PublicPromptVisibilityDateRange$zodSchema,
     has_data: boolean2(),
+    period: PublicResolvedPeriod$zodSchema.nullable().optional().describe("The resolved period and the previous period it is compared with."),
+    rates: PublicRates$zodSchema.nullable().optional().describe("Runs, owned citations, and per-run rates for both periods. Lead with `headline_metric`."),
     summary: PublicPromptVisibilitySummary$zodSchema,
     topics: array(PublicTopicVisibilityRow$zodSchema).optional()
   });
@@ -66020,6 +66592,7 @@ var init_v2visibilitypromptsretrieveop = __esm(() => {
   init_publicpromptvisibilityreportresponse();
   V2VisibilityPromptsRetrieveRequest$zodSchema = object({
     end_date: string2().date().describe("Inclusive range end; defaults to today.").optional(),
+    period: string2().describe("Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.").optional(),
     start_date: string2().date().describe("Inclusive range start; defaults to 30 days before the end date. The range may span at most 90 days.").optional()
   });
   V2VisibilityPromptsRetrieveResponse$zodSchema = union([
@@ -66030,9 +66603,9 @@ var init_v2visibilitypromptsretrieveop = __esm(() => {
 
 // src/funcs/visibilityPromptsRetrieve.ts
 function visibilityPromptsRetrieve(client$, request, options) {
-  return new APIPromise($do72(client$, request, options));
+  return new APIPromise($do74(client$, request, options));
 }
-async function $do72(client$, request, options) {
+async function $do74(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => V2VisibilityPromptsRetrieveRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -66042,6 +66615,7 @@ async function $do72(client$, request, options) {
   const path$ = pathToFunc("/v2/visibility/prompts")();
   const query$ = encodeFormQuery({
     end_date: payload$?.end_date,
+    period: payload$?.period,
     start_date: payload$?.start_date
   });
   const headers$ = new Headers(compactMap({
@@ -66106,12 +66680,12 @@ var init_visibilityPromptsRetrieve = __esm(() => {
 });
 
 // src/mcp-server/tools/visibilityPromptsRetrieve.ts
-var args57, tool$visibilityPromptsRetrieve;
+var args59, tool$visibilityPromptsRetrieve;
 var init_visibilityPromptsRetrieve2 = __esm(() => {
   init_visibilityPromptsRetrieve();
   init_v2visibilitypromptsretrieveop();
   init_tools();
-  args57 = {
+  args59 = {
     request: V2VisibilityPromptsRetrieveRequest$zodSchema.optional()
   };
   tool$visibilityPromptsRetrieve = {
@@ -66126,7 +66700,7 @@ Returns per-topic and per-prompt visibility metrics including recommendation sco
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args57,
+    args: args59,
     tool: async (client, args, ctx) => {
       const [result] = await visibilityPromptsRetrieve(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
@@ -66175,6 +66749,7 @@ function createMCPServer(deps) {
   tool(tool$visibilityOverviewRetrieve);
   tool(tool$visibilityCitationsList);
   tool(tool$visibilityPromptsRetrieve);
+  tool(tool$visibilityCitationsSummaryRetrieve);
   tool(tool$promptsList);
   tool(tool$promptsCreate);
   tool(tool$promptsTopicsList);
@@ -66188,6 +66763,7 @@ function createMCPServer(deps) {
   tool(tool$promptsDelete);
   tool(tool$promptsRun);
   tool(tool$promptsRunStatus);
+  tool(tool$promptsRunCancel);
   tool(tool$opportunitiesList);
   tool(tool$opportunitiesRetrieve);
   tool(tool$tasksList);
@@ -66297,6 +66873,7 @@ var init_server3 = __esm(() => {
   init_promptsList2();
   init_promptsRetrieve2();
   init_promptsRun2();
+  init_promptsRunCancel2();
   init_promptsRunsList2();
   init_promptsRunsRetrieve2();
   init_promptsRunStatus2();
@@ -66320,6 +66897,7 @@ var init_server3 = __esm(() => {
   init_tasksRetrieve2();
   init_tasksUpdate2();
   init_visibilityCitationsList2();
+  init_visibilityCitationsSummaryRetrieve2();
   init_visibilityCurrentRetrieve2();
   init_visibilityOverviewRetrieve2();
   init_visibilityPromptsRetrieve2();
@@ -66341,19 +66919,19 @@ Validates the API key and returns its organization ID, API key ID, scopes, and a
     },
     {
       name: "visibility-current-retrieve",
-      description: "Retrieve Current Visibility\n\nReturns recommendation score, visibility score, ranks, and date-range metadata for the configured primary company. Metrics are computed from active prompts only; when no data exists, values are `null`."
+      description: "Retrieve Current Visibility\n\nReturns recommendation score, visibility score, ranks, and date-range metadata for the configured primary company, with the same metrics for the previous period, run coverage, and per-run rates. Metrics are computed from active prompts only; when no data exists, values are `null`. Pass `period` (for example `last_30_days` or `2026Q4`) instead of computing dates."
     },
     {
       name: "visibility-overview-retrieve",
       description: `Retrieve Visibility Overview
 
-Returns aggregate snapshot, daily trends, per-platform breakdowns, and competitor comparison. Calculated from active prompts only.`
+Returns aggregate snapshot, daily trends, per-platform breakdowns, and competitor comparison, with run coverage and per-run rates against the previous period. Calculated from active prompts only.`
     },
     {
       name: "visibility-citations-list",
       description: `List Top Cited Urls
 
-Returns URL-level citation counts ranked from most to least cited. Results can be filtered by platform and to owned or external sources.`
+Returns URL-level citation counts ranked from most to least cited. Results can be filtered by platform and to owned or external sources. For totals by URL prefix, domain, or day compared with the previous period, use the citations summary.`
     },
     {
       name: "visibility-prompts-retrieve",
@@ -66361,6 +66939,10 @@ Returns URL-level citation counts ranked from most to least cited. Results can b
 
 Returns per-topic and per-prompt visibility metrics including recommendation score, rank, visibility score, average position, and citation counts.`
     },
+    {
+      name: "visibility-citations-summary-retrieve",
+      description: "Retrieve Citation Summary\n\nReturns citation totals grouped by URL prefix (domain and first path segment, such as `example.com/blog`), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with `url_prefix`, for example `https://example.com/blog/`. Aggregated in one call; use it instead of paging the citations list."
+    },
     {
       name: "prompts-list",
       description: "List Prompts\n\nReturns active and inactive prompts by default. Set `include_archived` to include archived prompts."
@@ -66427,17 +67009,25 @@ Archives the prompt and excludes it from normal listings while preserving its hi
       name: "prompts-run",
       description: `Run Prompts
 
-Queue saved prompts using the organization's configured targets.
+Queue saved prompts on answer engines and coding agents.
 
 Provide \`prompt_ids\` to run selected prompts, or omit them to run all active
-prompts. Saved prompt run settings apply to coding-agent targets. The
-response returns a run ID to poll with
+prompts. By default the run uses the organization's configured targets.
+Provide \`agent\` with IDs from \`GET /v2/agents\` to run the prompts on
+specific coding-agent harnesses and models instead, for example to compare
+how several coding tools answer the same developer question. Results
+include mentions and citations. Saved prompt run settings apply to
+coding-agent targets. The response returns a run ID to poll with
 \`GET /v2/prompts/runs/{run_id}/status\`.`
     },
     {
       name: "prompts-run-status",
       description: "Get Prompt Run Status\n\nReturn status and progress for a queued prompt run.\n\nPoll this endpoint until `status` is `completed`, `failed`, or `cancelled`.\nIndividual stored results are available from `GET /v2/prompts/runs`."
     },
+    {
+      name: "prompts-run-cancel",
+      description: "Cancel a prompt run\n\nMarks an active prompt run as cancelled and prevents queued prompts from starting. Running coding-agent attempts are stopped asynchronously. Requests already sent to an answer platform cannot be recalled, so prompts already in progress may still finish and store their results, but the run stays cancelled. Prompts that never start use no usage-based credits. The response has the same shape as the status operation, with cancelled prompts counted in `progress.cancelled`. Repeating this request for an already-cancelled run is safe."
+    },
     {
       name: "opportunities-list",
       description: "List Opportunities\n\nReturns ranked opportunities computed from stored prompt visibility results. Each includes an `execution_prompt` with context for an AI agent. Default window is 30 days."
@@ -66486,9 +67076,7 @@ Returns one audited page with its score, priority, supporting evidence, and reco
     },
     {
       name: "agent-analytics-summary-retrieve",
-      description: `Retrieve Agent Analytics Summary
-
-Returns a site's visits by traffic type (coding agents, user-requested AI fetches, AI search, AI training, other bots, and people) for the date range and for the same number of days before it.`
+      description: "Retrieve Agent Analytics Summary\n\nReturns a site's visits by traffic type (coding agents, user-requested AI fetches, AI search, AI training, other bots, and people) for the date range and for the previous period (the same number of days before it, or the previous calendar week, month, or quarter for a named `period`)."
     },
     {
       name: "agent-analytics-sources-list",
@@ -66514,7 +67102,7 @@ Returns a site's visits from coding agents and AI assistants per country in the
     },
     {
       name: "evals-create",
-      description: "Create Eval\n\nCreates a reusable simulation definition with one or more task prompts and judges. Optional agents, persona, CLI installations, MCP servers, setup commands, cleanup commands, grounding policy, repeat count, and tags are saved with the eval. `search_grounding` supports `disabled`, `enabled`, and `default`; `default` preserves normal platform behavior. Creating the eval does not start a run and does not accept secret environment values."
+      description: "Create Eval\n\nCreates a reusable simulation definition with one or more task prompts and judges. Optional agents, persona, CLI installations, MCP servers, setup commands, cleanup commands, grounding policy, repeat count, and tags are saved with the eval. `search_grounding` supports `disabled`, `enabled`, and `default`; `default` preserves normal platform behavior. Creating the eval does not start a run and does not accept secret environment values.\n\nEvals measure how well agents complete tasks with your product. To track how agents and answer engines answer research questions, including which brands they mention and cite, run prompts with `POST /v2/prompts/runs` instead."
     },
     {
       name: "evals-batch-create",
@@ -66568,7 +67156,7 @@ Permanently deletes an eval configuration and returns its last saved state.`
     },
     {
       name: "evals-run",
-      description: "Start an eval run\n\nQueues a durable eval job and returns immediately with a polling ID. Poll `GET /v2/eval-runs/{run_id}` until its status reaches a terminal value; once finished it also returns the results and analysis. Follow a run live with the monitor operation.\n\nSend one of these flat request forms:\n\n- **Saved eval:** provide `eval_id`; optionally replace its prompts, persona, agents, CLIs, MCPs, setup commands, cleanup commands, or runs for this launch. A saved configuration can still provide repository, environment, skills, and legacy tool selections.\n- **Direct create-and-run:** provide `prompts`, `judges`, and `agent`. You may also provide a persona, tags, repository, write-only environment variables, saved or inline CLIs and MCP servers, skills, setup commands, and cleanup commands.\n\nThe run fans out across prompts × agents × runs. Persona is shared metadata and does not multiply attempts. No separate `mode` field is required. If the organization lacks the estimated credits, the request fails with `402` before dispatching work.\n\nA saved or inline environment containing an empty or placeholder credential is rejected with `400` before any evaluation is dispatched."
+      description: "Start an eval run\n\nQueues a durable eval job and returns immediately with a polling ID. Poll `GET /v2/eval-runs/{run_id}` until its status reaches a terminal value; once finished it also returns the results and analysis. Follow a run live with the monitor operation.\n\nEval runs measure how well agents complete tasks with your product. To compare how coding agents and answer engines answer the same research question, with mentions and citations, use `POST /v2/prompts/runs` with `agent` instead.\n\nSend one of these flat request forms:\n\n- **Saved eval:** provide `eval_id`; optionally replace its prompts, persona, agents, CLIs, MCPs, setup commands, cleanup commands, or runs for this launch. A saved configuration can still provide repository, environment, skills, and legacy tool selections.\n- **Direct create-and-run:** provide `prompts`, `judges`, and `agent`. You may also provide a persona, tags, repository, write-only environment variables, saved or inline CLIs and MCP servers, skills, setup commands, and cleanup commands.\n\nThe run fans out across prompts × agents × runs. Persona is shared metadata and does not multiply attempts. No separate `mode` field is required. If the organization lacks the estimated credits, the request fails with `402` before dispatching work.\n\nA saved or inline environment containing an empty or placeholder credential is rejected with `400` before any evaluation is dispatched."
     },
     {
       name: "evals-cancel",
@@ -66658,9 +67246,7 @@ Returns recorded attempts for an Agent Preference eval, newest first, each with
     },
     {
       name: "agents-list",
-      description: `List Agents
-
-Returns the harness-and-model combinations your plan can run, as single agent IDs for use in eval runs.`
+      description: "List Agents\n\nReturns the coding-agent harness-and-model combinations your plan can run, as single agent IDs. Pass them as `agent` to `POST /v2/prompts/runs` to see how coding agents answer your prompts, with mentions and citations; to `POST /v2/agent-preference/evals` to see whether agents recommend your company over one competitor; or to `POST /v2/evals` and `POST /v2/eval-runs` to measure how well agents complete tasks with your product."
     },
     {
       name: "repositories-list",
@@ -67620,7 +68206,7 @@ http_headers = { "lightsage-api-key-auth" = "YOUR_LIGHTSAGE_API_KEY_AUTH" }`;
         <h1>Instructions</h1>
         <p>One-click installation for Claude Desktop users</p>
         <div class="instruction-item">
-          <a href="https://github.com/lightsagehq/mcp/releases/download/v0.4.17/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
+          <a href="https://github.com/lightsagehq/mcp/releases/download/v0.4.18/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
             \uD83D\uDCE5 Download MCP Bundle
           </a>
         </div>
@@ -70520,7 +71106,7 @@ var routes = buildRouteMap({
 var app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.4.17"
+    currentVersion: "0.4.18"
   }
 });
 run(app, process3.argv.slice(2), buildContext(process3));
@@ -70528,5 +71114,5 @@ export {
   app
 };
 
-//# debugId=5C5EC6411988AD1A64756E2164756E21
+//# debugId=7BE94F7B9FDE6A6464756E2164756E21
 //# sourceMappingURL=mcp-server.js.map