@adkit/cli 1.13.1 → 1.13.3

package/dist/cli.js

@@ -1834,7 +1834,7 @@ var CAMPAIGN_CREATE_FLAGS = ["name", "status", "budget-daily", "campaign-type",
 var CAMPAIGN_UPDATE_FLAGS = ["name", "status", "budget-daily", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "countries"];
 var AD_GROUP_LIST_FLAGS = ["campaign", "status", "limit", "offset"];
 var AD_GROUP_FLAGS = ["campaign", "name", "status", "cpc-bid"];
-var AD_LIST_FLAGS = ["ad-group", "status", "policy-status", "limit", "offset"];
+var AD_LIST_FLAGS = ["ad-group", "campaign", "status", "policy-status", "limit", "offset"];
 var AD_FLAGS2 = ["headline", "headline-1", "headline-2", "headline-3", "description", "description-1", "description-2", "callout", "sitelink", "final-url", "path", "ad-group", "status"];
 var KEYWORD_LIST_FLAGS = ["ad-group", "campaign", "status", "limit", "offset"];
 var KEYWORD_FLAGS = ["ad-group", "text", "match-type", "cpc-bid", "status"];
@@ -2484,8 +2484,9 @@ async function deleteAdGroup(client, args, flags) {
 }
 async function listGoogleAds(client, _args, flags) {
   validateFlags(flags, AD_LIST_FLAGS, "manage google ads list");
-  const adGroupId = typeof flags["ad-group"] === "string" ? flags["ad-group"] : void 0;
-  const qs = buildGoogleListQuery(flags, { adGroupId });
+  const adGroupIds = typeof flags["ad-group"] === "string" ? flags["ad-group"] : void 0;
+  const campaignIds = typeof flags.campaign === "string" ? flags.campaign : void 0;
+  const qs = buildGoogleListQuery(flags, { adGroupIds, campaignIds });
   const path3 = `/manage/google/ads${qs}`;
   return client.get(path3);
 }
@@ -2782,17 +2783,25 @@ async function listGoogleKeywordResults(client, _args, flags) {
 }
 async function researchKeywords(client, _args, flags) {
   validateFlags(flags, KEYWORD_RESEARCH_FLAGS, "manage google research keywords");
-  const keywords = _args.join(",");
-  if (!keywords) throw new CliError("MISSING_ARGUMENT", "At least one seed keyword is required", 'Run: adkit manage google research keywords "saas ads" --account 1234567890');
+  const keywords = _args.map((keyword) => keyword.trim());
+  const hasBlankKeyword = keywords.some((keyword) => keyword.length === 0);
+  if (keywords.length === 0) throw new CliError("MISSING_ARGUMENT", "At least one seed keyword is required", 'Run: adkit manage google research keywords "saas ads" --account 1234567890');
+  if (hasBlankKeyword) throw new CliError("INVALID_VALUE", "Seed keywords must be non-empty", 'Run: adkit manage google research keywords "saas ads" --account 1234567890');
   const url = typeof flags.url === "string" ? flags.url : void 0;
   const location = typeof flags.location === "string" ? flags.location : void 0;
   const language = typeof flags.language === "string" ? flags.language : void 0;
   const limit = typeof flags.limit === "string" ? flags.limit : void 0;
   const minVolume = typeof flags["min-volume"] === "string" ? flags["min-volume"] : void 0;
   const accountId = typeof flags.account === "string" ? flags.account : void 0;
-  const qs = queryString({ accountId, keywords, url, location, language, limit, minVolume });
-  const path3 = `/manage/google/research/keywords${qs}`;
-  return client.get(path3);
+  return client.post("/manage/google/research/keywords", {
+    accountId,
+    keywords,
+    url,
+    location,
+    language,
+    limit,
+    minVolume
+  });
 }
 async function researchTopics(client, args, flags) {
   validateFlags(flags, TARGETING_RESEARCH_FLAGS, "manage google research topics");
@@ -3504,6 +3513,7 @@ function isStatusResponse(value) {
   if (!value || typeof value !== "object") return false;
   if (!("connected" in value) || typeof value.connected !== "boolean") return false;
   if (!("project" in value) || !value.project || typeof value.project !== "object") return false;
+  if (!("instructions" in value) || typeof value.instructions !== "string") return false;
   if (!("platforms" in value) || !value.platforms || typeof value.platforms !== "object") return false;
   return true;
 }
@@ -3531,6 +3541,8 @@ async function status(client, json) {
     lines.push("Google: connected");
     for (const a of platforms.google.accounts) lines.push(`  ${a.id} \u2014 ${a.name} (${a.currency})`);
   } else lines.push("Google: not connected");
+  lines.push("");
+  lines.push(data.instructions);
   console.log(lines.join("\n"));
 }
 
@@ -4150,7 +4162,10 @@ function wrapToLines(value, max) {
     if (word.length > max) {
       if (current) lines.push(current);
       current = "";
-      for (let i = 0; i < word.length; i += max) lines.push(word.slice(i, i + max));
+      for (let i = 0; i < word.length; i += max) {
+        const chunk = word.slice(i, i + max);
+        lines.push(chunk);
+      }
       continue;
     }
     const next = current ? current + " " + word : word;
@@ -4164,14 +4179,19 @@ function wrapToLines(value, max) {
   if (current) lines.push(current);
   return lines.length > 0 ? lines : [""];
 }
-function formatSearchTermCost(cost) {
-  return `$${cost.toFixed(2)}`;
+function formatSearchTermMoney(value) {
+  return `$${value.toFixed(2)}`;
 }
 function formatSearchTermConversions(conversions) {
   if (conversions === 0) return "0";
   const fixed = conversions.toFixed(2);
   return fixed.replace(/\.?0+$/, "");
 }
+function formatSearchTermRoas(roas) {
+  if (roas === 0) return "0x";
+  const fixed = roas.toFixed(2);
+  return fixed.replace(/\.?0+$/, "") + "x";
+}
 function hasSearchTermStringFields(value) {
   if (value === null || typeof value !== "object") return false;
   if (!("searchTerm" in value) || typeof value.searchTerm !== "string") return false;
@@ -4182,7 +4202,11 @@ function hasSearchTermStringFields(value) {
 function hasSearchTermNumberFields(value) {
   if (value === null || typeof value !== "object") return false;
   if (!("impressions" in value) || typeof value.impressions !== "number") return false;
+  if (!("clicks" in value) || typeof value.clicks !== "number") return false;
   if (!("cost" in value) || typeof value.cost !== "number") return false;
+  if (!("conversions" in value) || typeof value.conversions !== "number") return false;
+  if (!("conversionsValue" in value) || typeof value.conversionsValue !== "number") return false;
+  if (!("roas" in value) || typeof value.roas !== "number") return false;
   return true;
 }
 function isGoogleSearchTermRecord(value) {
@@ -4205,8 +4229,10 @@ function toGoogleSearchTermDisplayRows(row) {
       MATCH: isFirst ? row.matchType : "",
       IMPR: isFirst ? row.impressions : "",
       CLICKS: isFirst ? row.clicks : "",
-      COST: isFirst ? formatSearchTermCost(row.cost) : "",
-      CONV: isFirst ? formatSearchTermConversions(row.conversions) : ""
+      COST: isFirst ? formatSearchTermMoney(row.cost) : "",
+      CONV: isFirst ? formatSearchTermConversions(row.conversions) : "",
+      VALUE: isFirst ? formatSearchTermMoney(row.conversionsValue) : "",
+      ROAS: isFirst ? formatSearchTermRoas(row.roas) : ""
     });
   }
   return result;
@@ -5242,7 +5268,7 @@ Notes:
   Display targeting is passed with --data on create or update:
     targeting.audience.interests, targeting.audience.customAudiences, targeting.content.topics, targeting.content.websites.
   Topic and interest search return IDs used in targeting: research topics -> targeting.content.topics; research interests -> targeting.audience.interests.
-  Websites use direct URLs in targeting.content.websites.include/exclude. Custom audiences are Google user list IDs.
+  Websites use direct URLs in targeting.content.websites.include/exclude. Bare numeric customAudiences IDs are treated as Google user lists (remarketing/Customer Match); for custom segments, pass a customAudiences/{id} or customers/{accountId}/customAudiences/{id} resource path.
   WARNING: On update, targeting replaces the full Display targeting set. If you send only one new website, old websites/topics/audiences can be removed.
   list returns ad group configuration only (name, status, bid).
   For spend/clicks/conversions: adkit manage google results
@@ -5274,7 +5300,8 @@ Flags (create/update):
   --status <s>           enabled, paused, removed
 
 Flags (list):
-  --ad-group <id>        Filter by Google ad group ID (platformId)
+  --campaign <ids>       Filter by Google campaign IDs (platformId, comma-separated)
+  --ad-group <ids>       Filter by Google ad group IDs (platformId, comma-separated)
   --status <s>           Filter by ad status (default: enabled,paused; use all for every status)
   --policy-status <s>    Filter by policy status: approved, limited, disapproved, problem, pending_review, under_appeal
   --limit <n>            Max results
@@ -5293,6 +5320,7 @@ Notes:
   That means sibling ads in the same ad group may also use those assets. Use google assets if you need explicit scope control or richer sitelink payloads.
 
 Examples:
+  adkit manage google ads list --account 1234567890 --campaign 987654321,987654322
   adkit manage google ads list --account 1234567890 --ad-group 555666777
   adkit manage google ads create --data '{"ads":[{"type":"responsive_display","adGroupId":"555666777","headlines":[{"text":"Display headline"}],"longHeadline":{"text":"A longer Display headline"},"descriptions":[{"text":"Display description"}],"businessName":"AdKit","finalUrls":["https://example.com"],"media":[{"role":"marketing_image","id":"customers/123/assets/111"},{"role":"square_marketing_image","id":"customers/123/assets/222"},{"role":"logo","id":"customers/123/assets/333"},{"role":"square_logo","id":"customers/123/assets/444"}]}]}' --account 1234567890
   adkit manage google ads create --ad-group 555666777 \\
@@ -5328,7 +5356,8 @@ ${FLAG.publish}
 ${FLAG.data}
 
 Flags (list):
-  --ad-group <id>        Filter by Google ad group ID (platformId)
+  --campaign <ids>       Filter by Google campaign IDs (platformId, comma-separated)
+  --ad-group <ids>       Filter by Google ad group IDs (platformId, comma-separated)
   --status <s>           Filter by ad status (default: enabled,paused; use all for every status)
   --policy-status <s>    Filter by policy status: approved, limited, disapproved, problem, pending_review, under_appeal
   --limit <n>            Max results
@@ -5349,6 +5378,7 @@ Notes:
   Path format: pass one string like "crm" or "crm/demo". AdKit normalizes extra slashes, and each segment must stay within Google's 15-character limit.
 
 Examples:
+  adkit manage google ads list --account 1234567890 --campaign 987654321,987654322
   adkit manage google ads list --account 1234567890 --ad-group 555666777
   adkit manage google ads create --data '{"ads":[{"type":"responsive_display","adGroupId":"555666777","headlines":[{"text":"Display headline"}],"longHeadline":{"text":"A longer Display headline"},"descriptions":[{"text":"Display description"}],"businessName":"AdKit","finalUrls":["https://example.com"],"media":[{"role":"marketing_image","id":"customers/123/assets/111"},{"role":"square_marketing_image","id":"customers/123/assets/222"},{"role":"logo","id":"customers/123/assets/333"},{"role":"square_logo","id":"customers/123/assets/444"}]}]}' --account 1234567890
   adkit manage google ads create --ad-group 555666777 \\
@@ -5623,6 +5653,8 @@ Flags:
   --limit <n>             Max results
   --raw                   Return raw Google API response
 
+Output includes conversion value and ROAS so tROAS accounts can be judged from the same rows.
+
 Examples:
   adkit manage google results search-terms --account 1234567890
   adkit manage google results search-terms --account 1234567890 --campaign 456 --period 30d --sort clicks
@@ -5665,7 +5697,7 @@ Examples:
   adkit manage google results keywords --account 1234567890 --period 30d --fields all`;
 var GOOGLE_RESEARCH_HELP = `adkit manage google research \u2014 Google Ads research tools
 
-  keywords <query>    Get keyword ideas from Google Keyword Planner
+  keywords <keyword...>  Get keyword ideas from Google Keyword Planner
   topics <query>      Find Display topic IDs for targeting.content.topics
   interests <query>   Find Display interest IDs for targeting.audience.interests
 
@@ -5687,9 +5719,10 @@ Examples:
   adkit manage google research interests software --account 1234567890
 
 Notes:
+  Keyword research: pass each seed keyword as a separate argument. Do not comma-separate keywords.
   Topic search returns IDs for targeting.content.topics.include/exclude.
   Interest search returns IDs for targeting.audience.interests.include/exclude.
-  Websites use direct URLs in targeting.content.websites.include/exclude. Custom audiences are Google user list IDs.`;
+  Websites use direct URLs in targeting.content.websites.include/exclude. Bare numeric customAudiences IDs are treated as Google user lists (remarketing/Customer Match); for custom segments, pass a customAudiences/{id} or customers/{accountId}/customAudiences/{id} resource path.`;
 var GOOGLE_MEDIA_HELP = `adkit manage google media \u2014 Upload creative media to Google Ads
 
   upload              Upload an image and return reusable Google asset IDs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.13.1",
+  "version": "1.13.3",
   "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",