@ainyc/canonry 4.60.2 → 4.61.0

package/dist/{chunk-DXWUBWBD.js → chunk-URPUUKLC.js}

@@ -851,6 +851,10 @@ var gbpLocationDtoSchema = z7.object({
   primaryCategoryDisplayName: z7.string().nullable(),
   storefrontAddress: z7.string().nullable(),
   websiteUri: z7.string().nullable(),
+  // Google Maps Place ID + public Maps link (from location metadata; null when
+  // the location is not on Maps). `placeId` is the join key to the Places API.
+  placeId: z7.string().nullable(),
+  mapsUri: z7.string().nullable(),
   selected: z7.boolean(),
   syncedAt: z7.string().nullable(),
   createdAt: z7.string(),
@@ -944,6 +948,22 @@ var gbpLodgingListResponseSchema = z7.object({
   lodging: z7.array(gbpLodgingDtoSchema),
   total: z7.number().int().nonnegative()
 });
+var gbpPlaceDetailsDtoSchema = z7.object({
+  locationName: z7.string(),
+  placeId: z7.string(),
+  /** Field-mask SKU tier the snapshot was fetched at ('atmosphere' | 'pro'). */
+  tier: z7.string(),
+  /** Amenities the public listing advertises, derived from `place`. */
+  amenities: z7.array(z7.string()),
+  /** When this listing was last fetched from Places — advances on every fetch, even when the content is unchanged (this is what the refresh-cadence gate reads). */
+  syncedAt: z7.string(),
+  /** Raw Place Details resource as Google returned it. */
+  place: z7.record(z7.string(), z7.unknown())
+});
+var gbpPlaceDetailsListResponseSchema = z7.object({
+  places: z7.array(gbpPlaceDetailsDtoSchema),
+  total: z7.number().int().nonnegative()
+});
 var gbpSummaryDtoSchema = z7.object({
   scope: z7.object({
     locationName: z7.string().nullable(),
@@ -2099,6 +2119,7 @@ var projectSearchInsightHitSchema = z18.object({
     "competitor-lost",
     // Google Business Profile (local-AEO) insight types — see InsightType.
     "gbp-lodging-gap",
+    "gbp-listing-discrepancy",
     "gbp-cta-gap",
     "gbp-metric-drop",
     "gbp-keyword-drop"
@@ -3887,6 +3908,7 @@ export {
   gbpKeywordImpressionListResponseSchema,
   gbpPlaceActionListResponseSchema,
   gbpLodgingListResponseSchema,
+  gbpPlaceDetailsListResponseSchema,
   gbpSummaryDtoSchema,
   withRetry,
   isRetryableHttpError,

package/dist/{chunk-AUR7VMQF.js → chunk-ZTVBTGDW.js}

@@ -8,7 +8,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-CKWHFAVB.js";
+} from "./chunk-PITZUUFV.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -54,14 +54,17 @@ import {
   gbpLocations,
   gbpLodgingSnapshots,
   gbpPlaceActions,
+  gbpPlaceDetails,
   getCrawlIssues,
   getLodging,
+  getPlaceDetails,
   getUrlInfo,
   groupRunsByCreatedAt,
   gscCoverageSnapshots,
   gscSearchData,
   gscUrlInspections,
   hashLodging,
+  hashPlaceDetails,
   insights,
   inspectUrl,
   installDuckdb,
@@ -90,7 +93,7 @@ import {
   runs,
   schedules,
   usageCounters
-} from "./chunk-3G3GAT3E.js";
+} from "./chunk-QZN3J35I.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -138,7 +141,7 @@ import {
   skillsClientSchema,
   validationError,
   withRetry
-} from "./chunk-DXWUBWBD.js";
+} from "./chunk-URPUUKLC.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -2692,6 +2695,21 @@ var perplexityAdapter = {
   }
 };
 
+// src/places-config.ts
+var DEFAULT_TIER = "atmosphere";
+var DEFAULT_REFRESH_INTERVAL_DAYS = 7;
+function parseTier(raw) {
+  return raw === "atmosphere" || raw === "pro" || raw === "off" ? raw : void 0;
+}
+function getPlacesConfig(config) {
+  const envKey = process.env.GOOGLE_PLACES_API_KEY?.trim();
+  const apiKey = envKey || config.places?.apiKey || void 0;
+  const tier = parseTier(process.env.GOOGLE_PLACES_TIER?.trim()) ?? config.places?.tier ?? DEFAULT_TIER;
+  const envInterval = Number(process.env.GOOGLE_PLACES_REFRESH_INTERVAL_DAYS);
+  const refreshIntervalDays = Number.isFinite(envInterval) && envInterval > 0 ? envInterval : config.places?.refreshIntervalDays ?? DEFAULT_REFRESH_INTERVAL_DAYS;
+  return { apiKey, tier, refreshIntervalDays };
+}
+
 // src/google-config.ts
 function ensureConnections(config) {
   if (!config.google) config.google = {};
@@ -3790,6 +3808,7 @@ async function executeGscSync(db, runId, projectId, opts) {
 // src/gbp-sync.ts
 import crypto5 from "crypto";
 import { eq as eq3, and as and3, desc, inArray as inArray2, lt } from "drizzle-orm";
+var MS_PER_DAY = 864e5;
 var log3 = createLogger("GbpSync");
 var LOCATION_CONCURRENCY = 4;
 var DEFAULT_DAYS_OF_METRICS = 30;
@@ -3849,6 +3868,7 @@ async function executeGbpSync(db, runId, projectId, opts) {
     const keywordsEnd = monthMinus(0);
     const trendMonths = Array.from({ length: KEYWORD_TREND_MONTHS }, (_, i) => monthMinus(i + 1));
     const keywordRetentionCutoff = monthKey(monthMinus(KEYWORD_HISTORY_RETENTION_MONTHS));
+    const { apiKey: placesApiKey, tier: placesTier, refreshIntervalDays: placesRefreshDays } = getPlacesConfig(opts.config);
     log3.info("sync.start", { runId, projectId, locations: locationRows.length, daysOfMetrics, monthsOfKeywords });
     const errors = /* @__PURE__ */ new Map();
     let okCount = 0;
@@ -3880,6 +3900,25 @@ async function executeGbpSync(db, runId, projectId, opts) {
           const lodgingHash = lodging ? hashLodging(lodging) : null;
           const latestLodging = lodging ? db.select().from(gbpLodgingSnapshots).where(and3(eq3(gbpLodgingSnapshots.projectId, projectId), eq3(gbpLodgingSnapshots.locationName, loc.locationName))).orderBy(desc(gbpLodgingSnapshots.syncedAt)).limit(1).get() : void 0;
           const lodgingChanged = lodging !== null && latestLodging?.contentHash !== lodgingHash;
+          let placeToWrite = null;
+          let placeToTouch = null;
+          if (placesTier !== "off" && placesApiKey && lodging !== null && loc.placeId) {
+            const latestPlace = db.select().from(gbpPlaceDetails).where(and3(eq3(gbpPlaceDetails.projectId, projectId), eq3(gbpPlaceDetails.locationName, loc.locationName))).orderBy(desc(gbpPlaceDetails.syncedAt)).limit(1).get();
+            const ageDays = latestPlace ? (Date.now() - new Date(latestPlace.syncedAt).getTime()) / MS_PER_DAY : Infinity;
+            if (ageDays >= placesRefreshDays) {
+              try {
+                const place = await getPlaceDetails(loc.placeId, placesApiKey, { tier: placesTier });
+                const hash = hashPlaceDetails(place);
+                if (!latestPlace || latestPlace.contentHash !== hash) {
+                  placeToWrite = { contentHash: hash, attributes: place, tier: placesTier, placeId: loc.placeId };
+                } else {
+                  placeToTouch = latestPlace.id;
+                }
+              } catch (placesErr) {
+                log3.warn("places.failed", { runId, location: loc.locationName, error: placesErr instanceof Error ? placesErr.message : String(placesErr) });
+              }
+            }
+          }
           const insertNow = (/* @__PURE__ */ new Date()).toISOString();
           db.transaction((tx) => {
             tx.delete(gbpDailyMetrics).where(and3(eq3(gbpDailyMetrics.projectId, projectId), eq3(gbpDailyMetrics.locationName, loc.locationName))).run();
@@ -3962,6 +4001,21 @@ async function executeGbpSync(db, runId, projectId, opts) {
                 syncRunId: runId
               }).run();
             }
+            if (placeToWrite) {
+              tx.insert(gbpPlaceDetails).values({
+                id: crypto5.randomUUID(),
+                projectId,
+                locationName: loc.locationName,
+                placeId: placeToWrite.placeId,
+                contentHash: placeToWrite.contentHash,
+                tier: placeToWrite.tier,
+                attributes: placeToWrite.attributes,
+                syncedAt: insertNow,
+                syncRunId: runId
+              }).run();
+            } else if (placeToTouch) {
+              tx.update(gbpPlaceDetails).set({ syncedAt: insertNow, syncRunId: runId }).where(eq3(gbpPlaceDetails.id, placeToTouch)).run();
+            }
             tx.update(gbpLocations).set({ syncedAt: insertNow, updatedAt: insertNow }).where(eq3(gbpLocations.id, loc.id)).run();
           });
           okCount++;
@@ -5562,7 +5616,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-UYVVKQ2K.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-RWVBWSB5.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -9776,6 +9830,7 @@ async function createServer(opts) {
       registerAgentRoutes(scope, { db: opts.db, sessionRegistry });
     },
     getGoogleAuthConfig: () => getGoogleAuthConfig(opts.config),
+    getPlacesConfig: () => getPlacesConfig(opts.config),
     googleConnectionStore,
     googleStateSecret,
     publicUrl: opts.config.publicUrl,

package/dist/cli.js

@@ -27,7 +27,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-AUR7VMQF.js";
+} from "./chunk-ZTVBTGDW.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -43,7 +43,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-CKWHFAVB.js";
+} from "./chunk-PITZUUFV.js";
 import {
   apiKeys,
   createClient,
@@ -51,7 +51,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-3G3GAT3E.js";
+} from "./chunk-QZN3J35I.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -67,7 +67,7 @@ import {
   notificationEventSchema,
   providerQuotaPolicySchema,
   resolveProviderInput
-} from "./chunk-DXWUBWBD.js";
+} from "./chunk-URPUUKLC.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -3069,6 +3069,23 @@ async function gbpLodging(project, opts) {
     console.log(`  ${l.locationName}  ${l.populatedGroupCount} attribute group(s)${note}`);
   }
 }
