@adkit/cli 1.12.4 → 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 = "";
@@ -4552,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)
@@ -4578,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:
@@ -4594,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)
@@ -4628,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:
@@ -6442,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.4",
+  "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",