@canonry/canonry 4.124.0 → 4.125.0

package/assets/assets/{trash-2-CcmHLt5u.js → trash-2-BnFgG3Wq.js}

@@ -1 +1 @@
-import{c}from"./index-CqFSTLK5.js";const a=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],h=c("circle-check",a);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"}]],n=c("circle-question-mark",e);const o=[["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=c("download",o);const t=[["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"}]],r=c("trash-2",t);export{h as C,s as D,r as T,n as a};
+import{c}from"./index-B_CDPjOg.js";const a=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],h=c("circle-check",a);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"}]],n=c("circle-question-mark",e);const o=[["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=c("download",o);const t=[["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"}]],r=c("trash-2",t);export{h as C,s as D,r as T,n 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-CqFSTLK5.js"></script>
+    <script type="module" crossorigin src="./assets/index-B_CDPjOg.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-4D2XUMMV.js → chunk-DN5H2ZN7.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-WGGB7QBD.js";
+} from "./chunk-WA57WG6W.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -115,7 +115,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-BGLBWFMV.js";
+} from "./chunk-YPRUBNUK.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -185,7 +185,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-SLCGTOKT.js";
+} from "./chunk-RFLNTI7Y.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -4612,7 +4612,10 @@ async function fetchAllPages(apiKey, path10, queryPairs) {
   );
 }
 function insightsPairs(opts) {
-  return (opts?.fields ?? []).map((field) => `fields[]=${encodeURIComponent(field)}`);
+  return [
+    ...(opts?.fields ?? []).map((field) => `fields[]=${encodeURIComponent(field)}`),
+    ...(opts?.timeRanges ?? []).map((range) => `time_ranges[]=${encodeURIComponent(JSON.stringify(range))}`)
+  ];
 }
 async function getAdAccount(apiKey) {
   validateApiKey(apiKey);
@@ -4793,6 +4796,31 @@ 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 INSIGHTS_LOOKBACK_MS = 90 * 24 * 60 * 60 * 1e3;
+function accountHour(date, timezone) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: timezone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    hourCycle: "h23"
+  }).formatToParts(date);
+  const value = (type) => {
+    const part = parts.find((candidate) => candidate.type === type)?.value;
+    if (!part) throw new Error(`OpenAI Ads account timezone did not produce a ${type}`);
+    return part;
+  };
+  return `${value("year")}-${value("month")}-${value("day")}T${value("hour")}`;
+}
+function trailingAdsInsightHourRange(now, timezone) {
+  return {
+    type: "hour_range",
+    since: accountHour(new Date(now.getTime() - INSIGHTS_LOOKBACK_MS), timezone),
+    until: accountHour(now, timezone),
+    timezone
+  };
+}
 function toInsightUpserts(level, entityId, rows) {
   const upserts = [];
   for (const row of rows) {
@@ -4830,6 +4858,7 @@ 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 errors = /* @__PURE__ */ new Map();
     const adGroupsByCampaign = /* @__PURE__ */ new Map();
     const adsByGroup = /* @__PURE__ */ new Map();
@@ -4839,12 +4868,18 @@ 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 })
+          getCampaignInsights(apiKey, campaign.id, {
+            fields: CAMPAIGN_INSIGHT_FIELDS,
+            timeRanges: insightTimeRanges
+          })
         ]);
         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 })
+          insights: await getAdGroupInsights(apiKey, group.id, {
+            fields: AD_GROUP_INSIGHT_FIELDS,
+            timeRanges: insightTimeRanges
+          })
         })));
         syncedCampaigns.push(campaign);
         adGroupsByCampaign.set(campaign.id, adGroups);
@@ -6901,7 +6936,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-SACHNNCT.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-WJ2ZR7GF.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-SLCGTOKT.js → chunk-RFLNTI7Y.js}

@@ -6848,10 +6848,19 @@ var adsOperationStepDtoSchema = z35.discriminatedUnion("state", [
   adsOperationStepRollbackFailedDtoSchema,
   adsOperationStepUnknownDtoSchema
 ]);
