@lightsage/mcp 0.4.17 → 0.4.18

package/src/models/publiccoverageday.ts

@@ -0,0 +1,68 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 934b3f835415
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const Period = {
+  Current: "current",
+  Previous: "previous",
+} as const;
+export type Period = ClosedEnum<typeof Period>;
+
+export const Period$zodSchema = z.enum([
+  "current",
+  "previous",
+]);
+
+/**
+ * `missing`: no runs on a day that expected some. `short`: under half the expected runs. `in_progress`: today, before its runs finished.
+ */
+export const PublicCoverageDayStatus = {
+  Ok: "ok",
+  Short: "short",
+  Missing: "missing",
+  InProgress: "in_progress",
+  NotExpected: "not_expected",
+} as const;
+/**
+ * `missing`: no runs on a day that expected some. `short`: under half the expected runs. `in_progress`: today, before its runs finished.
+ */
+export type PublicCoverageDayStatus = ClosedEnum<
+  typeof PublicCoverageDayStatus
+>;
+
+export const PublicCoverageDayStatus$zodSchema = z.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.",
+);
+
+export type PublicCoverageDay = {
+  date: string;
+  period: Period;
+  runs: number;
+  expected_runs: number;
+  status: PublicCoverageDayStatus;
+};
+
+export const PublicCoverageDay$zodSchema: z.ZodType<PublicCoverageDay> = z
+  .object({
+    date: z.string(),
+    expected_runs: z.int().describe(
+      "Median daily runs over the 7 days before; 0 when no daily runs are expected.",
+    ),
+    period: Period$zodSchema,
+    runs: z.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.",
+    ),
+  });

package/src/models/publiccurrentvisibilityresponse.ts

@@ -5,6 +5,16 @@
 
 import * as z from "zod";
 import { PublicCompany, PublicCompany$zodSchema } from "./publiccompany.js";
+import { PublicCoverage, PublicCoverage$zodSchema } from "./publiccoverage.js";
+import {
+  PublicPreviousVisibility,
+  PublicPreviousVisibility$zodSchema,
+} from "./publicpreviousvisibility.js";
+import { PublicRates, PublicRates$zodSchema } from "./publicrates.js";
+import {
+  PublicResolvedPeriod,
+  PublicResolvedPeriod$zodSchema,
+} from "./publicresolvedperiod.js";
 
 export type PublicCurrentVisibilityResponse = {
   company: PublicCompany;
@@ -21,6 +31,10 @@ export type PublicCurrentVisibilityResponse = {
   end_date: string;
   active_prompts_only?: boolean | undefined;
   has_data: boolean;
+  period?: PublicResolvedPeriod | null | undefined;
+  previous?: PublicPreviousVisibility | null | undefined;
+  coverage?: PublicCoverage | null | undefined;
+  rates?: PublicRates | null | undefined;
 };
 
 export const PublicCurrentVisibilityResponse$zodSchema: z.ZodType<
@@ -32,11 +46,23 @@ export const PublicCurrentVisibilityResponse$zodSchema: z.ZodType<
   ),
   average_position_rank: z.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: z.string().nullable().optional().describe(
     "Latest prompt-run date in the range.",
   ),
   end_date: z.string(),
   has_data: z.boolean(),
+  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: z.number().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.",
   ),

package/src/models/publicperiodcoverage.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 826ee3c7ea7a
+ */
+
+import * as z from "zod";
+
+export type PublicPeriodCoverage = {
+  start_date: string;
+  end_date: string;
+  runs: number;
+  expected_runs: number;
+  complete_days: number;
+  runs_per_day?: number | null | undefined;
+  missing_days?: Array<string> | undefined;
+  short_days?: Array<string> | undefined;
+};
+
+export const PublicPeriodCoverage$zodSchema: z.ZodType<PublicPeriodCoverage> = z
+  .object({
+    complete_days: z.int().describe(
+      "Days in the period other than today in progress.",
+    ),
+    end_date: z.string(),
+    expected_runs: z.int(),
+    missing_days: z.array(z.string()).optional(),
+    runs: z.int(),
+    runs_per_day: z.number().nullable().optional().describe(
+      "Runs per complete day.",
+    ),
+    short_days: z.array(z.string()).optional(),
+    start_date: z.string(),
+  });

package/src/models/publicperiodrates.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e7a509001b7d
+ */
+
+import * as z from "zod";
+
+export type PublicPeriodRates = {
+  runs: number;
+  owned_citations: number;
+  owned_citations_per_run?: number | null | undefined;
+  brand_mention_runs: number;
+  mention_rate?: number | null | undefined;
+};
+
+export const PublicPeriodRates$zodSchema: z.ZodType<PublicPeriodRates> = z
+  .object({
+    brand_mention_runs: z.int().describe(
+      "Runs that mention the primary company.",
+    ),
+    mention_rate: z.number().nullable().optional().describe(
+      "Share of runs that mention the primary company, from 0 to 1.",
+    ),
+    owned_citations: z.int().describe(
+      "Citations of the organization's own domains.",
+    ),
+    owned_citations_per_run: z.number().nullable().optional(),
+    runs: z.int(),
+  });

