@adkit/cli 1.13.36 → 1.13.37

package/dist/cli.js

@@ -2017,8 +2017,8 @@ var ASSET_CREATE_FLAGS = ["type", "text", "sitelink", "header", "value", "descri
 var ASSET_LINK_FLAGS = ["type", "scope", "scope-id", "status"];
 var MEDIA_UPLOAD_FLAGS = ["file", "url", "base64", "adkit-media", "video-id", "filename", "content-type", "name"];
 var CAMPAIGN_LIST_FLAGS = ["status", "limit", "offset"];
-var CAMPAIGN_CREATE_FLAGS = ["name", "status", "budget-daily", "campaign-type", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "conversion-goals", "countries"];
-var CAMPAIGN_UPDATE_FLAGS = ["name", "status", "budget-daily", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "conversion-goals", "countries"];
+var CAMPAIGN_CREATE_FLAGS = ["ai-max", "name", "status", "budget-daily", "campaign-type", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "conversion-goals", "countries"];
+var CAMPAIGN_UPDATE_FLAGS = ["ai-max", "name", "status", "budget-daily", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "conversion-goals", "countries"];
 var ASSET_GROUP_LIST_FLAGS = ["campaign", "limit", "offset"];
 var ASSET_GROUP_CREATE_FLAGS = ["campaign", "name", "status", "final-url"];
 var ASSET_GROUP_UPDATE_FLAGS = ["name", "status", "final-url"];
@@ -2310,6 +2310,7 @@ function resolveAssetScope(flags) {
 }
 function buildCampaignPayload2(flags) {
   const payload = {};
+  if (flags["ai-max"] !== void 0) payload.aiMax = parseGoogleCampaignAiMaxFlag(flags["ai-max"]);
   if (typeof flags.name === "string") payload.name = flags.name;
   if (typeof flags.status === "string") payload.status = flags.status;
   if (typeof flags["campaign-type"] === "string") payload.campaignType = flags["campaign-type"];
@@ -2324,6 +2325,11 @@ function buildCampaignPayload2(flags) {
   if (typeof flags.countries === "string") payload.countries = parseCampaignCountries(flags.countries);
   return payload;
 }
+function parseGoogleCampaignAiMaxFlag(value) {
+  if (value === true || value === "true") return { enabled: true };
+  if (value === false || value === "false") return { enabled: false };
+  throw new CliError("INVALID_VALUE", "Invalid --ai-max value", "Use --ai-max true or --ai-max false");
+}
 function parseCampaignCountries(value) {
   const countryParts = value.split(",");
   const normalizedCountries = countryParts.map((country) => country.trim().toUpperCase());
@@ -2337,6 +2343,7 @@ function parseCampaignConversionGoals(value) {
 }
 function buildCampaignUpdatePayloadFromFlags(flags) {
   const payload = {};
+  if (flags["ai-max"] !== void 0) payload.aiMax = parseGoogleCampaignAiMaxFlag(flags["ai-max"]);
   if (typeof flags.name === "string") payload.name = flags.name;
   if (typeof flags.status === "string") payload.status = flags.status;
   if (typeof flags["budget-daily"] === "string") payload.budget = { daily: Number.parseFloat(flags["budget-daily"]) };
@@ -2778,9 +2785,11 @@ async function listGoogleAssetGroups(client, _args, flags) {
   return client.get(`/manage/google/asset-groups${qs}`);
 }
 async function getGoogleAssetGroup(client, args, flags) {
-  validateFlags(flags, ["raw"], "manage google asset-groups <id>");
+  validateFlags(flags, ["raw", "fields"], "manage google asset-groups <id>");
   const id = requireGoogleNumericId(args, "asset-group-id", "Run: adkit manage google asset-groups <asset-group-id>");
-  const qs = buildGoogleListQuery(flags);
+  const fields = typeof flags.fields === "string" ? flags.fields : void 0;
+  const qs = buildGoogleListQuery(flags, { fields });
+  if (fields !== void 0) delete flags.fields;
   return client.get(`/manage/google/asset-groups/${id}${qs}`);
 }
 async function createGoogleAssetGroup(client, _args, flags) {
@@ -3063,7 +3072,7 @@ function parseGoogleResultsLevelArg(args) {
   const [rawLevel, ...unexpectedArgs] = args;
   if (!rawLevel) return void 0;
   const level = rawLevel.trim().toLowerCase();
-  if (level !== "campaigns" && level !== "ad-groups" && level !== "ads") throw new CliError("UNKNOWN_COMMAND", `Unknown action: google results ${rawLevel}`, "Available: campaigns, ad-groups, ads, keywords, placements, search-terms");
+  if (level !== "campaigns" && level !== "ad-groups" && level !== "asset-groups" && level !== "ads") throw new CliError("UNKNOWN_COMMAND", `Unknown action: google results ${rawLevel}`, "Available: campaigns, ad-groups, asset-groups, ads, keywords, placements, search-terms");
   if (unexpectedArgs.length > 0) throw new CliError("UNKNOWN_COMMAND", `Unknown argument after google results ${rawLevel}: ${unexpectedArgs.join(" ")}`, `Run: adkit manage google results ${level} --help`);
   return level;
 }
@@ -3074,11 +3083,13 @@ function inferGoogleResultsLevel(campaignId, adGroupId, explicitLevel) {
   return void 0;
 }
 async function listGoogleResults(client, args, flags) {
+  const requestedLevel = parseGoogleResultsLevelArg(args);
+  if (requestedLevel === "asset-groups") return listGoogleAssetGroupResults(client, flags);
   validateFlags(flags, GOOGLE_RESULTS_FLAGS, "manage google results");
   const accountId = typeof flags.account === "string" ? flags.account : void 0;
   const campaignId = typeof flags.campaign === "string" ? flags.campaign : void 0;
   const adGroupId = typeof flags["ad-group"] === "string" ? flags["ad-group"] : void 0;
-  const explicitLevel = parseGoogleResultsLevelArg(args);
+  const explicitLevel = requestedLevel;
   const level = inferGoogleResultsLevel(campaignId, adGroupId, explicitLevel);
   const period = typeof flags.period === "string" ? flags.period : void 0;
   const from = typeof flags.from === "string" ? flags.from : void 0;
@@ -3095,6 +3106,19 @@ async function listGoogleResults(client, args, flags) {
   const qs = queryString({ accountId, level, campaignId, adGroupId, period, from, to, sort, limit, status: status2, breakdown, fields, conversionActions, raw });
   return client.get(`/manage/google/results${qs}`);
 }
+async function listGoogleAssetGroupResults(client, flags) {
+  validateFlags(flags, ["campaign", "asset-group", "period", "from", "to", "sort", "sort-direction", "limit", "offset", "status", "breakdown", "fields", "raw"], "manage google results asset-groups");
+  const mappings = { account: "accountId", campaign: "campaignIds", "asset-group": "assetGroupIds", period: "period", from: "from", to: "to", sort: "sort", "sort-direction": "sortDirection", limit: "limit", offset: "offset", status: "statuses", breakdown: "breakdowns", fields: "fields" };
+  const params = { level: "asset-groups" };
+  for (const [flag, param] of Object.entries(mappings)) {
+    const value = flags[flag];
+    if (typeof value === "string") params[param] = value;
+  }
+  if (flags.raw === true) params.raw = "true";
+  if (typeof flags.fields === "string") delete flags.fields;
+  const qs = queryString(params);
+  return client.get(`/manage/google/results${qs}`);
+}
 function buildSearchTermsQuery(flags) {
   const accountId = typeof flags.account === "string" ? flags.account : void 0;
   const campaignId = typeof flags.campaign === "string" ? flags.campaign : void 0;
@@ -5700,7 +5724,7 @@ var CLI_VERSION = require2("../package.json").version;
 var DEFAULT_BASE_URL = "https://app.adkit.so/api/v1";
 var GOOGLE_NUMERIC_ID_PATTERN2 = /^\d+$/;
 var GOOGLE_CAMPAIGN_CONVERSION_GOAL_CATEGORY_LIST = GOOGLE_CAMPAIGN_CONVERSION_GOAL_CATEGORIES.join(", ");
-var GOOGLE_RESULTS_LEVEL_ACTIONS = /* @__PURE__ */ new Set(["campaigns", "ad-groups", "ads"]);
+var GOOGLE_RESULTS_LEVEL_ACTIONS = /* @__PURE__ */ new Set(["campaigns", "ad-groups", "asset-groups", "ads"]);
 var TIKTOK_NUMERIC_ID_PATTERN = /^\d+$/;
 var REDDIT_ID_PATTERN = /^[A-Za-z0-9_-]+$/;
 var LINKEDIN_ID_PATTERN = /[\d:_]/;
@@ -6406,6 +6430,7 @@ Flags (create):
   --bid-strategy <s>  manual_cpc, manual_cpm, maximize_clicks, maximize_conversions, maximize_conversion_value, target_spend, target_impression_share
   --target-cpa <n>    Target CPA in account currency (with --bid-strategy maximize_conversions)
   --target-roas <n>   Target ROAS ratio, e.g. 3.5 = 350% (with --bid-strategy maximize_conversion_value)
+  --ai-max <true|false>  AI Max master switch (Search only)
   --conversion-goals <list>  Comma-separated goal categories or conversion-action IDs; never mix them
 
 Flags (update):
@@ -6415,6 +6440,7 @@ Flags (update):
   --bid-strategy <s>  Change bidding strategy
   --target-cpa <n>    Target CPA in account currency. Send alone to retune the existing maximize_conversions target
   --target-roas <n>   Target ROAS ratio (3.5 = 350%). Send alone to retune the existing target, incl. Performance Max
+  --ai-max <true|false>  Enable/disable AI Max (Search only); omit to leave unchanged
   --conversion-goals <list>  Replace goals; pass null to restore account defaults
   --countries <codes> Replace included countries, e.g. US,CA
 
@@ -6424,7 +6450,10 @@ Flags (list):
   --offset <n>        Pagination offset
 
 Note:
-  list returns campaign configuration only (name, status, budget).
+  list returns campaign configuration only (name, status, budget, aiMax when Google returns it).
+  AI Max: --ai-max true or --data '{"aiMax":{"enabled":true}}'. This master switch does not opt in to text customization or Final URL expansion.
+  Enabling expands search matching unless disabled on an ad group. Disabling stops all AI Max features, including previously enabled text customization.
+  AI Max does not guarantee an AI Mode placement.
   Geo targeting lives in targeting.geoLocations. For countries, use {"type":"country","country":"US"}.
   Use --data to set match to "presence" or "presence_or_interest". AdKit uses presence on create; on update, omit match to keep the live value.
   For cities, regions, postal codes, and metros, run google geo-locations search and use the returned bare code.
@@ -6464,6 +6493,7 @@ Flags (create):
   --budget-daily <n>  Daily budget in account currency
   --campaign-type <type>    search, display, demand_gen, performance_max (performance_max needs --data for asset groups)
   --bid-strategy <s>  manual_cpc, manual_cpm, maximize_clicks, maximize_conversions, maximize_conversion_value, target_spend, target_impression_share
+  --ai-max <true|false>  AI Max master switch (Search only)
   --conversion-goals <list>  Comma-separated goal categories or conversion-action IDs; never mix them
 ${FLAG.account}
 ${FLAG.publish}
@@ -6474,6 +6504,7 @@ Flags (update):
   --status <s>        enabled, paused
   --budget-daily <n>  Daily budget in account currency
   --bid-strategy <s>  Change bidding strategy
+  --ai-max <true|false>  Enable/disable AI Max (Search only); omit to leave unchanged
   --conversion-goals <list>  Replace goals; pass null to restore account defaults
   --countries <codes> Replace included countries, e.g. US,CA
 ${FLAG.account}
@@ -6487,7 +6518,10 @@ Flags (list):
 
 Notes:
   Use google assets for explicit account/campaign/ad-group attachment, reusable libraries, or richer sitelinks via --data.
-  list returns campaign configuration only (name, status, budget).
+  list returns campaign configuration only (name, status, budget, aiMax when Google returns it).
+  AI Max: --ai-max true or --data '{"aiMax":{"enabled":true}}'. This master switch does not opt in to text customization or Final URL expansion.
+  Enabling expands search matching unless disabled on an ad group. Disabling stops all AI Max features, including previously enabled text customization.
+  AI Max does not guarantee an AI Mode placement.
   Geo targeting lives in targeting.geoLocations. For countries, use {"type":"country","country":"US"}.
   Use --data to set match to "presence" or "presence_or_interest". AdKit uses presence on create; on update, match alone changes matching without replacing locations and omission keeps the live value.
   platformLocation accepts exact Google geo objects for advanced criteria and existing raw values.
@@ -6524,6 +6558,10 @@ var GOOGLE_ASSET_GROUP_HELP = `adkit manage google asset-groups \u2014 Performan
   delete <id>         Delete by numeric Google asset group ID (platformId)
   <id>                View one group by numeric Google asset group ID (platformId)
 
+Flags (detail):
+  --fields <list>     Select detail fields, e.g. name,listingGroups. Omit for full detail.
+  listingGroups is the configured include/exclude rule tree, not an expanded SKU inventory.
+
 Flags (list):
   --campaign <id>     Parent Performance Max campaign ID (required)
   --limit <n>         Max results
@@ -6922,6 +6960,7 @@ var GOOGLE_RESULTS_HELP = `adkit manage google results \u2014 Google Ads perform
   [default]           Account-wide or filtered performance metrics
   campaigns           One row per campaign
   ad-groups           One row per ad group
+  asset-groups        Performance Max asset-group reports
   ads                 One row per ad
   keywords            Keyword-level spend, clicks, impressions per keyword
   placements          Placement report: websites, apps, and YouTube
@@ -6943,7 +6982,17 @@ Flags:
   --raw               Return raw Google API response
   --account <id>      Optional if one Google Ads account is connected
 
-Default metrics include:
+PMax asset-groups:
+  Returns { report, rows, totals?, warnings? }; each row has entity, metrics and conversionEvents.
+  Metrics: spend, conversions, conversionValue, costPerConversion (CPA), roas, clicks, impressions.
+  Use --campaign <ids> and --asset-group <ids> (comma-separated), --period or --from/--to.
+  --sort defaults to spend; --sort-direction asc|desc; --limit defaults to 1000; --offset for pages.
+  --status active|paused|removed (comma-separated; omitted includes all); --breakdown day|device|network.
+  --fields selects the metrics above. --raw adds provider fields inside each row, keeping the report envelope.
+  Finite dates required; conversion-actions and legacy metric names are not supported at this level.
+  Product rules: adkit manage google asset-groups <id> --fields listingGroups
+
+Default metrics for other levels include:
   Cost/clicks/conversions, CPA, CVR, ROAS, all conversions, view-through conversions,
   top-position rates, search impression share where Google supports it, and serving/learning status.
 
@@ -6958,6 +7007,7 @@ Examples:
   adkit manage google results
   adkit manage google results campaigns --account 1234567890 --period 30d
   adkit manage google results ad-groups --campaign 123 --period 30d
+  adkit manage google results asset-groups --campaign 123 --period 30d
   adkit manage google results ads --campaign 123 --period 30d
   adkit manage google results keywords --account 1234567890 --period 7d
   adkit manage google results --campaign 123 --period 7d

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.13.36",
+  "version": "1.13.37",
   "description": "The Ads CLI for AI agents — manage Meta & Google ad campaigns, browse the ad library, and generate creatives from your terminal.",
   "keywords": [
     "ads cli",