@adsuploader/cli 0.1.2 → 0.1.3

package/SKILL.md

@@ -506,6 +506,15 @@ ads create spec.json
 ads jobs JOB_ID --follow
 ```
 
+`ads create` and `ads jobs --follow` watch for up to 30 minutes. On very large batches (hundreds of creatives), the command may exit before the job finishes with:
+
+```
+−  Still running after 30 min — job continues on the server.
+   Resume with: ads jobs JOB_ID --follow
+```
+
+This is **not** a failure. The backend job keeps creating ads. Re-run the suggested command to resume watching. Exit code is `2` for this case (vs `0` for success, `1` for real errors) — shell scripts and agents should branch on the exit code to distinguish.
+
 ---
 
 ## Critical Gotchas
@@ -519,3 +528,5 @@ ads jobs JOB_ID --follow
 7. **`textPresetId` and `texts` are mutually exclusive** — use one or the other
 8. **Objective-specific CTAs** (`MESSAGE_PAGE`, `WHATSAPP_MESSAGE`, etc.) are inherited from the template — don't set them manually
 9. **Do not use `--json`** — it's for shell scripts, not interactive use. The human-readable output has everything you need
+10. **Never wrap CLI commands in polling loops** (`watch`, `while true; do ads adset X; sleep 5; done`, or equivalent). If you need to follow a job, use `ads jobs JOB_ID --follow`. If you need to verify ads landed after a create, run `ads adset <id>` **once** after the create returns — the job engine only marks complete when every ad is created on Facebook. Polling loops trigger rate limits (per-user-per-operation; list/read endpoints cap at 20/min) and return `429 Rate Limit Exceeded` with a `Retry-After` header.
+11. **`ads create` exit code 2 means "still running," not "failed."** On very large batches the CLI stops watching after 30 minutes while the backend job continues. Resume with `ads jobs JOB_ID --follow`. Treat exit code 2 as "come back later," exit code 1 as a real error.

package/dist/cli.cjs

@@ -5182,7 +5182,8 @@ var import_picocolors11 = __toESM(require_picocolors(), 1);
 // src/lib/poll.js
 var import_picocolors10 = __toESM(require_picocolors(), 1);
 var POLL_INTERVAL = 500;
-var TIMEOUT_MS = 5 * 60 * 1e3;
+var TIMEOUT_MS = 30 * 60 * 1e3;
+var TIMEOUT_MINUTES = TIMEOUT_MS / 6e4;
 async function pollJob(client, jobId, opts = {}) {
   const jsonMode = opts.json;
   const tty = process.stdout.isTTY && !jsonMode;
@@ -5212,6 +5213,11 @@ async function pollJob(client, jobId, opts = {}) {
     if (jsonMode) {
       console.log(JSON.stringify(data));
       if (data.complete) return data;
+      if (Date.now() - startMs > TIMEOUT_MS) {
+        console.log(JSON.stringify({ event: "still_running", jobId }));
+        process.exitCode = 2;
+        return { status: "still_running", jobId };
+      }
       await sleep(POLL_INTERVAL);
       continue;
     }
@@ -5255,10 +5261,16 @@ async function pollJob(client, jobId, opts = {}) {
       return data;
     }
     if (Date.now() - startMs > TIMEOUT_MS) {
-      console.log("");
-      printError(`Timed out after 5 minutes. Check: ads jobs ${jobId}`);
-      console.log("");
-      return data;
+      if (jsonMode) {
+        console.log(JSON.stringify({ event: "still_running", jobId }));
+      } else {
+        console.log("");
+        console.log(`  ${import_picocolors10.default.yellow("\u2212")}  ${import_picocolors10.default.yellow(`Still running after ${TIMEOUT_MINUTES} min \u2014 job continues on the server.`)}`);
+        console.log(`     Resume with: ${import_picocolors10.default.bold(`ads jobs ${jobId} --follow`)}`);
+        console.log("");
+      }
+      process.exitCode = 2;
+      return { status: "still_running", jobId };
     }
     await sleep(POLL_INTERVAL);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adsuploader/cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Create Facebook ads from the command line — bulk upload media, preview configurations, and launch ads at scale",
   "author": "Ads Uploader <support@adsuploader.com> (https://adsuploader.com)",
   "license": "UNLICENSED",