@ainyc/canonry 4.78.0 → 4.81.0

package/assets/assets/{trash-2-B_UtEEm8.js → trash-2-BQ69cGl0.js}

@@ -1 +1 @@
-import{c}from"./index-D9smxU6R.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-DhdFTQkU.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-D9smxU6R.js"></script>
+    <script type="module" crossorigin src="./assets/index-DhdFTQkU.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/vendor-tanstack-Dq7p98wZ.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-radix-B57xfQbP.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-recharts-ClRVR6aX.js">

package/dist/{chunk-XI6YSTGE.js → chunk-6XOZSS3Y.js}

@@ -2,6 +2,7 @@ import {
   AGENT_MEMORY_KEY_MAX_LENGTH,
   AGENT_MEMORY_VALUE_MAX_BYTES,
   DISCOVERY_MAX_PROBES_CAP,
+  backlinkSourceSchema,
   competitorBatchRequestSchema,
   discoveryBucketSchema,
   discoveryCompetitorTypeSchema,
@@ -22,7 +23,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-KPN22EWK.js";
+} from "./chunk-GMT3YPLT.js";
 
 // src/config.ts
 import fs from "fs";
@@ -2193,6 +2194,94 @@ var getApiV1ProjectsByNameGbpSummary = (options) => {
     ...options
   });
 };
+var postApiV1ProjectsByNameAdsConnect = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/connect",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var deleteApiV1ProjectsByNameAdsConnection = (options) => {
+  return (options.client ?? client).delete({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/connection",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameAdsStatus = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/status",
+    ...options
+  });
+};
+var postApiV1ProjectsByNameAdsSync = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/sync",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameAdsCampaigns = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/campaigns",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameAdsInsights = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/insights",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameAdsSummary = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/summary",
+    ...options
+  });
+};
 var postApiV1ProjectsByNameBingConnect = (options) => {
   return (options.client ?? client).post({
     security: [
@@ -3133,6 +3222,30 @@ var getApiV1ProjectsByNameBacklinksHistory = (options) => {
     ...options
   });
 };
+var getApiV1ProjectsByNameBacklinksSources = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/backlinks/sources",
+    ...options
+  });
+};
+var postApiV1ProjectsByNameBacklinksBingSync = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/backlinks/bing-sync",
+    ...options
+  });
+};
 var postApiV1ProjectsByNameTrafficConnectCloudRun = (options) => {
   return (options.client ?? client).post({
     security: [
@@ -4129,6 +4242,41 @@ var ApiClient = class {
       })
     );
   }
+  async adsConnect(project, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsConnect({ client: this.heyClient, path: { name: project }, body })
+    );
+  }
+  async adsDisconnect(project) {
+    return this.invoke(
+      () => deleteApiV1ProjectsByNameAdsConnection({ client: this.heyClient, path: { name: project } })
+    );
+  }
+  async getAdsStatus(project) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAdsStatus({ client: this.heyClient, path: { name: project } })
+    );
+  }
+  async triggerAdsSync(project) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsSync({ client: this.heyClient, path: { name: project } })
+    );
+  }
+  async getAdsCampaigns(project) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAdsCampaigns({ client: this.heyClient, path: { name: project } })
+    );
+  }
+  async getAdsInsights(project, query) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAdsInsights({ client: this.heyClient, path: { name: project }, query })
+    );
+  }
+  async getAdsSummary(project) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAdsSummary({ client: this.heyClient, path: { name: project } })
+    );
+  }
   async listGbpMetrics(project, opts) {
     return this.invoke(
       () => getApiV1ProjectsByNameGbpMetrics({
@@ -4937,6 +5085,23 @@ var ApiClient = class {
       })
     );
   }
+  async backlinksBingSync(project) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameBacklinksBingSync({
+        client: this.heyClient,
+        path: { name: project }
+      })
+    );
+  }
+  async backlinksSources(project, opts = {}) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameBacklinksSources({
+        client: this.heyClient,
+        path: { name: project },
+        query: { excludeCrawlers: opts.excludeCrawlers ? "1" : void 0 }
+      })
+    );
+  }
   async backlinksSummary(project, opts = {}) {
     return this.invoke(
       () => getApiV1ProjectsByNameBacklinksSummary({
@@ -4944,7 +5109,8 @@ var ApiClient = class {
         path: { name: project },
         query: {
           release: opts.release,
-          excludeCrawlers: opts.excludeCrawlers ? "1" : void 0
+          excludeCrawlers: opts.excludeCrawlers ? "1" : void 0,
+          source: opts.source
         }
       })
     );
@@ -4958,14 +5124,19 @@ var ApiClient = class {
           limit: opts.limit,
           offset: opts.offset,
           release: opts.release,
-          excludeCrawlers: opts.excludeCrawlers ? "1" : void 0
+          excludeCrawlers: opts.excludeCrawlers ? "1" : void 0,
+          source: opts.source
         }
       })
     );
   }
