@canonry/canonry 4.117.2 → 4.118.0

package/dist/{chunk-F2SRZJMY.js → chunk-HGNY5GL4.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-4PMMEFME.js";
+} from "./chunk-75UBTCKS.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -115,7 +115,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-BMPIV35C.js";
+} from "./chunk-CMZIPFNQ.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -178,7 +178,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-EZME2J2G.js";
+} from "./chunk-KEZWLP4O.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -4241,6 +4241,16 @@ var OPENAI_ADS_REQUEST_TIMEOUT_MS = 3e4;
 var OPENAI_ADS_MAX_PAGES = 100;
 
 // ../integration-openai-ads/src/types.ts
+var OpenAiAdsWriteStatuses = {
+  active: "active",
+  paused: "paused"
+};
+var OpenAiAdsBillingEventTypes = {
+  impression: "impression"
+};
+var OpenAiAdsCreativeTypes = {
+  chatCard: "chat_card"
+};
 var OpenAiAdsApiError = class extends Error {
   status;
   code;
@@ -4264,6 +4274,16 @@ function parseErrorEnvelope(body) {
 }
 
 // ../integration-openai-ads/src/ads-client.ts
+var MIN_ENTITY_NAME_LENGTH = 3;
+var MAX_ENTITY_NAME_LENGTH = 1e3;
+var MIN_CAMPAIGN_TIMESTAMP = 946684800;
+var MAX_CAMPAIGN_TIMESTAMP = 4102444800;
+var MIN_LIFETIME_BUDGET_MICROS = 1e6;
+var MIN_BID_MICROS = 1;
+var MAX_BID_MICROS = 1e8;
+var MIN_AD_TITLE_LENGTH = 3;
+var MAX_AD_TITLE_LENGTH = 50;
+var MAX_AD_BODY_LENGTH = 100;
 function validateApiKey(apiKey) {
   if (!apiKey || typeof apiKey !== "string" || apiKey.trim().length === 0) {
     throw new OpenAiAdsApiError("API key is required and must be a non-empty string", 400);
@@ -4274,6 +4294,174 @@ function validateId(value, label) {
     throw new OpenAiAdsApiError(`${label} is required and must be a non-empty string`, 400);
   }
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateRequestObject(value, label) {
+  if (!isRecord(value)) {
+    throw new OpenAiAdsApiError(`${label} must be a JSON object`, 400);
+  }
+}
+function validateNonEmptyRequest(value, label) {
+  validateRequestObject(value, label);
+  if (Object.keys(value).length === 0) {
+    throw new OpenAiAdsApiError(`${label} must include at least one field`, 400);
+  }
+}
+function snapshotJsonRequest(value, label) {
+  try {
+    const serialized = JSON.stringify(value);
+    return JSON.parse(serialized);
+  } catch {
+    throw new OpenAiAdsApiError(`${label} must be JSON-serializable`, 400);
+  }
+}
+function validateEntityName(value, label) {
+  if (typeof value !== "string" || value.trim().length < MIN_ENTITY_NAME_LENGTH || value.length > MAX_ENTITY_NAME_LENGTH) {
+    throw new OpenAiAdsApiError(
+      `${label} must be ${MIN_ENTITY_NAME_LENGTH}-${MAX_ENTITY_NAME_LENGTH} characters and include a non-space character`,
+      400
+    );
+  }
+}
+function validatePausedCreateStatus(value, label) {
+  if (value !== OpenAiAdsWriteStatuses.paused) {
+    throw new OpenAiAdsApiError(`${label} status must be paused`, 400);
+  }
+}
+function validatePublicUpdateRequest(value, label) {
+  validateNonEmptyRequest(value, label);
+  if (Object.hasOwn(value, "status")) {
+    throw new OpenAiAdsApiError(`${label} cannot include status; use an explicit lifecycle action`, 400);
+  }
+}
+function validateCampaignTimestamp(value, label) {
+  if (value === void 0 || value === null) return;
+  if (!Number.isInteger(value) || value < MIN_CAMPAIGN_TIMESTAMP || value > MAX_CAMPAIGN_TIMESTAMP) {
+    throw new OpenAiAdsApiError(
+      `${label} must be a Unix timestamp between ${MIN_CAMPAIGN_TIMESTAMP} and ${MAX_CAMPAIGN_TIMESTAMP}`,
+      400
+    );
+  }
+}
+function validateCampaignBudget(value) {
+  validateRequestObject(value, "Campaign budget");
+  const limit = value.lifetime_spend_limit_micros;
+  if (!Number.isInteger(limit) || limit < MIN_LIFETIME_BUDGET_MICROS) {
+    throw new OpenAiAdsApiError(
+      `Campaign budget lifetime_spend_limit_micros must be an integer of at least ${MIN_LIFETIME_BUDGET_MICROS}`,
+      400
+    );
+  }
+}
+function validateCampaignTargeting(value) {
+  if (value === void 0) return;
+  if (value === null) {
+    throw new OpenAiAdsApiError("Campaign targeting cannot be null; omit it to preserve existing targeting", 400);
+  }
+  validateRequestObject(value, "Campaign targeting");
+  validateRequestObject(value.locations, "Campaign targeting locations");
+  const include = value.locations.include;
+  if (!Array.isArray(include) || include.length === 0) {
+    throw new OpenAiAdsApiError("Campaign targeting locations include must be a non-empty array", 400);
+  }
+  for (const target of include) {
+    validateRequestObject(target, "Campaign location target");
+    validateId(target.id, "Campaign location id");
+  }
+}
+function validateBiddingConfig(value) {
+  validateRequestObject(value, "Ad group bidding_config");
+  if (value.billing_event_type !== OpenAiAdsBillingEventTypes.impression) {
+    throw new OpenAiAdsApiError("Ad group billing_event_type must be impression", 400);
+  }
+  const maxBid = value.max_bid_micros;
+  if (!Number.isInteger(maxBid) || maxBid < MIN_BID_MICROS || maxBid > MAX_BID_MICROS) {
+    throw new OpenAiAdsApiError(
+      `Ad group max_bid_micros must be an integer between ${MIN_BID_MICROS} and ${MAX_BID_MICROS}`,
+      400
+    );
+  }
+}
+function validateContextHints(value) {
+  if (value === void 0) return;
+  if (!Array.isArray(value) || value.some((hint) => typeof hint !== "string" || hint.trim().length === 0)) {
+    throw new OpenAiAdsApiError("Ad group context_hints must be an array of non-empty strings", 400);
+  }
+}
+function validateHttpUrl(value, label) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new OpenAiAdsApiError(`${label} is required and must be a non-empty URL`, 400);
+  }
+  try {
+    const parsed = new URL(value);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+      throw new Error("unsupported protocol");
+    }
+  } catch {
+    throw new OpenAiAdsApiError(`${label} must be an absolute HTTP or HTTPS URL`, 400);
+  }
+}
+function validateChatCardCreative(value) {
+  validateRequestObject(value, "Ad creative");
+  if (value.type !== OpenAiAdsCreativeTypes.chatCard) {
+    throw new OpenAiAdsApiError("Ad creative type must be chat_card", 400);
+  }
+  if (typeof value.title !== "string" || value.title.trim().length < MIN_AD_TITLE_LENGTH || value.title.length > MAX_AD_TITLE_LENGTH) {
+    throw new OpenAiAdsApiError(
+      `Ad creative title must be ${MIN_AD_TITLE_LENGTH}-${MAX_AD_TITLE_LENGTH} characters`,
+      400
+    );
+  }
+  if (typeof value.body !== "string" || value.body.trim().length === 0 || value.body.length > MAX_AD_BODY_LENGTH) {
+    throw new OpenAiAdsApiError(`Ad creative body must be 1-${MAX_AD_BODY_LENGTH} characters`, 400);
+  }
+  validateId(value.file_id, "Ad creative file id");
+  validateHttpUrl(value.target_url, "Ad creative target URL");
+}
+function validateCreateCampaignRequest(request) {
+  validateRequestObject(request, "Campaign create request");
+  validateEntityName(request.name, "Campaign name");
+  validatePausedCreateStatus(request.status, "Campaign create request");
+  validateCampaignBudget(request.budget);
+  validateCampaignTimestamp(request.start_time, "Campaign start_time");
+  validateCampaignTimestamp(request.end_time, "Campaign end_time");
+  validateCampaignTargeting(request.targeting);
+}
+function validateUpdateCampaignRequest(request) {
+  validatePublicUpdateRequest(request, "Campaign update request");
+  if (request.name !== void 0) validateEntityName(request.name, "Campaign name");
+  if (request.budget !== void 0) validateCampaignBudget(request.budget);
+  validateCampaignTimestamp(request.start_time, "Campaign start_time");
+  validateCampaignTimestamp(request.end_time, "Campaign end_time");
+  validateCampaignTargeting(request.targeting);
+}
+function validateCreateAdGroupRequest(request) {
+  validateRequestObject(request, "Ad group create request");
+  validateId(request.campaign_id, "Campaign id");
+  validateEntityName(request.name, "Ad group name");
+  validatePausedCreateStatus(request.status, "Ad group create request");
+  validateContextHints(request.context_hints);
+  validateBiddingConfig(request.bidding_config);
+}
+function validateUpdateAdGroupRequest(request) {
+  validatePublicUpdateRequest(request, "Ad group update request");
+  if (request.name !== void 0) validateEntityName(request.name, "Ad group name");
+  validateContextHints(request.context_hints);
+  if (request.bidding_config !== void 0) validateBiddingConfig(request.bidding_config);
+}
+function validateCreateAdRequest(request) {
+  validateRequestObject(request, "Ad create request");
+  validateId(request.ad_group_id, "Ad group id");
+  validateEntityName(request.name, "Ad name");
+  validatePausedCreateStatus(request.status, "Ad create request");
+  validateChatCardCreative(request.creative);
+}
+function validateUpdateAdRequest(request) {
+  validatePublicUpdateRequest(request, "Ad update request");
+  if (request.name !== void 0) validateEntityName(request.name, "Ad name");
+  if (request.creative !== void 0) validateChatCardCreative(request.creative);
+}
 function adsClientLog(level, action, ctx) {
   const entry = {
     ts: (/* @__PURE__ */ new Date()).toISOString(),
@@ -4290,14 +4478,15 @@ function buildUrl(path10, queryPairs) {
   const qs = queryPairs.join("&");
   return qs ? `${OPENAI_ADS_API_BASE}/${path10}?${qs}` : `${OPENAI_ADS_API_BASE}/${path10}`;
 }
-async function adsFetch(apiKey, path10, queryPairs = []) {
+async function adsFetch(apiKey, path10, queryPairs = [], method = "GET", body) {
   const url = buildUrl(path10, queryPairs);
   const res = await fetch(url, {
-    method: "GET",
+    method,
     headers: {
       Authorization: `Bearer ${apiKey}`,
       "Content-Type": "application/json"
     },
+    body: body === void 0 ? void 0 : JSON.stringify(body),
     signal: AbortSignal.timeout(OPENAI_ADS_REQUEST_TIMEOUT_MS)
   });
   if (res.status === 401 || res.status === 403) {
@@ -4311,10 +4500,10 @@ async function adsFetch(apiKey, path10, queryPairs = []) {
     throw new OpenAiAdsApiError("OpenAI Ads API rate limit exceeded", 429, code);
   }
   if (!res.ok) {
-    const body = await res.text();
-    const { message, code } = parseErrorEnvelope(body);
+    const body2 = await res.text();
+    const { message, code } = parseErrorEnvelope(body2);
     adsClientLog("error", "http.error", { path: path10, httpStatus: res.status, code });
-    const detail = message ?? (body.length <= 500 ? body : `${body.slice(0, 500)}... [truncated]`);
+    const detail = message ?? (body2.length <= 500 ? body2 : `${body2.slice(0, 500)}... [truncated]`);
     throw new OpenAiAdsApiError(`OpenAI Ads API error (${res.status}): ${detail}`, res.status, code);
   }
   const text = await res.text();
@@ -4350,16 +4539,91 @@ async function listCampaigns(apiKey) {
   validateApiKey(apiKey);
   return fetchAllPages(apiKey, "campaigns", []);
 }
+async function getCampaign(apiKey, campaignId) {
+  validateApiKey(apiKey);
+  validateId(campaignId, "Campaign id");
+  return adsFetch(apiKey, `campaigns/${encodeURIComponent(campaignId)}`);
+}
+async function createCampaign(apiKey, request) {
+  validateApiKey(apiKey);
+  const outbound = snapshotJsonRequest(request, "Campaign create request");
+  validateCreateCampaignRequest(outbound);
+  return adsFetch(apiKey, "campaigns", [], "POST", outbound);
+}
+async function updateCampaign(apiKey, campaignId, request) {
+  validateApiKey(apiKey);
+  validateId(campaignId, "Campaign id");
+  const outbound = snapshotJsonRequest(request, "Campaign update request");
+  validateUpdateCampaignRequest(outbound);
+  return adsFetch(apiKey, `campaigns/${encodeURIComponent(campaignId)}`, [], "POST", outbound);
+}
+async function pauseCampaign(apiKey, campaignId) {
+  validateApiKey(apiKey);
+  validateId(campaignId, "Campaign id");
+  return adsFetch(apiKey, `campaigns/${encodeURIComponent(campaignId)}/pause`, [], "POST");
+}
 async function listAdGroups(apiKey, campaignId) {
   validateApiKey(apiKey);
   validateId(campaignId, "Campaign id");
   return fetchAllPages(apiKey, "ad_groups", [`campaign_id=${encodeURIComponent(campaignId)}`]);
 }
+async function getAdGroup(apiKey, adGroupId) {
+  validateApiKey(apiKey);
+  validateId(adGroupId, "Ad group id");
+  return adsFetch(apiKey, `ad_groups/${encodeURIComponent(adGroupId)}`);
+}
+async function createAdGroup(apiKey, request) {
+  validateApiKey(apiKey);
+  const outbound = snapshotJsonRequest(request, "Ad group create request");
+  validateCreateAdGroupRequest(outbound);
+  return adsFetch(apiKey, "ad_groups", [], "POST", outbound);
+}
+async function updateAdGroup(apiKey, adGroupId, request) {
+  validateApiKey(apiKey);
+  validateId(adGroupId, "Ad group id");
+  const outbound = snapshotJsonRequest(request, "Ad group update request");
+  validateUpdateAdGroupRequest(outbound);
+  return adsFetch(apiKey, `ad_groups/${encodeURIComponent(adGroupId)}`, [], "POST", outbound);
+}
+async function pauseAdGroup(apiKey, adGroupId) {
+  validateApiKey(apiKey);
+  validateId(adGroupId, "Ad group id");
+  return adsFetch(apiKey, `ad_groups/${encodeURIComponent(adGroupId)}/pause`, [], "POST");
+}
 async function listAds(apiKey, adGroupId) {
   validateApiKey(apiKey);
   validateId(adGroupId, "Ad group id");
   return fetchAllPages(apiKey, "ads", [`ad_group_id=${encodeURIComponent(adGroupId)}`]);
 }
+async function getAd(apiKey, adId) {
+  validateApiKey(apiKey);
+  validateId(adId, "Ad id");
+  return adsFetch(apiKey, `ads/${encodeURIComponent(adId)}`);
+}
+async function createAd(apiKey, request) {
+  validateApiKey(apiKey);
+  const outbound = snapshotJsonRequest(request, "Ad create request");
+  validateCreateAdRequest(outbound);
+  return adsFetch(apiKey, "ads", [], "POST", outbound);
+}
+async function updateAd(apiKey, adId, request) {
+  validateApiKey(apiKey);
+  validateId(adId, "Ad id");
+  const outbound = snapshotJsonRequest(request, "Ad update request");
+  validateUpdateAdRequest(outbound);
+  return adsFetch(apiKey, `ads/${encodeURIComponent(adId)}`, [], "POST", outbound);
+}
+async function pauseAd(apiKey, adId) {
+  validateApiKey(apiKey);
+  validateId(adId, "Ad id");
+  return adsFetch(apiKey, `ads/${encodeURIComponent(adId)}/pause`, [], "POST");
+}
+async function uploadImageFromUrl(apiKey, imageUrl) {
+  validateApiKey(apiKey);
+  validateHttpUrl(imageUrl, "Image URL");
+  const request = { image_url: imageUrl };
+  return adsFetch(apiKey, "upload", [], "POST", request);
+}
 async function getCampaignInsights(apiKey, campaignId, opts) {
   validateApiKey(apiKey);
   validateId(campaignId, "Campaign id");
@@ -4491,7 +4755,10 @@ async function executeAdsSync(db, runId, projectId, opts) {
           id: campaign.id,
           projectId,
           name: campaign.name,
+          description: campaign.description ?? null,
           status: campaign.status,
+          startTime: campaign.start_time ?? null,
+          endTime: campaign.end_time ?? null,
           biddingType: campaign.bidding_type,
           dailySpendLimitMicros: campaign.budget?.daily_spend_limit_micros ?? null,
           lifetimeSpendLimitMicros: campaign.budget?.lifetime_spend_limit_micros ?? null,
@@ -4507,6 +4774,7 @@ async function executeAdsSync(db, runId, projectId, opts) {
             projectId,
             campaignId: campaign.id,
             name: group.name,
+            description: group.description ?? null,
             status: group.status,
             billingEventType: group.bidding_config?.billing_event_type ?? null,
             maxBidMicros: group.bidding_config?.max_bid_micros ?? null,
@@ -6515,7 +6783,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-GNOE4J35.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-FWPXMAVK.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -8605,6 +8873,17 @@ var AERO_ADS_OPERATOR_MCP_TOOL_NAMES = /* @__PURE__ */ new Set([
   CanonryMcpToolNames.canonry_ads_campaigns,
   CanonryMcpToolNames.canonry_ads_insights,
   CanonryMcpToolNames.canonry_ads_summary,
+  CanonryMcpToolNames.canonry_ads_operation_get,
+  CanonryMcpToolNames.canonry_ads_image_upload,
+  CanonryMcpToolNames.canonry_ads_campaign_create,
+  CanonryMcpToolNames.canonry_ads_campaign_update,
+  CanonryMcpToolNames.canonry_ads_campaign_pause,
+  CanonryMcpToolNames.canonry_ads_ad_group_create,
+  CanonryMcpToolNames.canonry_ads_ad_group_update,
+  CanonryMcpToolNames.canonry_ads_ad_group_pause,
+  CanonryMcpToolNames.canonry_ads_ad_create,
+  CanonryMcpToolNames.canonry_ads_ad_update,
+  CanonryMcpToolNames.canonry_ads_ad_pause,
   CanonryMcpToolNames.canonry_ads_sync
 ]);
 function toolResult(details) {
@@ -8666,6 +8945,7 @@ function compactCampaigns(response, limit) {
       adGroups: campaign.adGroups.slice(0, 8).map((group) => ({
         id: group.id,
         name: group.name,
+        description: group.description,
         status: group.status,
         billingEventType: group.billingEventType,
         maxBidMicros: group.maxBidMicros,
@@ -8677,14 +8957,25 @@ function compactCampaigns(response, limit) {
           name: ad.name,
           status: ad.status,
           reviewStatus: ad.reviewStatus,
+          upstreamUpdatedAt: ad.upstreamUpdatedAt,
+          syncedAt: ad.syncedAt,
           creative: ad.creative ? {
             type: ad.creative.type,
             title: ad.creative.title,
             body: ad.creative.body,
-            targetUrl: ad.creative.targetUrl
+            targetUrl: ad.creative.targetUrl,
+            fileId: ad.creative.fileId
           } : ad.creative
-        }))
-      }))
+        })),
+        upstreamUpdatedAt: group.upstreamUpdatedAt,
+        syncedAt: group.syncedAt
+      })),
+      description: campaign.description,
+      startTime: campaign.startTime,
+      endTime: campaign.endTime,
+      locationIds: campaign.locationIds ?? [],
+      upstreamUpdatedAt: campaign.upstreamUpdatedAt,
+      syncedAt: campaign.syncedAt
     }))
   };
 }
