@adkit/cli 1.12.3 → 1.12.8

package/dist/cli.js

@@ -1,12 +1,5 @@
 #!/usr/bin/env node
 
-// ../shared/dist/utils/service-status.js
-var ADKIT_STATUS_NOTICE = null;
-function getAdKitStatusNotice() {
-  const statusNotice = ADKIT_STATUS_NOTICE?.trim();
-  return statusNotice ? `Active AdKit status notice: ${statusNotice}` : void 0;
-}
-
 // src/config.ts
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
 import { join } from "node:path";
@@ -72,6 +65,15 @@ function readLegacyProjectApiKey(config, selectedProject) {
   return config.projects?.[selectedProject]?.apiKey ?? null;
 }
 
+// ../shared/dist/errors.js
+function describeRetryDelay(retryAfterSeconds) {
+  if (!retryAfterSeconds || retryAfterSeconds <= 300)
+    return "in a few minutes";
+  if (retryAfterSeconds <= 3600)
+    return "within the hour";
+  return "in a few hours";
+}
+
 // src/errors.ts
 var CliError = class extends Error {
   code;
@@ -86,6 +88,19 @@ var CliError = class extends Error {
 };
 
 // src/client.ts
+var noticePrinted = false;
+function printServerNotice(response) {
+  if (noticePrinted) return;
+  const encoded = response.headers.get("x-adkit-notice");
+  if (!encoded) return;
+  noticePrinted = true;
+  const text = decodeURIComponent(encoded);
+  const dim = "\x1B[2m";
+  const yellow = "\x1B[33m";
+  const reset = "\x1B[0m";
+  process.stderr.write(`${yellow}${dim}[AdKit notice] ${text}${reset}
+`);
+}
 function isErrorResponse(value) {
   return value != null && typeof value === "object";
 }
@@ -135,12 +150,14 @@ function appendErrorDetail(message, detail) {
 }
 function buildRetrySuggestion(retryable, retryAfterSeconds) {
   if (retryable !== true) return void 0;
-  if (typeof retryAfterSeconds === "number") return `Wait ${String(retryAfterSeconds)} seconds before retrying`;
+  if (typeof retryAfterSeconds === "number" && retryAfterSeconds <= 300) return `Wait ${String(retryAfterSeconds)} seconds before retrying`;
+  if (typeof retryAfterSeconds === "number") return `Try again ${describeRetryDelay(retryAfterSeconds)}`;
   return "Retry in a few seconds";
 }
-var AUTH_CODES = /* @__PURE__ */ new Set(["not_connected", "token_expired", "refresh_token_expired"]);
+var AUTH_CODES = /* @__PURE__ */ new Set(["invalid_grant", "auth_error", "auth_expired", "not_connected", "token_expired", "refresh_token_expired"]);
 function buildAuthSuggestion(code) {
-  if (!AUTH_CODES.has(code)) return void 0;
+  const normalizedCode = code.toLowerCase();
+  if (!AUTH_CODES.has(normalizedCode)) return void 0;
   return "Run: adkit setup manage";
 }
 var AdkitClient = class {
@@ -178,6 +195,7 @@ var AdkitClient = class {
       const detail = code ?? (err instanceof Error ? err.message : String(err));
       throw new CliError("NETWORK_ERROR", `Cannot reach ${target} (${detail})`, "Verify your network connection");
     }
+    printServerNotice(response);
     if (response.status === 204) return void 0;
     if (!response.ok) {
       let serverMessage = "";
@@ -2656,7 +2674,7 @@ var PLATFORM_OVERRIDE_FLAG = "platform-overrides";
 var CAMPAIGN_CREATE_FLAGS = ["name", "objective", "status", "budget-daily", "budget-lifetime", PLATFORM_OVERRIDE_FLAG];
 var CAMPAIGN_UPDATE_FLAGS = ["name", "status", "budget-daily", "budget-lifetime", PLATFORM_OVERRIDE_FLAG];
 var AD_GROUP_LIST_FLAGS2 = ["campaign-ids", "fields", "limit", "offset"];
-var AD_GROUP_CREATE_FLAGS = ["campaign", "name", "status", "budget-daily", "budget-lifetime", "billing-event", "optimization", "schedule-start-time", "schedule-end-time", "schedule-type", "pacing", "bid-amount", "event-type", "pixel", "placement", PLATFORM_OVERRIDE_FLAG];
+var AD_GROUP_CREATE_FLAGS = ["campaign", "name", "status", "budget-daily", "budget-lifetime", "billing-event", "bid-strategy", "optimization", "schedule-start-time", "schedule-end-time", "schedule-type", "pacing", "bid-amount", "event-type", "pixel", "placement", PLATFORM_OVERRIDE_FLAG];
 var AD_GROUP_UPDATE_FLAGS = ["name", "status", "budget-daily", "budget-lifetime", "billing-event", "optimization", "schedule-start-time", "schedule-end-time", "schedule-type", "pacing", "bid-amount", "event-type", "pixel", PLATFORM_OVERRIDE_FLAG];
 var AD_LIST_FLAGS2 = ["ad-group-ids", "campaign-ids", "fields", "limit", "offset"];
 var AD_CREATE_FLAGS = ["ad-group", "name", "status", "media-id", "ad-text", "url", "cta", "display-name", "identity-id", "identity-type", "tracking-pixel", PLATFORM_OVERRIDE_FLAG];
@@ -2809,6 +2827,7 @@ function buildTikTokAdGroupPayload(flags, mode) {
   if (budget) payload.budget = budget;
   if (typeof flags.status === "string") payload.status = flags.status;
   if (typeof flags["billing-event"] === "string") payload.billingEvent = flags["billing-event"];
+  if (mode === "create" && typeof flags["bid-strategy"] === "string") payload.bidStrategy = flags["bid-strategy"];
   if (typeof flags.optimization === "string") payload.optimization = flags.optimization;
   if (typeof flags["schedule-end-time"] === "string") payload.scheduleEndTime = flags["schedule-end-time"];
   if (typeof flags["schedule-type"] === "string") payload.scheduleType = flags["schedule-type"];
@@ -4551,7 +4570,7 @@ var GOOGLE_CAMPAIGN_HELP = `adkit manage google campaigns \u2014 Google Ads camp
   create              Create a campaign
   update <id>         Update a campaign
   delete <id>         Delete a campaign
-  <id>                View campaign details
+  <id>                View campaign details (PMAX includes assetGroups)
 
 Flags (create):
   --name <name>       Campaign name (required)
@@ -4577,6 +4596,7 @@ Note:
   Advanced geo examples: adkit manage google campaigns --help full
   Display creation starts here: campaigns create --campaign-type display, then create Display ad groups and responsive_display ads.
   Performance Max: campaignType "performance_max" with asset groups \u2014 build it with --data. See --help full.
+  View a Performance Max campaign by ID to read back its assetGroups from Google.
   For spend/clicks/conversions: adkit manage google results
 
 Examples:
@@ -4593,7 +4613,7 @@ var GOOGLE_CAMPAIGN_HELP_FULL = `adkit manage google campaigns \u2014 Google Ads
   create              Create a campaign
   update <id>         Update a campaign
   delete <id>         Delete a campaign
-  <id>                View campaign details
+  <id>                View campaign details (PMAX includes assetGroups)
 
 Flags (create):
   --name <name>       Campaign name (required)
@@ -4627,6 +4647,7 @@ Notes:
   Google excludes support location geo target constants, not proximity radius exclusions.
   Display campaign creation uses campaignType:"display" or --campaign-type display. Videos are not supported for Display media in v1.
   Performance Max: campaignType "performance_max" with exactly one assetGroups[] entry. Text assets inline ({role,text}); image assets are uploaded via google media first, then referenced by id/resourceName. Needs an enabled conversion action (publish is blocked without one). Non-retail only. Build it with --data.
+  View a Performance Max campaign by ID to read back assetGroups from Google. There is no separate google asset-groups command.
   For spend/clicks/conversions: adkit manage google results
 
 Examples:
@@ -5268,15 +5289,16 @@ ${FLAG.data}
   --schedule-start-time <value> Required for create, e.g. "2026-05-15 12:00:00"
   --schedule-end-time <value> Optional end time
   --billing-event <s> cpc, cpm, ocpm
+  --bid-strategy <s>  bid_type_no_bid, bid_type_custom, bid_type_max_conversion
   --optimization <s>  click, convert, lead_generation, video_view, reach
-  --bid-amount <n>    Manual bid amount in account currency
+  --bid-amount <n>    Custom bid in account currency; conversion/OCPM maps to cost per conversion
   --event-type <s>    purchase, add_to_cart, view_content, complete_registration, lead, submit_form
   --pixel <id>        Pixel ID; falls back to account default pixel when conversion is used
   --placement <ids>   Override TikTok placement IDs (publish default: PLACEMENT_TIKTOK)
 
 Examples:
   adkit manage tiktok ad-groups create --campaign 1770 --name "US Broad" --budget-daily 50 --schedule-start-time "2026-05-15 12:00:00" --billing-event cpc --optimization click
-  adkit manage tiktok ad-groups create --data '{"adGroups":[{"campaignId":"1770","name":"Purchase","budget":{"daily":50},"scheduleStartTime":"2026-05-15 12:00:00","conversion":{"eventType":"purchase"},"targeting":{"geoLocations":{"include":[{"type":"country","country":"US"}]}}}]}'`.trim(),
+  adkit manage tiktok ad-groups create --data '{"adGroups":[{"campaignId":"1770","name":"Purchase","budget":{"daily":50},"scheduleStartTime":"2026-05-15 12:00:00","bidAmount":80,"conversion":{"eventType":"purchase"},"targeting":{"geoLocations":{"include":[{"type":"country","country":"US"}]}}}]}'`.trim(),
   "tiktok ads": `adkit manage tiktok ads \u2014 TikTok video ads
 
   list                List ads
@@ -6440,11 +6462,7 @@ function showHelp(key, full = false) {
   return false;
 }
 function printHelp(text) {
-  const statusNotice = getAdKitStatusNotice();
-  const helpText = statusNotice ? `${statusNotice}
-
-${text}` : text;
-  console.log(helpText);
+  console.log(text);
 }
 async function selfUpdate(currentVersion) {
   const { execSync } = await import("node:child_process");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.12.3",
+  "version": "1.12.8",
   "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",
@@ -34,6 +34,9 @@
     "build": "esbuild src/cli.ts --bundle --format=esm --platform=node --target=node18 --outfile=dist/cli.js --banner:js='#!/usr/bin/env node'",
     "release": "cd ../shared && npm run build && cd ../cli && npm version patch && npm run build && npm publish --access public"
   },
+  "dependencies": {
+    "open": "^10.2.0"
+  },
   "devDependencies": {
     "@adkit/shared": "*",
     "@types/node": "^20.10.0",