package/src/models/publicpreviousvisibility.ts

@@ -0,0 +1,30 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b65281016f32
+ */
+
+import * as z from "zod";
+
+export type PublicPreviousVisibility = {
+  recommendation_score?: number | null | undefined;
+  visibility_score?: number | null | undefined;
+  share_of_voice?: number | null | undefined;
+  average_position?: number | null | undefined;
+  has_data?: boolean | undefined;
+};
+
+export const PublicPreviousVisibility$zodSchema: z.ZodType<
+  PublicPreviousVisibility
+> = z.object({
+  average_position: z.number().nullable().optional(),
+  has_data: z.boolean().default(false),
+  recommendation_score: z.number().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: z.number().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: z.number().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.",
+  ),
+});

package/src/models/publicpromptvisibilityreportresponse.ts

@@ -5,6 +5,7 @@
 
 import * as z from "zod";
 import { PublicCompany, PublicCompany$zodSchema } from "./publiccompany.js";
+import { PublicCoverage, PublicCoverage$zodSchema } from "./publiccoverage.js";
 import {
   PublicPromptVisibilityDateRange,
   PublicPromptVisibilityDateRange$zodSchema,
@@ -13,6 +14,11 @@ import {
   PublicPromptVisibilitySummary,
   PublicPromptVisibilitySummary$zodSchema,
 } from "./publicpromptvisibilitysummary.js";
+import { PublicRates, PublicRates$zodSchema } from "./publicrates.js";
+import {
+  PublicResolvedPeriod,
+  PublicResolvedPeriod$zodSchema,
+} from "./publicresolvedperiod.js";
 import {
   PublicTopicVisibilityRow,
   PublicTopicVisibilityRow$zodSchema,
@@ -24,14 +30,26 @@ export type PublicPromptVisibilityReportResponse = {
   has_data: boolean;
   summary: PublicPromptVisibilitySummary;
   topics?: Array<PublicTopicVisibilityRow> | undefined;
+  period?: PublicResolvedPeriod | null | undefined;
+  coverage?: PublicCoverage | null | undefined;
+  rates?: PublicRates | null | undefined;
 };
 
 export const PublicPromptVisibilityReportResponse$zodSchema: z.ZodType<
   PublicPromptVisibilityReportResponse
 > = z.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: z.boolean(),
+  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: z.array(PublicTopicVisibilityRow$zodSchema).optional(),
 });

package/src/models/publicratechanges.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7e8926781b3d
+ */
+
+import * as z from "zod";
+
+export type PublicRateChanges = {
+  owned_citations?: number | null | undefined;
+  owned_citations_per_run?: number | null | undefined;
+  mention_rate?: number | null | undefined;
+};
+
+export const PublicRateChanges$zodSchema: z.ZodType<PublicRateChanges> = z
+  .object({
+    mention_rate: z.number().nullable().optional().describe(
+      "Relative change from the previous period.",
+    ),
+    owned_citations: z.number().nullable().optional().describe(
+      "Relative change from the previous period; 0.25 means 25% higher.",
+    ),
+    owned_citations_per_run: z.number().nullable().optional().describe(
+      "Relative change from the previous period.",
+    ),
+  });

package/src/models/publicrates.ts

@@ -0,0 +1,52 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9b8379be34f2
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+import {
+  PublicPeriodRates,
+  PublicPeriodRates$zodSchema,
+} from "./publicperiodrates.js";
+import {
+  PublicRateChanges,
+  PublicRateChanges$zodSchema,
+} from "./publicratechanges.js";
+
+/**
+ * The number to lead with: owned citations when the periods are comparable, otherwise owned citations per run.
+ */
+export const PublicRatesHeadlineMetric = {
+  OwnedCitations: "owned_citations",
+  OwnedCitationsPerRun: "owned_citations_per_run",
+} as const;
+/**
+ * The number to lead with: owned citations when the periods are comparable, otherwise owned citations per run.
+ */
+export type PublicRatesHeadlineMetric = ClosedEnum<
+  typeof PublicRatesHeadlineMetric
+>;
+
+export const PublicRatesHeadlineMetric$zodSchema = z.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.",
+);
+
+export type PublicRates = {
+  headline_metric: PublicRatesHeadlineMetric;
+  current: PublicPeriodRates;
+  previous: PublicPeriodRates;
+  change: PublicRateChanges;
+};
+
+export const PublicRates$zodSchema: z.ZodType<PublicRates> = z.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,
+});

