@adkit/cli 1.13.0 → 1.13.2

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");
@@ -3493,6 +3502,12 @@ function buildLinkedInMediaUploadSource(flags) {
   return source;
 }
 
+// src/commands/microsoft.ts
+async function listMicrosoftAvailableAccounts(client, _args, flags) {
+  validateFlags(flags, [], "manage microsoft accounts available");
+  return client.get("/manage/microsoft/accounts/available");
+}
+
 // src/commands/status.ts
 function isStatusResponse(value) {
   if (!value || typeof value !== "object") return false;
@@ -4144,7 +4159,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;
@@ -4158,14 +4176,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;
@@ -4176,7 +4199,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) {
@@ -4199,8 +4226,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;
@@ -4456,7 +4485,7 @@ var FLAG = {
   budgetDaily: "  --budget-daily <n>  Daily budget in account currency",
   cta: "  --cta <type>        sign_up, learn_more, shop_now, download, get_offer, contact_us, subscribe, get_quote, book_now, apply_now"
 };
-var RAW_PLATFORM_LABELS = { google: "Google", meta: "Meta", reddit: "Reddit", tiktok: "TikTok", x: "X", linkedin: "LinkedIn" };
+var RAW_PLATFORM_LABELS = { google: "Google", meta: "Meta", reddit: "Reddit", tiktok: "TikTok", x: "X", linkedin: "LinkedIn", microsoft: "Microsoft" };
 function rawPlatformCommandLine(platform2) {
   return `Raw ${RAW_PLATFORM_LABELS[platform2] ?? platform2} API calls use the shared command: adkit manage platform-api-requests --platform ${platform2} ...`;
 }
@@ -5268,7 +5297,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
@@ -5287,6 +5317,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 \\
@@ -5322,7 +5353,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
@@ -5343,6 +5375,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 \\
@@ -5617,6 +5650,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
@@ -5659,7 +5694,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
 
@@ -5681,6 +5716,7 @@ 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.`;
@@ -6150,9 +6186,9 @@ Examples:
 
 Flags:
   --data <json>             Full request object (preferred for agents)
-  --platform <meta|google|tiktok|reddit|x|linkedin> Target platform (required)
-  --endpoint <path>          Relative API path (required)
-  --payload <json>           JSON body for POST/PUT/PATCH, query params for GET, omit for DELETE
+  --platform <meta|google|tiktok|reddit|x|linkedin|microsoft> Target platform (required)
+  --endpoint <path>          Relative API path (required). Microsoft is the exception: pass the full https URL to a Bing Ads v13 host
+  --payload <json>           JSON body for POST/PUT/PATCH, query params for GET, omit for DELETE (exception: Microsoft DELETE takes a JSON body of ids)
   --method <GET|POST|PUT|PATCH|DELETE>  HTTP method (default: POST)
   --request-description <text>  What this request does (required)
   --account <id>             Ad account ID (required)
@@ -6168,7 +6204,8 @@ Examples:
   adkit manage platform-api-requests --platform tiktok --endpoint "campaign/get/" --method GET --payload '{"advertiser_id":"123"}' --request-description "List TikTok campaigns" --account 123
   adkit manage platform-api-requests --platform reddit --endpoint "ad_accounts/a2_example/campaigns" --payload '{"name":"Test","objective":"TRAFFIC","configured_status":"PAUSED"}' --request-description "Create paused Reddit campaign" --account a2_example
   adkit manage platform-api-requests --platform x --endpoint "accounts/18ce54d4x5t/campaigns" --method GET --request-description "List X campaigns" --account 18ce54d4x5t
-  adkit manage platform-api-requests --platform linkedin --endpoint "adCampaignGroups/(account:urn:li:sponsoredAccount:512345678)" --method GET --request-description "List LinkedIn campaign groups" --account 512345678`.trim(),
+  adkit manage platform-api-requests --platform linkedin --endpoint "adCampaignGroups/(account:urn:li:sponsoredAccount:512345678)" --method GET --request-description "List LinkedIn campaign groups" --account 512345678
+  adkit manage platform-api-requests --platform microsoft --endpoint "https://campaign.api.bingads.microsoft.com/CampaignManagement/v13/Campaigns/QueryByAccountId" --payload '{"AccountId":187276743,"CampaignType":"Search"}' --request-description "List Microsoft campaigns" --account 187276743 --publish`.trim(),
   manage: `adkit manage \u2014 Ad platform management
 
 Platforms:
@@ -6178,6 +6215,7 @@ Platforms:
   reddit              Reddit Ads
   x                   X Ads raw API access
   linkedin            LinkedIn Ads (campaigns, ad groups, ads, targeting, results)
+  microsoft           Microsoft Ads raw API access + account discovery
   drafts              Manage drafts across platforms
   platform-api-requests  Send raw API requests (escape hatch)
 
@@ -6270,6 +6308,21 @@ ${rawPlatformCommandLine("x")}
 
 Examples:
   adkit manage platform-api-requests --platform x --endpoint "accounts/18ce54d4x5t/campaigns" --method GET --request-description "List X campaigns" --account 18ce54d4x5t`.trim(),
+  microsoft: `adkit manage microsoft \u2014 Microsoft Ads raw API access + account discovery
+
+Microsoft (Bing) is currently exposed through Advanced Platform Access, plus account discovery.
+Endpoints are FULL https URLs to Bing Ads v13 hosts (campaign/reporting/bulk .api.bingads.microsoft.com) \u2014 not relative paths.
+Bing REST puts the operation in the HTTP verb; query reads are POST to .../Query* paths.
+Because query reads are POST, add --publish on read-only Query* calls \u2014 otherwise you get a draft instead of data.
+
+${rawPlatformCommandLine("microsoft")}
+
+Commands:
+  accounts available   List Microsoft ad accounts discoverable from the connected workspace login
+
+Examples:
+  adkit manage microsoft accounts available
+  adkit manage platform-api-requests --platform microsoft --endpoint "https://campaign.api.bingads.microsoft.com/CampaignManagement/v13/Campaigns/QueryByAccountId" --payload '{"AccountId":187276743,"CampaignType":"Search"}' --request-description "List Microsoft campaigns" --account 187276743 --publish`.trim(),
   linkedin: `adkit manage linkedin \u2014 LinkedIn Ads management
 
 Entity groups:
@@ -7202,13 +7255,14 @@ function readRawRequestData(flags) {
   const data = parseDataFlag(flags, `Run: adkit manage platform-api-requests --data '{"platform":"meta","endpoint":"act_123/campaigns","payload":{},"description":"Create campaign","accountId":"act_123"}'`);
   if (!data || typeof data !== "object" || Array.isArray(data)) throw new CliError("INVALID_VALUE", "--data must be a JSON object", "Include platform, endpoint, payload, description, and accountId");
   const input = data;
+  const platform2 = readRawRequestPlatform(input.platform);
   const method = readRawRequestMethod(input.method);
   const publish = readRawRequestPublish({ data: input, flags });
   const description = readRawRequestDataDescription(input);
-  const payload = readRawRequestPayload({ method, payload: input.payload, source: "data" });
+  const payload = readRawRequestPayload({ method, payload: input.payload, platform: platform2, source: "data" });
   return {
     body: {
-      platform: readRawRequestPlatform(input.platform),
+      platform: platform2,
       endpoint: readRawRequestString({ value: input.endpoint, field: "endpoint", hint: "Include endpoint in --data" }),
       payload,
       method,
@@ -7219,13 +7273,14 @@ function readRawRequestData(flags) {
   };
 }
 function readRawRequestFlags(flags) {
-  const platform2 = requireFlag(flags, "platform", "Required: --platform meta, google, tiktok, reddit, x, or linkedin");
+  const platformFlag = requireFlag(flags, "platform", "Required: --platform meta, google, tiktok, reddit, x, linkedin, or microsoft");
+  const platform2 = readRawRequestPlatform(platformFlag);
   const method = readRawRequestMethod(flags.method);
   const rawPayload = readRawRequestFlagPayload(flags);
-  const payload = readRawRequestPayload({ method, payload: rawPayload, source: "flag" });
+  const payload = readRawRequestPayload({ method, payload: rawPayload, platform: platform2, source: "flag" });
   return {
     body: {
-      platform: readRawRequestPlatform(platform2),
+      platform: platform2,
       endpoint: requireFlag(flags, "endpoint", "Required: --endpoint <api-path>"),
       payload,
       method,
@@ -7254,8 +7309,8 @@ function readRawRequestString(input) {
   throw new CliError("MISSING_FLAG", `Missing required field: \`${input.field}\``, input.hint);
 }
 function readRawRequestPlatform(value) {
-  if (value === "meta" || value === "google" || value === "tiktok" || value === "reddit" || value === "x" || value === "linkedin") return value;
-  throw new CliError("INVALID_VALUE", `Invalid platform: ${String(value)}`, "Use meta, google, tiktok, reddit, x, or linkedin");
+  if (value === "meta" || value === "google" || value === "tiktok" || value === "reddit" || value === "x" || value === "linkedin" || value === "microsoft") return value;
+  throw new CliError("INVALID_VALUE", `Invalid platform: ${String(value)}`, "Use meta, google, tiktok, reddit, x, linkedin, or microsoft");
 }
 function readRawRequestMethod(value) {
   const method = typeof value === "string" ? value.toUpperCase() : "POST";
@@ -7280,7 +7335,7 @@ function readRawRequestPayload(input) {
     if (input.source === "data") throw new CliError("MISSING_FLAG", "POST/PUT/PATCH requests require payload in --data", 'Include "payload": {"key":"value"}');
     throw new CliError("MISSING_FLAG", "POST/PUT/PATCH requests require --payload", `Add --payload '{"key":"value"}'`);
   }
-  if (input.method === "DELETE" && input.payload !== void 0 && input.payload !== null) throw new CliError("INVALID_VALUE", "DELETE requests do not support payload", "Put identifiers in the endpoint path");
+  if (input.method === "DELETE" && input.platform !== "microsoft" && input.payload !== void 0 && input.payload !== null) throw new CliError("INVALID_VALUE", "DELETE requests do not support payload", "Put identifiers in the endpoint path");
   return input.payload ?? null;
 }
 function showHelp(key, full = false) {
@@ -7426,7 +7481,7 @@ async function main() {
         return;
       }
       const platform2 = manageTarget;
-      if (platform2 !== "meta" && platform2 !== "google" && platform2 !== "tiktok" && platform2 !== "reddit" && platform2 !== "x" && platform2 !== "linkedin") throw new CliError("UNKNOWN_COMMAND", `Unknown platform: ${platform2}`, "Available: meta, google, tiktok, reddit, x, linkedin, drafts, platform-api-requests");
+      if (platform2 !== "meta" && platform2 !== "google" && platform2 !== "tiktok" && platform2 !== "reddit" && platform2 !== "x" && platform2 !== "linkedin" && platform2 !== "microsoft") throw new CliError("UNKNOWN_COMMAND", `Unknown platform: ${platform2}`, "Available: meta, google, tiktok, reddit, x, linkedin, microsoft, drafts, platform-api-requests");
       const entity = args[2];
       const action = args[3];
       const restArgs = args.slice(4);
@@ -8164,8 +8219,23 @@ async function main() {
           default:
             throw new CliError("UNKNOWN_COMMAND", `Unknown entity: linkedin ${entity}`, "Available: accounts, media, campaigns, ad-groups, ads, targeting-search, results, platform-api-requests");
         }
+      } else if (platform2 === "microsoft") {
+        switch (entity) {
+          case "accounts":
+            switch (action) {
+              case "available":
+                data = await listMicrosoftAvailableAccounts(client, restArgs, flags);
+                emptyHint = "No Microsoft ad accounts available from the connected workspace login.";
+                break;
+              default:
+                throw new CliError("UNKNOWN_COMMAND", `Unknown action: microsoft accounts ${action}`, "Available: available.");
+            }
+            break;
+          default:
+            throw new CliError("UNKNOWN_COMMAND", `Unknown entity: microsoft ${entity}`, "Available: accounts, platform-api-requests");
+        }
       } else if (platform2 === "x") throw new CliError("UNKNOWN_COMMAND", `Unknown entity: x ${entity}`, "Available: platform-api-requests");
-      else throw new CliError("UNKNOWN_COMMAND", "Unknown platform", "Available: meta, google, tiktok, reddit, x, linkedin, drafts, platform-api-requests");
+      else throw new CliError("UNKNOWN_COMMAND", "Unknown platform", "Available: meta, google, tiktok, reddit, x, linkedin, microsoft, drafts, platform-api-requests");
       printResult(data, flags, emptyHint, detailEntity);
       return;
     }

package/package.json

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