@koda-sl/baker-cli 0.255.0-dev.9688d6d20 → 0.255.0

package/dist/cli.js

@@ -58,7 +58,7 @@ import {
   ulid,
   validateCanvasDeep,
   ytDlpBlockSignal
-} from "./chunk-HBDGUVUH.js";
+} from "./chunk-SJPRTSGY.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -67,7 +67,7 @@ import {
   resolveAccountIdArg,
   resolveEffectiveStatus,
   todayIso
-} from "./chunk-6MAVG6LO.js";
+} from "./chunk-KSOGK7SJ.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -83,13 +83,14 @@ import {
   writeAdsJson,
   writeAdsOutput,
   writeJsonEnvelope
-} from "./chunk-5JHSX3ZB.js";
+} from "./chunk-6F52WYB7.js";
 import {
   ApiError,
   apiGet,
+  apiGetWithHeaders,
   apiPost,
   validateConvexId
-} from "./chunk-JKSMLAQN.js";
+} from "./chunk-GU7IWEBC.js";
 import {
   installStreamTaps,
   logInvocation
@@ -2152,8 +2153,18 @@ var ADVERTISING_CHANNEL_TYPES = [
   "LOCAL",
   "SMART",
   "TRAVEL",
-  "HOTEL",
-  "DISCOVERY"
+  "HOTEL"
+  // This constant has ONE consumer — `campaignCreateSchema.channelType` — so it is a write-side
+  // allowlist, not a vocabulary. A value belongs here only if Baker can legitimately create a
+  // campaign of that type. GAQL reads never pass through it (`listSizeRequirement` takes the raw
+  // string straight off the row, deliberately), so adding a channel here buys no read coverage.
+  //
+  // Two omissions are therefore deliberate. DISCOVERY used to sit here: Google renamed it
+  // DEMAND_GEN and dropped the old name from the v23 enum, so a campaign staged as DISCOVERY could
+  // only ever fail at publish — inside an atomic batch, taking every co-staged op down with it.
+  // LOCAL_SERVICES is a real v23 channel but is not creatable through the API; Google's own LSA
+  // migration produces those campaigns. Accepting either one would stage a campaign that passes
+  // validation, reaches a review card a user approves, and then fails the whole publish.
 ];
 var ADVERTISING_CHANNEL_SUB_TYPES = [
   "SEARCH_MOBILE_APP",
@@ -2183,7 +2194,13 @@ var BIDDING_STRATEGY_TYPES = [
   "TARGET_IMPRESSION_SHARE",
   "MANUAL_CPM",
   "MANUAL_CPV",
-  "PERCENT_CPC"
+  "PERCENT_CPC",
+  // Demand Gen's "maximize clicks at a target CPC" — `Campaign.target_cpc`, overridable per ad
+  // group via `AdGroup.target_cpc_micros`. Confirmed present in v23.
+  // It is one of the target-driven strategies governed by the August 2026 budget-limited
+  // change, so modelling it as a strategy without a target would leave a Demand Gen
+  // campaign's exposure invisible to `biddingTargetWarnings`.
+  "TARGET_CPC"
 ];
 var MERGED_TARGET_STRATEGY_CHANNELS = /* @__PURE__ */ new Set(["SEARCH"]);
 var MERGED_TARGET_CPA_MESSAGE = "Google doesn't accept Target CPA as a bidding strategy of its own on a Search campaign \u2014 the target sits inside Maximize conversions. Choose Maximize conversions and give it the same target CPA; it bids exactly the same.";
@@ -2197,6 +2214,13 @@ function mergedTargetStrategyRefusal(channelType, biddingType) {
   }
   return biddingType === "TARGET_ROAS" ? MERGED_TARGET_ROAS_MESSAGE : void 0;
 }
+var TARGET_CPC_DEMAND_GEN_MESSAGE = "Google only accepts Target CPC on a Demand Gen campaign \u2014 no other campaign type has a target CPC. Pick the bidding this campaign's type supports (Maximize conversions with a target CPA on Search), or set the target CPC on the Demand Gen campaign that should carry it.";
+function demandGenOnlyStrategyRefusal(channelType, biddingType) {
+  if (biddingType !== "TARGET_CPC" || channelType === void 0 || channelType === "DEMAND_GEN") {
+    return void 0;
+  }
+  return TARGET_CPC_DEMAND_GEN_MESSAGE;
+}
 var POSITIVE_GEO_TARGET_TYPES = ["PRESENCE_OR_INTEREST", "PRESENCE"];
 var NEGATIVE_GEO_TARGET_TYPES = ["PRESENCE_OR_INTEREST", "PRESENCE"];
 var BUDGET_DELIVERY_METHODS = ["STANDARD", "ACCELERATED"];
@@ -2849,6 +2873,8 @@ var biddingConfigSchema = z4.object({
   type: z4.enum(BIDDING_STRATEGY_TYPES),
   targetCpaMicros: microsSchema.optional(),
   targetRoas: z4.number().positive().optional(),
+  /** Demand Gen only — `Campaign.target_cpc.target_cpc_micros`. */
+  targetCpcMicros: microsSchema.optional(),
   cpcBidCeilingMicros: microsSchema.optional(),
   enhancedCpcEnabled: z4.boolean().optional()
 }).superRefine((p, ctx) => {
@@ -2858,6 +2884,9 @@ var biddingConfigSchema = z4.object({
   if (p.type === "TARGET_ROAS" && p.targetRoas === void 0) {
     ctx.addIssue({ code: "custom", path: ["targetRoas"], message: "TARGET_ROAS needs targetRoas" });
   }
+  if (p.type === "TARGET_CPC" && p.targetCpcMicros === void 0) {
+    ctx.addIssue({ code: "custom", path: ["targetCpcMicros"], message: "TARGET_CPC needs targetCpcMicros" });
+  }
 });
 var networkSettingsSchema = z4.strictObject({
   targetGoogleSearch: z4.boolean().optional(),
@@ -2921,9 +2950,9 @@ var campaignCreateSchema2 = z4.strictObject({
   if (p.channelType === "PERFORMANCE_MAX" && p.bidding && p.bidding.type === "MANUAL_CPC") {
     ctx.addIssue({ code: "custom", path: ["bidding"], message: "Performance Max does not support Manual CPC" });
   }
-  const mergedTarget = mergedTargetStrategyRefusal(p.channelType, p.bidding?.type);
-  if (mergedTarget) {
-    ctx.addIssue({ code: "custom", path: ["bidding"], message: mergedTarget });
+  const channelRefusal = mergedTargetStrategyRefusal(p.channelType, p.bidding?.type) ?? demandGenOnlyStrategyRefusal(p.channelType, p.bidding?.type);
+  if (channelRefusal) {
+    ctx.addIssue({ code: "custom", path: ["bidding"], message: channelRefusal });
   }
   if (p.startDate && p.endDate && p.endDate <= p.startDate) {
     ctx.addIssue({ code: "custom", path: ["endDate"], message: "endDate must be after startDate" });
@@ -3259,6 +3288,7 @@ var conversionGoalSetSchema = z4.object({
   /** True = conversions of this category/origin count toward automated bidding; false = reported only. */
   biddable: z4.boolean()
 });
+var PORTFOLIO_TARGET_CPC_MESSAGE = "portfolio strategies cannot be Target CPC \u2014 it is set on the Demand Gen campaign itself";
 var biddingStrategyCreateSchema = z4.object({
   name: z4.string().min(1).max(GOOGLE_ADS_LIMITS.biddingStrategy.nameMax),
   config: biddingConfigSchema
@@ -3266,11 +3296,21 @@ var biddingStrategyCreateSchema = z4.object({
   if (p.config.type === "MANUAL_CPC") {
     ctx.addIssue({ code: "custom", path: ["config", "type"], message: "portfolio strategies cannot be Manual CPC" });
   }
+  if (p.config.type === "TARGET_CPC") {
+    ctx.addIssue({ code: "custom", path: ["config", "type"], message: PORTFOLIO_TARGET_CPC_MESSAGE });
+  }
 });
 var biddingStrategyUpdateSchema = z4.object({
   name: z4.string().min(1).max(GOOGLE_ADS_LIMITS.biddingStrategy.nameMax).optional(),
   config: biddingConfigSchema.optional()
-}).refine((p) => Object.values(p).some((v) => v !== void 0), "update needs at least one field");
+}).superRefine((p, ctx) => {
+  if (Object.values(p).every((v) => v === void 0)) {
+    ctx.addIssue({ code: "custom", message: "update needs at least one field" });
+  }
+  if (p.config?.type === "TARGET_CPC") {
+    ctx.addIssue({ code: "custom", path: ["config", "type"], message: PORTFOLIO_TARGET_CPC_MESSAGE });
+  }
+});
 var labelCreateSchema = z4.object({
   name: z4.string().min(1).max(GOOGLE_ADS_LIMITS.label.nameMax),
   backgroundColor: z4.string().regex(/^#[0-9A-Fa-f]{6}$/).optional(),
@@ -4593,24 +4633,6 @@ var FLOW_SIDE_EFFECT_CATALOG = [
     gotcha: "`eventTagId` comes from X Events Manager and is passed verbatim. `eventName` is an optional label only.",
     reference: TAGS_REF
   },
-  {
-    kind: "side-effect",
-    type: "microsoftAds",
-    summary: "Fires a Microsoft Ads (UET) conversion event.",
-    skeleton: {
-      ...SIDE_EFFECT_ENVELOPE,
-      type: "microsoftAds",
-      tagIds: TAG_REF_SLOT,
-      eventName: "<UET event action, e.g. lead_submitted>",
-      userMatching: matchingSlots("em", "ph"),
-      value: null,
-      currency: null,
-      transactionId: null
-    },
-    owners: { tagIds: "tags" },
-    gotcha: "`eventName` is the UET *event action*, and it only counts as a conversion once someone creates a matching custom-event conversion goal in Microsoft Advertising \u2014 the tag alone records nothing. `page_view` is refused outright (UET reserves it for SPA navigation), so pick any other action. `eventCategory` and `eventLabel` are optional plain strings (not mapped slots) \u2014 add them only when the goal filters on them. `userMatching` needs Enhanced conversions turned on for that goal, and `ph` must carry a country code (`+34\u2026`/`0034\u2026`) \u2014 map it from a phone field with the country picker, not a plain text field, or it is dropped rather than guessed at.",
-    reference: TAGS_REF
-  },
   eventSideEffect("posthog", "Captures a PostHog event.", { eventParams: [] }),
   {
     kind: "side-effect",
@@ -6053,8 +6075,7 @@ var TAG_TYPES = [
   "posthog",
   "datafast",
   "recaptcha",
-  "twitterAds",
-  "microsoftAds"
+  "twitterAds"
 ];
 var tagTypeSchema = z19.enum(TAG_TYPES);
 var TAG_IDENTIFYING_FIELD = {
@@ -6075,8 +6096,7 @@ var TAG_IDENTIFYING_FIELD = {
   posthog: "projectToken",
   datafast: "websiteId",
   recaptcha: "siteKey",
-  twitterAds: "pixelId",
-  microsoftAds: "tagId"
+  twitterAds: "pixelId"
 };
 var tagDraftOpKindSchema = z19.enum(["create", "update", "delete"]);
 var tagDraftOpViewSchema = z19.object({
@@ -6203,7 +6223,10 @@ var testimonialsListRequestSchema = z20.object({
   status: testimonialStatusSchema.optional(),
   sentiment: testimonialSentimentSchema.optional(),
   language: z20.string().min(2).max(5).optional(),
-  limit: z20.coerce.number().int().positive().max(200).optional()
+  limit: z20.coerce.number().int().positive().max(200).optional(),
+  // Opaque, from the previous response's `X-Baker-Next-Cursor`. Absent on the
+  // first page; its absence on a response means the corpus is exhausted.
+  cursor: z20.string().optional()
 });
 var testimonialsListResponseSchema = z20.array(testimonialDocSchema);
 var testimonialsGetRequestSchema = z20.object({ id: z20.string().min(1, "Missing id parameter") });
@@ -7970,6 +7993,14 @@ var FIELD_DESCRIPTIONS = {
   "campaign.status": "ENABLED, PAUSED, or REMOVED",
   "campaign.advertising_channel_type": "Campaign type: SEARCH, DISPLAY, SHOPPING, VIDEO, PERFORMANCE_MAX, DEMAND_GEN",
   "campaign.bidding_strategy_type": "Bidding strategy (TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, etc.)",
+  "campaign.primary_status": "Whether the campaign can serve: ELIGIBLE, PAUSED, REMOVED, ENDED, PENDING, MISCONFIGURED, LIMITED, LEARNING, NOT_ELIGIBLE. Unlike the keyword equivalent, LIMITED is a real value here \u2014 but Google publishes no reason-to-status mapping, so decide 'Limited by budget' from primary_status_reasons, not from this field.",
+  "campaign.primary_status_reasons": "Why the campaign is limited or not serving (repeated field \u2014 an array). BUDGET_CONSTRAINED is 'Limited by budget'; BUDGET_MISCONFIGURED is a broken budget setting, not a cap. Since 17 Aug 2026 a budget-limited campaign on a target-based strategy delivers toward its target instead of toward its recent actual cost, so BUDGET_CONSTRAINED is the flag that says a target above actual now costs money. BIDDING_STRATEGY_LEARNING means the bidding system is still adjusting to a change.",
+  "campaign.target_cpa.target_cpa_micros": "Target CPA in micros on a standalone Target CPA strategy",
+  "campaign.maximize_conversions.target_cpa_micros": "Target CPA in micros when the target is held inside a Maximize Conversions strategy \u2014 the shape Google uses on Search",
+  "campaign.target_roas.target_roas": "Target ROAS as a ratio (2.5 = 250%) on a standalone Target ROAS strategy",
+  "campaign.maximize_conversion_value.target_roas": "Target ROAS as a ratio when held inside a Maximize Conversion Value strategy",
+  "campaign.target_cpc.target_cpc_micros": "Target CPC in micros on a Demand Gen Target CPC strategy. Governed by the same August 2026 change as Target CPA/ROAS: on a budget-limited campaign it is what delivery moves toward, not a ceiling.",
+  "ad_group.target_cpc_micros": "Ad-group override of the campaign's Demand Gen target CPC, in micros",
   "campaign.start_date": "Campaign start date (YYYY-MM-DD)",
   "campaign.end_date": "Campaign end date (YYYY-MM-DD), blank if ongoing",
   // Campaign budget
@@ -8022,6 +8053,8 @@ var FIELD_DESCRIPTIONS = {
   "metrics.average_cpc": "Average cost per click in micros (\xF7 1,000,000)",
   "metrics.average_cpm": "Average cost per 1000 impressions in micros (\xF7 1,000,000)",
   "metrics.search_impression_share": "Impression share as decimal (0.0\u20131.0)",
+  "metrics.search_budget_lost_impression_share": "Share of impressions lost because the budget ran out, as a decimal (0.0\u20131.0). The corroborating signal for a 'Limited by budget' campaign \u2014 a high value here alongside a target above actual cost per conversion is the combination that now raises spend.",
+  "metrics.cost_per_conversion": "Actual cost per conversion in micros (\xF7 1,000,000) \u2014 compare against the campaign's target",
   "metrics.interaction_rate": "Interaction rate as decimal",
   "metrics.video_views": "Total video views (integer)",
   "metrics.video_view_rate": "Video view rate as decimal",
@@ -10830,6 +10863,14 @@ var PRESETS = [
     defaultLimit: 200,
     statusFields: ["campaign.status"]
   },
+  {
+    name: "budget-limited",
+    description: "Campaigns Google reports as limited by budget, with each one's bid target next to its actual cost per conversion \u2014 the state where a target above actual now drives delivery up to the target instead of holding recent cost",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, campaign.advertising_channel_type, campaign.bidding_strategy_type, campaign.primary_status, campaign.primary_status_reasons, campaign.target_cpa.target_cpa_micros, campaign.maximize_conversions.target_cpa_micros, campaign.target_roas.target_roas, campaign.maximize_conversion_value.target_roas, campaign.target_cpc.target_cpc_micros, campaign_budget.amount_micros, metrics.cost_micros, metrics.conversions, metrics.conversions_value, metrics.cost_per_conversion, metrics.search_budget_lost_impression_share FROM campaign WHERE campaign.primary_status_reasons CONTAINS ANY (BUDGET_CONSTRAINED) AND segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC LIMIT {limit}`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status"]
+  },
   {
     name: "keyword-analysis",
     description: "Keyword performance with match type and quality",
@@ -13866,15 +13907,27 @@ function biddingFromFlags(args) {
         "--max-cpc needs --bidding-strategy too (the ceiling belongs to a strategy) \u2014 e.g. --bidding-strategy TARGET_IMPRESSION_SHARE --max-cpc 12"
       );
     }
+    if (args["target-cpc"] !== void 0) {
+      failWriteValidation(
+        "--target-cpc needs --bidding-strategy too (the target belongs to a strategy) \u2014 use --bidding-strategy TARGET_CPC --target-cpc 1.5"
+      );
+    }
     return void 0;
   }
   if (maxCpcMicros !== void 0 && !MAX_CPC_STRATEGIES.includes(type.toUpperCase())) {
     failWriteValidation(`${type} does not take --max-cpc \u2014 only ${MAX_CPC_STRATEGIES.join(", ")} carry a bid ceiling`);
   }
+  const targetCpcMicros = microsFlag(args["target-cpc"], "--target-cpc");
+  if (targetCpcMicros !== void 0 && type.toUpperCase() !== "TARGET_CPC") {
+    failWriteValidation(
+      `${type} does not take --target-cpc \u2014 pair it with --bidding-strategy TARGET_CPC (Demand Gen campaigns only)`
+    );
+  }
   return {
     type,
     targetCpaMicros: microsFlag(args["target-cpa"], "--target-cpa"),
     targetRoas: args["target-roas"] !== void 0 ? Number(args["target-roas"]) : void 0,
+    targetCpcMicros,
     cpcBidCeilingMicros: maxCpcMicros
   };
 }
@@ -14059,6 +14112,10 @@ var campaignsCommand = defineCommand30({
           type: "string",
           description: "Target ROAS (e.g. 4.0). On a Search campaign pair it with --bidding-strategy MAXIMIZE_CONVERSION_VALUE \u2014 Google keeps the target inside that strategy and rejects a standalone TARGET_ROAS."
         },
+        "target-cpc": {
+          type: "string",
+          description: "Target CPC (major units) for Demand Gen \u2014 pair it with --bidding-strategy TARGET_CPC. Demand Gen only; other channels have no target CPC."
+        },
         ...maxCpcArg,
         ...finalUrlSuffixArg,
         ...urlOptionsArgs,
@@ -14117,6 +14174,10 @@ var campaignsCommand = defineCommand30({
           type: "string",
           description: "Target ROAS (e.g. 4.0). On a Search campaign pair it with --bidding-strategy MAXIMIZE_CONVERSION_VALUE \u2014 Google keeps the target inside that strategy and rejects a standalone TARGET_ROAS."
         },
+        "target-cpc": {
+          type: "string",
+          description: "Target CPC (major units) for Demand Gen \u2014 pair it with --bidding-strategy TARGET_CPC. Demand Gen only; other channels have no target CPC."
+        },
         ...maxCpcArg,
         ...finalUrlSuffixArg,
         ...urlOptionsArgs,
@@ -21034,10 +21095,10 @@ function duplicateCommand2(entity, label) {
       replace: { type: "boolean", description: "Pause the original once the copy publishes" }
     },
     run: async ({ args }) => {
-      const { apiPost: apiPost2 } = await import("./client-3TNO43FO.js");
+      const { apiPost: apiPost2 } = await import("./client-VDCCDEHE.js");
       const { requireChatId: requireChatId2 } = await import("./env-FWMZXMQK.js");
-      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-B3OCLLS5.js");
-      const { handleMetaError: handleMetaError2 } = await import("./shared-J24NXBW4.js");
+      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-JBYI5IVX.js");
+      const { handleMetaError: handleMetaError2 } = await import("./shared-GWFXJXKJ.js");
       try {
         const accountId = bareAccountId2(args);
         const chatId = requireChatId2();
@@ -34723,10 +34784,6 @@ var MAPPING_SLOTS = {
   twitterAds: [
     { kind: "record", key: "userMatching", allowed: ["em", "ph"] },
     { kind: "scalar", keys: ["value", "currency"] }
-  ],
-  microsoftAds: [
-    { kind: "record", key: "userMatching", allowed: ["em", "ph"] },
-    { kind: "scalar", keys: ["value", "currency", "transactionId"] }
   ]
 };
 var UNMAPPABLE = {
@@ -50129,14 +50186,30 @@ function emptyReasonDetail(reason, sourceCount, activeFilters) {
   }
   return `${sourceCount} review source${sourceCount === 1 ? " is" : "s are"} connected but hold no testimonials yet \u2014 the source is there, the rows are not. Ingestion may still be running.`;
 }
+function morePagesHint(resultCount, cursor) {
+  const found = resultCount === 0 ? "This page held no matches" : `This page held ${resultCount}`;
+  return `${found}, and the library continues past it \u2014 so this is one page, not the client's whole set. Do not report it as the corpus and do not conclude anything is missing from it. Read the next page with \`baker testimonials list --cursor ${cursor}\` (same filters), or go straight at the rows you want with \`baker testimonials search <query>\`.`;
+}
+function endOfWalkHint(command) {
+  const noun = command === "search" ? "results" : "rows";
+  return `That was the end of the library \u2014 no more ${noun} past the page before this one. Nothing here says the corpus is empty (the earlier pages held it), so answer from what those pages returned rather than re-reading.`;
+}
 async function measureEmptyCorpus({
   command,
   resultCount,
-  activeFilters
+  activeFilters,
+  nextCursor = null,
+  continued = false
 }) {
+  if (nextCursor) {
+    return { hints: [morePagesHint(resultCount, nextCursor)] };
+  }
   if (resultCount > 0) {
     return { hints: [] };
   }
+  if (continued) {
+    return { hints: [endOfWalkHint(command)] };
+  }
   if (activeFilters.length > 0) {
     const reason2 = "filtered_out";
     return {
@@ -50215,7 +50288,12 @@ registerSchema({
     },
     language: { type: "string", description: "Filter by language code (e.g. en, es)", required: false },
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
-    limit: { type: "number", description: "Max results (default 50)", required: false, default: 50 }
+    limit: { type: "number", description: "Max results per page (default 50)", required: false, default: 50 },
+    cursor: {
+      type: "string",
+      description: "Read the next page: pass meta.next_cursor from the previous call, with the same filters.",
+      required: false
+    }
   }
 });
 var PARAM_NAMES = {
@@ -50226,7 +50304,8 @@ var PARAM_NAMES = {
   sentiment: "sentiment",
   language: "language",
   tags: "tags",
-  limit: "limit"
+  limit: "limit",
+  cursor: "cursor"
 };
 function buildListParams(args) {
   const params = {};
@@ -50251,22 +50330,30 @@ var listCommand18 = defineCommand205({
     sentiment: { type: "string", description: "Filter: positive|neutral|negative", required: false },
     language: { type: "string", description: "Filter by language code (e.g. en, es)", required: false },
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
-    limit: { type: "string", description: "Max results (default 50)", required: false },
+    limit: { type: "string", description: "Max results per page (default 50)", required: false },
+    cursor: { type: "string", description: "meta.next_cursor from the previous page", required: false },
     output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
     fields: { type: "string", description: "Comma-separated field names to include", required: false },
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   },
   run: async ({ args }) => {
     try {
-      const data = await apiGet("/api/testimonials", buildListParams(args));
+      const { data, headers } = await apiGetWithHeaders(
+        "/api/testimonials",
+        buildListParams(args)
+      );
+      const nextCursor = headers.get("x-baker-next-cursor");
       const { hints: hints2, empty } = await measureEmptyCorpus({
         command: "list",
         resultCount: data.length,
-        activeFilters: activeFilterFlags(args, FILTER_FLAGS)
+        activeFilters: activeFilterFlags(args, FILTER_FLAGS),
+        nextCursor,
+        continued: Boolean(args.cursor)
       });
       const outputFormat = args.output || "json";
+      const meta = { ...empty ? { empty } : {}, ...nextCursor ? { next_cursor: nextCursor } : {} };
       writeOutput(
-        { ok: true, data, ...empty ? { meta: { empty } } : {}, ...hints2.length > 0 ? { hints: hints2 } : {} },
+        { ok: true, data, ...Object.keys(meta).length > 0 ? { meta } : {}, ...hints2.length > 0 ? { hints: hints2 } : {} },
         outputFormat,
         args.fields ? args.fields.split(",") : void 0,
         args.full,