@canonry/canonry 4.118.0 → 4.123.0

package/dist/{chunk-75UBTCKS.js → chunk-HJIIJI7K.js}

@@ -3,14 +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,
@@ -33,7 +37,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-KEZWLP4O.js";
+} from "./chunk-MMFSI3OG.js";
 
 // src/config.ts
 import fs from "fs";
@@ -2330,6 +2334,66 @@ var getApiV1ProjectsByNameAdsStatus = (options) => {
     ...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: [
@@ -2342,6 +2406,74 @@ var getApiV1ProjectsByNameAdsOperationsByOperationKey = (options) => {
     ...options
   });
 };
+var postApiV1ProjectsByNameAdsOperationsByOperationKeyReconcile = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    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: [
@@ -4604,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 } })
@@ -4632,6 +4784,52 @@ var ApiClient = class {
       })
     );
   }
+  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 })
@@ -4660,6 +4858,15 @@ var ApiClient = class {
       })
     );
   }
+  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 })
@@ -5816,10 +6023,21 @@ 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
@@ -5833,6 +6051,11 @@ var adsCampaignUpdateInputSchema = z2.object({
   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),
@@ -7411,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",
@@ -7444,10 +7711,25 @@ 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. A pending or unknown receipt must be reconciled by a human; never retry it with a new key because the upstream request may already have succeeded.",
+    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,
@@ -7455,6 +7737,28 @@ var canonryMcpTools = [
     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",
@@ -7469,7 +7773,7 @@ var canonryMcpTools = [
   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. The server ignores any status concept and always sends paused. Inspect the receipt, then create paused ad groups and ads. Activation is deliberately human-only for the beta.",
+    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,
@@ -7480,7 +7784,7 @@ var canonryMcpTools = [
   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 reactivate after reviewing the change. Uses a durable operation key.",
+    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,
@@ -7488,6 +7792,17 @@ var canonryMcpTools = [
     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",
@@ -7502,7 +7817,7 @@ var canonryMcpTools = [
   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; maxBidMicros is an impression bid. The server fixes the billing event to impression.",
+    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,
@@ -7513,7 +7828,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_ads_ad_group_update",
     title: "Update an ads ad group",
-    description: "Update a PAUSED ad group name, description, context hints, or impression bid without changing 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.",
+    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,