@canonry/canonry 4.133.3 → 4.134.1

package/dist/{chunk-6ON6GUAL.js → chunk-NWVPRV7A.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-A6BYMSZL.js";
+} from "./chunk-BSU2MI3Y.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -40,6 +40,7 @@ import {
   classifyAiUserFetch,
   classifyCrawler,
   competitors,
+  computeCitedCompetitorDomains,
   computeCompetitorOverlap,
   countAttributes,
   countPopulatedGroups,
@@ -118,7 +119,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-HENMGNLT.js";
+} from "./chunk-DVJGFY3J.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -188,10 +189,11 @@ import {
   serializeRunError,
   skillsClientSchema,
   splitList,
+  startOfDayHourInTimeZone,
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-YRRQFOAH.js";
+} from "./chunk-CF5WTWXI.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -4877,14 +4879,22 @@ function accountHour(date, timezone) {
   };
   return `${value("year")}-${value("month")}-${value("day")}T${value("hour")}`;
 }
-function trailingAdsInsightHourRange(now, timezone) {
+function trailingAdsInsightHourRange(now, timezone, lookbackMs = INSIGHTS_LOOKBACK_MS) {
   return {
     type: "hour_range",
-    since: accountHour(new Date(now.getTime() - INSIGHTS_LOOKBACK_MS), timezone),
+    since: accountHour(new Date(now.getTime() - lookbackMs), timezone),
     until: accountHour(now, timezone),
     timezone
   };
 }
+function liveAdsInsightHourRange(request) {
+  return {
+    type: "hour_range",
+    since: startOfDayHourInTimeZone(request.startDate, request.timezone),
+    until: accountHour(new Date(request.fetchedAtMs), request.timezone),
+    timezone: request.timezone
+  };
+}
 function toInsightUpserts(level, entityId, rows) {
   const upserts = [];
   for (const row of rows) {
@@ -7000,7 +7010,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-OSLFG5S2.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-NO4FJUYD.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -9114,6 +9124,7 @@ var AERO_ADS_OPERATOR_MCP_TOOL_NAMES = /* @__PURE__ */ new Set([
   CanonryMcpToolNames.canonry_ads_insights,
   CanonryMcpToolNames.canonry_ads_summary,
   CanonryMcpToolNames.canonry_ads_delivery_diagnostics,
+  CanonryMcpToolNames.canonry_ads_live_delivery,
   CanonryMcpToolNames.canonry_ads_operations_unresolved,
   CanonryMcpToolNames.canonry_ads_operation_get,
   CanonryMcpToolNames.canonry_ads_operation_reconcile,
@@ -11592,6 +11603,14 @@ async function executeResearchRun(db, registry, runId, projectId) {
           return provider.adapter.executeTrackedQuery({ query: row.queryText, canonicalDomains: domains, competitorDomains, ...run.location ? { location: run.location } : {} }, config);
         });
         const normalized = provider.adapter.normalizeResult(raw);
+        const namedCompetitors = extractRecommendedCompetitors(
+          normalized.answerText,
+          domains,
+          normalized.citedDomains,
+          competitorDomains,
+          brands
+        );
+        const citedCompetitorDomains = computeCitedCompetitorDomains(normalized.citedDomains, competitorDomains);
         const completed = db.update(researchRunQueries).set({
           status: ResearchQueryStatuses.completed,
           servedModel: raw.servedModel ?? null,
@@ -11599,6 +11618,8 @@ async function executeResearchRun(db, registry, runId, projectId) {
           groundingSources: normalized.groundingSources,
           citedDomains: normalized.citedDomains,
           searchQueries: normalized.searchQueries,
+          namedCompetitors,
+          citedCompetitorDomains,
           answerMentioned: determineAnswerMentioned(normalized.answerText, brands, domains),
           citationState: determineCitationState(normalized, domains),
           rawResponse: raw.rawResponse,
@@ -12204,6 +12225,42 @@ async function createServer(opts) {
     activateAd: async (apiKey, id) => adsAdEntityResult(await activateAd(apiKey, id)),
     pauseAd: async (apiKey, id) => adsAdEntityResult(await pauseAd(apiKey, id))
   };
+  const adsLiveEntity = (entity, extra) => ({
+    id: entity.id,
+    name: entity.name,
+    status: entity.status,
+    reviewStatus: extra?.reviewStatus ?? null,
+    mode: extra?.mode ?? null,
+    updatedAt: entity.updated_at
+  });
+  const adsLiveMetricRow = (row) => ({
+    date: row.readable_time ?? null,
+    startTime: row.start_time ?? null,
+    endTime: row.end_time ?? null,
+    impressions: row.impressions ?? null,
+    clicks: row.clicks ?? null,
+    // Provider units: the insights API returns decimal currency for spend.
+    spend: row.spend ?? null,
+    conversions: row.conversions ?? null,
+    ctr: row.ctr ?? null,
+    cpc: row.cpc ?? null,
+    cpm: row.cpm ?? null
+  });
+  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)
+  };
   const scheduler = new Scheduler(opts.db, {
     onRunCreated: (runId, projectId, providers2, location) => {
       jobRunner.executeRun(runId, projectId, providers2, location).catch((err) => {
@@ -12803,6 +12860,11 @@ async function createServer(opts) {
     adsCredentialStore,
     verifyAdsAccount,
     adsReader,
+    adsLiveDeliveryReader,
+    // Reporting only: lets the route state the true upstream HTTP ceiling
+    // (reader-call budget x pages per reader call) instead of implying that a
+    // reader call is one request.
+    adsLiveDeliveryMaxPagesPerReaderCall: OPENAI_ADS_MAX_PAGES,
     adsOperator,
     onAdsSyncRequested: (runId, projectId) => {
       runAdsSync(runId, projectId);

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-6ON6GUAL.js";
+} from "./chunk-NWVPRV7A.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-A6BYMSZL.js";
+} from "./chunk-BSU2MI3Y.js";
 import {
   apiKeys,
   createClient,
@@ -54,10 +54,11 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-HENMGNLT.js";
+} from "./chunk-DVJGFY3J.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
+  AdsLiveEntityTypes,
   AdsOperationKinds,
   AdsOperationStates,
   AdsOperationStepStates,
@@ -99,7 +100,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-YRRQFOAH.js";
+} from "./chunk-CF5WTWXI.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -2692,6 +2693,12 @@ function printDetail(project, detail, format) {
     console.log(`  ${query.query.slice(0, 58).padEnd(58)}  ${query.status.padEnd(10)}  ${cited.padEnd(5)}  ${mentioned}`);
     if (query.error) console.log(`    Error: ${query.error}`);
     if (query.answerText) console.log(`    Answer: ${query.answerText}`);
+    if (query.namedCompetitors.length > 0) {
+      console.log(`    Named competitors: ${query.namedCompetitors.join(", ")}`);
+    }
+    if (query.citedCompetitorDomains.length > 0) {
+      console.log(`    Cited competitor domains: ${query.citedCompetitorDomains.join(", ")}`);
+    }
     if (query.groundingSources.length > 0) {
       console.log("    Sources:");
       for (const source of query.groundingSources) {
@@ -3414,6 +3421,42 @@ async function adsDeliveryDiagnostics(project, opts) {
     }
   }
 }
+async function adsLiveDelivery(project, opts) {
+  const result = await getClient6().getAdsLiveDelivery(project, {
+    campaignId: opts?.campaignId,
+    lookbackDays: opts?.lookbackDays
+  });
+  if (isMachineFormat(opts?.format)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`Read at:      ${result.fetchedAt} (live provider read)`);
+  console.log(`Ad account:   ${result.adAccountId}`);
+  console.log(`Snapshot:     last synced ${result.storedSnapshotSyncedAt ?? "never"}`);
+  console.log(`Metrics:      last ${result.metricsWindow.lookbackDays}d, as the provider reported them`);
+  console.log(`Provider:     ${result.bounds.readerCalls}/${result.bounds.maxReaderCalls} reader calls, up to ${result.bounds.maxUpstreamHttpRequests} upstream HTTP requests${result.bounds.truncated ? " (TRUNCATED, walk hit a cap)" : ""}`);
+  console.log(`Drift:        ${result.drift.driftedEntities}/${result.drift.entitiesCompared} entities (${result.drift.statusDrifted} status, ${result.drift.metricsDrifted} metrics)`);
+  for (const failure of result.errors) {
+    console.log(`Read failed:  ${failure.surface}${failure.entityId ? ` ${failure.entityId}` : ""}${failure.upstreamStatus === null ? "" : ` [HTTP ${failure.upstreamStatus}]`}`);
+  }
+  for (const entity of result.entities) {
+    const indent = entity.entityType === AdsLiveEntityTypes.campaign ? "" : entity.entityType === AdsLiveEntityTypes.ad_group ? "  " : "    ";
+    const label = entity.live?.name ?? entity.stored?.name ?? entity.id;
+    const liveStatus = entity.live === null ? "absent upstream" : entity.live.status;
+    const storedStatus = entity.stored === null ? "absent locally" : entity.stored.status;
+    const marker = entity.drifted ? "DRIFT" : "match";
+    console.log(`${indent}${label} [${entity.entityType}]: live ${liveStatus} / stored ${storedStatus} (${marker})`);
+    for (const delta of entity.fieldDeltas) {
+      console.log(`${indent}  ${delta.field}: live ${delta.live ?? "none"} / stored ${delta.stored ?? "none"}`);
+    }
+    for (const delta of entity.metricDeltas ?? []) {
+      if (!delta.drifted) continue;
+      const live = delta.live === null ? "no provider row" : `${delta.live.impressions} impr / ${delta.live.clicks} clicks / ${formatMicros(delta.live.spendMicros)}`;
+      const stored = delta.stored === null ? "no stored row" : `${delta.stored.impressions} impr / ${delta.stored.clicks} clicks / ${formatMicros(delta.stored.spendMicros)}`;
+      console.log(`${indent}  ${delta.date}: live ${live} / stored ${stored}`);
+    }
+  }
+}
 
 // src/cli-commands/ads.ts
 var ADS_CLI_COMMANDS = [
@@ -3770,6 +3813,27 @@ Usage: ${usage}`, {
       await adsSummary(project, { format: input.format });
     }
   },
+  {
+    path: ["ads", "live-delivery"],
+    usage: "canonry ads live-delivery <project> [--campaign <id>] [--lookback-days <n>] [--format json]",
+    options: {
+      campaign: stringOption(),
+      "lookback-days": stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry ads live-delivery <project> [--campaign <id>] [--lookback-days <n>] [--format json]";
+      const project = requireProject(input, "ads.live-delivery", usage);
+      await adsLiveDelivery(project, {
+        campaignId: getString(input.values, "campaign"),
+        lookbackDays: parseIntegerOption(input, "lookback-days", {
+          command: "ads.live-delivery",
+          message: "--lookback-days must be an integer from 1 to 30",
+          usage
+        }),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["ads", "delivery-diagnostics"],
     usage: "canonry ads delivery-diagnostics <project> [--format json]",
@@ -4047,6 +4111,36 @@ async function gaAiReferralHistory(project, opts) {
     );
   }
 }
+async function gaAiReferralDaily(project, opts) {
+  const client = getClient7();
+  const result = await client.gaAiReferralDaily(project, opts?.window ? { window: opts.window } : void 0);
+  if (opts?.format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  } else if (opts?.format === "jsonl") {
+    emitJsonl(result.days.map((day) => ({ project, window: opts?.window, ...day })));
+    return;
+  }
+  if (result.days.length === 0) {
+    console.log(`No AI referral sessions.${opts?.window ? " Try a wider window or omit --window." : ' Run "canonry ga sync <project>" first.'}`);
+    return;
+  }
+  const dateWidth = 12;
+  const sourceWidth = Math.min(30, Math.max(10, ...result.sources.map((s) => s.length)));
+  console.log(`GA4 AI Referral Sessions per Day for "${project}":
+`);
+  console.log(`  ${"DATE".padEnd(dateWidth)}  ${"SOURCE".padEnd(sourceWidth)}  ${"SESSIONS".padEnd(10)}${"PAID".padEnd(8)}${"ORGANIC".padEnd(9)}`);
+  console.log(`  ${"\u2500".repeat(dateWidth)}  ${"\u2500".repeat(sourceWidth)}  ${"\u2500".repeat(10)}${"\u2500".repeat(8)}${"\u2500".repeat(9)}`);
+  for (const day of result.days) {
+    for (const entry of day.bySource) {
+      console.log(
+        `  ${day.date.padEnd(dateWidth)}  ${entry.source.padEnd(sourceWidth)}  ${String(entry.sessions).padEnd(10)}${String(entry.paidSessions).padEnd(8)}${String(entry.organicSessions).padEnd(9)}`
+      );
+    }
+  }
+  console.log(`
+  Total: ${result.totalSessions} sessions (${result.totalPaidSessions} paid, ${result.totalOrganicSessions} organic)`);
+}
 async function gaSocialReferralHistory(project, opts) {
   const client = getClient7();
   const result = await client.gaSocialReferralHistory(project, opts?.window ? { window: opts.window } : void 0);
@@ -4511,6 +4605,20 @@ var GA_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["ga", "ai-referral-daily"],
+    usage: "canonry ga ai-referral-daily <project> [--window 30d] [--format json]",
+    options: {
+      window: stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(input, "ga.ai-referral-daily", "canonry ga ai-referral-daily <project> [--window 30d] [--format json]");
+      await gaAiReferralDaily(project, {
+        window: getString(input.values, "window"),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["ga", "social-referral-history"],
     usage: "canonry ga social-referral-history <project> [--window 30d] [--format json]",
@@ -4574,7 +4682,7 @@ var GA_CLI_COMMANDS = [
       unknownSubcommand(input.positionals[0], {
         command: "ga",
         usage: "canonry ga <subcommand> <project> [args]",
-        available: ["connect", "disconnect", "status", "sync", "measurement-analysis", "traffic", "coverage", "ai-referral-history", "social-referral-history", "session-history", "social-referral-summary", "attribution"]
+        available: ["connect", "disconnect", "status", "sync", "measurement-analysis", "traffic", "coverage", "ai-referral-history", "ai-referral-daily", "social-referral-history", "session-history", "social-referral-summary", "attribution"]
       });
     }
   }

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-6ON6GUAL.js";
+} from "./chunk-NWVPRV7A.js";
 import {
   loadConfig
-} from "./chunk-A6BYMSZL.js";
-import "./chunk-HENMGNLT.js";
-import "./chunk-YRRQFOAH.js";
+} from "./chunk-BSU2MI3Y.js";
+import "./chunk-DVJGFY3J.js";
+import "./chunk-CF5WTWXI.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-OSLFG5S2.js → intelligence-service-NO4FJUYD.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-HENMGNLT.js";
-import "./chunk-YRRQFOAH.js";
+} from "./chunk-DVJGFY3J.js";
+import "./chunk-CF5WTWXI.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-A6BYMSZL.js";
+} from "./chunk-BSU2MI3Y.js";
 import {
   isReadOnlyKey
-} from "./chunk-YRRQFOAH.js";
+} from "./chunk-CF5WTWXI.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "4.133.3",
+  "version": "4.134.1",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -68,24 +68,24 @@
     "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0"
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",