-  async backlinksHistory(project) {
+  async backlinksHistory(project, opts = {}) {
     return this.invoke(
-      () => getApiV1ProjectsByNameBacklinksHistory({ client: this.heyClient, path: { name: project } })
+      () => getApiV1ProjectsByNameBacklinksHistory({
+        client: this.heyClient,
+        path: { name: project },
+        query: { source: opts.source }
+      })
     );
   }
 };
@@ -5147,6 +5318,13 @@ var gbpLocationScopedInputSchema = z2.object({
 var gbpAccountsInputSchema = z2.object({
   project: projectNameSchema
 });
+var adsInsightsInputSchema = z2.object({
+  project: projectNameSchema,
+  level: z2.enum(["campaign", "ad_group"]).optional(),
+  entityId: z2.string().optional(),
+  from: z2.string().optional(),
+  to: z2.string().optional()
+});
 var keywordsInputSchema = z2.object({
   project: projectNameSchema,
   request: keywordBatchRequestSchema
@@ -5202,7 +5380,11 @@ var contentMapInputSchema = z2.object({
 var backlinksDomainsInputSchema = z2.object({
   project: projectNameSchema,
   limit: z2.number().int().positive().max(200).optional().describe("Max linking-domain rows. Default 50, max 200."),
-  release: z2.string().optional().describe("Common Crawl release id (e.g., cc-main-2026-jan-feb-mar). Omit for the most recent release with data.")
+  release: z2.string().optional().describe("Window id (Common Crawl release e.g. cc-main-2026-jan-feb-mar, or Bing window e.g. bing-2026-06-15). Omit for the most recent window with data."),
+  source: backlinkSourceSchema.optional().describe("Backlink source: commoncrawl (default) or bing-webmaster.")
+});
+var backlinksSourcesInputSchema = z2.object({
+  project: projectNameSchema
 });
 var memoryUpsertInputSchema = z2.object({
   project: projectNameSchema,
@@ -5692,7 +5874,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_backlinks_domains",
     title: "List backlink domains",
-    description: "Backlink summary and top linking domains from the most recent ready Common Crawl release for a project. Off-site authority signal that correlates with citation likelihood. Returns null summary when no release sync has completed for this workspace.",
+    description: "Source-aware backlink summary + top linking domains for a project. `source=commoncrawl` (default) reads the most recent ready Common Crawl release; `source=bing-webmaster` reads the latest live Bing Webmaster inbound-link window. Off-site authority signal that correlates with citation likelihood. Returns null summary when the source has no data yet.",
     access: "read",
     tier: "setup",
     inputSchema: backlinksDomainsInputSchema,
@@ -5700,9 +5882,21 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/backlinks/domains"],
     handler: (client2, input) => client2.backlinksDomains(input.project, {
       limit: input.limit ?? 50,
-      release: input.release
+      release: input.release,
+      source: input.source
     })
   }),
+  defineTool({
+    name: "canonry_backlinks_sources",
+    title: "Backlink source availability",
+    description: "Reports which backlink sources are set up for a project (commoncrawl, bing-webmaster): connected, has data, latest window, linking-domain count, and freshness. Use to decide whether to read CC vs Bing or prompt the operator to connect a source.",
+    access: "read",
+    tier: "setup",
+    inputSchema: backlinksSourcesInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/backlinks/sources"],
+    handler: (client2, input) => client2.backlinksSources(input.project)
+  }),
   defineTool({
     name: "canonry_settings_get",
     title: "Get settings",
@@ -6564,6 +6758,62 @@ var canonryMcpTools = [
       sitemapUrl: input.sitemapUrl,
       limit: input.limit
     })
+  }),
+  // ----- OpenAI ads (ChatGPT ads) -----
+  defineTool({
+    name: "canonry_ads_status",
+    title: "OpenAI ads connection status",
+    description: "Connection status and last sync time for the project's OpenAI ad account (ChatGPT ads).",
+    access: "read",
+    tier: "ads",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/ads/status"],
+    handler: (client2, input) => client2.getAdsStatus(input.project)
+  }),
+  defineTool({
+    name: "canonry_ads_campaigns",
+    title: "List synced ad campaigns",
+    description: "Synced campaign snapshots with nested ad groups (context hints \u2014 the targeting primitive) and ads. Paid-surface structure; never conflate with organic cited/mentioned signals.",
+    access: "read",
+    tier: "ads",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/ads/campaigns"],
+    handler: (client2, input) => client2.getAdsCampaigns(input.project)
+  }),
+  defineTool({
+    name: "canonry_ads_insights",
+    title: "Daily paid-performance rollups",
+    description: "Daily paid-performance rollups per level (campaign/ad_group). Spend is integer micros; ctr/cpcMicros are derived server-side (null on zero denominators).",
+    access: "read",
+    tier: "ads",
+    inputSchema: adsInsightsInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/ads/insights"],
+    handler: (client2, input) => client2.getAdsInsights(input.project, compactStringParams(input, ["level", "entityId", "from", "to"]))
+  }),
+  defineTool({
+    name: "canonry_ads_summary",
+    title: "Paid-performance summary",
+    description: "Composite paid summary: campaign/ad-group/ad counts, campaign-level totals (impressions, clicks, spend micros, derived ctr/cpc) and the covered date window.",
+    access: "read",
+    tier: "ads",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/ads/summary"],
+    handler: (client2, input) => client2.getAdsSummary(input.project)
+  }),
+  defineTool({
+    name: "canonry_ads_sync",
+    title: "Trigger ads sync",
+    description: "Trigger an ads-sync run (entity snapshots + daily paid-performance rollups) for the connected OpenAI ad account. Returns the run id; poll canonry_run_get for status.",
+    access: "write",
+    tier: "ads",
+    inputSchema: projectInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/sync"],
+    handler: (client2, input) => client2.triggerAdsSync(input.project)
   })
 ];
 var CANONRY_MCP_TOOL_COUNT = canonryMcpTools.length;

package/dist/{chunk-KPN22EWK.js → chunk-GMT3YPLT.js}

@@ -383,7 +383,8 @@ var runKindSchema = z3.enum([
   "traffic-sync",
   "aeo-discover-seed",
   "aeo-discover-probe",
-  "gbp-sync"
+  "gbp-sync",
+  "ads-sync"
 ]);
 var RunKinds = runKindSchema.enum;
 var runTriggerSchema = z3.enum(["manual", "scheduled", "config-apply", "backfill", "probe"]);
@@ -1618,7 +1619,7 @@ var siteAuditRunResponseSchema = z14.object({
 
 // ../contracts/src/schedule.ts
 import { z as z15 } from "zod";
-var schedulableRunKindSchema = z15.enum(["answer-visibility", "traffic-sync", "gbp-sync", "data-refresh", "backlinks-sync", "site-audit"]);
+var schedulableRunKindSchema = z15.enum(["answer-visibility", "traffic-sync", "gbp-sync", "data-refresh", "backlinks-sync", "site-audit", "ads-sync"]);
 var SchedulableRunKinds = schedulableRunKindSchema.enum;
 var scheduleDtoSchema = z15.object({
   id: z15.string(),
@@ -2500,6 +2501,22 @@ var agentMemoryDeleteRequestSchema = z21.object({
 
 // ../contracts/src/backlinks.ts
 import { z as z22 } from "zod";
+var backlinkSourceSchema = z22.enum(["commoncrawl", "bing-webmaster"]);
+var BacklinkSources = backlinkSourceSchema.enum;
+function computeBacklinkSummaryMetrics(rows) {
+  if (rows.length === 0) {
+    return { totalLinkingDomains: 0, totalHosts: 0, top10HostsShare: "0" };
+  }
+  const sorted = [...rows].sort((a, b) => b.numHosts - a.numHosts);
+  const totalHosts = sorted.reduce((acc, r) => acc + r.numHosts, 0);
+  const top10Hosts = sorted.slice(0, 10).reduce((acc, r) => acc + r.numHosts, 0);
+  const share = totalHosts > 0 ? top10Hosts / totalHosts : 0;
+  return {
+    totalLinkingDomains: rows.length,
+    totalHosts,
+    top10HostsShare: share.toFixed(6)
+  };
+}
 var ccReleaseSyncStatusSchema = z22.enum(["queued", "downloading", "querying", "ready", "failed"]);
 var CcReleaseSyncStatuses = ccReleaseSyncStatusSchema.enum;
 var ccReleaseSyncDtoSchema = z22.object({
@@ -2525,16 +2542,24 @@ var ccReleaseSyncDtoSchema = z22.object({
 });
 var backlinkDomainDtoSchema = z22.object({
   linkingDomain: z22.string(),
-  numHosts: z22.number().int()
+  // For Common Crawl this is the count of distinct hosts within the linking
+  // domain; for Bing Webmaster it is the count of distinct linking pages (URLs)
+  // from that linking host. Read alongside `source` — the unit differs per source.
+  numHosts: z22.number().int(),
+  source: backlinkSourceSchema
 });
 var backlinkSummaryDtoSchema = z22.object({
   projectId: z22.string(),
+  // Window identifier. Common Crawl uses the release slug
+  // (`cc-main-YYYY-<mon>-<mon>-<mon>`); Bing Webmaster uses a synthetic
+  // per-sync-day window (`bing-YYYY-MM-DD`).
   release: z22.string(),
   targetDomain: z22.string(),
   totalLinkingDomains: z22.number().int(),
   totalHosts: z22.number().int(),
   top10HostsShare: z22.string(),
   queriedAt: z22.string(),
+  source: backlinkSourceSchema,
   // Populated when the response is filtered (e.g. ?excludeCrawlers=1).
   // Counts the rows omitted from totalLinkingDomains/totalHosts so callers
   // can show "N hidden" hints without re-deriving them.
@@ -2542,6 +2567,9 @@ var backlinkSummaryDtoSchema = z22.object({
   excludedHosts: z22.number().int().optional()
 });
 var backlinkListResponseSchema = z22.object({
+  // The source this response was filtered to (defaults to commoncrawl when the
+  // caller omits `?source`).
+  source: backlinkSourceSchema,
   summary: backlinkSummaryDtoSchema.nullable(),
   total: z22.number().int(),
   rows: z22.array(backlinkDomainDtoSchema)
@@ -2551,7 +2579,38 @@ var backlinkHistoryEntrySchema = z22.object({
   totalLinkingDomains: z22.number().int(),
   totalHosts: z22.number().int(),
   top10HostsShare: z22.string(),
-  queriedAt: z22.string()
+  queriedAt: z22.string(),
+  source: backlinkSourceSchema
+});
+var backlinkSourceAvailabilityDtoSchema = z22.object({
+  source: backlinkSourceSchema,
+  /**
+   * The source is set up for this project:
+   *  - commoncrawl: `autoExtractBacklinks` enabled AND a `ready` release sync exists.
+   *  - bing-webmaster: a Bing Webmaster connection exists for the project domain.
+   */
+  connected: z22.boolean(),
+  /** Backlink rows exist for this project + source. */
+  hasData: z22.boolean(),
+  /** Latest window id with data for this source, null when none. */
+  latestRelease: z22.string().nullable(),
+  /**
+   * Linking-domain count in the latest window. Excludes crawler/proxy hosts only
+   * when the request sets `?excludeCrawlers=1` (default off, matching the summary
+   * and domains endpoints); the dashboard passes it so the switcher pill matches
+   * the metric card.
+   */
+  totalLinkingDomains: z22.number().int(),
+  /** Freshness: `queriedAt` of the latest summary for this source, null when none. */
+  lastSyncedAt: z22.string().nullable()
+});
+var backlinkSourcesResponseSchema = z22.object({
+  projectId: z22.string(),
+  targetDomain: z22.string(),
+  /** Availability for every known source, in a stable order. */
+  sources: z22.array(backlinkSourceAvailabilityDtoSchema),
+  anyConnected: z22.boolean(),
+  anyData: z22.boolean()
 });
 var backlinksInstallStatusDtoSchema = z22.object({
   duckdbInstalled: z22.boolean(),
@@ -3022,6 +3081,17 @@ function absolutizeProjectUrl(url, canonicalDomain) {
   if (trimmed.startsWith("/")) return `https://${host}${trimmed}`;
   return `https://${host}/${trimmed}`;
 }
+function hostOf(value) {
+  if (value == null) return null;
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+  try {
+    const url = trimmed.includes("://") ? new URL(trimmed) : new URL(`https://${trimmed}`);
+    return url.hostname.replace(/^www\./, "").toLowerCase();
+  } catch {
+    return null;
+  }
+}
 function normalizeUrlPath(input) {
   if (input == null) return null;
   let trimmed = input.trim();
@@ -4257,6 +4327,129 @@ function formatDeltaCopy(d, suffix, windowLabel = "vs prior 7 days") {
   return `Flat ${windowLabel} (${formatNumber(d.prior)} ${suffix})`;
 }
 
+// ../contracts/src/ads.ts
+import { z as z30 } from "zod";
+var adsConnectRequestSchema = z30.object({
+  /** Ads Manager "SDK key" scoped to one ad account. Stored in config.yaml, never the DB. */
+  apiKey: z30.string().min(1)
+});
+var adsConnectionStatusDtoSchema = z30.object({
+  connected: z30.boolean(),
+  adAccountId: z30.string().nullable().optional(),
+  displayName: z30.string().nullable().optional(),
+  currencyCode: z30.string().nullable().optional(),
+  timezone: z30.string().nullable().optional(),
+  status: z30.string().nullable().optional(),
+  lastSyncedAt: z30.string().nullable().optional()
+});
+var adsDisconnectResponseSchema = z30.object({
+  disconnected: z30.boolean()
+});
+var adsSyncResponseSchema = z30.object({
+  runId: z30.string(),
+  status: z30.string()
+});
+var adsCreativeDtoSchema = z30.object({
+  type: z30.string().nullable().optional(),
+  title: z30.string().nullable().optional(),
+  body: z30.string().nullable().optional(),
+  targetUrl: z30.string().nullable().optional()
+});
+var adsAdDtoSchema = z30.object({
+  id: z30.string(),
+  adGroupId: z30.string(),
+  name: z30.string(),
+  status: z30.string(),
+  reviewStatus: z30.string().nullable().optional(),
+  creative: adsCreativeDtoSchema.nullable().optional()
+});
+var adsAdGroupDtoSchema = z30.object({
+  id: z30.string(),
+  campaignId: z30.string(),
+  name: z30.string(),
+  status: z30.string(),
+  billingEventType: z30.string().nullable().optional(),
+  maxBidMicros: z30.number().int().nullable().optional(),
+  /**
+   * The targeting primitive: entries are multi-line strings of
+   * newline-separated example queries (the live Ads Manager format).
+   */
+  contextHints: z30.array(z30.string()).default([]),
+  ads: z30.array(adsAdDtoSchema).default([])
+});
+var adsCampaignDtoSchema = z30.object({
+  id: z30.string(),
+  name: z30.string(),
+  status: z30.string(),
+  biddingType: z30.string().nullable().optional(),
+  dailySpendLimitMicros: z30.number().int().nullable().optional(),
+  lifetimeSpendLimitMicros: z30.number().int().nullable().optional(),
+  adGroups: z30.array(adsAdGroupDtoSchema).default([])
+});
+var adsCampaignListResponseSchema = z30.object({
+  campaigns: z30.array(adsCampaignDtoSchema)
+});
+var adsInsightLevelSchema = z30.enum(["campaign", "ad_group"]);
+var AdsInsightLevels = adsInsightLevelSchema.enum;
+var adsInsightRowDtoSchema = z30.object({
+  level: adsInsightLevelSchema,
+  entityId: z30.string(),
+  date: z30.string(),
+  impressions: z30.number().int(),
+  clicks: z30.number().int(),
+  spendMicros: z30.number().int(),
+  /** clicks / impressions; null when impressions is 0. */
+  ctr: z30.number().nullable(),
+  /** spendMicros / clicks, rounded to integer micros; null when clicks is 0. */
+  cpcMicros: z30.number().int().nullable()
+});
+var adsInsightsResponseSchema = z30.object({
+  rows: z30.array(adsInsightRowDtoSchema),
+  /** Account currency for rendering spend/cpc; null before the first sync. */
+  currencyCode: z30.string().nullable().optional()
+});
+var adsTotalsDtoSchema = z30.object({
+  impressions: z30.number().int(),
+  clicks: z30.number().int(),
+  spendMicros: z30.number().int(),
+  ctr: z30.number().nullable(),
+  cpcMicros: z30.number().int().nullable()
+});
+var adsSummaryDtoSchema = z30.object({
+  connected: z30.boolean(),
+  displayName: z30.string().nullable().optional(),
+  currencyCode: z30.string().nullable().optional(),
+  lastSyncedAt: z30.string().nullable().optional(),
+  campaignCount: z30.number().int(),
+  adGroupCount: z30.number().int(),
+  adCount: z30.number().int(),
+  /** Date range the totals cover (oldest/newest rollup date), null when empty. */
+  window: z30.object({
+    from: z30.string().nullable(),
+    to: z30.string().nullable()
+  }),
+  /** Campaign-level rollup totals over the window (levels are not summed across). */
+  totals: adsTotalsDtoSchema
+});
+function adsCtr(clicks, impressions) {
+  return impressions > 0 ? clicks / impressions : null;
+}
+function adsCpcMicros(spendMicros, clicks) {
+  return clicks > 0 ? Math.round(spendMicros / clicks) : null;
+}
+
+// ../contracts/src/money.ts
+var MICROS_PER_UNIT = 1e6;
+function dollarsToMicros(dollars) {
+  return Math.round(dollars * MICROS_PER_UNIT);
+}
+function formatMicros(micros, currencyCode = "USD") {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: currencyCode
+  }).format(micros / MICROS_PER_UNIT);
+}
+
 // ../contracts/src/ai-engines.ts
 var AI_ENGINE_DOMAINS = {
   /** OpenAI marketing/blog/API surface. */
@@ -4486,11 +4679,15 @@ export {
   AGENT_MEMORY_KEY_MAX_LENGTH,
   agentMemoryUpsertRequestSchema,
   agentMemoryDeleteRequestSchema,
+  backlinkSourceSchema,
+  BacklinkSources,
+  computeBacklinkSummaryMetrics,
   CcReleaseSyncStatuses,
   ccReleaseSyncDtoSchema,
   backlinkSummaryDtoSchema,
   backlinkListResponseSchema,
   backlinkHistoryEntrySchema,
+  backlinkSourcesResponseSchema,
   backlinksInstallStatusDtoSchema,
   backlinksInstallResultDtoSchema,
   ccAvailableReleaseSchema,
@@ -4519,6 +4716,7 @@ export {
   doctorReportSchema,
   summarizeCheckResults,
   absolutizeProjectUrl,
+  hostOf,
   normalizeUrlPath,
   citationVisibilityResponseSchema,
   emptyCitationVisibility,
@@ -4566,6 +4764,18 @@ export {
   deltaPercent,
   deltaTone,
   formatDeltaCopy,
+  adsConnectRequestSchema,
+  adsConnectionStatusDtoSchema,
+  adsDisconnectResponseSchema,
+  adsSyncResponseSchema,
+  adsCampaignListResponseSchema,
+  adsInsightLevelSchema,
+  adsInsightsResponseSchema,
+  adsSummaryDtoSchema,
+  adsCtr,
+  adsCpcMicros,
+  dollarsToMicros,
+  formatMicros,
   AI_ENGINE_DOMAINS,
   AI_ENGINE_SELF_DOMAINS,
   VERTEX_AI_SEARCH_PROXY_DOMAIN,