@adkit/cli 1.13.11 → 1.13.13

package/dist/cli.js

@@ -4569,19 +4569,20 @@ function formatHelpSearch(data) {
   for (const result of cliData.results) {
     lines.push(`adkit ${result.path} --help`);
     if (result.description) lines.push(`  ${result.description}`);
+    if (result.snippet) lines.push(`  \u21B3 ${result.snippet}`);
   }
   lines.push("", "Each command above opens the matching CLI help.");
   return lines.join("\n");
 }
 function serverHelpPointerToCli(result) {
   const override = CLI_HELP_OVERRIDES[result.path];
-  if (override) return { path: override.path, description: override.description || result.description };
+  if (override) return { path: override.path, description: override.description || result.description, snippet: result.snippet };
   const negativeListPrefix = "manage google negative-list ";
   if (result.path.startsWith(negativeListPrefix)) {
     const action = result.path.slice(negativeListPrefix.length);
-    return { path: `manage google keywords negative-lists ${action}`, description: result.description };
+    return { path: `manage google keywords negative-lists ${action}`, description: result.description, snippet: result.snippet };
   }
-  if (result.path.startsWith("manage platform-api-request ")) return { path: "manage platform-api-requests", description: result.description };
+  if (result.path.startsWith("manage platform-api-request ")) return { path: "manage platform-api-requests", description: result.description, snippet: result.snippet };
   return result;
 }
 function isHelpSearchResponse(value) {
@@ -6095,22 +6096,34 @@ ${FLAG.data}
   --campaign-ids <ids> Comma-separated campaign IDs for filtered reads
   --campaign <id>     Parent campaign ID (create only)
   --name <name>       Ad group name
-  --status <s>        active, paused
+  --status <s>        active, paused (create default: paused)
   --budget-daily <n>  Daily budget in account currency
   --budget-lifetime <n> Lifetime budget in account currency
   --start-date <value> Optional TikTok schedule datetime; omit to start now
   --end-date <value>   Optional TikTok schedule datetime; required with lifetime budget
   --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
+  --optimization <s>  click, convert, lead_generation, video_view, reach, value
   --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)
 
+Value Optimization (website):
+  --optimization value bids on purchase value. It needs --event-type purchase plus a pixel (--pixel, or the account default), and rejects --bid-strategy, --bid-amount, and any --billing-event other than ocpm.
+  targetRoas has no flag \u2014 send it with --data. targetRoas set = Minimum ROAS (0.01-1000, where 1.5 = 150%); targetRoas omitted = Highest Value.
+  update only retunes targetRoas on an ad group that already uses Value Optimization. TikTok cannot move an ordinary ad group onto it \u2014 create a new ad group instead.
+  TikTok checks account and pixel eligibility, so a valid payload can still be rejected at publish.
+
 Examples:
   adkit manage tiktok ad-groups create --campaign 1770 --name "US Broad" --budget-daily 50 --billing-event cpc --optimization click
-  adkit manage tiktok ad-groups create --data '{"adGroups":[{"campaignId":"1770","name":"Purchase","budget":{"daily":50},"startDate":"2026-05-15 12:00:00","bidAmount":80,"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},"startDate":"2026-05-15 12:00:00","bidAmount":80,"conversion":{"eventType":"purchase"},"targeting":{"geoLocations":{"include":[{"type":"country","country":"US"}]}}}]}'
+  # Highest Value
+  adkit manage tiktok ad-groups create --campaign 1770 --name "Highest value" --budget-daily 50 --optimization value --event-type purchase
+  # Minimum ROAS 1.5x
+  adkit manage tiktok ad-groups create --data '{"adGroups":[{"campaignId":"1770","name":"Min ROAS 1.5x","budget":{"daily":50},"optimization":"value","targetRoas":1.5,"conversion":{"eventType":"purchase"}}]}'
+  # Retune the ROAS target on an existing Value Optimization ad group
+  adkit manage tiktok ad-groups update 1770000000000000000 --data '{"targetRoas":2}'`.trim(),
   "tiktok ads": `adkit manage tiktok ads \u2014 TikTok video ads
 
   list                List ads

package/package.json

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