@canonry/canonry 7.47.1 → 7.48.0

package/dist/{chunk-QNXQHHCP.js → chunk-U2GU6MAC.js}

@@ -765,6 +765,7 @@ import {
   resultsClearRequestSchema,
   resultsClearResponseSchema,
   resultsExportDtoSchema,
+  retrievedSourceSchema,
   retryAfterDelayMs,
   roundRatio,
   runAdmissionDtoSchema,
@@ -915,7 +916,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-QS262E4F.js";
+} from "./chunk-NVKQVQ3C.js";
 
 // src/intelligence-service.ts
 import { eq as eq99, desc as desc45, asc as asc20, and as and82, ne as ne17, or as or24, inArray as inArray40, gte as gte26, lte as lte23, isNull as isNull19, sql as sql37, exists as exists2 } from "drizzle-orm";
@@ -3402,6 +3403,7 @@ var researchRunQueries = sqliteTable("research_run_queries", {
   groundingSources: text("grounding_sources", { mode: "json" }).$type().notNull().default([]),
   citedDomains: text("cited_domains", { mode: "json" }).$type().notNull().default([]),
   searchQueries: text("search_queries", { mode: "json" }).$type().notNull().default([]),
+  retrievedSources: text("retrieved_sources", { mode: "json" }).$type(),
   namedCompetitors: text("named_competitors", { mode: "json" }).$type().notNull().default([]),
   citedCompetitorDomains: text("cited_competitor_domains", { mode: "json" }).$type().notNull().default([]),
   answerMentioned: integer("answer_mentioned", { mode: "boolean" }),
@@ -8682,6 +8684,15 @@ var MIGRATION_VERSIONS = [
       `ALTER TABLE doctor_health_state ADD COLUMN urgent_receipts TEXT`,
       `ALTER TABLE site_liveness_state ADD COLUMN urgent_receipts TEXT`
     ]
+  },
+  {
+    // Pages an engine's searches listed or opened for a Research answer. NULL
+    // on every existing row and for engines that do not report retrievals.
+    version: 184,
+    name: "research-retrieved-sources",
+    statements: [
+      `ALTER TABLE research_run_queries ADD COLUMN retrieved_sources TEXT`
+    ]
   }
 ];
 var AERO_LEDGER_REBUILDS = [
@@ -22569,6 +22580,7 @@ async function competitorSuggestionRoutes(app) {
 // ../api-routes/src/runs.ts
 import crypto16 from "crypto";
 import { and as and22, eq as eq30, ne as ne7, asc as asc4, desc as desc11, inArray as inArray15, notInArray, or as or7, sql as sql11 } from "drizzle-orm";
+import { z as z3 } from "zod";
 import { gte as gte4 } from "drizzle-orm";
 
 // ../api-routes/src/run-fill.ts
@@ -23386,9 +23398,12 @@ function formatRun(row) {
 }
 function parseSnapshotRawResponse(raw) {
   const parsed = parseJsonColumn(raw, {});
+  const retrieved = z3.array(retrievedSourceSchema).safeParse(parsed.retrievedSources);
   return {
     groundingSources: parsed.groundingSources ?? [],
     searchQueries: parsed.searchQueries ?? [],
+    // Absent on engines that do not report retrievals and on older rows.
+    retrievedSources: retrieved.success ? retrieved.data : null,
     model: parsed.model ?? null
   };
 }
@@ -23480,6 +23495,7 @@ function loadRunDetail(app, run) {
       usage: s.usage,
       groundingSources: rawParsed.groundingSources,
       searchQueries: rawParsed.searchQueries,
+      retrievedSources: rawParsed.retrievedSources,
       createdAt: s.createdAt
     };
   });
@@ -40255,7 +40271,7 @@ function winnabilityClassRank(winnabilityClass) {
 }
 
 // ../api-routes/src/openapi-schemas.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 var SCHEMA_TABLE = {
   SentimentSummary: sentimentSummarySchema,
   SentimentSettings: sentimentSettingsSchema,