@@ -8845,11 +9136,11 @@ function recordLlmUsageEvent(args) {
 var AERO_MEMORY_SEPARATOR = "\n\n---\n\n";
 var AERO_MEMORY_BLOCK_PREFIX = `${AERO_MEMORY_SEPARATOR}<memory>
 `;
-function isRecord(value) {
+function isRecord2(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function isTextSystemBlock(value) {
-  return isRecord(value) && value.type === "text" && typeof value.text === "string";
+  return isRecord2(value) && value.type === "text" && typeof value.text === "string";
 }
 function splitAeroHydratedSystemPrompt(systemPrompt) {
   const idx = systemPrompt.lastIndexOf(AERO_MEMORY_BLOCK_PREFIX);
@@ -8861,7 +9152,7 @@ function splitAeroHydratedSystemPrompt(systemPrompt) {
 }
 function splitAeroAnthropicSystemCachePayload(payload, model) {
   if (model.api !== "anthropic-messages") return void 0;
-  if (!isRecord(payload) || !Array.isArray(payload.system)) return void 0;
+  if (!isRecord2(payload) || !Array.isArray(payload.system)) return void 0;
   let changed = false;
   const nextSystem = [];
   for (const block of payload.system) {
@@ -11371,6 +11662,83 @@ async function createServer(opts) {
       timezone: account.timezone ?? null
     };
   };
+  const adsEntityResult = (entity) => ({
+    id: entity.id,
+    status: entity.status,
+    updatedAt: entity.updated_at,
+    reviewStatus: entity.review_status ?? null
+  });
+  const adsOperator = {
+    uploadImage: async (apiKey, imageUrl) => {
+      const result = await uploadImageFromUrl(apiKey, imageUrl);
+      return { fileId: result.file_id };
+    },
+    getCampaign: async (apiKey, id) => adsEntityResult(await getCampaign(apiKey, id)),
+    createCampaign: async (apiKey, input) => adsEntityResult(await createCampaign(apiKey, {
+      name: input.name,
+      description: input.description,
+      start_time: input.startTime,
+      end_time: input.endTime,
+      status: OpenAiAdsWriteStatuses.paused,
+      budget: { lifetime_spend_limit_micros: input.lifetimeSpendLimitMicros },
+      targeting: { locations: { include: input.locationIds.map((id) => ({ id })) } }
+    })),
+    updateCampaign: async (apiKey, id, input) => adsEntityResult(await updateCampaign(apiKey, id, {
+      name: input.name,
+      description: input.description,
+      start_time: input.startTime,
+      end_time: input.endTime,
+      budget: input.lifetimeSpendLimitMicros === void 0 ? void 0 : { lifetime_spend_limit_micros: input.lifetimeSpendLimitMicros },
+      targeting: input.locationIds === void 0 ? void 0 : { locations: { include: input.locationIds.map((locationId) => ({ id: locationId })) } }
+    })),
+    pauseCampaign: async (apiKey, id) => adsEntityResult(await pauseCampaign(apiKey, id)),
+    getAdGroup: async (apiKey, id) => adsEntityResult(await getAdGroup(apiKey, id)),
+    createAdGroup: async (apiKey, input) => adsEntityResult(await createAdGroup(apiKey, {
+      campaign_id: input.campaignId,
+      name: input.name,
+      description: input.description,
+      context_hints: input.contextHints,
+      status: OpenAiAdsWriteStatuses.paused,
+      bidding_config: {
+        billing_event_type: OpenAiAdsBillingEventTypes.impression,
+        max_bid_micros: input.maxBidMicros
+      }
+    })),
+    updateAdGroup: async (apiKey, id, input) => adsEntityResult(await updateAdGroup(apiKey, id, {
+      name: input.name,
+      description: input.description,
+      context_hints: input.contextHints,
+      bidding_config: input.maxBidMicros === void 0 ? void 0 : {
+        billing_event_type: OpenAiAdsBillingEventTypes.impression,
+        max_bid_micros: input.maxBidMicros
+      }
+    })),
+    pauseAdGroup: async (apiKey, id) => adsEntityResult(await pauseAdGroup(apiKey, id)),
+    getAd: async (apiKey, id) => adsEntityResult(await getAd(apiKey, id)),
+    createAd: async (apiKey, input) => adsEntityResult(await createAd(apiKey, {
+      ad_group_id: input.adGroupId,
+      name: input.name,
+      status: OpenAiAdsWriteStatuses.paused,
+      creative: {
+        type: OpenAiAdsCreativeTypes.chatCard,
+        title: input.creative.title,
+        body: input.creative.body,
+        target_url: input.creative.targetUrl,
+        file_id: input.creative.fileId
+      }
+    })),
+    updateAd: async (apiKey, id, input) => adsEntityResult(await updateAd(apiKey, id, {
+      name: input.name,
+      creative: input.creative ? {
+        type: OpenAiAdsCreativeTypes.chatCard,
+        title: input.creative.title,
+        body: input.creative.body,
+        target_url: input.creative.targetUrl,
+        file_id: input.creative.fileId
+      } : void 0
+    })),
+    pauseAd: async (apiKey, id) => adsEntityResult(await pauseAd(apiKey, id))
+  };
   const scheduler = new Scheduler(opts.db, {
     onRunCreated: (runId, projectId, providers2, location) => {
       jobRunner.executeRun(runId, projectId, providers2, location).catch((err) => {
@@ -11963,6 +12331,7 @@ async function createServer(opts) {
     },
     adsCredentialStore,
     verifyAdsAccount,
+    adsOperator,
     onAdsSyncRequested: (runId, projectId) => {
       runAdsSync(runId, projectId);
     },