@canonry/canonry 4.134.0 → 4.135.0

package/assets/assets/{trash-2-BVh__r6G.js → trash-2-DX33Ys-K.js}

@@ -1 +1 @@
-import{c as a}from"./index-De1MKbc7.js";const c=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],d=a("circle-check",c);const e=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],k=a("circle-question-mark",e);const t=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],s=a("download",t);const o=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],r=a("external-link",o);const n=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],y=a("trash-2",n);export{d as C,s as D,r as E,y as T,k as a};
+import{c as a}from"./index-BMlTgq7D.js";const c=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],d=a("circle-check",c);const e=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],k=a("circle-question-mark",e);const t=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],s=a("download",t);const o=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],r=a("external-link",o);const n=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],y=a("trash-2",n);export{d as C,s as D,r as E,y as T,k as a};

package/assets/index.html

@@ -12,7 +12,7 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-De1MKbc7.js"></script>
+    <script type="module" crossorigin src="./assets/index-BMlTgq7D.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/vendor-tanstack-Be8JdV5M.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-radix-CQ77EO2y.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-recharts-DSxTZhaH.js">

package/dist/{chunk-TKXWTDV6.js → chunk-3PFRVEWP.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-ZUQPHGEN.js";
+} from "./chunk-PAR6P5H6.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -119,7 +119,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-LIXWDIDR.js";
+} from "./chunk-TPVMHYHD.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -171,6 +171,7 @@ import {
   effectiveDomains,
   embedClientConfigForRequest,
   factorStatusFromScore,
+  formatIsoDateInTimeZone,
   frameAncestorsHeaderValue,
   hostOf,
   isAgentProviderId,
@@ -193,7 +194,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-PC7AYXND.js";
+} from "./chunk-PXEEWJRV.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -4658,10 +4659,10 @@ async function adsFetch(apiKey, path10, queryPairs = [], method = "GET", body) {
     throw new OpenAiAdsApiError("OpenAI Ads API returned invalid JSON", 502);
   }
 }