@@ -40541,7 +40557,7 @@ var SCHEMA_TABLE = {
   SnapshotListResponse: snapshotListResponseSchema,
   SnapshotReportDto: snapshotReportSchema,
   // The API accepts legacy phrases, but the public contract advertises queries.
-  SnapshotRequest: z3.object(snapshotRequestInputSchema.shape).omit({ phrases: true }),
+  SnapshotRequest: z4.object(snapshotRequestInputSchema.shape).omit({ phrases: true }),
   SourceBreakdownDto: sourceBreakdownDtoSchema,
   TelemetryEventAcceptedDto: telemetryEventAcceptedDtoSchema,
   FeedbackSubmission: feedbackSubmissionSchema,
@@ -40581,11 +40597,11 @@ var SCHEMA_TABLE = {
   // the API never returns this from a typed handler — it's emitted by the
   // global error handler. Codegen consumers reference it through the
   // ErrorEnvelope ref so error shape is part of the public contract.
-  ErrorEnvelope: z3.object({
-    error: z3.object({
-      code: z3.string(),
-      message: z3.string(),
-      details: z3.unknown().optional()
+  ErrorEnvelope: z4.object({
+    error: z4.object({
+      code: z4.string(),
+      message: z4.string(),
+      details: z4.unknown().optional()
     })
   })
 };
@@ -40610,7 +40626,7 @@ function buildComponentSchemas() {
   const out = {};
   for (const [name, schema] of Object.entries(SCHEMA_TABLE)) {
     const io = INPUT_FORM_SCHEMAS.has(name) ? "input" : "output";
-    const json = z3.toJSONSchema(schema, { target: "openapi-3.0", io });
+    const json = z4.toJSONSchema(schema, { target: "openapi-3.0", io });
     addNullToNullableEnums(json);
     out[name] = json;
   }
@@ -53339,18 +53355,18 @@ function parseReviewLimit(value) {
 // ../api-routes/src/google-marketing.ts
 import crypto37 from "crypto";
 import { and as and51, desc as desc30, eq as eq63, isNull as isNull11, lt as lt9, ne as ne12, or as or15, sql as sql24 } from "drizzle-orm";
-import { z as z4 } from "zod";
-var snapshotPageQuerySchema = z4.object({
-  limit: z4.coerce.number().int().min(1).max(GOOGLE_MARKETING_STORED_SNAPSHOT_PAGE_MAX).optional(),
-  cursor: z4.string().min(1).optional()
+import { z as z5 } from "zod";
+var snapshotPageQuerySchema = z5.object({
+  limit: z5.coerce.number().int().min(1).max(GOOGLE_MARKETING_STORED_SNAPSHOT_PAGE_MAX).optional(),
+  cursor: z5.string().min(1).optional()
 }).strict();
-var oauthStateSchema = z4.object({
-  projectId: z4.string().min(1),
-  projectName: z4.string().min(1),
+var oauthStateSchema = z5.object({
+  projectId: z5.string().min(1),
+  projectName: z5.string().min(1),
   provider: googleMarketingProviderSchema,
-  redirectUri: z4.string().url(),
-  nonce: z4.string().regex(/^[\w-]{43}$/),
-  issuedAt: z4.number()
+  redirectUri: z5.string().url(),
+  nonce: z5.string().regex(/^[\w-]{43}$/),
+  issuedAt: z5.number()
 }).strict();
 var GOOGLE_MARKETING_OAUTH_PENDING_FLOW_MAX = 256;
 var GOOGLE_MARKETING_OAUTH_COOKIE_PREFIX = "canonry_google_marketing_oauth_";
@@ -53494,7 +53510,7 @@ function decodeSnapshotCursor(value) {
   try {
     const decoded = Buffer.from(value, "base64url");
     if (decoded.toString("base64url") !== value) throw new Error("Non-canonical cursor");
-    const parsed = z4.object({ capturedAt: z4.string().min(1), id: z4.string().min(1) }).strict().parse(JSON.parse(decoded.toString()));
+    const parsed = z5.object({ capturedAt: z5.string().min(1), id: z5.string().min(1) }).strict().parse(JSON.parse(decoded.toString()));
     return parsed;
   } catch {
     throw validationError("Invalid Google Marketing snapshot cursor.");
@@ -53793,7 +53809,7 @@ function latestGtmSnapshot(app, projectId) {
   if (!snapshot || snapshot.metadata.id !== connection.lastSnapshotId || snapshot.metadata.connectionId !== connection.id || snapshot.metadata.accountId !== connection.selectedAccountId || snapshot.metadata.containerId !== connection.selectedContainerId || snapshot.metadata.workspaceId !== connection.selectedWorkspaceId || snapshot.metadata.capturedAt !== connection.lastSnapshotAt || snapshot.payload.kind !== GtmSnapshotKinds.container) return null;
   return snapshot;
 }
-var googleAdsPerformanceQuerySchema = z4.object({
+var googleAdsPerformanceQuerySchema = z5.object({
   window: googleAdsMetricsWindowSchema.optional()
 }).strict();
 var GOOGLE_ADS_PERFORMANCE_WINDOW_DAYS = {
@@ -93416,7 +93432,7 @@ async function technicalAeoRoutes(app, opts) {
 
 // ../api-routes/src/research.ts
 import crypto55 from "crypto";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 import { and as and79, count as count8, desc as desc44, eq as eq96, gte as gte25, lt as lt14, or as or23, sql as sql36 } from "drizzle-orm";
 var sameLocation = (a, b) => a.label === b.label && a.city === b.city && a.region === b.region && a.country === b.country && a.timezone === b.timezone;
 var BATCH_RECEIPT_PREFIX = "__canonry_research_batch__:";
@@ -93638,7 +93654,7 @@ function assertSameDirectResearchRequest(existing, input, hash2) {
   };
   if (crypto55.createHash("sha256").update(JSON.stringify(normalized)).digest("hex") !== existing.requestHash) throw alreadyExists("Research idempotency key", input.idempotencyKey);
 }
-var researchCursorSchema = z5.object({ projectId: z5.string().min(1), createdAt: z5.string().datetime({ offset: true }), id: z5.string().min(1).max(256) }).strict();
+var researchCursorSchema = z6.object({ projectId: z6.string().min(1), createdAt: z6.string().datetime({ offset: true }), id: z6.string().min(1).max(256) }).strict();
 function parseResearchCursor(value, projectId) {
   try {
     if (value.length > 2048 || !/^[\w-]+$/.test(value)) throw new Error("Invalid encoding");
@@ -93747,7 +93763,7 @@ function serializeRun(row) {
   return { id: row.id, projectId: row.projectId, status: row.status, provider: row.provider, requestedModel: row.requestedModel, resolvedModel: row.resolvedModel, location: row.location ?? null, scope: row.scope ?? null, template: row.template ?? null, totalQueries: row.totalQueries, completedQueries: row.completedQueries, failedQueries: row.failedQueries, error: row.error, initiatedBy: row.initiatedBy ?? null, startedAt: row.startedAt, finishedAt: row.finishedAt, createdAt: row.createdAt };
 }
 function serializeQuery(row) {
-  return { id: row.id, position: row.position, query: row.queryText, queryClass: row.queryClass ?? null, status: row.status, requestedModel: row.requestedModel, resolvedModel: row.resolvedModel, servedModel: row.servedModel, answerText: row.answerText, groundingSources: row.groundingSources, citedDomains: row.citedDomains, searchQueries: row.searchQueries, namedCompetitors: row.namedCompetitors, citedCompetitorDomains: row.citedCompetitorDomains, answerMentioned: row.answerMentioned, citationState: row.citationState, error: row.error, startedAt: row.startedAt, finishedAt: row.finishedAt, createdAt: row.createdAt };
+  return { id: row.id, position: row.position, query: row.queryText, queryClass: row.queryClass ?? null, status: row.status, requestedModel: row.requestedModel, resolvedModel: row.resolvedModel, servedModel: row.servedModel, answerText: row.answerText, groundingSources: row.groundingSources, citedDomains: row.citedDomains, searchQueries: row.searchQueries, retrievedSources: row.retrievedSources ?? null, namedCompetitors: row.namedCompetitors, citedCompetitorDomains: row.citedCompetitorDomains, answerMentioned: row.answerMentioned, citationState: row.citationState, error: row.error, startedAt: row.startedAt, finishedAt: row.finishedAt, createdAt: row.createdAt };
 }
 function researchPrincipal(request) {
   const principal = request.principal;

package/dist/{cli-catalog-MRYQK7LI.js → cli-catalog-NJPHC55G.js}

@@ -3,10 +3,10 @@ import {
   buildCliCatalog,
   printCliCatalog,
   renderTopLevelHelp
-} from "./chunk-66K6U5H5.js";
-import "./chunk-DGKSQ5QD.js";
+} from "./chunk-P6KH6N4Z.js";
+import "./chunk-AKDSQTHE.js";
 import "./chunk-HGMYEDAQ.js";
-import "./chunk-QS262E4F.js";
+import "./chunk-NVKQVQ3C.js";
 export {
   CLI_ROOT_SUMMARIES,
   buildCliCatalog,

package/dist/cli-commands-MVIT7XNN.js

@@ -0,0 +1,15 @@
+import {
+  REGISTERED_CLI_COMMANDS
+} from "./chunk-PTDX75HP.js";
+import "./chunk-BNZ3N6UX.js";
+import "./chunk-CS4POCLI.js";
+import "./chunk-AKDSQTHE.js";
+import "./chunk-RB2F4D3Z.js";
+import "./chunk-JPFZ4CXQ.js";
+import "./chunk-5KCJQO4I.js";
+import "./chunk-HGMYEDAQ.js";
+import "./chunk-U2GU6MAC.js";
+import "./chunk-NVKQVQ3C.js";
+export {
+  REGISTERED_CLI_COMMANDS
+};

package/dist/cli.js

@@ -2,18 +2,18 @@
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-HQS2Y7HO.js";
+} from "./chunk-NPYNNEFP.js";
 import {
   accessFilterFromArgs,
   dispatchRegisteredCommand,
   printCliCatalog
-} from "./chunk-66K6U5H5.js";
+} from "./chunk-P6KH6N4Z.js";
 import {
   REGISTERED_CLI_COMMANDS,
   buildSetupState,
   consumePendingServeHandoff,
   serveCommand
-} from "./chunk-XCS3JXN2.js";
+} from "./chunk-PTDX75HP.js";
 import {
   checkLatestVersionForCli,
   cliRuntimeContext,
@@ -27,14 +27,14 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent
-} from "./chunk-IYAUKA7Z.js";
-import "./chunk-CIYCCA2I.js";
+} from "./chunk-BNZ3N6UX.js";
+import "./chunk-CS4POCLI.js";
 import {
   resolveCliAccess
-} from "./chunk-DGKSQ5QD.js";
+} from "./chunk-AKDSQTHE.js";
 import "./chunk-RB2F4D3Z.js";
-import "./chunk-JNBPNW7P.js";
-import "./chunk-XHRJYIJQ.js";
+import "./chunk-JPFZ4CXQ.js";
+import "./chunk-5KCJQO4I.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -42,10 +42,10 @@ import {
   printCliError,
   usageError
 } from "./chunk-HGMYEDAQ.js";
-import "./chunk-QNXQHHCP.js";
+import "./chunk-U2GU6MAC.js";
 import {
   OperationAccesses
-} from "./chunk-QS262E4F.js";
+} from "./chunk-NVKQVQ3C.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";

package/dist/{demo-server-GPNX3EXT.js → demo-server-CX2FZGR5.js}

@@ -5,11 +5,11 @@ import {
   computeFactorAverages,
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-JNBPNW7P.js";
+} from "./chunk-JPFZ4CXQ.js";
 import {
   PACKAGE_VERSION,
   canonryMcpTools
-} from "./chunk-XHRJYIJQ.js";
+} from "./chunk-5KCJQO4I.js";
 import "./chunk-HGMYEDAQ.js";
 import {
   HISTORY_WINDOW_RUNS,
@@ -86,7 +86,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-QNXQHHCP.js";
+} from "./chunk-U2GU6MAC.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -116,7 +116,7 @@ import {
   roundPreservingTotal,
   siteAuditPageFactorSchema,
   wilsonInterval
-} from "./chunk-QS262E4F.js";
+} from "./chunk-NVKQVQ3C.js";
 
 // src/demo-server.ts
 import { dirname, join as join2 } from "path";

package/dist/index.d.ts

@@ -22863,6 +22863,35 @@ declare const researchRunQueries: drizzle_orm_sqlite_core.SQLiteTableWithColumns
         }, {}, {
             $type: string[];
         }>;
+        retrievedSources: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "retrieved_sources";
+            tableName: "research_run_queries";
+            dataType: "json";
+            columnType: "SQLiteTextJson";
+            data: {
+                uri: string;
+                title: string;
+                kind: "search-result" | "page-read";
+                query: string | null;
+            }[];
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: {
+                uri: string;
+                title: string;
+                kind: "search-result" | "page-read";
+                query: string | null;
+            }[];
+        }>;
         namedCompetitors: drizzle_orm_sqlite_core.SQLiteColumn<{
             name: "named_competitors";
             tableName: "research_run_queries";

package/dist/index.js

@@ -3,15 +3,15 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-IYAUKA7Z.js";
+} from "./chunk-BNZ3N6UX.js";
 import {
   loadConfig
-} from "./chunk-CIYCCA2I.js";
-import "./chunk-JNBPNW7P.js";
-import "./chunk-XHRJYIJQ.js";
+} from "./chunk-CS4POCLI.js";
+import "./chunk-JPFZ4CXQ.js";
+import "./chunk-5KCJQO4I.js";
 import "./chunk-HGMYEDAQ.js";
-import "./chunk-QNXQHHCP.js";
-import "./chunk-QS262E4F.js";
+import "./chunk-U2GU6MAC.js";
+import "./chunk-NVKQVQ3C.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-LZ3MC6G6.js → intelligence-service-6INMSEAQ.js}

@@ -1,8 +1,8 @@
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService
-} from "./chunk-QNXQHHCP.js";
-import "./chunk-QS262E4F.js";
+} from "./chunk-U2GU6MAC.js";
+import "./chunk-NVKQVQ3C.js";
 export {
   HISTORY_WINDOW_RUNS,
   IntelligenceService

package/dist/mcp.js

@@ -1,16 +1,16 @@
 import {
   autoSyncSkills
-} from "./chunk-HQS2Y7HO.js";
+} from "./chunk-NPYNNEFP.js";
 import {
   createApiClient,
   createCanonryMcpServer
-} from "./chunk-CIYCCA2I.js";
-import "./chunk-XHRJYIJQ.js";
+} from "./chunk-CS4POCLI.js";
+import "./chunk-5KCJQO4I.js";
 import "./chunk-HGMYEDAQ.js";
 import {
   isReadOnlyKey,
   updateCheckEnvOptOut
-} from "./chunk-QS262E4F.js";
+} from "./chunk-NVKQVQ3C.js";
 
 // src/mcp/cli.ts
 import { randomUUID } from "crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "7.47.1",
+  "version": "7.48.0",
   "type": "module",
   "description": "Self-hosted AI visibility (AEO) platform: track how ChatGPT, Claude, Gemini, and Perplexity cite your domain, join it with Search Console, GA4, server-side traffic, and paid media, and fix what you find through agent tools (CLI, REST, MCP). Local SQLite.",
   "keywords": [
@@ -85,34 +85,34 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@canonry/canonry-web": "0.0.0",
     "@canonry/canonry-api-client": "0.0.0",
-    "@canonry/canonry-contracts": "0.0.0",
     "@canonry/canonry-config": "0.0.0",
+    "@canonry/canonry-web": "0.0.0",
     "@canonry/canonry-db": "0.0.0",
+    "@canonry/canonry-contracts": "0.0.0",
     "@canonry/canonry-api-routes": "0.0.0",
     "@canonry/canonry-integration-bing": "0.0.0",
+    "@canonry/canonry-integration-cloud-run": "0.0.0",
     "@canonry/canonry-integration-cloudflare-worker": "0.0.0",
     "@canonry/canonry-integration-cloudflare-queue": "0.0.0",
-    "@canonry/canonry-integration-cloud-run": "0.0.0",
-    "@canonry/canonry-integration-google": "0.0.0",
     "@canonry/canonry-integration-google-ads": "0.0.0",
+    "@canonry/canonry-integration-commoncrawl": "0.0.0",
     "@canonry/canonry-integration-google-business-profile": "0.0.0",
     "@canonry/canonry-integration-google-places": "0.0.0",
-    "@canonry/canonry-integration-commoncrawl": "0.0.0",
-    "@canonry/canonry-integration-google-tag-manager": "0.0.0",
+    "@canonry/canonry-integration-google": "0.0.0",
     "@canonry/canonry-integration-openai-ads": "0.0.0",
-    "@canonry/canonry-integration-traffic": "0.0.0",
+    "@canonry/canonry-integration-google-tag-manager": "0.0.0",
     "@canonry/canonry-integration-wordpress": "0.0.0",
+    "@canonry/canonry-integration-traffic": "0.0.0",
     "@canonry/canonry-provider-cdp": "0.0.0",
-    "@canonry/canonry-intelligence": "0.0.0",
+    "@canonry/canonry-provider-claude": "0.0.0",
     "@canonry/canonry-provider-gemini": "0.0.0",
+    "@canonry/canonry-intelligence": "0.0.0",
     "@canonry/canonry-provider-local": "0.0.0",
     "@canonry/canonry-provider-muse": "0.0.0",
     "@canonry/canonry-provider-openai": "0.0.0",
     "@canonry/canonry-provider-perplexity": "0.0.0",
-    "@canonry/canonry-integration-typesafe": "0.0.0",
-    "@canonry/canonry-provider-claude": "0.0.0"
+    "@canonry/canonry-integration-typesafe": "0.0.0"
   },
   "scripts": {
     "build": "pnpm run build:cli && pnpm run build:web",

package/dist/cli-commands-ZX7GLZZT.js

@@ -1,15 +0,0 @@
-import {
-  REGISTERED_CLI_COMMANDS
-} from "./chunk-XCS3JXN2.js";
-import "./chunk-IYAUKA7Z.js";
-import "./chunk-CIYCCA2I.js";
-import "./chunk-DGKSQ5QD.js";
-import "./chunk-RB2F4D3Z.js";
-import "./chunk-JNBPNW7P.js";
-import "./chunk-XHRJYIJQ.js";
-import "./chunk-HGMYEDAQ.js";
-import "./chunk-QNXQHHCP.js";
-import "./chunk-QS262E4F.js";
-export {
-  REGISTERED_CLI_COMMANDS
-};