+async function gbpPlaces(project, opts) {
+  const client = getClient6();
+  const response = await client.listGbpPlaces(project, { locationName: opts.location });
+  if (opts.format === "json") {
+    console.log(JSON.stringify(response, null, 2));
+    return;
+  }
+  if (response.places.length === 0) {
+    console.log('No Places data \u2014 set a Places API key (places.apiKey / GOOGLE_PLACES_API_KEY) and run "canonry gbp sync" for lodging locations.');
+    return;
+  }
+  console.log(`${response.total} Places listing snapshot(s) \u2014 the amenities Google's public listing advertises:`);
+  for (const p of response.places) {
+    const amenities = p.amenities.length > 0 ? p.amenities.join(", ") : "(none detected)";
+    console.log(`  ${p.locationName}  [${p.tier}]  ${amenities}`);
+  }
+}
 function fmtDelta(pct2) {
   if (pct2 === null) return "n/a";
   return `${pct2 >= 0 ? "+" : ""}${pct2}%`;
@@ -3261,6 +3278,17 @@ var GBP_CLI_COMMANDS = [
       await gbpLodging(project, { location: getString(input.values, "location"), format: input.format });
     }
   },
+  {
+    path: ["gbp", "places"],
+    usage: "canonry gbp places <project> [--location <name>] [--format json]",
+    options: {
+      location: stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(input, "gbp.places", "canonry gbp places <project> [--location <name>] [--format json]");
+      await gbpPlaces(project, { location: getString(input.values, "location"), format: input.format });
+    }
+  },
   {
     path: ["gbp", "summary"],
     usage: "canonry gbp summary <project> [--location <name>] [--format json]",

package/dist/index.d.ts

@@ -144,6 +144,21 @@ interface AgentConfigEntry {
     /** Agent mode. Only 'disabled' is valid until the native loop ships. */
     mode?: 'disabled';
 }
+/**
+ * Google Places API config — supplemental rendered-listing data for GBP
+ * lodging locations (#648). The API key authenticates Place Details calls
+ * (`X-Goog-Api-Key`); it is NOT OAuth and is unrelated to `google.clientId`.
+ *   - `tier`: 'atmosphere' (default; amenity booleans for the cross-reference,
+ *     1k free calls/month) | 'pro' (cheaper, accessibility-only) | 'off'.
+ *   - `refreshIntervalDays`: minimum age before a location's Place Details is
+ *     re-fetched during gbp-sync (default 7) — the cost lever, since amenities
+ *     change rarely.
+ */
+interface PlacesConfigEntry {
+    apiKey?: string;
+    tier?: 'atmosphere' | 'pro' | 'off';
+    refreshIntervalDays?: number;
+}
 interface CanonryConfig {
     apiUrl: string;
     publicUrl?: string;
@@ -172,6 +187,7 @@ interface CanonryConfig {
     lastUpdateCheckAt?: string;
     lastKnownLatestVersion?: string;
     agent?: AgentConfigEntry;
+    places?: PlacesConfigEntry;
 }
 declare function loadConfig(): CanonryConfig;
 

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-AUR7VMQF.js";
+} from "./chunk-ZTVBTGDW.js";
 import {
   loadConfig
-} from "./chunk-CKWHFAVB.js";
-import "./chunk-3G3GAT3E.js";
-import "./chunk-DXWUBWBD.js";
+} from "./chunk-PITZUUFV.js";
+import "./chunk-QZN3J35I.js";
+import "./chunk-URPUUKLC.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-UYVVKQ2K.js → intelligence-service-RWVBWSB5.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-3G3GAT3E.js";
-import "./chunk-DXWUBWBD.js";
+} from "./chunk-QZN3J35I.js";
+import "./chunk-URPUUKLC.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,8 +3,8 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-CKWHFAVB.js";
-import "./chunk-DXWUBWBD.js";
+} from "./chunk-PITZUUFV.js";
+import "./chunk-URPUUKLC.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.60.2",
+  "version": "4.61.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -61,25 +61,26 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-api-client": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
-    "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "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-google-business-profile": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0"
+    "@ainyc/canonry-provider-local": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",