-async function fetchAllPages(apiKey, path10, queryPairs) {
+async function fetchAllPages(apiKey, path10, queryPairs, maxPages = OPENAI_ADS_MAX_PAGES) {
   const items = [];
   let after = null;
-  for (let page = 0; page < OPENAI_ADS_MAX_PAGES; page++) {
+  for (let page = 0; page < maxPages; page++) {
     const pairs = after ? [...queryPairs, `after=${encodeURIComponent(after)}`] : [...queryPairs];
     const response = await adsFetch(apiKey, path10, pairs);
     items.push(...response.data);
@@ -4670,6 +4671,7 @@ async function fetchAllPages(apiKey, path10, queryPairs) {
     }
     after = response.last_id;
   }
+  if (maxPages < OPENAI_ADS_MAX_PAGES) return items;
   adsClientLog("error", "pagination.cap-reached", { path: path10, pages: OPENAI_ADS_MAX_PAGES, items: items.length });
   throw new OpenAiAdsApiError(
     `OpenAI Ads API collection remained incomplete after the ${OPENAI_ADS_MAX_PAGES}-page safety cap`,
@@ -4683,6 +4685,9 @@ function insightsPairs(opts) {
     ...(opts?.timeRanges ?? []).map((range) => `time_ranges[]=${encodeURIComponent(JSON.stringify(range))}`)
   ];
 }
+function insightsMaxPages(opts) {
+  return opts?.firstPageOnly ? 1 : OPENAI_ADS_MAX_PAGES;
+}
 async function getAdAccount(apiKey) {
   validateApiKey(apiKey);
   return adsFetch(apiKey, "ad_account");
@@ -4813,7 +4818,8 @@ async function getCampaignInsights(apiKey, campaignId, opts) {
   return fetchAllPages(
     apiKey,
     `campaigns/${encodeURIComponent(campaignId)}/insights`,
-    insightsPairs(opts)
+    insightsPairs(opts),
+    insightsMaxPages(opts)
   );
 }
 async function getAdGroupInsights(apiKey, adGroupId, opts) {
@@ -4822,7 +4828,8 @@ async function getAdGroupInsights(apiKey, adGroupId, opts) {
   return fetchAllPages(
     apiKey,
     `ad_groups/${encodeURIComponent(adGroupId)}/insights`,
-    insightsPairs(opts)
+    insightsPairs(opts),
+    insightsMaxPages(opts)
   );
 }
 
@@ -4862,6 +4869,8 @@ function removeOpenAiAdsConnection(config, projectName) {
 var log4 = createLogger("AdsSync");
 var CAMPAIGN_INSIGHT_FIELDS = ["campaign.impressions", "campaign.clicks", "campaign.spend", "campaign.conversions", "metadata.readable_time"];
 var AD_GROUP_INSIGHT_FIELDS = ["ad_group.impressions", "ad_group.clicks", "ad_group.spend", "ad_group.conversions", "metadata.readable_time"];
+var CAMPAIGN_IN_PROGRESS_INSIGHT_FIELDS = CAMPAIGN_INSIGHT_FIELDS.filter((field) => field !== "campaign.conversions");
+var AD_GROUP_IN_PROGRESS_INSIGHT_FIELDS = AD_GROUP_INSIGHT_FIELDS.filter((field) => field !== "ad_group.conversions");
 var INSIGHTS_LOOKBACK_MS = 90 * 24 * 60 * 60 * 1e3;
 function accountHour(date, timezone) {
   const parts = new Intl.DateTimeFormat("en-CA", {
@@ -4879,11 +4888,17 @@ function accountHour(date, timezone) {
   };
   return `${value("year")}-${value("month")}-${value("day")}T${value("hour")}`;
 }
+function accountLocalDate(at, timezone) {
+  return formatIsoDateInTimeZone(at.toISOString(), timezone);
+}
+function startOfAccountDay(at, timezone) {
+  return startOfDayHourInTimeZone(accountLocalDate(at, timezone), timezone);
+}
 function trailingAdsInsightHourRange(now, timezone, lookbackMs = INSIGHTS_LOOKBACK_MS) {
   return {
     type: "hour_range",
     since: accountHour(new Date(now.getTime() - lookbackMs), timezone),
-    until: accountHour(now, timezone),
+    until: startOfAccountDay(now, timezone),
     timezone
   };
 }
@@ -4891,11 +4906,21 @@ function liveAdsInsightHourRange(request) {
   return {
     type: "hour_range",
     since: startOfDayHourInTimeZone(request.startDate, request.timezone),
-    until: accountHour(new Date(request.fetchedAtMs), request.timezone),
+    until: startOfAccountDay(new Date(request.fetchedAtMs), request.timezone),
     timezone: request.timezone
   };
 }
-function toInsightUpserts(level, entityId, rows) {
+async function readInsightDays(input) {
+  const [closedDays, unranged] = await Promise.all([
+    input.read({ fields: [...input.rangedFields], timeRanges: [...input.timeRanges] }),
+    input.read({ fields: [...input.inProgressFields], firstPageOnly: true })
+  ]);
+  return {
+    closedDays,
+    inProgressDay: unranged.find((row) => row.readable_time === input.inProgressDate) ?? null
+  };
+}
+function toInsightUpserts(level, entityId, rows, opts) {
   const upserts = [];
   for (const row of rows) {
     if (!row.readable_time) {
@@ -4909,11 +4934,22 @@ function toInsightUpserts(level, entityId, rows) {
       impressions: row.impressions ?? 0,
       clicks: row.clicks ?? 0,
       spendMicros: dollarsToMicros(row.spend ?? 0),
-      conversions: Math.round(row.conversions ?? 0)
+      conversions: opts.conversionsReported ? Math.round(row.conversions ?? 0) : null
     });
   }
   return upserts;
 }
+function toDailyUpserts(level, entityId, read) {
+  return [
+    ...toInsightUpserts(level, entityId, read.closedDays, { conversionsReported: true }),
+    ...toInsightUpserts(
+      level,
+      entityId,
+      read.inProgressDay ? [read.inProgressDay] : [],
+      { conversionsReported: false }
+    )
+  ];
+}
 async function executeAdsSync(db, runId, projectId, opts) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   db.update(runs).set({ status: "running", startedAt: now }).where(eq5(runs.id, runId)).run();
@@ -4932,7 +4968,9 @@ async function executeAdsSync(db, runId, projectId, opts) {
     log4.info("sync.start", { runId, projectId, adAccountId: connRow.adAccountId });
     const account = await getAdAccount(apiKey);
     const campaigns = await listCampaigns(apiKey);
-    const insightTimeRanges = [trailingAdsInsightHourRange(/* @__PURE__ */ new Date(), account.timezone)];
+    const insightAnchor = /* @__PURE__ */ new Date();
+    const insightTimeRanges = [trailingAdsInsightHourRange(insightAnchor, account.timezone)];
+    const inProgressDate = accountLocalDate(insightAnchor, account.timezone);
     const errors = /* @__PURE__ */ new Map();
     const adGroupsByCampaign = /* @__PURE__ */ new Map();
     const adsByGroup = /* @__PURE__ */ new Map();
@@ -4942,25 +4980,31 @@ async function executeAdsSync(db, runId, projectId, opts) {
       try {
         const [adGroups, campaignInsights] = await Promise.all([
           listAdGroups(apiKey, campaign.id),
-          getCampaignInsights(apiKey, campaign.id, {
-            fields: CAMPAIGN_INSIGHT_FIELDS,
-            timeRanges: insightTimeRanges
+          readInsightDays({
+            read: (options) => getCampaignInsights(apiKey, campaign.id, options),
+            rangedFields: CAMPAIGN_INSIGHT_FIELDS,
+            inProgressFields: CAMPAIGN_IN_PROGRESS_INSIGHT_FIELDS,
+            timeRanges: insightTimeRanges,
+            inProgressDate
           })
         ]);
         const groupResults = await Promise.all(adGroups.map(async (group) => ({
           group,
           ads: await listAds(apiKey, group.id),
-          insights: await getAdGroupInsights(apiKey, group.id, {
-            fields: AD_GROUP_INSIGHT_FIELDS,
-            timeRanges: insightTimeRanges
+          insights: await readInsightDays({
+            read: (options) => getAdGroupInsights(apiKey, group.id, options),
+            rangedFields: AD_GROUP_INSIGHT_FIELDS,
+            inProgressFields: AD_GROUP_IN_PROGRESS_INSIGHT_FIELDS,
+            timeRanges: insightTimeRanges,
+            inProgressDate
           })
         })));
         syncedCampaigns.push(campaign);
         adGroupsByCampaign.set(campaign.id, adGroups);
-        insightUpserts.push(...toInsightUpserts("campaign", campaign.id, campaignInsights));
+        insightUpserts.push(...toDailyUpserts("campaign", campaign.id, campaignInsights));
         for (const { group, ads, insights: insights2 } of groupResults) {
           adsByGroup.set(group.id, ads);
-          insightUpserts.push(...toInsightUpserts("ad_group", group.id, insights2));
+          insightUpserts.push(...toDailyUpserts("ad_group", group.id, insights2));
         }
       } catch (err) {
         errors.set(campaign.name, err instanceof Error ? err.message : String(err));
@@ -5029,7 +5073,16 @@ async function executeAdsSync(db, runId, projectId, opts) {
         tx.insert(adsInsightsDaily).values({
           id: crypto7.randomUUID(),
           projectId,
-          ...upsert,
+          level: upsert.level,
+          entityId: upsert.entityId,
+          date: upsert.date,
+          impressions: upsert.impressions,
+          clicks: upsert.clicks,
+          spendMicros: upsert.spendMicros,
+          // A day whose conversions the provider will not report yet starts at
+          // the column default. The first sync after that day closes reads it
+          // from the ranged call and fills it in.
+          conversions: upsert.conversions ?? 0,
           syncRunId: runId
         }).onConflictDoUpdate({
           target: [adsInsightsDaily.projectId, adsInsightsDaily.level, adsInsightsDaily.entityId, adsInsightsDaily.date],
@@ -5037,7 +5090,10 @@ async function executeAdsSync(db, runId, projectId, opts) {
             impressions: upsert.impressions,
             clicks: upsert.clicks,
             spendMicros: upsert.spendMicros,
-            conversions: upsert.conversions,
+            // Only written when the provider actually reported a count.
+            // Stamping a placeholder over a stored figure would turn a number
+            // this read could not obtain into a number that is simply wrong.
+            ...upsert.conversions === null ? {} : { conversions: upsert.conversions },
             syncRunId: runId
           }
         }).run();
@@ -7010,7 +7066,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-4XOFUN5E.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-BMEJ5GFZ.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -12246,20 +12302,32 @@ async function createServer(opts) {
     cpc: row.cpc ?? null,
     cpm: row.cpm ?? null
   });
+  const adsLiveInsightDays = (read, request, rangedFields, inProgressFields) => readInsightDays({
+    read,
+    rangedFields,
+    inProgressFields,
+    timeRanges: [liveAdsInsightHourRange(request)],
+    inProgressDate: accountLocalDate(new Date(request.fetchedAtMs), request.timezone)
+  });
+  const adsLiveMetricRows = (read) => [...read.closedDays, ...read.inProgressDay ? [read.inProgressDay] : []].map(adsLiveMetricRow);
   const adsLiveDeliveryReader = {
     listCampaigns: async (apiKey) => (await listCampaigns(apiKey)).map((campaign) => adsLiveEntity(campaign, { mode: campaign.mode })),
     listAdGroups: async (apiKey, campaignId) => (await listAdGroups(apiKey, campaignId)).map((adGroup) => adsLiveEntity(adGroup)),
     listAds: async (apiKey, adGroupId) => (await listAds(apiKey, adGroupId)).map(
       (ad) => adsLiveEntity(ad, { reviewStatus: ad.review_status ?? ad.review?.status ?? null })
     ),
-    campaignInsights: async (apiKey, campaignId, request) => (await getCampaignInsights(apiKey, campaignId, {
-      fields: CAMPAIGN_INSIGHT_FIELDS,
-      timeRanges: [liveAdsInsightHourRange(request)]
-    })).map(adsLiveMetricRow),
-    adGroupInsights: async (apiKey, adGroupId, request) => (await getAdGroupInsights(apiKey, adGroupId, {
-      fields: AD_GROUP_INSIGHT_FIELDS,
-      timeRanges: [liveAdsInsightHourRange(request)]
-    })).map(adsLiveMetricRow)
+    campaignInsights: async (apiKey, campaignId, request) => adsLiveMetricRows(await adsLiveInsightDays(
+      (options) => getCampaignInsights(apiKey, campaignId, options),
+      request,
+      CAMPAIGN_INSIGHT_FIELDS,
+      CAMPAIGN_IN_PROGRESS_INSIGHT_FIELDS
+    )),
+    adGroupInsights: async (apiKey, adGroupId, request) => adsLiveMetricRows(await adsLiveInsightDays(
+      (options) => getAdGroupInsights(apiKey, adGroupId, options),
+      request,
+      AD_GROUP_INSIGHT_FIELDS,
+      AD_GROUP_IN_PROGRESS_INSIGHT_FIELDS
+    ))
   };
   const scheduler = new Scheduler(opts.db, {
     onRunCreated: (runId, projectId, providers2, location) => {

package/dist/{chunk-ZUQPHGEN.js → chunk-PAR6P5H6.js}

@@ -42,7 +42,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-PC7AYXND.js";
+} from "./chunk-PXEEWJRV.js";
 
 // src/config.ts
 import fs from "fs";
@@ -3283,6 +3283,18 @@ var getApiV1ProjectsByNameGaAiReferralHistory = (options) => {
     ...options
   });
 };
+var getApiV1ProjectsByNameGaAiReferralDaily = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ga/ai-referral-daily",
+    ...options
+  });
+};
 var getApiV1ProjectsByNameGaSocialReferralHistory = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -5352,6 +5364,15 @@ var ApiClient = class {
       })
     );
   }
+  async gaAiReferralDaily(project, params) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameGaAiReferralDaily({
+        client: this.heyClient,
+        path: { name: project },
+        query: params
+      })
+    );
+  }
   async gaSocialReferralHistory(project, params) {
     return this.invoke(
       () => getApiV1ProjectsByNameGaSocialReferralHistory({
@@ -7081,8 +7102,8 @@ var canonryMcpTools = [
   }),
   defineTool({
     name: "canonry_ga_ai_referral_history",
-    title: "Get GA AI referral history",
-    description: "Get AI referral sessions per day grouped by source.",
+    title: "Get GA AI referral detail rows",
+    description: "Get raw AI referral rows per day, landing page, and attribution dimension. Detail, not totals: use canonry_ga_ai_referral_daily for session counts.",
     access: "read",
     tier: "ga",
     inputSchema: gaWindowInputSchema,
@@ -7090,6 +7111,17 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/ga/ai-referral-history"],
     handler: (client2, input) => client2.gaAiReferralHistory(input.project, compactStringParams(input, ["window"]))
   }),
+  defineTool({
+    name: "canonry_ga_ai_referral_daily",
+    title: "Get GA AI referral sessions per day",
+    description: "Get AI referral sessions per day and per source, deduplicated across attribution dimensions. Totals match the AI sessions reported by canonry_ga_traffic.",
+    access: "read",
+    tier: "ga",
+    inputSchema: gaWindowInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/ga/ai-referral-daily"],
+    handler: (client2, input) => client2.gaAiReferralDaily(input.project, compactStringParams(input, ["window"]))
+  }),
   defineTool({
     name: "canonry_ga_social_referral_history",
     title: "Get GA social referral history",

package/dist/{chunk-PC7AYXND.js → chunk-PXEEWJRV.js}

@@ -3976,7 +3976,21 @@ var ga4AiReferralDtoSchema = z25.object({
   medium: z25.string(),
   trafficClass: aiReferralTrafficClassSchema,
   sessions: z25.number(),
-  users: z25.number(),
+  /**
+   * @deprecated Never emitted since 4.135.0. Removed in the next major.
+   *
+   * GA reports `totalUsers` as a COUNT DISTINCT at the grain requested, and
+   * `ga_ai_referrals` is keyed by (date, source, medium, channelGroup,
+   * landingPage, sourceDimension), so summing it re-counted the same visitor on
+   * every extra day, page and channel they appear in. Unlike GA daily users, no
+   * un-dimensioned AI-referral fetch exists to ask Google for the true figure,
+   * so the number could not be corrected — only withdrawn. Optional rather than
+   * deleted so existing API / `canonry ga traffic --format json` / MCP
+   * consumers keep parsing; they now read `undefined` instead of an inflated
+   * number. Sessions are unaffected: GA4 attributes exactly one landing page
+   * per session, so the landing-page rows partition the day and do sum.
+   */
+  users: z25.number().optional(),
   /**
    * The winning attribution dimension for this (source, medium) tuple — the
    * one with the highest session count. GA4 emits one row per dimension
@@ -3997,7 +4011,8 @@ var ga4AiReferralLandingPageDtoSchema = z25.object({
   sourceDimension: ga4SourceDimensionSchema,
   landingPage: z25.string(),
   sessions: z25.number(),
-  users: z25.number()
+  /** @deprecated See `GA4AiReferralDto.users`. Never emitted since 4.135.0. */
+  users: z25.number().optional()
 });
 var ga4SocialReferralDtoSchema = z25.object({
   source: z25.string(),
@@ -4037,28 +4052,28 @@ var ga4TrafficSummaryDtoSchema = z25.object({
   aiReferralLandingPages: z25.array(ga4AiReferralLandingPageDtoSchema),
   /** Deduped AI session total: MAX(sessions) per date+source+medium across attribution dimensions, then summed. Cross-cutting: can overlap with Direct/Organic/Social via firstUserSource. */
   aiSessionsDeduped: z25.number(),
-  /** Deduped AI user total: MAX(users) per date+source+medium across attribution dimensions, then summed. */
-  aiUsersDeduped: z25.number(),
+  /** @deprecated See `GA4AiReferralDto.users`. Never emitted since 4.135.0. */
+  aiUsersDeduped: z25.number().optional(),
   /** Deduped AI sessions whose attribution carries paid intent. */
   paidAiSessionsDeduped: z25.number(),
-  /** Deduped users for paid AI sessions. */
-  paidAiUsersDeduped: z25.number(),
+  /** @deprecated See `GA4AiReferralDto.users`. Never emitted since 4.135.0. */
+  paidAiUsersDeduped: z25.number().optional(),
   /** Deduped AI sessions without paid intent evidence. */
   organicAiSessionsDeduped: z25.number(),
-  /** Deduped users for organic/non-paid AI sessions. */
-  organicAiUsersDeduped: z25.number(),
+  /** @deprecated See `GA4AiReferralDto.users`. Never emitted since 4.135.0. */
+  organicAiUsersDeduped: z25.number().optional(),
   /** AI sessions whose CURRENT sessionSource matched an AI engine. Can overlap with raw Organic/Social/Direct totals; `channelBreakdown` removes those overlaps for display. */
   aiSessionsBySession: z25.number(),
-  /** AI users whose CURRENT sessionSource matched an AI engine. Can overlap with raw Organic/Social/Direct totals. */
-  aiUsersBySession: z25.number(),
+  /** @deprecated See `GA4AiReferralDto.users`. Never emitted since 4.135.0. */
+  aiUsersBySession: z25.number().optional(),
   /** Session-source-only paid AI sessions. */
   paidAiSessionsBySession: z25.number(),
-  /** Session-source-only paid AI users. */
-  paidAiUsersBySession: z25.number(),
+  /** @deprecated See `GA4AiReferralDto.users`. Never emitted since 4.135.0. */
+  paidAiUsersBySession: z25.number().optional(),
   /** Session-source-only organic/non-paid AI sessions. */
   organicAiSessionsBySession: z25.number(),
-  /** Session-source-only organic/non-paid AI users. */
-  organicAiUsersBySession: z25.number(),
+  /** @deprecated See `GA4AiReferralDto.users`. Never emitted since 4.135.0. */
+  organicAiUsersBySession: z25.number().optional(),
   socialReferrals: z25.array(ga4SocialReferralDtoSchema),
   /** Total social sessions (session-scoped, no cross-dimension dedup needed). */
   socialSessions: z25.number(),
@@ -4148,6 +4163,29 @@ var ga4AiReferralHistoryEntrySchema = z25.object({
   /** Which GA4 dimension this row came from: session (sessionSource), first_user (firstUserSource), or manual_utm (utm_source parameter) */
   sourceDimension: ga4SourceDimensionSchema
 });
+var ga4AiReferralDailySourceSchema = z25.object({
+  source: z25.string(),
+  sessions: z25.number(),
+  paidSessions: z25.number(),
+  organicSessions: z25.number()
+});
+var ga4AiReferralDailyEntrySchema = z25.object({
+  date: z25.string(),
+  sessions: z25.number(),
+  paidSessions: z25.number(),
+  organicSessions: z25.number(),
+  /** Per-source split of the day. `sessions` is the sum of these. */
+  bySource: z25.array(ga4AiReferralDailySourceSchema)
+});
+var ga4AiReferralDailyDtoSchema = z25.object({
+  /** Ascending by date. Dates with no AI referrals are absent, not zero-filled. */
+  days: z25.array(ga4AiReferralDailyEntrySchema),
+  /** Sources present in the window, ordered by total sessions descending. */
+  sources: z25.array(z25.string()),
+  totalSessions: z25.number(),
+  totalPaidSessions: z25.number(),
+  totalOrganicSessions: z25.number()
+});
 var ga4SocialReferralHistoryEntrySchema = z25.object({
   date: z25.string(),
   source: z25.string(),
@@ -6818,13 +6856,31 @@ var adsInsightRowDtoSchema = z38.object({
   /** clicks / impressions; null when impressions is 0. */
   ctr: z38.number().nullable(),
   /** spendMicros / clicks, rounded to integer micros; null when clicks is 0. */
-  cpcMicros: z38.number().int().nullable()
+  cpcMicros: z38.number().int().nullable(),
+  /**
+   * True when `date` is the ad account's CURRENT local calendar date, so this
+   * row is a running figure rather than a closed day. The sync re-reads the
+   * open day and overwrites the row every time it runs, so the numbers here
+   * keep rising until the day ends. Do not compare it against a finished day
+   * or treat it as final.
+   *
+   * `conversions` is the one field that does NOT fill in live on such a row.
+   * The provider serves the open day only from a call that may not request
+   * conversion metrics, so the count stays at 0 until the day closes and the
+   * next sync reads the real figure. Treat it as not yet reported.
+   */
+  inProgress: z38.boolean()
 });
 var adsInsightsResponseSchema = z38.object({
   rows: z38.array(adsInsightRowDtoSchema),
   /** Account currency for rendering spend/cpc; null before the first sync. */
   currencyCode: z38.string().nullable().optional()
 });
+var adsRollupWindowDtoSchema = z38.object({
+  from: z38.string().nullable(),
+  to: z38.string().nullable(),
+  inProgressDate: z38.string().nullable()
+});
 var adsTotalsDtoSchema = z38.object({
   impressions: z38.number().int(),
   clicks: z38.number().int(),
@@ -6842,10 +6898,7 @@ var adsSummaryDtoSchema = z38.object({
   adGroupCount: z38.number().int(),
   adCount: z38.number().int(),
   /** Date range the totals cover (oldest/newest rollup date), null when empty. */
-  window: z38.object({
-    from: z38.string().nullable(),
-    to: z38.string().nullable()
-  }),
+  window: adsRollupWindowDtoSchema,
   /** Campaign-level rollup totals over the window (levels are not summed across). */
   totals: adsTotalsDtoSchema
 });
@@ -6918,7 +6971,7 @@ var adsDeliveryDiagnosticsDtoSchema = z38.object({
   }),
   historicalCampaignRollups: z38.object({
     status: adsHistoricalCampaignRollupStatusSchema,
-    window: z38.object({ from: z38.string().nullable(), to: z38.string().nullable() }),
+    window: adsRollupWindowDtoSchema,
     totals: adsTotalsDtoSchema.nullable()
   }),
   storedConfiguration: z38.object({
@@ -7965,6 +8018,7 @@ export {
   ga4StatusDtoSchema,
   ga4SyncResponseDtoSchema,
   ga4AiReferralHistoryEntrySchema,
+  ga4AiReferralDailyDtoSchema,
   ga4SocialReferralHistoryEntrySchema,
   ga4SessionHistoryEntrySchema,
   extractAnswerMentions,