@canonry/canonry 4.133.1 → 4.133.3

package/dist/{chunk-ZPQX5ZQ2.js → chunk-YRRQFOAH.js}

@@ -6742,6 +6742,91 @@ var adsSummaryDtoSchema = z38.object({
   /** Campaign-level rollup totals over the window (levels are not summed across). */
   totals: adsTotalsDtoSchema
 });
+var adsDeliverySnapshotStatusSchema = z38.enum(["unavailable", "partial", "complete"]);
+var AdsDeliverySnapshotStatuses = adsDeliverySnapshotStatusSchema.enum;
+var adsDeliverySnapshotIssueSchema = z38.enum([
+  "no_ads_connection",
+  "connection_not_synced",
+  "no_ads_sync",
+  "entity_rows_missing_sync_run_id",
+  "entity_rows_span_multiple_sync_runs",
+  "source_sync_missing",
+  "source_sync_not_ads_sync",
+  "source_sync_not_completed"
+]);
+var AdsDeliverySnapshotIssues = adsDeliverySnapshotIssueSchema.enum;
+var adsHistoricalCampaignRollupStatusSchema = z38.enum(["unavailable", "reported"]);
+var AdsHistoricalCampaignRollupStatuses = adsHistoricalCampaignRollupStatusSchema.enum;
+var AdsDeliveryConfigurationBases = {
+  storedSnapshot: "stored_ads_snapshot"
+};
+var adsActivityAssessmentStateSchema = z38.enum([
+  "unavailable",
+  "partial_snapshot",
+  "metrics_unavailable",
+  "observed_activity",
+  "no_observed_activity"
+]);
+var AdsActivityAssessmentStates = adsActivityAssessmentStateSchema.enum;
+var adsDeliveryDiagnosticsAdSchema = z38.object({
+  id: z38.string(),
+  name: z38.string(),
+  status: z38.string(),
+  reviewStatus: z38.string().nullable()
+});
+var adsDeliveryDiagnosticsAdGroupSchema = z38.object({
+  id: z38.string(),
+  name: z38.string(),
+  status: z38.string(),
+  billingEventType: z38.union([adsAdGroupBillingEventTypeSchema, z38.null()]),
+  maxBidMicros: z38.number().int().nullable(),
+  contextHints: z38.array(z38.string()),
+  ads: z38.array(adsDeliveryDiagnosticsAdSchema)
+});
+var adsDeliveryDiagnosticsCampaignSchema = z38.object({
+  id: z38.string(),
+  name: z38.string(),
+  status: z38.string(),
+  biddingType: z38.union([adsCampaignBiddingTypeSchema, z38.null()]),
+  dailySpendLimitMicros: z38.number().int().nullable(),
+  lifetimeSpendLimitMicros: z38.number().int().nullable(),
+  conversionEventSettingIds: z38.array(z38.string()),
+  adGroups: z38.array(adsDeliveryDiagnosticsAdGroupSchema)
+});
+var adsDeliveryDiagnosticsDtoSchema = z38.object({
+  snapshot: z38.object({
+    status: adsDeliverySnapshotStatusSchema,
+    // A union keeps the OpenAPI form explicit enough for the generated SDK to
+    // retain the complete-snapshot `null` value (rather than narrowing it to
+    // the issue enum alone).
+    issue: z38.union([adsDeliverySnapshotIssueSchema, z38.null()]),
+    lastSyncedAt: z38.string().nullable(),
+    campaignCount: z38.number().int().nonnegative(),
+    adGroupCount: z38.number().int().nonnegative(),
+    adCount: z38.number().int().nonnegative(),
+    sourceSync: z38.object({
+      runId: z38.string(),
+      status: runStatusSchema
+    }).nullable()
+  }),
+  historicalCampaignRollups: z38.object({
+    status: adsHistoricalCampaignRollupStatusSchema,
+    window: z38.object({ from: z38.string().nullable(), to: z38.string().nullable() }),
+    totals: adsTotalsDtoSchema.nullable()
+  }),
+  storedConfiguration: z38.object({
+    basis: z38.literal(AdsDeliveryConfigurationBases.storedSnapshot),
+    connection: z38.object({
+      status: z38.string().nullable(),
+      reviewStatus: z38.string().nullable(),
+      integrityReviewStatus: z38.string().nullable(),
+      integrityDecision: z38.string().nullable(),
+      conversionTrackingConfigured: z38.boolean()
+    }).nullable(),
+    campaigns: z38.array(adsDeliveryDiagnosticsCampaignSchema)
+  }),
+  assessment: z38.object({ state: adsActivityAssessmentStateSchema })
+});
 var adsOperationKeySchema = z38.string().min(8).max(128).regex(/^[\w.:-]+$/, "operationKey may contain letters, numbers, dot, underscore, colon, and hyphen");
 var adsEntityIdSchema = z38.string().min(1).max(200);
 var adsNameSchema = z38.string().min(3).max(1e3).refine((value) => value.trim().length > 0);