+var AdsActivationVersionPolicies = {
+  exact: "exact",
+  refreshSemanticallyUnchanged: "refresh_semantically_unchanged"
+};
+var adsActivationVersionPolicySchema = z35.enum([
+  AdsActivationVersionPolicies.exact,
+  AdsActivationVersionPolicies.refreshSemanticallyUnchanged
+]);
 var adsActivationGrantCreateRequestSchema = z35.object({
   manifest: adsActivationManifestSchema,
   executorApiKeyId: adsEntityIdSchema,
-  expiresAt: adsActivationIsoTimestampSchema
+  expiresAt: adsActivationIsoTimestampSchema,
+  versionPolicy: adsActivationVersionPolicySchema.default(AdsActivationVersionPolicies.exact)
 }).strict();
 var adsActivationGrantResponseSchema = z35.object({
   grant: adsActivationGrantDtoSchema
@@ -7441,6 +7450,7 @@ export {
   adsOperationResponseSchema,
   adsActivationGrantDtoSchema,
   adsOperationStepDtoSchema,
+  AdsActivationVersionPolicies,
   adsActivationGrantCreateRequestSchema,
   adsActivationGrantResponseSchema,
   adsActivationGrantRevokeRequestSchema,

package/dist/{chunk-WGGB7QBD.js → chunk-WA57WG6W.js}

@@ -37,7 +37,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-SLCGTOKT.js";
+} from "./chunk-RFLNTI7Y.js";
 
 // src/config.ts
 import fs from "fs";

package/dist/{chunk-BGLBWFMV.js → chunk-YPRUBNUK.js}

@@ -7,6 +7,7 @@ import {
   AI_PROVIDER_INFRA_DOMAINS,
   AdsActivationEntityTypes,
   AdsActivationGrantStates,
+  AdsActivationVersionPolicies,
   AdsAdGroupBillingEventTypes,
   AdsCampaignBiddingTypes,
   AdsEntityStatuses,
@@ -335,7 +336,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-SLCGTOKT.js";
+} from "./chunk-RFLNTI7Y.js";
 
 // src/intelligence-service.ts
 import { eq as eq41, desc as desc18, asc as asc9, and as and32, ne as ne6, or as or8, inArray as inArray15, gte as gte10, lte as lte6 } from "drizzle-orm";
@@ -18623,7 +18624,13 @@ var routeCatalog = [
             properties: {
               manifest: adsActivationManifestSchema2,
               executorApiKeyId: adsEntityIdSchema,
-              expiresAt: { type: "string", format: "date-time" }
+              expiresAt: { type: "string", format: "date-time" },
+              versionPolicy: {
+                type: "string",
+                enum: ["exact", "refresh_semantically_unchanged"],
+                default: "exact",
+                description: "Exact rejects any provider version drift. refresh_semantically_unchanged rebinds versions only when the live paused tree still matches its durable create receipts field-for-field."
+              }
             }
           }
         }
@@ -24948,6 +24955,81 @@ async function preflightAdsActivationApproval(provider, request) {
   }
   return { manifest, manifestHash: hashAdsActivationManifest(manifest) };
 }
