@canonry/canonry 4.117.2 → 4.123.0

package/dist/{chunk-4PMMEFME.js → chunk-HJIIJI7K.js}

@@ -3,6 +3,18 @@ import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   DISCOVERY_MAX_PROBES_CAP,
   DISCOVERY_PROBE_CONCURRENCY_CAP,
+  adsActivateTreeRequestSchema,
+  adsAdCreateRequestSchema,
+  adsAdGroupCreateRequestSchema,
+  adsAdGroupUpdateRequestSchema,
+  adsAdUpdateRequestSchema,
+  adsCampaignCreateRequestSchema,
+  adsCampaignUpdateRequestSchema,
+  adsGeoSearchQuerySchema,
+  adsImageUploadRequestSchema,
+  adsOperationReconcileRequestSchema,
+  adsPauseRequestSchema,
+  adsUnresolvedOperationListQuerySchema,
   backlinkSourceSchema,
   competitorBatchRequestSchema,
   discoveryBucketSchema,
@@ -25,7 +37,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-EZME2J2G.js";
+} from "./chunk-MMFSI3OG.js";
 
 // src/config.ts
 import fs from "fs";
@@ -1506,6 +1518,18 @@ var getApiV1ProjectsByNameHistory = (options) => {
     ...options
   });
 };
+var getApiV1History = (options) => {
+  return (options?.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/history",
+    ...options
+  });
+};
 var getApiV1ProjectsByNameSnapshots = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -2310,7 +2334,79 @@ var getApiV1ProjectsByNameAdsStatus = (options) => {
     ...options
   });
 };
-var postApiV1ProjectsByNameAdsSync = (options) => {
+var getApiV1ProjectsByNameAdsAccount = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/account",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameAdsGeoSearch = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/geo/search",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameAdsConversionsPixels = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/conversions/pixels",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameAdsConversionsEventSettings = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/conversions/event-settings",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameAdsOperations = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/operations",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameAdsOperationsByOperationKey = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/operations/{operationKey}",
+    ...options
+  });
+};
+var postApiV1ProjectsByNameAdsOperationsByOperationKeyReconcile = (options) => {
   return (options.client ?? client).post({
     security: [
       {
@@ -2318,19 +2414,247 @@ var postApiV1ProjectsByNameAdsSync = (options) => {
         type: "http"
       }
     ],
-    url: "/api/v1/projects/{name}/ads/sync",
+    url: "/api/v1/projects/{name}/ads/operations/{operationKey}/reconcile",
+    ...options
+  });
+};
+var postApiV1ProjectsByNameAdsOperationsByOperationKeyResumeActivation = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/operations/{operationKey}/resume-activation",
+    ...options
+  });
+};
+var postApiV1ProjectsByNameAdsActivationGrants = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/activation-grants",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsActivationGrantsByGrantIdRevoke = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/activation-grants/{grantId}/revoke",
+    ...options
+  });
+};
+var postApiV1ProjectsByNameAdsCampaignsByIdActivateTree = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/campaigns/{id}/activate-tree",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsFiles = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/files",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var getApiV1ProjectsByNameAdsCampaigns = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/campaigns",
     ...options
   });
 };
