adapty 0.8.4-beta.1 → 0.8.5

package/oclif.manifest.json

@@ -425,36 +425,59 @@
         "update.js"
       ]
     },
-    "auth:login": {
+    "asa:connect": {
       "aliases": [],
       "args": {},
-      "description": "Authenticate with Adapty via browser",
+      "description": "Connect an Apple Search Ads account to this company",
       "examples": [
-        "<%= config.bin %> auth login"
+        "<%= config.bin %> asa connect",
+        "<%= config.bin %> asa connect --no-wait"
       ],
-      "flags": {},
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Seconds to wait for the browser step",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "description": "Wait until Apple Ads reports as connected",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:login",
+      "id": "asa:connect",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "login.js"
+        "asa",
+        "connect.js"
       ]
     },
-    "auth:logout": {
+    "asa:whoami": {
       "aliases": [],
       "args": {},
-      "description": "Remove stored authentication token",
+      "description": "Show which company the token unlocks, whether Apple Ads is connected, and the request budgets it gets\n\nLimits are raised per company, so read them here rather than assuming the defaults: metrics_limit_per_minute\nand metrics_burst_limit govern asa metrics, keywords_read_limit_per_minute the keyword lists,\nmetrics_inflight_limit how many analytics calls may overlap, and max_breakdown_rows_per_page the size a\ngrouped page may project to before it is refused.",
       "examples": [
-        "<%= config.bin %> auth logout"
+        "<%= config.bin %> asa whoami"
       ],
       "flags": {
         "json": {
@@ -467,7 +490,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:logout",
+      "id": "asa:whoami",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -477,48 +500,40 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "logout.js"
+        "asa",
+        "whoami.js"
       ]
     },
-    "auth:revoke": {
+    "auth:login": {
       "aliases": [],
       "args": {},
-      "description": "Revoke the current authentication token",
+      "description": "Authenticate with Adapty via browser",
       "examples": [
-        "<%= config.bin %> auth revoke"
+        "<%= config.bin %> auth login"
       ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:revoke",
+      "id": "auth:login",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "auth",
-        "revoke.js"
+        "login.js"
       ]
     },
-    "auth:status": {
+    "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Show current authentication state (local only)",
+      "description": "Remove stored authentication token",
       "examples": [
-        "<%= config.bin %> auth status"
+        "<%= config.bin %> auth logout"
       ],
       "flags": {
         "json": {
@@ -531,7 +546,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:status",
+      "id": "auth:logout",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -542,15 +557,15 @@
         "dist",
         "commands",
         "auth",
-        "status.js"
+        "logout.js"
       ]
     },
-    "auth:whoami": {
+    "auth:revoke": {
       "aliases": [],
       "args": {},
-      "description": "Show current user info from server (verifies token)",
+      "description": "Revoke the current authentication token",
       "examples": [
-        "<%= config.bin %> auth whoami"
+        "<%= config.bin %> auth revoke"
       ],
       "flags": {
         "json": {
@@ -563,7 +578,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:whoami",
+      "id": "auth:revoke",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -574,16 +589,15 @@
         "dist",
         "commands",
         "auth",
-        "whoami.js"
+        "revoke.js"
       ]
     },
-    "asa:connect": {
+    "auth:status": {
       "aliases": [],
       "args": {},
-      "description": "Connect an Apple Search Ads account to this company",
+      "description": "Show current authentication state (local only)",
       "examples": [
-        "<%= config.bin %> asa connect",
-        "<%= config.bin %> asa connect --no-wait"
+        "<%= config.bin %> auth status"
       ],
       "flags": {
         "json": {
@@ -592,25 +606,11 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "timeout": {
-          "description": "Seconds to wait for the browser step",
-          "name": "timeout",
-          "default": 300,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "description": "Wait until Apple Ads reports as connected",
-          "name": "wait",
-          "allowNo": true,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:connect",
+      "id": "auth:status",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -620,16 +620,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "connect.js"
+        "auth",
+        "status.js"
       ]
     },
-    "asa:whoami": {
+    "auth:whoami": {
       "aliases": [],
       "args": {},
-      "description": "Show which company the token unlocks and whether Apple Ads is connected",
+      "description": "Show current user info from server (verifies token)",
       "examples": [
-        "<%= config.bin %> asa whoami"
+        "<%= config.bin %> auth whoami"
       ],
       "flags": {
         "json": {
@@ -642,7 +642,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:whoami",
+      "id": "auth:whoami",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -652,7 +652,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
+        "auth",
         "whoami.js"
       ]
     },
@@ -2198,56 +2198,6 @@
         "update.js"
       ]
     },
-    "asa:apps:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List the apps promoted by this company in Apple Search Ads",
-      "examples": [
-        "<%= config.bin %> asa apps list",
-        "<%= config.bin %> asa apps list --page 2 --page-size 50"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:apps:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "apps",
-        "list.js"
-      ]
-    },
     "asa:ads:create": {
       "aliases": [],
       "args": {},
@@ -2529,13 +2479,65 @@
         "update.js"
       ]
     },
+    "asa:apps:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the apps promoted by this company in Apple Search Ads",
+      "examples": [
+        "<%= config.bin %> asa apps list",
+        "<%= config.bin %> asa apps list --page 2 --page-size 50"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:apps:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "apps",
+        "list.js"
+      ]
+    },
     "asa:automations:create": {
       "aliases": [],
       "args": {},
-      "description": "Create an automation rule from a JSON rule file",
+      "description": "Create an automation rule from a JSON rule file. The add-as-keyword action flags fill in or override actions[0].params, so the bid, the match type and the target ad groups need no hand-written JSON.",
       "examples": [
         "<%= config.bin %> asa automations create --file rule.json",
-        "<%= config.bin %> asa automations create --file rule.json --run-now"
+        "<%= config.bin %> asa automations create --file rule.json --run-now",
+        "<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type search_term_current_cpt",
+        "<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type set_to --cpt-bid 1.50 --negate ad-group"
       ],
       "flags": {
         "json": {
@@ -2545,6 +2547,79 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "cpt-bid": {
+          "description": "cpt_bid.value: the bid itself with --cpt-bid-type set_to, or a percent markup on the entity bid with search_term_current_cpt / keyword_current_bid; not accepted with ad_group_default_bid",
+          "name": "cpt-bid",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cpt-bid-type": {
+          "description": "Where the bid of the created keyword comes from; the API has no default",
+          "name": "cpt-bid-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ad_group_default_bid",
+            "keyword_current_bid",
+            "search_term_current_cpt",
+            "set_to"
+          ],
+          "type": "option"
+        },
+        "match-type": {
+          "description": "Match type of the created keyword; the API has no default",
+          "name": "match-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "BROAD",
+            "EXACT"
+          ],
+          "type": "option"
+        },
+        "negate": {
+          "description": "Also add the search term as a negative keyword at this level (search-term rules)",
+          "exclusive": [
+            "no-negate"
+          ],
+          "name": "negate",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ad-group",
+            "campaign"
+          ],
+          "type": "option"
+        },
+        "no-negate": {
+          "description": "Leave no negative keyword behind (search-term rules)",
+          "exclusive": [
+            "negate"
+          ],
+          "name": "no-negate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "pause-original": {
+          "description": "Pause the source keyword in its own ad group (targeting-keyword rules)",
+          "name": "pause-original",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "skip-enable-duplicates": {
+          "description": "Skip a keyword that already exists in the target ad group instead of enabling it (search-term rules)",
+          "name": "skip-enable-duplicates",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "target-ad-group": {
+          "description": "Ad group the keyword is added to (UUID), repeatable; a rule without one does nothing",
+          "name": "target-ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "yes": {
           "char": "y",
           "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2803,10 +2878,11 @@
           "required": true
         }
       },
-      "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
+      "description": "Change an automation rule: stop it, rename it, or replace parts of the rule. An add-as-keyword action flag turns the call into a read-modify-write: the rule is read, actions[0].params is rebuilt from the flags and the whole actions list is written back — an edit someone makes in the dashboard in between is overwritten. This is also the way to repair a rule whose stored params carry the wrong shape.",
       "examples": [
         "<%= config.bin %> asa automations update UUID --stop",
-        "<%= config.bin %> asa automations update UUID --file rule.json"
+        "<%= config.bin %> asa automations update UUID --file rule.json",
+        "<%= config.bin %> asa automations update UUID --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type search_term_current_cpt"
       ],
       "flags": {
         "json": {
@@ -2816,6 +2892,79 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "cpt-bid": {
+          "description": "cpt_bid.value: the bid itself with --cpt-bid-type set_to, or a percent markup on the entity bid with search_term_current_cpt / keyword_current_bid; not accepted with ad_group_default_bid",
+          "name": "cpt-bid",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cpt-bid-type": {
+          "description": "Where the bid of the created keyword comes from; the API has no default",
+          "name": "cpt-bid-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ad_group_default_bid",
+            "keyword_current_bid",
+            "search_term_current_cpt",
+            "set_to"
+          ],
+          "type": "option"
+        },
+        "match-type": {
+          "description": "Match type of the created keyword; the API has no default",
+          "name": "match-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "BROAD",
+            "EXACT"
+          ],
+          "type": "option"
+        },
+        "negate": {
+          "description": "Also add the search term as a negative keyword at this level (search-term rules)",
+          "exclusive": [
+            "no-negate"
+          ],
+          "name": "negate",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ad-group",
+            "campaign"
+          ],
+          "type": "option"
+        },
+        "no-negate": {
+          "description": "Leave no negative keyword behind (search-term rules)",
+          "exclusive": [
+            "negate"
+          ],
+          "name": "no-negate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "pause-original": {
+          "description": "Pause the source keyword in its own ad group (targeting-keyword rules)",
+          "name": "pause-original",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "skip-enable-duplicates": {
+          "description": "Skip a keyword that already exists in the target ad group instead of enabling it (search-term rules)",
+          "name": "skip-enable-duplicates",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "target-ad-group": {
+          "description": "Ad group the keyword is added to (UUID), repeatable; a rule without one does nothing",
+          "name": "target-ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "yes": {
           "char": "y",
           "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2880,47 +3029,6 @@
         "update.js"
       ]
     },
-    "asa:competitors:summary": {
-      "aliases": [],
-      "args": {},
-      "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
-      "examples": [
-        "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app-ids": {
-          "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
-          "name": "app-ids",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:competitors:summary",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "competitors",
-        "summary.js"
-      ]
-    },
     "asa:campaigns:bulk-create": {
       "aliases": [],
       "args": {},
@@ -3639,13 +3747,12 @@
         "update.js"
       ]
     },
-    "asa:creatives:list": {
+    "asa:competitors:summary": {
       "aliases": [],
       "args": {},
-      "description": "List creatives; creative_id is what `asa ads create` needs",
+      "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
       "examples": [
-        "<%= config.bin %> asa creatives list",
-        "<%= config.bin %> asa creatives list --app APP_UUID"
+        "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
       ],
       "flags": {
         "json": {
@@ -3655,40 +3762,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
+        "app-ids": {
+          "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
+          "name": "app-ids",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "app": {
-          "description": "Keep only rows in this app; repeatable",
-          "name": "app",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "campaign-group": {
-          "description": "Keep only rows in this campaign group; repeatable",
-          "name": "campaign-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:creatives:list",
+      "id": "asa:competitors:summary",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -3699,8 +3784,8 @@
         "dist",
         "commands",
         "asa",
-        "creatives",
-        "list.js"
+        "competitors",
+        "summary.js"
       ]
     },
     "asa:keywords:add": {
@@ -4009,13 +4094,14 @@
     "asa:metrics": {
       "aliases": [],
       "args": {},
-      "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the finest --group-by period: 28 days when\nday is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by\ncoarsening the grouping, not by splitting into more calls. Each page is also capped at 20000 breakdown\nrows (entities × countries × periods); over it the call fails with 422 cli_response_too_large — coarsen\nthe grouping, narrow the window, or reduce page[size]. Budget: 5 metrics calls per minute, at most\n2 per 10 seconds, one at a time.",
+      "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the finest --group-by period: 28 days when\nday is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by\ncoarsening the grouping, not by splitting into more calls. Each page is also capped at a breakdown-row\ncount (entities × countries × periods); over it the call fails with 422 cli_response_too_large naming the\npage[size] that fits — coarsen the grouping, narrow the window, or reduce page[size].\n\nMoney columns are in the campaign group currency, not USD, and spend and local_spend carry the same\nfigure; the currency itself comes from asa orgs list. Rate budgets and the breakdown-row cap are set per\ncompany: read the current ones with asa whoami rather than assuming a default. meta.pagination.count is\nthe full entity count behind the filters, so take inventory from there instead of counting the rows on a\npage. meta.max_valid_day says how many days the youngest cohort in the window has lived — any --by-days\nwindow above it repeats the last real figure because that time has not passed yet, so treat those as\nunreached rather than as a plateau.\n\n--metric is required and every metric named is computed over the whole entity set, so ask for the\ncolumns you actually read. subscribers and paid_subscribers (and arppu / arpas, which derive from them)\ncount unique profiles per entity and cost roughly seventeen times the rest; whatever the --entity, they\nare refused unless --campaign or --ad-group scopes the call. Those scope flags are also the cheapest way\nto make any call fast, since cost follows the number of entities aggregated, not the page size.",
       "examples": [
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric adapty_installs",
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --order-by spend --page-size 5",
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --group-by country --page-size 1000",
         "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90",
+        "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric arpas --campaign 0f0e..."
       ],
       "flags": {
         "json": {
@@ -4048,6 +4134,27 @@
           "multiple": true,
           "type": "option"
         },
+        "ad-group": {
+          "description": "Keep only rows in this ad group; repeatable",
+          "name": "ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign": {
+          "description": "Keep only rows in this campaign; repeatable",
+          "name": "campaign",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "date-from": {
           "description": "Start of the period (YYYY-MM-DD)",
           "name": "date-from",
@@ -4094,8 +4201,9 @@
           "type": "option"
         },
         "metric": {
-          "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
+          "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable and required; every metric asked for is computed over the whole entity set, so list only what you read; a wrong name fails listing all valid ones",
           "name": "metric",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -4705,6 +4813,70 @@
         "list.js"
       ]
     },
+    "asa:creatives:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List creatives; creative_id is what `asa ads create` needs",
+      "examples": [
+        "<%= config.bin %> asa creatives list",
+        "<%= config.bin %> asa creatives list --app APP_UUID"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign-group": {
+          "description": "Keep only rows in this campaign group; repeatable",
+          "name": "campaign-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:creatives:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "creatives",
+        "list.js"
+      ]
+    },
     "flows:config:get": {
       "aliases": [],
       "args": {
@@ -5009,5 +5181,5 @@
       ]
     }
   },
-  "version": "0.8.4-beta.1"
+  "version": "0.8.5"
 }