package/src/models/publicresolvedperiod.ts

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: eeb8e6b4cc74
+ */
+
+import * as z from "zod";
+
+export type PublicResolvedPeriod = {
+  name?: string | null | undefined;
+  start_date: string;
+  end_date: string;
+  days: number;
+  previous_start_date: string;
+  previous_end_date: string;
+  previous_days: number;
+  partial: boolean;
+  timezone?: "UTC" | undefined;
+};
+
+export const PublicResolvedPeriod$zodSchema: z.ZodType<PublicResolvedPeriod> = z
+  .object({
+    days: z.int().describe("Days in the period, counting both ends."),
+    end_date: z.string().describe("Last day of the period (UTC), inclusive."),
+    name: z.string().nullable().optional().describe(
+      "The `period` requested, or null when the range came from `start_date` and `end_date`.",
+    ),
+    partial: z.boolean().describe(
+      "Whether the period includes today, so its last day is still in progress.",
+    ),
+    previous_days: z.int().describe("Days in the previous period."),
+    previous_end_date: z.string().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: z.string().describe(
+      "First day of the previous period it is compared with.",
+    ),
+    start_date: z.string().describe(
+      "First day of the period (UTC), inclusive.",
+    ),
+    timezone: z.literal("UTC").default("UTC"),
+  });

package/src/models/publictopcitedurlsresponse.ts

@@ -10,11 +10,17 @@ import {
   PublicCitedUrlDateRange,
   PublicCitedUrlDateRange$zodSchema,
 } from "./publiccitedurldaterange.js";
+import { PublicCoverage, PublicCoverage$zodSchema } from "./publiccoverage.js";
+import { PublicRates, PublicRates$zodSchema } from "./publicrates.js";
+import {
+  PublicResolvedPeriod,
+  PublicResolvedPeriod$zodSchema,
+} from "./publicresolvedperiod.js";
 
 /**
  * Whether the results include all, owned, or external URLs.
  */