-var getApiV1ProjectsByNameAdsCampaigns = (options) => {
-  return (options.client ?? client).get({
+var postApiV1ProjectsByNameAdsCampaigns = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/campaigns",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsAdGroups = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/ad-groups",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsAds = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/ads",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsCampaignsById = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/campaigns/{id}",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsAdGroupsById = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/ad-groups/{id}",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsAdsById = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/ads/{id}",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsCampaignsByIdPause = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/campaigns/{id}/pause",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsAdGroupsByIdPause = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/ad-groups/{id}/pause",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsAdsByIdPause = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/ads/ads/{id}/pause",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameAdsSync = (options) => {
+  return (options.client ?? client).post({
     security: [
       {
         scheme: "bearer",
         type: "http"
       }
     ],
-    url: "/api/v1/projects/{name}/ads/campaigns",
+    url: "/api/v1/projects/{name}/ads/sync",
     ...options
   });
 };
@@ -4124,14 +4448,19 @@ var ApiClient = class {
   async cancelRun(id) {
     return this.invoke(() => postApiV1RunsByIdCancel({ client: this.heyClient, path: { id } }));
   }
-  async getTimeline(project, location) {
+  async getTimeline(project, location, limit) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameTimeline({ client: this.heyClient, path: { name: project }, query: { location, limit } })
+    );
+  }
+  async getHistory(project, opts) {
     return this.invoke(
-      () => getApiV1ProjectsByNameTimeline({ client: this.heyClient, path: { name: project }, query: { location } })
+      () => getApiV1ProjectsByNameHistory({ client: this.heyClient, path: { name: project }, query: opts })
     );
   }
-  async getHistory(project) {
+  async getGlobalHistory(opts) {
     return this.invoke(
-      () => getApiV1ProjectsByNameHistory({ client: this.heyClient, path: { name: project } })
+      () => getApiV1History({ client: this.heyClient, query: opts })
     );
   }
   async getSnapshots(project, opts) {
@@ -4407,6 +4736,26 @@ var ApiClient = class {
       () => getApiV1ProjectsByNameAdsStatus({ client: this.heyClient, path: { name: project } })
     );
   }
+  async getAdsAccount(project) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAdsAccount({ client: this.heyClient, path: { name: project } })
+    );
+  }
+  async searchAdsGeo(project, query) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAdsGeoSearch({ client: this.heyClient, path: { name: project }, query })
+    );
+  }
+  async getAdsConversionPixels(project) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAdsConversionsPixels({ client: this.heyClient, path: { name: project } })
+    );
+  }
+  async getAdsConversionEventSettings(project) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAdsConversionsEventSettings({ client: this.heyClient, path: { name: project } })
+    );
+  }
   async triggerAdsSync(project) {
     return this.invoke(
       () => postApiV1ProjectsByNameAdsSync({ client: this.heyClient, path: { name: project } })
@@ -4427,6 +4776,143 @@ var ApiClient = class {
       () => getApiV1ProjectsByNameAdsSummary({ client: this.heyClient, path: { name: project } })
     );
   }
+  async getAdsOperation(project, operationKey) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAdsOperationsByOperationKey({
+        client: this.heyClient,
+        path: { name: project, operationKey }
+      })
+    );
+  }
+  async getUnresolvedAdsOperations(project, query) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAdsOperations({
+        client: this.heyClient,
+        path: { name: project },
+        query: query ? {
+          state: query.state?.join(","),
+          limit: query.limit,
+          cursor: query.cursor
+        } : void 0
+      })
+    );
+  }
+  async reconcileAdsOperation(project, operationKey) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsOperationsByOperationKeyReconcile({
+        client: this.heyClient,
+        path: { name: project, operationKey }
+      })
+    );
+  }
+  async resumeAdsActivation(project, operationKey) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsOperationsByOperationKeyResumeActivation({
+        client: this.heyClient,
+        path: { name: project, operationKey }
+      })
+    );
+  }
+  async createAdsActivationGrant(project, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsActivationGrants({
+        client: this.heyClient,
+        path: { name: project },
+        body
+      })
+    );
+  }
+  async revokeAdsActivationGrant(project, grantId) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsActivationGrantsByGrantIdRevoke({
+        client: this.heyClient,
+        path: { name: project, grantId }
+      })
+    );
+  }
+  async uploadAdsImage(project, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsFiles({ client: this.heyClient, path: { name: project }, body })
+    );
+  }
+  async createAdsCampaign(project, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsCampaigns({ client: this.heyClient, path: { name: project }, body })
+    );
+  }
+  async updateAdsCampaign(project, campaignId, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsCampaignsById({
+        client: this.heyClient,
+        path: { name: project, id: campaignId },
+        body
+      })
+    );
+  }
+  async pauseAdsCampaign(project, campaignId, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsCampaignsByIdPause({
+        client: this.heyClient,
+        path: { name: project, id: campaignId },
+        body
+      })
+    );
+  }
+  async activateAdsCampaignTree(project, campaignId, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsCampaignsByIdActivateTree({
+        client: this.heyClient,
+        path: { name: project, id: campaignId },
+        body
+      })
+    );
+  }
+  async createAdsAdGroup(project, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsAdGroups({ client: this.heyClient, path: { name: project }, body })
+    );
+  }
+  async updateAdsAdGroup(project, adGroupId, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsAdGroupsById({
+        client: this.heyClient,
+        path: { name: project, id: adGroupId },
+        body
+      })
+    );
+  }
+  async pauseAdsAdGroup(project, adGroupId, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsAdGroupsByIdPause({
+        client: this.heyClient,
+        path: { name: project, id: adGroupId },
+        body
+      })
+    );
+  }
+  async createAdsAd(project, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsAds({ client: this.heyClient, path: { name: project }, body })
+    );
+  }
+  async updateAdsAd(project, adId, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsAdsById({
+        client: this.heyClient,
+        path: { name: project, id: adId },
+        body
+      })
+    );
+  }
+  async pauseAdsAd(project, adId, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameAdsAdsByIdPause({
+        client: this.heyClient,
+        path: { name: project, id: adId },
+        body
+      })
+    );
+  }
   async listGbpMetrics(project, opts) {
     return this.invoke(
       () => getApiV1ProjectsByNameGbpMetrics({
@@ -4912,9 +5398,9 @@ var ApiClient = class {
     );
   }
   // ── Technical AEO (site-audit) ──────────────────────────────────────────
-  async getTechnicalAeoScore(project) {
+  async getTechnicalAeoScore(project, opts) {
     return this.invoke(
-      () => getApiV1ProjectsByNameTechnicalAeo({ client: this.heyClient, path: { name: project } })
+      () => getApiV1ProjectsByNameTechnicalAeo({ client: this.heyClient, path: { name: project }, query: { runId: opts?.runId } })
     );
   }
   async getTechnicalAeoPages(project, opts) {
@@ -4923,6 +5409,7 @@ var ApiClient = class {
         client: this.heyClient,
         path: { name: project },
         query: {
+          runId: opts?.runId,
           status: opts?.status,
           sort: opts?.sort,
           limit: opts?.limit !== void 0 ? String(opts.limit) : void 0,
@@ -5420,8 +5907,19 @@ var runGetInputSchema = z2.object({
 });
 var timelineInputSchema = z2.object({
   project: projectNameSchema,
-  location: z2.string().optional().describe("Location label. Use an empty string for locationless results.")
+  location: z2.string().optional().describe("Location label. Use an empty string for locationless results."),
+  limit: z2.number().int().positive().max(100).optional().describe("Restrict history to the most recent N project runs.")
 });
+var historyFilterShape = {
+  limit: z2.number().int().positive().max(500).optional(),
+  offset: z2.number().int().nonnegative().optional(),
+  since: z2.string().optional().describe("ISO 8601 lower bound."),
+  action: z2.string().optional().describe("Exact audit action filter."),
+  actor: z2.string().optional().describe("Exact actor filter."),
+  entityType: z2.string().optional().describe("Exact entity type filter.")
+};
+var projectHistoryInputSchema = z2.object({ project: projectNameSchema, ...historyFilterShape });
+var globalHistoryInputSchema = z2.object(historyFilterShape);
 var snapshotsListInputSchema = z2.object({
   project: projectNameSchema,
   limit: z2.number().int().positive().max(500).optional(),
@@ -5525,6 +6023,72 @@ var adsInsightsInputSchema = z2.object({
   from: z2.string().optional(),
   to: z2.string().optional()
 });
+var adsGeoSearchInputSchema = adsGeoSearchQuerySchema.extend({
+  project: projectNameSchema
+});
+var adsOperationInputSchema = z2.object({
+  project: projectNameSchema,
+  operationKey: z2.string().min(8).max(128)
+});
+var adsOperationResumeActivationInputSchema = adsOperationInputSchema.strict();
+var adsUnresolvedOperationsInputSchema = adsUnresolvedOperationListQuerySchema.extend({
+  project: projectNameSchema
+});
+var adsOperationReconcileInputSchema = adsOperationReconcileRequestSchema.extend({
+  project: projectNameSchema,
+  operationKey: z2.string().min(8).max(128)
+});
+var adsImageUploadInputSchema = z2.object({
+  project: projectNameSchema,
+  request: adsImageUploadRequestSchema
+});
+var adsCampaignCreateInputSchema = z2.object({
+  project: projectNameSchema,
+  request: adsCampaignCreateRequestSchema
+});
+var adsCampaignUpdateInputSchema = z2.object({
+  project: projectNameSchema,
+  campaignId: z2.string().min(1),
+  request: adsCampaignUpdateRequestSchema
+});
+var adsCampaignActivateTreeInputSchema = z2.object({
+  project: projectNameSchema,
+  campaignId: z2.string().min(1),
+  request: adsActivateTreeRequestSchema
+});
+var adsCampaignPauseInputSchema = z2.object({
+  project: projectNameSchema,
+  campaignId: z2.string().min(1),
+  request: adsPauseRequestSchema
+});
+var adsAdGroupCreateInputSchema = z2.object({
+  project: projectNameSchema,
+  request: adsAdGroupCreateRequestSchema
+});
+var adsAdGroupUpdateInputSchema = z2.object({
+  project: projectNameSchema,
+  adGroupId: z2.string().min(1),
+  request: adsAdGroupUpdateRequestSchema
+});
+var adsAdGroupPauseInputSchema = z2.object({
+  project: projectNameSchema,
+  adGroupId: z2.string().min(1),
+  request: adsPauseRequestSchema
+});
+var adsAdCreateInputSchema = z2.object({
+  project: projectNameSchema,
+  request: adsAdCreateRequestSchema
+});
+var adsAdUpdateInputSchema = z2.object({
+  project: projectNameSchema,
+  adId: z2.string().min(1),
+  request: adsAdUpdateRequestSchema
+});
+var adsAdPauseInputSchema = z2.object({
+  project: projectNameSchema,
+  adId: z2.string().min(1),
+  request: adsPauseRequestSchema
+});
 var keywordsInputSchema = z2.object({
   project: projectNameSchema,
   request: keywordBatchRequestSchema
@@ -5672,10 +6236,12 @@ var discoveryPromoteInputSchema = z2.object({
   }).optional()
 });
 var technicalAeoScoreInputSchema = z2.object({
-  project: projectNameSchema
+  project: projectNameSchema,
+  runId: runIdSchema.optional().describe("Historical site-audit run ID. Omit for the latest audit.")
 });
 var technicalAeoPagesInputSchema = z2.object({
   project: projectNameSchema,
+  runId: runIdSchema.optional().describe("Historical site-audit run ID. Omit for the latest audit."),
   status: z2.enum(["success", "error"]).optional().describe("Filter to successfully-audited or errored pages."),
   sort: z2.enum(["score-asc", "score-desc", "url"]).optional().describe("Sort order. Defaults to score-asc (worst pages first)."),
   limit: z2.number().int().positive().max(500).optional(),
@@ -5834,10 +6400,28 @@ var canonryMcpTools = [
     description: "Get audit history for a Canonry project.",
     access: "read",
     tier: "monitoring",
-    inputSchema: projectInputSchema,
+    inputSchema: projectHistoryInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/history"],
-    handler: (client2, input) => client2.getHistory(input.project)
+    handler: (client2, input) => client2.getHistory(input.project, {
+      limit: input.limit,
+      offset: input.offset,
+      since: input.since,
+      action: input.action,
+      actor: input.actor,
+      entityType: input.entityType
+    })
+  }),
+  defineTool({
+    name: "canonry_history_global",
+    title: "Get instance history",
+    description: "Get the instance-wide audit trail, including retained entries whose project was deleted. Full-instance keys only; project-scoped keys remain limited to their project.",
+    access: "read",
+    tier: "monitoring",
+    inputSchema: globalHistoryInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/history"],
+    handler: (client2, input) => client2.getGlobalHistory(input)
   }),
   defineTool({
     name: "canonry_runs_list",
@@ -5881,7 +6465,7 @@ var canonryMcpTools = [
     inputSchema: timelineInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/timeline"],
-    handler: (client2, input) => client2.getTimeline(input.project, input.location)
+    handler: (client2, input) => client2.getTimeline(input.project, input.location, input.limit)
   }),
   defineTool({
     name: "canonry_snapshots_list",
@@ -6994,7 +7578,7 @@ var canonryMcpTools = [
     inputSchema: technicalAeoScoreInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/technical-aeo"],
-    handler: (client2, input) => client2.getTechnicalAeoScore(input.project)
+    handler: (client2, input) => client2.getTechnicalAeoScore(input.project, { runId: input.runId })
   }),
   defineTool({
     name: "canonry_technical_aeo_pages",
@@ -7006,6 +7590,7 @@ var canonryMcpTools = [
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/technical-aeo/pages"],
     handler: (client2, input) => client2.getTechnicalAeoPages(input.project, {
+      runId: input.runId,
       status: input.status,
       sort: input.sort,
       limit: input.limit,
@@ -7049,6 +7634,50 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/ads/status"],
     handler: (client2, input) => client2.getAdsStatus(input.project)
   }),
+  defineTool({
+    name: "canonry_ads_account",
+    title: "Read the live OpenAI ads account",
+    description: "Read live OpenAI Ads account metadata, currency, timezone, status, and account-integrity review state. Use before planning or launch to confirm the connected advertiser account is the intended one and is eligible to serve.",
+    access: "read",
+    tier: "ads",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(true),
+    openApiOperations: ["GET /api/v1/projects/{name}/ads/account"],
+    handler: (client2, input) => client2.getAdsAccount(input.project)
+  }),
+  defineTool({
+    name: "canonry_ads_geo_search",
+    title: "Search OpenAI ads locations",
+    description: "Search the live OpenAI Ads geo catalog by place name. Returns provider location IDs and canonical labels; use those IDs in campaign locationIds instead of inventing or guessing targeting identifiers.",
+    access: "read",
+    tier: "ads",
+    inputSchema: adsGeoSearchInputSchema,
+    annotations: readAnnotations(true),
+    openApiOperations: ["GET /api/v1/projects/{name}/ads/geo/search"],
+    handler: (client2, input) => client2.searchAdsGeo(input.project, { q: input.q, limit: input.limit })
+  }),
+  defineTool({
+    name: "canonry_ads_conversion_pixels",
+    title: "List OpenAI ads conversion pixels",
+    description: "List conversion pixels from the live OpenAI ad account. Use with conversion event settings to verify that measurable conversion infrastructure exists before recommending activation or budget changes.",
+    access: "read",
+    tier: "ads",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(true),
+    openApiOperations: ["GET /api/v1/projects/{name}/ads/conversions/pixels"],
+    handler: (client2, input) => client2.getAdsConversionPixels(input.project)
+  }),
+  defineTool({
+    name: "canonry_ads_conversion_event_settings",
+    title: "List OpenAI ads conversion event settings",
+    description: "List live OpenAI Ads conversion event settings, attribution windows, and attached pixel or CAPI sources. Use to select and verify the conversion goal before launch.",
+    access: "read",
+    tier: "ads",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(true),
+    openApiOperations: ["GET /api/v1/projects/{name}/ads/conversions/event-settings"],
+    handler: (client2, input) => client2.getAdsConversionEventSettings(input.project)
+  }),
   defineTool({
     name: "canonry_ads_campaigns",
     title: "List synced ad campaigns",
@@ -7082,6 +7711,175 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/ads/summary"],
     handler: (client2, input) => client2.getAdsSummary(input.project)
   }),
+  defineTool({
+    name: "canonry_ads_operations_unresolved",
+    title: "List unresolved ads mutation receipts",
+    description: "List pending, unknown, or actively reconciling OpenAI Ads mutation receipts that need recovery. Pass nextCursor back as cursor to advance past permanent rows. Use this before new lifecycle work so an ambiguous earlier outcome is settled instead of retried under another key. Route campaign_tree_activate receipts to canonry_ads_operation_resume_activation; use generic reconciliation only for other supported receipt kinds.",
+    access: "read",
+    tier: "ads",
+    inputSchema: adsUnresolvedOperationsInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/ads/operations"],
+    handler: (client2, input) => client2.getUnresolvedAdsOperations(input.project, {
+      state: input.state,
+      limit: input.limit,
+      cursor: input.cursor
+    })
+  }),
+  defineTool({
+    name: "canonry_ads_operation_get",
+    title: "Get an ads mutation receipt",
+    description: "Read the durable receipt for an OpenAI Ads mutation by its caller-supplied operation key. Never retry a pending or unknown receipt with a new key because the upstream request may already have succeeded. Resume campaign_tree_activate receipts through canonry_ads_operation_resume_activation; send other supported receipt kinds to generic reconciliation.",
+    access: "read",
+    tier: "ads",
+    inputSchema: adsOperationInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/ads/operations/{operationKey}"],
+    handler: (client2, input) => client2.getAdsOperation(input.project, input.operationKey)
+  }),
+  defineTool({
+    name: "canonry_ads_operation_reconcile",
+    title: "Reconcile an ads mutation receipt",
+    description: "Verify a checkpointed provider entity against the receipt-bound OpenAI ad account without retrying the original mutation. Uncheckpointed creates remain unresolved because mutable-field matching cannot prove provenance. This generic tool rejects campaign_tree_activate receipts; use canonry_ads_operation_resume_activation for those.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsOperationReconcileInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/operations/{operationKey}/reconcile"],
+    handler: (client2, input) => client2.reconcileAdsOperation(input.project, input.operationKey)
+  }),
+  defineTool({
+    name: "canonry_ads_operation_resume_activation",
+    title: "Resume an ads activation receipt",
+    description: "Resume recovery for an existing campaign_tree_activate receipt using its durable approval grant and ordered step ledger. The request is bodyless, requires ads.activate on the exact executor key already bound to the grant, and cannot replace the operation, grant, manifest, campaign, or account. Canonry inspects provider state and never blindly resends an ambiguous activation mutation.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsOperationResumeActivationInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, destructiveHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/operations/{operationKey}/resume-activation"],
+    handler: (client2, input) => client2.resumeAdsActivation(input.project, input.operationKey)
+  }),
+  defineTool({
+    name: "canonry_ads_image_upload",
+    title: "Upload an ads image from URL",
+    description: "Upload a public HTTPS image URL to the connected OpenAI ad account. The operation key makes a repeated identical request replay its receipt without another upstream upload. Save the returned file entityId for chat-card creation.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsImageUploadInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/files"],
+    handler: (client2, input) => client2.uploadAdsImage(input.project, input.request)
+  }),
+  defineTool({
+    name: "canonry_ads_campaign_create",
+    title: "Create a paused ads campaign",
+    description: "Create an OpenAI Ads campaign PAUSED with an explicit lifetime spend limit and location allowlist. Set biddingType=clicks with one or more provider-issued conversionEventSettingIds for conversion-optimized delivery; omit both for legacy impressions bidding. The server ignores any status concept and always sends paused. Inspect the receipt, then create matching paused ad groups and ads. A human must separately approve the exact tree before this operator can activate it.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsCampaignCreateInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/campaigns"],
+    handler: (client2, input) => client2.createAdsCampaign(input.project, input.request)
+  }),
+  defineTool({
+    name: "canonry_ads_campaign_update",
+    title: "Update an ads campaign",
+    description: "Update a PAUSED campaign copy, dates, lifetime spend limit, or locations without changing status. Active campaigns fail closed: pause first, sync, and use the refreshed upstreamUpdatedAt. A human must approve the exact updated tree before this operator can reactivate it. Uses a durable operation key.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsCampaignUpdateInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, destructiveHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/campaigns/{id}"],
+    handler: (client2, input) => client2.updateAdsCampaign(input.project, input.campaignId, input.request)
+  }),
+  defineTool({
+    name: "canonry_ads_campaign_activate_tree",
+    title: "Activate an approved ads campaign tree",
+    description: "Execute one short-lived human approval grant for the exact paused campaign, ad groups, and reviewed ads named by its manifest. The grant is bound to this executor key and manifest hash. Canonry checkpoints every step, activates ads before parents, verifies active state, and rolls back parent-first on failure. This tool cannot create or widen an approval.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsCampaignActivateTreeInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, destructiveHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/campaigns/{id}/activate-tree"],
+    handler: (client2, input) => client2.activateAdsCampaignTree(input.project, input.campaignId, input.request)
+  }),
+  defineTool({
+    name: "canonry_ads_campaign_pause",
+    title: "Pause an ads campaign",
+    description: "Pause a campaign immediately. Use this first when spend, conversion tracking, landing-page behavior, or policy status is unsafe. The operation is idempotent through its durable operation key.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsCampaignPauseInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/campaigns/{id}/pause"],
+    handler: (client2, input) => client2.pauseAdsCampaign(input.project, input.campaignId, input.request)
+  }),
+  defineTool({
+    name: "canonry_ads_ad_group_create",
+    title: "Create a paused ads ad group",
+    description: "Create a PAUSED ad group under a reviewed campaign. Context hints describe when the audit offer is useful. Set billingEventType=click under a clicks campaign; omit it for the legacy impression mode. Canonry reads the live parent and rejects a billing/bidding mismatch before mutation.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsAdGroupCreateInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/ad-groups"],
+    handler: (client2, input) => client2.createAdsAdGroup(input.project, input.request)
+  }),
+  defineTool({
+    name: "canonry_ads_ad_group_update",
+    title: "Update an ads ad group",
+    description: "Update a PAUSED ad group name, description, context hints, or max bid without changing its billing event or status. Active ad groups fail closed: pause first, sync, and use the refreshed upstreamUpdatedAt. A human must reactivate after review. Uses a durable operation key.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsAdGroupUpdateInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, destructiveHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/ad-groups/{id}"],
+    handler: (client2, input) => client2.updateAdsAdGroup(input.project, input.adGroupId, input.request)
+  }),
+  defineTool({
+    name: "canonry_ads_ad_group_pause",
+    title: "Pause an ads ad group",
+    description: "Pause an ad group through a durable idempotent operation receipt.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsAdGroupPauseInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/ad-groups/{id}/pause"],
+    handler: (client2, input) => client2.pauseAdsAdGroup(input.project, input.adGroupId, input.request)
+  }),
+  defineTool({
+    name: "canonry_ads_ad_create",
+    title: "Create a paused chat-card ad",
+    description: "Create a PAUSED ChatGPT chat-card ad using a previously uploaded file entityId and an HTTPS destination. Title is 3-50 characters and body is at most 100. Activation is deliberately human-only for the beta.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsAdCreateInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/ads"],
+    handler: (client2, input) => client2.createAdsAd(input.project, input.request)
+  }),
+  defineTool({
+    name: "canonry_ads_ad_update",
+    title: "Update a chat-card ad",
+    description: "Update a PAUSED ad name or full chat-card creative without changing status. Active ads fail closed: pause first, sync, and use the refreshed upstreamUpdatedAt. A human must reactivate after review. Uses a durable operation key.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsAdUpdateInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, destructiveHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/ads/{id}"],
+    handler: (client2, input) => client2.updateAdsAd(input.project, input.adId, input.request)
+  }),
+  defineTool({
+    name: "canonry_ads_ad_pause",
+    title: "Pause a chat-card ad",
+    description: "Pause an individual ad through a durable idempotent operation receipt.",
+    access: "write",
+    tier: "ads",
+    inputSchema: adsAdPauseInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/ads/ads/{id}/pause"],
+    handler: (client2, input) => client2.pauseAdsAd(input.project, input.adId, input.request)
+  }),
   defineTool({
     name: "canonry_ads_sync",
     title: "Trigger ads sync",