@@ -7776,8 +7861,15 @@ export {
   AdsAdGroupBillingEventTypes,
   adsCampaignListResponseSchema,
   adsInsightLevelSchema,
+  AdsInsightLevels,
   adsInsightsResponseSchema,
   adsSummaryDtoSchema,
+  AdsDeliverySnapshotStatuses,
+  AdsDeliverySnapshotIssues,
+  AdsHistoricalCampaignRollupStatuses,
+  AdsDeliveryConfigurationBases,
+  AdsActivityAssessmentStates,
+  adsDeliveryDiagnosticsDtoSchema,
   AdsOperationKinds,
   AdsOperationStates,
   AdsReconcileStrategies,

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-42P7POVS.js";
+} from "./chunk-6ON6GUAL.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-P4MIG7V5.js";
+} from "./chunk-A6BYMSZL.js";
 import {
   apiKeys,
   createClient,
@@ -54,8 +54,10 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-VPY3PZXV.js";
+} from "./chunk-HENMGNLT.js";
 import {
+  AdsDeliverySnapshotStatuses,
+  AdsHistoricalCampaignRollupStatuses,
   AdsOperationKinds,
   AdsOperationStates,
   AdsOperationStepStates,
@@ -97,7 +99,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-ZPQX5ZQ2.js";
+} from "./chunk-YRRQFOAH.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -3381,6 +3383,37 @@ async function adsSummary(project, opts) {
   console.log(`Spend:        ${formatMicros(result.totals.spendMicros, result.currencyCode ?? "USD")}${result.totals.cpcMicros != null ? ` (CPC ${formatMicros(result.totals.cpcMicros, result.currencyCode ?? "USD")})` : ""}`);
   console.log(`Last synced:  ${result.lastSyncedAt ?? "never"}`);
 }
+async function adsDeliveryDiagnostics(project, opts) {
+  const result = await getClient6().getAdsDeliveryDiagnostics(project);
+  if (isMachineFormat(opts?.format)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`Snapshot:     ${result.snapshot.status}${result.snapshot.issue ? ` (${result.snapshot.issue})` : ""}`);
+  console.log(`Source sync:  ${result.snapshot.sourceSync ? `${result.snapshot.sourceSync.runId} [${result.snapshot.sourceSync.status}]` : "none"}`);
+  console.log(`Structure:    ${result.snapshot.campaignCount} campaigns / ${result.snapshot.adGroupCount} ad groups / ${result.snapshot.adCount} ads`);
+  console.log(`Last synced:  ${result.snapshot.lastSyncedAt ?? "never"}`);
+  console.log(`Activity:     ${result.assessment.state}`);
+  if (result.historicalCampaignRollups.status === AdsHistoricalCampaignRollupStatuses.reported && result.historicalCampaignRollups.totals !== null) {
+    console.log(`Historical:   ${result.historicalCampaignRollups.totals.impressions} impressions / ${result.historicalCampaignRollups.totals.clicks} clicks (${result.historicalCampaignRollups.window.from} \u2192 ${result.historicalCampaignRollups.window.to})`);
+  } else {
+    console.log("Historical:   no stored campaign rollups");
+  }
+  console.log("Evidence:     stored snapshot and historical rollups only; not an OpenAI eligibility or serving verdict.");
+  if (result.snapshot.status !== AdsDeliverySnapshotStatuses.complete) {
+    console.log("Structure details suppressed until a complete trusted snapshot exists.");
+    return;
+  }
+  for (const campaign of result.storedConfiguration.campaigns) {
+    const budget = campaign.dailySpendLimitMicros !== null ? `${formatMicros(campaign.dailySpendLimitMicros)}/day` : campaign.lifetimeSpendLimitMicros !== null ? `${formatMicros(campaign.lifetimeSpendLimitMicros)} lifetime` : "no stored budget";
+    console.log(`${campaign.name} [${campaign.status}] \u2014 ${campaign.biddingType ?? "unknown bidding"}, ${budget}, ${campaign.conversionEventSettingIds.length} conversion settings`);
+    for (const group of campaign.adGroups) {
+      const bid = group.maxBidMicros === null ? "no stored max bid" : `max bid ${formatMicros(group.maxBidMicros)}`;
+      console.log(`  - ${group.name} [${group.status}] \u2014 ${group.billingEventType ?? "unknown billing"}, ${bid}, ${group.contextHints.length} context hints`);
+      for (const ad of group.ads) console.log(`      ${ad.name} [${ad.status}] review=${ad.reviewStatus ?? "unknown"}`);
+    }
+  }
+}
 
 // src/cli-commands/ads.ts
 var ADS_CLI_COMMANDS = [
@@ -3736,6 +3769,14 @@ Usage: ${usage}`, {
       const project = requireProject(input, "ads.summary", "canonry ads summary <project> [--format json]");
       await adsSummary(project, { format: input.format });
     }
+  },
+  {
+    path: ["ads", "delivery-diagnostics"],
+    usage: "canonry ads delivery-diagnostics <project> [--format json]",
+    run: async (input) => {
+      const project = requireProject(input, "ads.delivery-diagnostics", "canonry ads delivery-diagnostics <project> [--format json]");
+      await adsDeliveryDiagnostics(project, { format: input.format });
+    }
   }
 ];
 

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-42P7POVS.js";
+} from "./chunk-6ON6GUAL.js";
 import {
   loadConfig
-} from "./chunk-P4MIG7V5.js";
-import "./chunk-VPY3PZXV.js";
-import "./chunk-ZPQX5ZQ2.js";
+} from "./chunk-A6BYMSZL.js";
+import "./chunk-HENMGNLT.js";
+import "./chunk-YRRQFOAH.js";
 export {
   createServer,
   loadConfig

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

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

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-P4MIG7V5.js";
+} from "./chunk-A6BYMSZL.js";
 import {
   isReadOnlyKey
-} from "./chunk-ZPQX5ZQ2.js";
+} from "./chunk-YRRQFOAH.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.1",
+  "version": "4.133.3",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -66,26 +66,26 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-config": "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-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-openai-ads": "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-business-profile": "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-integration-traffic": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "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-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",