@adkit/cli 1.12.24 → 1.12.26

package/dist/cli.js

@@ -80,6 +80,7 @@ var CliError = class extends Error {
   suggestion;
   instructions;
   actionUrl;
+  notice;
   constructor(code, message, suggestion) {
     super(message);
     this.code = code;
@@ -90,16 +91,17 @@ 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;
+  if (!encoded) return void 0;
   const text = decodeURIComponent(encoded);
+  if (noticePrinted) return text;
+  noticePrinted = true;
   const dim = "\x1B[2m";
   const yellow = "\x1B[33m";
   const reset = "\x1B[0m";
   process.stderr.write(`${yellow}${dim}[AdKit notice] ${text}${reset}
 `);
+  return text;
 }
 function isErrorResponse(value) {
   return value != null && typeof value === "object";
@@ -204,7 +206,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);
+    const serverNotice = printServerNotice(response);
     if (response.status === 204) return void 0;
     if (!response.ok) {
       let serverMessage = "";
@@ -229,27 +231,40 @@ var AdkitClient = class {
         const fallbackMsg = response.status >= 500 ? `Server error (HTTP ${String(response.status)})` : `Request failed (HTTP ${String(response.status)})`;
         const errorMsg = appendErrorDetail(dataMessage || serverMessage || fallbackMsg, batchSummary);
         const suggestion2 = buildMetaDsaSuggestion(structured.code) ?? buildRetrySuggestion(retryable, retryAfterSeconds) ?? buildAuthSuggestion(structured.code);
-        const error = new CliError(structured.code, errorMsg, suggestion2);
-        error.instructions = structured.instructions;
-        error.actionUrl = structured.actionUrl;
-        throw error;
+        const error2 = new CliError(structured.code, errorMsg, suggestion2);
+        error2.instructions = structured.instructions;
+        error2.actionUrl = structured.actionUrl;
+        error2.notice = serverNotice;
+        throw error2;
+      }
+      if (response.status === 401) {
+        const error2 = new CliError("INVALID_API_KEY", `Invalid or expired API key${serverMessage ? ` \u2014 ${serverMessage}` : ""}`, "Run: adkit setup");
+        error2.notice = serverNotice;
+        throw error2;
       }
-      if (response.status === 401) throw new CliError("INVALID_API_KEY", `Invalid or expired API key${serverMessage ? ` \u2014 ${serverMessage}` : ""}`, "Run: adkit setup");
       if (response.status === 429) {
         const waitMsg = buildRetrySuggestion(true, retryAfterSeconds) ?? "Wait a moment before retrying";
-        throw new CliError("RATE_LIMITED", appendErrorDetail(serverMessage || "Rate limit exceeded", batchSummary), waitMsg);
+        const error2 = new CliError("RATE_LIMITED", appendErrorDetail(serverMessage || "Rate limit exceeded", batchSummary), waitMsg);
+        error2.notice = serverNotice;
+        throw error2;
       }
       if (response.status === 404) {
         const fallback = `Not found: ${method} ${path3} \u2014 the resource may have been deleted or the ID is wrong`;
-        throw new CliError("NOT_FOUND", appendErrorDetail(serverMessage || fallback, batchSummary), "Check the resource ID");
+        const error2 = new CliError("NOT_FOUND", appendErrorDetail(serverMessage || fallback, batchSummary), "Check the resource ID");
+        error2.notice = serverNotice;
+        throw error2;
       }
       if (response.status >= 500) {
         const errorMsg = appendErrorDetail(dataMessage || serverMessage || `Server error (HTTP ${String(response.status)})`, batchSummary);
         const suggestion2 = buildRetrySuggestion(retryable, retryAfterSeconds);
-        throw new CliError("SERVER_ERROR", errorMsg, suggestion2);
+        const error2 = new CliError("SERVER_ERROR", errorMsg, suggestion2);
+        error2.notice = serverNotice;
+        throw error2;
       }
       const suggestion = buildRetrySuggestion(retryable, retryAfterSeconds);
-      throw new CliError("SERVER_ERROR", appendErrorDetail(serverMessage || `Request failed (HTTP ${String(response.status)})`, batchSummary), suggestion);
+      const error = new CliError("SERVER_ERROR", appendErrorDetail(serverMessage || `Request failed (HTTP ${String(response.status)})`, batchSummary), suggestion);
+      error.notice = serverNotice;
+      throw error;
     }
     return response.json();
   }