+async function refreshSemanticallyUnchangedAdsActivationManifest(provider, request) {
+  const manifest = canonicalManifest(request.manifest);
+  await validateAccount(provider, request.adAccountId);
+  await validateExactDescendants(provider, manifest, {
+    entityType: AdsActivationEntityTypes.campaign,
+    entityId: manifest.campaign.id,
+    parentId: null,
+    expectedUpdatedAt: manifest.campaign.expectedUpdatedAt
+  });
+  const versions = /* @__PURE__ */ new Map();
+  for (const target of activationTargets(manifest)) {
+    let entity;
+    try {
+      entity = await readTarget(provider, target);
+    } catch {
+      throw targetError(
+        AdsActivationErrorCodes.providerReadFailed,
+        "An ads entity could not be verified for version refresh",
+        502,
+        target
+      );
+    }
+    validateIdentity(target, entity);
+    validateAdApproval(target, entity);
+    if (entity.status !== PROVIDER_PAUSED) {
+      throw targetError(AdsActivationErrorCodes.entityNotPaused, "Every approved ads entity must still be paused", 409, target);
+    }
+    if (!Number.isInteger(entity.updatedAt) || entity.updatedAt === null || entity.updatedAt < 0) {
+      throw targetError(
+        AdsActivationErrorCodes.providerReadFailed,
+        "An ads entity did not report a usable provider version",
+        502,
+        target
+      );
+    }
+    if (!request.semanticallyMatchesMaterialization(target.entityType, target.entityId, entity)) {
+      throw targetError(
+        AdsActivationErrorCodes.entityMismatch,
+        "An ads entity no longer matches its materialized approved fields",
+        409,
+        target
+      );
+    }
+    versions.set(`${target.entityType}:${target.entityId}`, entity.updatedAt);
+  }
+  const version = (entityType, entityId) => {
+    const current = versions.get(`${entityType}:${entityId}`);
+    if (current === void 0) {
+      throw new AdsActivationError(
+        AdsActivationErrorCodes.persistenceFailed,
+        "A refreshed ads entity version is missing",
+        500
+      );
+    }
+    return current;
+  };
+  const refreshed = {
+    campaign: {
+      id: manifest.campaign.id,
+      expectedUpdatedAt: version(AdsActivationEntityTypes.campaign, manifest.campaign.id),
+      adGroups: manifest.campaign.adGroups.map((group) => ({
+        id: group.id,
+        expectedUpdatedAt: version(AdsActivationEntityTypes.ad_group, group.id),
+        ads: group.ads.map((ad) => ({
+          id: ad.id,
+          expectedUpdatedAt: version(AdsActivationEntityTypes.ad, ad.id)
+        }))
+      }))
+    }
+  };
+  return preflightAdsActivationApproval(provider, {
+    adAccountId: request.adAccountId,
+    manifest: refreshed
+  });
+}
 function stepTarget(manifest, step) {
   const target = activationTargets(manifest).find(
     (candidate) => candidate.entityType === step.entityType && candidate.entityId === step.entityId
@@ -26519,7 +26601,11 @@ function registerAdsActivationRoutes(app, opts) {
       const runtime = await opts.resolveRuntime(project);
       let preflight;
       try {
-        preflight = await preflightAdsActivationApproval(runtime.provider, {
+        preflight = body.versionPolicy === AdsActivationVersionPolicies.refreshSemanticallyUnchanged ? await refreshSemanticallyUnchangedAdsActivationManifest(runtime.provider, {
+          adAccountId: runtime.adAccountId,
+          manifest: body.manifest,
+          semanticallyMatchesMaterialization: runtime.semanticallyMatchesMaterialization ?? (() => false)
+        }) : await preflightAdsActivationApproval(runtime.provider, {
           adAccountId: runtime.adAccountId,
           manifest: body.manifest
         });
@@ -26960,6 +27046,44 @@ function entityMatchesReconcileFields(entity, desired, fingerprint) {
   const candidateFingerprint = requestHash(selected);
   return fingerprint === null ? candidateFingerprint === requestHash(desired) : candidateFingerprint === fingerprint;
 }
+function semanticallyMatchesMaterializedEntity(app, input) {
+  const createKind = (() => {
+    switch (input.entityType) {
+      case AdsActivationEntityTypes.campaign:
+        return AdsOperationKinds.campaign_create;
+      case AdsActivationEntityTypes.ad_group:
+        return AdsOperationKinds.ad_group_create;
+      case AdsActivationEntityTypes.ad:
+        return AdsOperationKinds.ad_create;
+    }
+  })();
+  const updateKind = (() => {
+    switch (input.entityType) {
+      case AdsActivationEntityTypes.campaign:
+        return AdsOperationKinds.campaign_update;
+      case AdsActivationEntityTypes.ad_group:
+        return AdsOperationKinds.ad_group_update;
+      case AdsActivationEntityTypes.ad:
+        return AdsOperationKinds.ad_update;
+    }
+  })();
+  const rows = app.db.select().from(adsOperations).where(and20(
+    eq26(adsOperations.projectId, input.projectId),
+    eq26(adsOperations.entityType, input.entityType),
+    eq26(adsOperations.entityId, input.entityId),
+    inArray12(adsOperations.kind, [createKind, updateKind])
+  )).orderBy(asc6(adsOperations.createdAt), asc6(adsOperations.id)).all();
+  if (rows.some((row) => row.state === AdsOperationStates.pending || row.state === AdsOperationStates.reconciling || row.state === AdsOperationStates.unknown || row.kind === updateKind && row.state === AdsOperationStates.succeeded)) {
+    return false;
+  }
+  const creates = rows.filter((row) => row.kind === createKind && row.state === AdsOperationStates.succeeded);
+  if (creates.length !== 1) return false;
+  const create = creates[0];
+  if (create.adAccountId !== input.adAccountId || create.reconcileStrategy !== AdsReconcileStrategies.create_fingerprint || !create.reconcileFields) {
+    return false;
+  }
+  return entityMatchesReconcileFields(input.entity, create.reconcileFields, null);
+}
 function reconcileFieldsWithoutParent(fields) {
   const { campaignId: _campaignId, adGroupId: _adGroupId, ...withoutParent } = fields;
   return withoutParent;
@@ -27743,6 +27867,16 @@ async function adsRoutes(app, opts) {
       }
       return {
         adAccountId,
+        semanticallyMatchesMaterialization: (entityType, entityId, entity) => {
+          if (entity.status === null || entity.updatedAt === null) return false;
+          return semanticallyMatchesMaterializedEntity(app, {
+            projectId: project.id,
+            adAccountId,
+            entityType,
+            entityId,
+            entity: { ...entity, status: entity.status, updatedAt: entity.updatedAt }
+          });
+        },
         provider: {
           getAccount: refreshAccount,
           getCampaign: (id) => operator.getCampaign(apiKey, id),

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-4D2XUMMV.js";
+} from "./chunk-DN5H2ZN7.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-WGGB7QBD.js";
+} from "./chunk-WA57WG6W.js";
 import {
   apiKeys,
   createClient,
@@ -54,7 +54,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-BGLBWFMV.js";
+} from "./chunk-YPRUBNUK.js";
 import {
   AdsOperationKinds,
   AdsOperationStates,
@@ -95,7 +95,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-SLCGTOKT.js";
+} from "./chunk-RFLNTI7Y.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-4D2XUMMV.js";
+} from "./chunk-DN5H2ZN7.js";
 import {
   loadConfig
-} from "./chunk-WGGB7QBD.js";
-import "./chunk-BGLBWFMV.js";
-import "./chunk-SLCGTOKT.js";
+} from "./chunk-WA57WG6W.js";
+import "./chunk-YPRUBNUK.js";
+import "./chunk-RFLNTI7Y.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-SACHNNCT.js → intelligence-service-WJ2ZR7GF.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-BGLBWFMV.js";
-import "./chunk-SLCGTOKT.js";
+} from "./chunk-YPRUBNUK.js";
+import "./chunk-RFLNTI7Y.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-WGGB7QBD.js";
+} from "./chunk-WA57WG6W.js";
 import {
   isReadOnlyKey
-} from "./chunk-SLCGTOKT.js";
+} from "./chunk-RFLNTI7Y.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.124.0",
+  "version": "4.125.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -66,24 +66,24 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-contracts": "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-bing": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
     "@ainyc/canonry-integration-google-places": "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-integration-openai-ads": "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-integration-traffic": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0"
   },