-export const SourceType = {
+export const PublicTopCitedUrlsResponseSourceType = {
   All: "all",
   Owned: "owned",
   External: "external",
@@ -22,9 +28,11 @@ export const SourceType = {
 /**
  * Whether the results include all, owned, or external URLs.
  */
-export type SourceType = ClosedEnum<typeof SourceType>;
+export type PublicTopCitedUrlsResponseSourceType = ClosedEnum<
+  typeof PublicTopCitedUrlsResponseSourceType
+>;
 
-export const SourceType$zodSchema = z.enum([
+export const PublicTopCitedUrlsResponseSourceType$zodSchema = z.enum([
   "all",
   "owned",
   "external",
@@ -33,16 +41,22 @@ export const SourceType$zodSchema = z.enum([
 export type PublicTopCitedUrlsResponse = {
   date_range: PublicCitedUrlDateRange;
   platform?: string | null | undefined;
-  source_type: SourceType;
+  source_type: PublicTopCitedUrlsResponseSourceType;
   has_data: boolean;
   count: number;
   data?: Array<PublicCitedUrl> | undefined;
+  period?: PublicResolvedPeriod | null | undefined;
+  coverage?: PublicCoverage | null | undefined;
+  rates?: PublicRates | null | undefined;
 };
 
 export const PublicTopCitedUrlsResponse$zodSchema: z.ZodType<
   PublicTopCitedUrlsResponse
 > = z.object({
   count: z.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: z.array(PublicCitedUrl$zodSchema).optional().describe(
     "Cited URLs ranked by citation count in descending order.",
   ),
@@ -50,10 +64,16 @@ export const PublicTopCitedUrlsResponse$zodSchema: z.ZodType<
   has_data: z.boolean().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: z.string().nullable().optional().describe(
     "Platform selector applied to the results, or null for all platforms.",
   ),
-  source_type: SourceType$zodSchema.describe(
+  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.",
   ),
 });

package/src/models/publicvisibilityoverviewresponse.ts

@@ -9,6 +9,12 @@ import {
   PublicCompetitorRow,
   PublicCompetitorRow$zodSchema,
 } from "./publiccompetitorrow.js";
+import { PublicCoverage, PublicCoverage$zodSchema } from "./publiccoverage.js";
+import { PublicRates, PublicRates$zodSchema } from "./publicrates.js";
+import {
+  PublicResolvedPeriod,
+  PublicResolvedPeriod$zodSchema,
+} from "./publicresolvedperiod.js";
 import {
   PublicVisibilityByPlatform,
   PublicVisibilityByPlatform$zodSchema,
@@ -34,6 +40,9 @@ export type PublicVisibilityOverviewResponse = {
   timeseries: PublicVisibilityTimeseries;
   by_platform: PublicVisibilityByPlatform;
   competitors?: Array<PublicCompetitorRow> | undefined;
+  period?: PublicResolvedPeriod | null | undefined;
+  coverage?: PublicCoverage | null | undefined;
+  rates?: PublicRates | null | undefined;
 };
 
 export const PublicVisibilityOverviewResponse$zodSchema: z.ZodType<
@@ -44,8 +53,17 @@ export const PublicVisibilityOverviewResponse$zodSchema: z.ZodType<
   competitors: z.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: z.boolean(),
+  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,
 });

package/src/models/updatev2promptrequest.ts

@@ -38,7 +38,7 @@ export const UpdateV2PromptRequest$zodSchema: z.ZodType<UpdateV2PromptRequest> =
       "Marks the prompt as branded or unbranded. Omit to keep the current value; changing `text` does not change it.",
     ),
     platform_ids: z.array(z.string()).nullable().optional().describe(
-      "Replacement list of answer-platform IDs.",
+      "Replacement list of platform IDs, as returned in `platforms` on `GET /v2/prompts`.",
     ),
     run_settings: V2PromptRunSettingsInput$zodSchema.nullable().optional()
       .describe(

package/src/models/v2agentanalyticscountrieslistop.ts

@@ -17,6 +17,7 @@ export type V2AgentAnalyticsCountriesListRequest = {
   site_id: string;
   start_date?: string | undefined;
   end_date?: string | undefined;
+  period?: string | undefined;
   limit?: number | undefined;
 };
 
@@ -27,6 +28,9 @@ export const V2AgentAnalyticsCountriesListRequest$zodSchema: z.ZodType<
     "Inclusive range end in UTC; defaults to today.",
   ).optional(),
   limit: z.int().default(20),
+  period: z.string().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: z.string(),
   start_date: z.string().date().describe(
     "Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.",

package/src/models/v2agentanalyticserrorpageslistop.ts

@@ -45,6 +45,7 @@ export type V2AgentAnalyticsErrorPagesListRequest = {
   site_id: string;
   start_date?: string | undefined;
   end_date?: string | undefined;
+  period?: string | undefined;
   limit?: number | undefined;
   status?: number | undefined;
   type?: V2AgentAnalyticsErrorPagesListType | undefined;
@@ -57,6 +58,9 @@ export const V2AgentAnalyticsErrorPagesListRequest$zodSchema: z.ZodType<
     "Inclusive range end in UTC; defaults to today.",
   ).optional(),
   limit: z.int().default(50),
+  period: z.string().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: z.string(),
   start_date: z.string().date().describe(
     "Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.",

package/src/models/v2agentanalyticspageslistop.ts

@@ -76,6 +76,7 @@ export type V2AgentAnalyticsPagesListRequest = {
   site_id: string;
   start_date?: string | undefined;
   end_date?: string | undefined;
+  period?: string | undefined;
   limit?: number | undefined;
   search?: string | undefined;
   sort?: Sort | undefined;
@@ -93,6 +94,9 @@ export const V2AgentAnalyticsPagesListRequest$zodSchema: z.ZodType<
     "Inclusive range end in UTC; defaults to today.",
   ).optional(),
   limit: z.int().default(20),
+  period: z.string().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: z.string().describe("Only pages whose path contains this text.")
     .optional(),
   site_id: z.string(),

package/src/models/v2agentanalyticssourceslistop.ts

@@ -17,6 +17,7 @@ export type V2AgentAnalyticsSourcesListRequest = {
   site_id: string;
   start_date?: string | undefined;
   end_date?: string | undefined;
+  period?: string | undefined;
 };
 
 export const V2AgentAnalyticsSourcesListRequest$zodSchema: z.ZodType<
@@ -25,6 +26,9 @@ export const V2AgentAnalyticsSourcesListRequest$zodSchema: z.ZodType<
   end_date: z.string().date().describe(
     "Inclusive range end in UTC; defaults to today.",
   ).optional(),
+  period: z.string().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: z.string(),
   start_date: z.string().date().describe(
     "Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.",

package/src/models/v2agentanalyticssummaryretrieveop.ts

@@ -17,6 +17,7 @@ export type V2AgentAnalyticsSummaryRetrieveRequest = {
   site_id: string;
   start_date?: string | undefined;
   end_date?: string | undefined;
+  period?: string | undefined;
 };
 
 export const V2AgentAnalyticsSummaryRetrieveRequest$zodSchema: z.ZodType<
@@ -25,6 +26,9 @@ export const V2AgentAnalyticsSummaryRetrieveRequest$zodSchema: z.ZodType<
   end_date: z.string().date().describe(
     "Inclusive range end in UTC; defaults to today.",
   ).optional(),
+  period: z.string().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: z.string(),
   start_date: z.string().date().describe(
     "Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.",