@@ -3168,6 +3183,12 @@ async function disconnectRedditAccount(client, args, flags) {
   return client.delete(`/manage/reddit/accounts/${adAccountId}`);
 }
 
+// src/commands/linkedin.ts
+async function listLinkedInAvailableAccounts(client, _args, flags) {
+  validateFlags(flags, [], "manage linkedin accounts available");
+  return client.get("/manage/linkedin/accounts/available");
+}
+
 // src/commands/status.ts
 function isStatusResponse(value) {
   if (!value || typeof value !== "object") return false;
@@ -3529,8 +3550,8 @@ async function requestMultipart(client, pathName, formData) {
     try {
       const json = await response.json();
       if (isErrorResponse2(json)) {
-        serverMessage = json.statusMessage ?? json.message ?? "";
         dataMessage = json.data?.message ?? "";
+        serverMessage = dataMessage || json.message || json.statusMessage || "";
         retryable = json.data?.retryable;
         retryAfterSeconds = json.data?.retryAfterSeconds ?? void 0;
       }
@@ -3885,11 +3906,23 @@ function toGoogleSearchTermDisplayRows(row) {
 import { createRequire } from "node:module";
 
 // src/update-check.ts
-import { writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "node:fs";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "node:fs";
 import { join as join2 } from "node:path";
 var CACHE_PATH = join2(CONFIG_DIR, "update-check.json");
 var FETCH_TIMEOUT_MS = 3e3;
 var REGISTRY_URL = "https://registry.npmjs.org/@adkit/cli/latest";
+function readCache() {
+  try {
+    const raw = readFileSync4(CACHE_PATH, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object") return void 0;
+    const cache = parsed;
+    if (typeof cache.lastCheck !== "number" || typeof cache.latestVersion !== "string") return void 0;
+    return { lastCheck: cache.lastCheck, latestVersion: cache.latestVersion };
+  } catch {
+    return void 0;
+  }
+}
 function writeCache(data) {
   try {
     const cacheJson = JSON.stringify(data);
@@ -3939,7 +3972,8 @@ function isNewer(latest, current) {
   return false;
 }
 function startUpdateCheck(currentVersion) {
-  const pending = fetch(REGISTRY_URL, {
+  const cached = readCache();
+  void fetch(REGISTRY_URL, {
     signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
   }).then(async (res) => {
     if (!res.ok) return null;
@@ -3955,12 +3989,11 @@ function startUpdateCheck(currentVersion) {
     return null;
   }).catch(() => null);
   return () => {
-    void pending.then((latest) => {
-      if (latest && isNewer(latest, currentVersion)) {
-        const updateNotice = formatUpdateNotice(currentVersion, latest);
-        process.stderr.write(updateNotice);
-      }
-    });
+    const latest = cached?.latestVersion;
+    if (latest && isNewer(latest, currentVersion)) {
+      const updateNotice = formatUpdateNotice(currentVersion, latest);
+      process.stderr.write(updateNotice);
+    }
   };
 }
 
@@ -4104,6 +4137,7 @@ Manage platforms:
   google        Google Ads
   tiktok        TikTok Ads
   reddit        Reddit Ads
+  linkedin      LinkedIn Ads
   drafts        Drafts across platforms
 
 Run \`adkit <command> --help\` for details.
@@ -4117,7 +4151,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" };
+var RAW_PLATFORM_LABELS = { google: "Google", meta: "Meta", reddit: "Reddit", tiktok: "TikTok", x: "X", linkedin: "LinkedIn" };
 function rawPlatformCommandLine(platform2) {
   return `Raw ${RAW_PLATFORM_LABELS[platform2] ?? platform2} API calls use the shared command: adkit manage platform-api-requests --platform ${platform2} ...`;
 }
@@ -5636,7 +5670,7 @@ Examples:
 
 Flags:
   --data <json>             Full request object (preferred for agents)
-  --platform <meta|google|tiktok|reddit|x> Target platform (required)
+  --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
   --method <GET|POST|PUT|PATCH|DELETE>  HTTP method (default: POST)
@@ -5653,7 +5687,8 @@ Examples:
   adkit manage platform-api-requests --platform google --endpoint "customers/123/googleAds:mutate" --payload '{"mutateOperations":[...]}' --request-description "Pause ad" --account 123
   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`.trim(),
+  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(),
   manage: `adkit manage \u2014 Ad platform management
 
 Platforms:
@@ -5662,6 +5697,7 @@ Platforms:
   tiktok              TikTok Ads
   reddit              Reddit Ads
   x                   X Ads raw API access
+  linkedin            LinkedIn Ads (account discovery + raw API access)
   drafts              Manage drafts across platforms
   platform-api-requests  Send raw API requests (escape hatch)
 
@@ -5754,6 +5790,19 @@ ${rawPlatformCommandLine("x")}
 
 Examples:
   adkit manage platform-api-requests --platform x --endpoint "accounts/18ce54d4x5t/campaigns" --method GET --request-description "List X campaigns" --account 18ce54d4x5t`.trim(),
+  linkedin: `adkit manage linkedin \u2014 LinkedIn Ads management
+
+Entity groups:
+  accounts available  List LinkedIn ad accounts discoverable from connected workspace logins
+
+Account discovery currently supports "available" only \u2014 connect/disconnect/list are not exposed yet.
+First-class LinkedIn campaign/ad reads and writes are not enabled yet.
+${rawPlatformCommandLine("linkedin")}
+
+General flags:
+${FLAG.account}
+
+Run adkit manage linkedin accounts available to discover ad accounts.`.trim(),
   drafts: `adkit manage drafts \u2014 Manage drafts
 
   list                List all drafts
@@ -6680,7 +6729,7 @@ function readRawRequestData(flags) {
   };
 }
 function readRawRequestFlags(flags) {
-  const platform2 = requireFlag(flags, "platform", "Required: --platform meta, google, tiktok, reddit, or x");
+  const platform2 = requireFlag(flags, "platform", "Required: --platform meta, google, tiktok, reddit, x, or linkedin");
   const method = readRawRequestMethod(flags.method);
   const rawPayload = readRawRequestFlagPayload(flags);
   const payload = readRawRequestPayload({ method, payload: rawPayload, source: "flag" });
@@ -6715,8 +6764,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") return value;
-  throw new CliError("INVALID_VALUE", `Invalid platform: ${String(value)}`, "Use meta, google, tiktok, reddit, or x");
+  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");
 }
 function readRawRequestMethod(value) {
   const method = typeof value === "string" ? value.toUpperCase() : "POST";
@@ -6783,7 +6832,8 @@ async function selfUpdate(currentVersion) {
     else console.log(`Updated: ${currentVersion} \u2192 ${newVersion}`);
   } catch {
     console.error("Update failed. Try manually: npm install -g @adkit/cli@latest");
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
 }
 async function main() {
@@ -6835,18 +6885,18 @@ async function main() {
       const manageTarget = args[1];
       if (flags.help && !manageTarget) {
         showHelp("manage", flags.help === "full");
-        process.exit(0);
+        return;
       }
       if (!manageTarget) {
         showHelp("manage", flags.help === "full");
-        process.exit(0);
+        return;
       }
       if (manageTarget === "drafts") {
         const action2 = args[2];
         const restArgs2 = args.slice(3);
         if (flags.help) {
           showHelp("drafts", flags.help === "full");
-          process.exit(0);
+          return;
         }
         const client2 = requireClient(flags);
         let data2;
@@ -6878,7 +6928,7 @@ async function main() {
       if (manageTarget === "platform-api-requests") {
         if (flags.help) {
           showHelp("platform-api-requests", flags.help === "full");
-          process.exit(0);
+          return;
         }
         const client2 = requireClient(flags);
         const data2 = await sendRawRequest(client2, flags);
@@ -6886,19 +6936,19 @@ async function main() {
         return;
       }
       const platform2 = manageTarget;
-      if (platform2 !== "meta" && platform2 !== "google" && platform2 !== "tiktok" && platform2 !== "reddit" && platform2 !== "x") throw new CliError("UNKNOWN_COMMAND", `Unknown platform: ${platform2}`, "Available: meta, google, tiktok, reddit, x, drafts, platform-api-requests");
+      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");
       const entity = args[2];
       const action = args[3];
       const restArgs = args.slice(4);
       if (flags.help) {
         const helpCandidates = [action ? `${platform2} ${entity} ${action}` : void 0, entity ? `${platform2} ${entity}` : void 0, platform2];
-        for (const helpKey of helpCandidates) if (helpKey && showHelp(helpKey, flags.help === "full")) process.exit(0);
+        for (const helpKey of helpCandidates) if (helpKey && showHelp(helpKey, flags.help === "full")) return;
         printHelp(USAGE);
-        process.exit(0);
+        return;
       }
       if (!entity) {
         showHelp(platform2, flags.help === "full");
-        process.exit(0);
+        return;
       }
       const client = requireClient(flags);
       let data;
@@ -6940,7 +6990,7 @@ async function main() {
           case "campaigns": {
             if (!action) {
               showHelp("meta campaigns", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -6967,7 +7017,7 @@ async function main() {
           case "adsets": {
             if (!action) {
               showHelp("meta adsets", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -6994,7 +7044,7 @@ async function main() {
           case "ads": {
             if (!action) {
               showHelp("meta ads", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7029,7 +7079,7 @@ async function main() {
           case "lead-forms": {
             if (!action) {
               showHelp("meta lead-forms", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7115,7 +7165,7 @@ async function main() {
           case "assets": {
             if (!action) {
               showHelp("google assets", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7143,7 +7193,7 @@ async function main() {
           case "media": {
             if (!action || flags.help) {
               showHelp("google media", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "upload":
@@ -7157,7 +7207,7 @@ async function main() {
           case "campaigns": {
             if (!action) {
               showHelp("google campaigns", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7182,7 +7232,7 @@ async function main() {
           case "ad-groups": {
             if (!action) {
               showHelp("google ad-groups", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7207,7 +7257,7 @@ async function main() {
           case "ads": {
             if (!action) {
               showHelp("google ads", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7234,7 +7284,7 @@ async function main() {
           case "keywords": {
             if (!action) {
               showHelp("google keywords", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7254,7 +7304,7 @@ async function main() {
                 const negativesAction = restArgs[0];
                 if (!negativesAction || flags.help) {
                   showHelp("google keywords negatives", flags.help === "full");
-                  process.exit(0);
+                  return;
                 }
                 switch (negativesAction) {
                   case "list":
@@ -7276,7 +7326,7 @@ async function main() {
                 const negativeListsAction = restArgs[0];
                 if (!negativeListsAction || flags.help) {
                   showHelp("google keywords negative-lists", flags.help === "full");
-                  process.exit(0);
+                  return;
                 }
                 const negativeListArgs = restArgs.slice(1);
                 switch (negativeListsAction) {
@@ -7330,7 +7380,7 @@ async function main() {
           case "conversions": {
             if (!action || flags.help) {
               showHelp("google conversions", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "upload":
@@ -7396,7 +7446,7 @@ async function main() {
           case "media": {
             if (!action || flags.help) {
               showHelp("tiktok media", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7414,7 +7464,7 @@ async function main() {
           case "campaigns": {
             if (!action) {
               showHelp("tiktok campaigns", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7436,7 +7486,7 @@ async function main() {
           case "ad-groups": {
             if (!action) {
               showHelp("tiktok ad-groups", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7458,7 +7508,7 @@ async function main() {
           case "ads": {
             if (!action) {
               showHelp("tiktok ads", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7513,8 +7563,23 @@ async function main() {
           default:
             throw new CliError("UNKNOWN_COMMAND", `Unknown entity: reddit ${entity}`, "Available: accounts, platform-api-requests");
         }
+      } else if (platform2 === "linkedin") {
+        switch (entity) {
+          case "accounts":
+            switch (action) {
+              case "available":
+                data = await listLinkedInAvailableAccounts(client, restArgs, flags);
+                emptyHint = "No LinkedIn ad accounts available from the connected workspace login.";
+                break;
+              default:
+                throw new CliError("UNKNOWN_COMMAND", `Unknown action: linkedin accounts ${action}`, "Available: available.");
+            }
+            break;
+          default:
+            throw new CliError("UNKNOWN_COMMAND", `Unknown entity: linkedin ${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, drafts, platform-api-requests");
+      else throw new CliError("UNKNOWN_COMMAND", "Unknown platform", "Available: meta, google, tiktok, reddit, x, linkedin, drafts, platform-api-requests");
       printResult(data, flags, emptyHint, detailEntity);
       return;
     }
@@ -7522,17 +7587,17 @@ async function main() {
       const libraryTarget = args[1];
       if (flags.help && !libraryTarget) {
         showHelp("library", flags.help === "full");
-        process.exit(0);
+        return;
       }
       if (!libraryTarget) {
         showHelp("library", flags.help === "full");
-        process.exit(0);
+        return;
       }
       if (libraryTarget === "advertisers") {
         const action = args[2];
         if (flags.help || !action) {
           showHelp("library advertisers", flags.help === "full");
-          process.exit(0);
+          return;
         }
         const client = requireClient(flags);
         if (action === "add") {
@@ -7553,7 +7618,8 @@ async function main() {
           const query = args.slice(3).join(" ");
           if (!query) {
             console.error("Usage: adkit library advertisers search <query>");
-            process.exit(1);
+            process.exitCode = 1;
+            return;
           }
           flags.search = query;
           const data = await listAdvertisers(client, [], flags);
@@ -7610,7 +7676,7 @@ ${pageInfo}`);
         const action = args[2];
         if (flags.help) {
           showHelp("library ads", flags.help === "full");
-          process.exit(0);
+          return;
         }
         const client = requireClient(flags);
         if (action && action !== "list") {
@@ -7621,7 +7687,7 @@ ${pageInfo}`);
           const hasFilters = ["platform", "status", "format", "min-days", "max-days", "language", "min-score", "min-spend", "query", "search", "advertiser", "ids", "sort"].some((f) => typeof flags[f] === "string");
           if (!action && !hasFilters) {
             showHelp("library ads", flags.help === "full");
-            process.exit(0);
+            return;
           }
           const data = await listLibraryAds(client, args.slice(3), flags);
           if (wantsJson(flags)) printResult(data, flags, "No ads found. Try adjusting your filters.");
@@ -7654,11 +7720,11 @@ ${pageInfo}`);
       const studioTarget = args[1];
       if (flags.help && !studioTarget) {
         showHelp("studio", flags.help === "full");
-        process.exit(0);
+        return;
       }
       if (!studioTarget) {
         showHelp("studio", flags.help === "full");
-        process.exit(0);
+        return;
       }
       let data;
       let emptyHint;
@@ -7668,7 +7734,7 @@ ${pageInfo}`);
           const restArgs = args.slice(3);
           if (flags.help) {
             showHelp("studio ads", flags.help === "full");
-            process.exit(0);
+            return;
           }
           const client = requireClient(flags);
           switch (action) {
@@ -7699,7 +7765,7 @@ ${pageInfo}`);
           const restArgs = args.slice(3);
           if (flags.help) {
             showHelp("studio media", flags.help === "full");
-            process.exit(0);
+            return;
           }
           const client = requireClient(flags);
           switch (action) {
@@ -7731,7 +7797,7 @@ ${pageInfo}`);
         case "share":
           if (flags.help) {
             showHelp("studio share", flags.help === "full");
-            process.exit(0);
+            return;
           }
           data = await shareAd(requireClient(flags), args.slice(2), flags);
           break;
@@ -7745,7 +7811,7 @@ ${pageInfo}`);
       const action = args[1];
       if (flags.help) {
         showHelp("projects", flags.help === "full");
-        process.exit(0);
+        return;
       }
       const client = requireClient(flags, { projectOptional: true });
       switch (action) {
@@ -7808,6 +7874,7 @@ ${pageInfo}`);
           ...err.instructions && { instructions: err.instructions },
           ...err.actionUrl && { actionUrl: err.actionUrl },
           ...err.suggestion && { suggestion: err.suggestion },
+          ...err.notice && { notice: err.notice },
           ...shouldNudgeFeedback && { hint: "If this error is unexpected, report it using: adkit feedback" }
         });
         console.error(errorPayload);
@@ -7835,7 +7902,8 @@ ${pageInfo}`);
       INVALID_API_KEY: 4,
       NOT_AUTHENTICATED: 4
     };
-    process.exit(err instanceof CliError ? EXIT_CODES[err.code] ?? 1 : 1);
+    process.exitCode = err instanceof CliError ? EXIT_CODES[err.code] ?? 1 : 1;
+    return;
   } finally {
     if (args[0] !== "update") printUpdateNotice();
   }

package/package.json

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