@koda-sl/baker-cli 0.552.0 → 0.554.0

package/dist/activities-ORMACIG2.js

@@ -0,0 +1,75 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-ZW2CN6L6.js";
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-QY7EK6Q4.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-QYH2UZAK.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-65Y3RCWP.js";
+import {
+  apiGet
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/activities.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  days: { type: "string", description: "Lookback days (default 7)" },
+  limit: { type: "string", description: "Max rows" },
+  "no-cache": NO_CACHE_ARG,
+  ...META_LIST_SHAPE_ARGS
+};
+registerMetaListSchema(
+  "activities",
+  "Account change log, as a table by default, one row per event: event_time, event_type, actor_name, object_type, object_name, object_id, and change ('old \u2192 new' when the change is a single value). Start here: baker ads meta activities --account-id act_123 --days 2. --fields event_time,object_name,extra_data or --full for the raw change payload; --output json returns the rows in the envelope.",
+  listArgs
+);
+var activitiesCommand = defineCommand({
+  meta: {
+    name: "activities",
+    description: `Audit log of recent ad-account changes (created, paused, edited). Default lookback 7 days,
+~90 day retention server-side.
+
+A table by default, one row per event: event_time, event_type, actor_name, object_type,
+object_name, object_id, and change ("old \u2192 new" when the change is a single value: status,
+name, budget, goal). --fields takes dotted paths (extra_data holds the raw change); --full returns
+every field Meta sent; --output json returns the rows as JSON.
+
+Examples:
+  baker ads meta activities --account-id act_123 --days 14
+  baker ads meta activities --account-id act_123 --days 2 --output json
+  baker ads meta activities --account-id act_123 --fields event_time,object_name,extra_data`
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = await resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args.days) params.days = args.days;
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/activities", params);
+      const shaped = shapeMetaListRows("activities", data, args);
+      writeMetaListRows("activities", shaped, csvOrJson(args));
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  activitiesCommand
+};
+//# sourceMappingURL=activities-ORMACIG2.js.map

package/dist/ad-group-writes-Y6CCMPCM.js

@@ -0,0 +1,172 @@
+import {
+  clearableArg,
+  compact,
+  failWriteValidation,
+  lowerArg,
+  microsFromArg,
+  productFiltersArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-7SNNQCDD.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-FAV6GUOZ.js";
+import "./chunk-QYH2UZAK.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/ad-group-writes.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.adGroups;
+var SHARED_ARGS = {
+  name: { type: "string", description: "Ad group name (3+ characters)" },
+  description: { type: "string", description: "Internal description" },
+  "context-hints": {
+    type: "string",
+    description: "When the ad would be useful, short phrases separated by commas \u2014 or by | when a phrase has a comma. ChatGPT's counterpart to keywords, written in the language of the campaign's countries, as people ask ChatGPT. On update it replaces the whole list; none clears it"
+  },
+  "bid-strategy": {
+    type: "string",
+    description: "fixed_bid (default, needs --max-bid) | maximize_clicks | maximize_conversions"
+  },
+  "max-bid": { type: "string", description: "Bid in account currency, e.g. 2.50 \u2014 fixed_bid only" },
+  "tracking-template": {
+    type: "string",
+    description: "Query string added to this ad group's landing pages, e.g. ad_group_id={ad_group_id} \u2014 none clears"
+  },
+  "audience-bids": {
+    type: "string",
+    description: "Raise or lower the fixed bid for people in an audience: audience=multiplier pairs, 0.1 to 10, e.g. caud_123=1.5,caud_456=0.8. Audiences of ~25,000 people only; not in the EEA or Switzerland. On update it replaces them; none clears"
+  },
+  "product-filters": {
+    type: "string",
+    description: "Catalog campaigns only: which products it shows \u2014 e.g. brand in Acme; price lte 5000 (preview with `catalogs products`). On update it replaces the set; none shows the whole catalog"
+  },
+  status: { type: "string", description: "paused (default) | active" }
+};
+var CREATE_ARGS = {
+  ...SHARED_ARGS,
+  "campaign-id": { type: "string", description: "cmpn_\u2026 or a staged chatgpt_temp_ ref", required: true },
+  name: { type: "string", description: "Ad group name (3+ characters)", required: true }
+};
+var UPDATE_ARGS = {
+  id: { type: "positional", description: "Ad group id (adgrp_\u2026) or a staged chatgpt_temp_ ref", required: true },
+  ...SHARED_ARGS
+};
+function contextHintsArg(value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    return void 0;
+  }
+  if (value.trim().toLowerCase() === "none") {
+    return [];
+  }
+  const separator = value.includes("|") ? "|" : ",";
+  return value.split(separator).map((hint) => hint.trim()).filter(Boolean);
+}
+function audienceBidsArg(value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    return void 0;
+  }
+  if (value.trim().toLowerCase() === "none") {
+    return [];
+  }
+  return value.split(",").map((pair) => pair.trim()).filter(Boolean).map((pair) => {
+    const [audienceId = "", multiplier = ""] = pair.split("=").map((part) => part.trim());
+    const times = Number(multiplier.replace(",", "."));
+    if (!audienceId || !Number.isFinite(times)) {
+      failWriteValidation(`"${pair}" is not an audience bid \u2014 write audience=multiplier, e.g. caud_123=1.5`);
+    }
+    return { audienceId, multiplierMicros: Math.round(times * 1e6) };
+  });
+}
+function productSetArg(value) {
+  const filters = productFiltersArg(value);
+  return filters === void 0 ? void 0 : { filters };
+}
+function sharedPayload(args) {
+  return {
+    name: args.name,
+    description: args.description,
+    contextHints: contextHintsArg(args["context-hints"]),
+    bidStrategy: lowerArg(args["bid-strategy"]),
+    maxBidMicros: microsFromArg(args["max-bid"], "--max-bid"),
+    trackingTemplate: clearableArg(args["tracking-template"]),
+    productSet: productSetArg(args["product-filters"]),
+    audienceBidMultipliers: audienceBidsArg(args["audience-bids"]),
+    status: lowerArg(args.status)
+  };
+}
+function adGroupCreateOp(args) {
+  return { kind: "adGroup.create", payload: compact({ ...sharedPayload(args), campaignId: args["campaign-id"] }) };
+}
+registerSchema({
+  command: "ads.chatgpt.ad-groups.create",
+  description: "Stage a new ad group under a live campaign (cmpn_\u2026) or one staged in this chat (its chatgpt_temp_ ref). Context hints decide where the ad shows; a fixed bid needs --max-bid.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var adGroupsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new ad group (applies when the chat is published).
+
+Examples:
+  baker ads chatgpt ad-groups create --campaign-id cmpn_123 --name "Rooftop owners" --context-hints "solar panels for my house,cut my electricity bill" --max-bid 2.50
+  baker ads chatgpt ad-groups create --campaign-id chatgpt_temp_ab12 --name "Auto" --bid-strategy maximize_clicks`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(adGroupCreateOp(args), REFERENCE, (staged) => [
+      adGroupNextHint(staged.ref, args["product-filters"] !== void 0)
+    ]);
+  }
+});
+registerSchema({
+  command: "ads.chatgpt.ad-groups.update",
+  description: "Stage a change to an ad group \u2014 name, context hints, bid or status. --context-hints replaces the whole list: read the ad group first and pass every hint to keep.",
+  args: schemaArgs(UPDATE_ARGS)
+});
+var adGroupsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to an ad group. --context-hints replaces the whole list.
+
+Examples:
+  baker ads chatgpt ad-groups update adgrp_123 --max-bid 3
+  baker ads chatgpt ad-groups update adgrp_123 --context-hints "solar panels,home battery,cut my electricity bill"`
+  },
+  args: UPDATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(
+      { kind: "adGroup.update", target: requireTarget(args, "id"), payload: compact(sharedPayload(args)) },
+      REFERENCE
+    );
+  }
+});
+var adGroupsPauseCommand = statusCommand("adGroup", "pause", REFERENCE);
+var adGroupsResumeCommand = statusCommand("adGroup", "resume", REFERENCE);
+var adGroupsArchiveCommand = statusCommand("adGroup", "archive", REFERENCE);
+function adGroupNextHint(ref, productFilters) {
+  const productAd = `baker ads chatgpt ads create-product --ad-group-id ${ref} --name "\u2026"`;
+  return productFilters ? `Next, give it its product ad: ${productAd}` : `Next, give it a card: baker ads chatgpt ads create --ad-group-id ${ref} --name "\u2026" --title "\u2026" --body "\u2026" --target-url https://\u2026 --image-url https://\u2026 \u2014 under a catalog campaign, its product ad instead: ${productAd}`;
+}
+export {
+  adGroupCreateOp,
+  adGroupNextHint,
+  adGroupsArchiveCommand,
+  adGroupsCreateCommand,
+  adGroupsPauseCommand,
+  adGroupsResumeCommand,
+  adGroupsUpdateCommand,
+  audienceBidsArg,
+  contextHintsArg
+};
+//# sourceMappingURL=ad-group-writes-Y6CCMPCM.js.map

package/dist/ad-groups-TW2UKDVU.js

@@ -0,0 +1,70 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-FAV6GUOZ.js";
+import "./chunk-QYH2UZAK.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/ad-groups.ts
+import { defineCommand } from "citty";
+var args = {
+  "campaign-id": { type: "string", description: "Only this campaign's ad groups (cmpn_\u2026)", required: false },
+  full: { type: "boolean", description: "Return ChatGPT Ads' own ad group objects", required: false }
+};
+registerSchema({
+  command: "ads.chatgpt.ad-groups",
+  description: "Ad groups in the connected ChatGPT Ads account, or in one campaign: bid strategy, billing event, max bid (currency units), context hints (when the ad should show \u2014 ChatGPT's counterpart to keywords) and serving issues.",
+  args
+});
+var adGroupsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "ChatGPT Ads ad groups. Example: baker ads chatgpt ad-groups --campaign-id cmpn_123"
+  },
+  args,
+  run: async ({ args: input }) => {
+    const params = {};
+    if (input["campaign-id"]) {
+      params["campaign-id"] = input["campaign-id"];
+    }
+    if (input.full) {
+      params.full = "true";
+    }
+    await runChatgptListRead(CHATGPT_ADS_REFERENCE.adGroups, "/api/ads/chatgpt/ad-groups", params);
+  }
+});
+var adGroupsCommand = defineCommand({
+  meta: {
+    name: "ad-groups",
+    description: `ChatGPT Ads ad groups: how each one bids and the context hints that decide where it shows \u2014 or stage a change that applies when the chat is published.
+
+Examples:
+  baker ads chatgpt ad-groups --campaign-id cmpn_123
+  baker ads chatgpt ad-groups create --campaign-id cmpn_123 --name "Rooftop owners" --context-hints "solar panels for my house" --max-bid 2.50
+  baker ads chatgpt ad-groups update adgrp_123 --max-bid 3
+  baker ads chatgpt ad-groups pause adgrp_123`
+  },
+  subCommands: {
+    list: adGroupsListCommand,
+    create: () => import("./ad-group-writes-Y6CCMPCM.js").then((m) => m.adGroupsCreateCommand),
+    update: () => import("./ad-group-writes-Y6CCMPCM.js").then((m) => m.adGroupsUpdateCommand),
+    pause: () => import("./ad-group-writes-Y6CCMPCM.js").then((m) => m.adGroupsPauseCommand),
+    resume: () => import("./ad-group-writes-Y6CCMPCM.js").then((m) => m.adGroupsResumeCommand),
+    archive: () => import("./ad-group-writes-Y6CCMPCM.js").then((m) => m.adGroupsArchiveCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args,
+  default: "list"
+});
+export {
+  adGroupsCommand
+};
+//# sourceMappingURL=ad-groups-TW2UKDVU.js.map

package/dist/ad-writes-J3UVUH7D.js

@@ -0,0 +1,176 @@
+import {
+  clearableArg,
+  compact,
+  cropArg,
+  lowerArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-7SNNQCDD.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-FAV6GUOZ.js";
+import "./chunk-QYH2UZAK.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/ad-writes.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.ads;
+var SHARED_ARGS = {
+  name: { type: "string", description: "Internal ad name (3+ characters)" },
+  title: { type: "string", description: "Card title, 3\u201350 characters" },
+  body: { type: "string", description: "Card text, up to 100 characters" },
+  "target-url": { type: "string", description: "Landing page, https://" },
+  "image-url": {
+    type: "string",
+    description: "Card image, https:// \u2014 PNG, JPEG, WebP or AVIF; square and 640 \xD7 640 px or larger reads best"
+  },
+  "image-crop": {
+    type: "string",
+    description: "The square of the image the card shows, as x,y,width,height shares from 0 to 1, e.g. 0.1,0,0.8,0.8 (default: chosen by ChatGPT Ads)"
+  },
+  "tracking-template": {
+    type: "string",
+    description: "Query string added to this card's landing page, e.g. ad_id={ad_id} \u2014 none clears"
+  },
+  status: { type: "string", description: "paused (default) | active" }
+};
+var CREATE_ARGS = {
+  ...SHARED_ARGS,
+  "ad-group-id": { type: "string", description: "adgrp_\u2026 or a staged chatgpt_temp_ ref", required: true },
+  name: { type: "string", description: "Internal ad name (3+ characters)", required: true },
+  title: { type: "string", description: "Card title, 3\u201350 characters", required: true },
+  body: { type: "string", description: "Card text, up to 100 characters", required: true },
+  "target-url": { type: "string", description: "Landing page, https://", required: true },
+  "image-url": { type: "string", description: "Card image, https://, at least 640 \xD7 640 px", required: true }
+};
+var UPDATE_ARGS = {
+  id: { type: "positional", description: "Ad id (ad_\u2026) or a staged chatgpt_temp_ ref", required: true },
+  ...SHARED_ARGS
+};
+function sharedPayload(args) {
+  return {
+    name: args.name,
+    title: args.title,
+    body: args.body,
+    targetUrl: args["target-url"],
+    imageUrl: args["image-url"],
+    imageCrop: cropArg(args["image-crop"], "--image-crop"),
+    trackingTemplate: clearableArg(args["tracking-template"]),
+    status: lowerArg(args.status)
+  };
+}
+function adCreateOp(args) {
+  return { kind: "ad.create", payload: compact({ ...sharedPayload(args), adGroupId: args["ad-group-id"] }) };
+}
+registerSchema({
+  command: "ads.chatgpt.ads.create",
+  description: "Stage a new chat card under a live ad group (adgrp_\u2026) or one staged in this chat. Every new card goes through ChatGPT Ads' review after publish before it serves.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var adsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new chat card (applies when the chat is published).
+
+Example:
+  baker ads chatgpt ads create --ad-group-id adgrp_123 --name "Card A" --title "Solar from 0 upfront" \\
+    --body "Get a quote in two minutes." --target-url https://example.com/solar --image-url https://example.com/card.png`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(adCreateOp(args), REFERENCE, () => [
+      "Review everything staged with `baker ads chatgpt draft`. It applies when the chat is published."
+    ]);
+  }
+});
+registerSchema({
+  command: "ads.chatgpt.ads.update",
+  description: "Stage a change to a chat card \u2014 any of title, body, landing page, image, name or status; the rest is kept from the live card. Changing the card sends it back to review.",
+  args: schemaArgs(UPDATE_ARGS)
+});
+var adsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to a chat card; what you do not pass is kept.
+
+Examples:
+  baker ads chatgpt ads update ad_123 --title "Solar with no upfront cost"
+  baker ads chatgpt ads update ad_123 --target-url https://example.com/solar-v2`
+  },
+  args: UPDATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(
+      { kind: "ad.update", target: requireTarget(args, "id"), payload: compact(sharedPayload(args)) },
+      REFERENCE
+    );
+  }
+});
+var adsPauseCommand = statusCommand("ad", "pause", REFERENCE);
+var adsResumeCommand = statusCommand("ad", "resume", REFERENCE);
+var adsArchiveCommand = statusCommand("ad", "archive", REFERENCE);
+var PRODUCT_ARGS = {
+  "ad-group-id": {
+    type: "string",
+    description: "adgrp_\u2026 under a catalog campaign, or a staged chatgpt_temp_ ref",
+    required: true
+  },
+  name: { type: "string", description: "Internal ad name (3+ characters)", required: true },
+  title: {
+    type: "string",
+    description: "Title template (default {{product.title}}) \u2014 text with {{brand}}, {{product.title}}, {{product.body}}, {{product.price}}"
+  },
+  "tracking-template": { type: "string", description: "Query string added to each product's landing page" },
+  status: { type: "string", description: "paused (default) | active" }
+};
+function productAdCreateOp(args) {
+  return {
+    kind: "ad.create",
+    payload: compact({
+      format: "product_template",
+      adGroupId: args["ad-group-id"],
+      name: args.name,
+      title: args.title,
+      trackingTemplate: args["tracking-template"],
+      status: lowerArg(args.status)
+    })
+  };
+}
+registerSchema({
+  command: "ads.chatgpt.ads.create-product",
+  description: "Stage the product ad of a catalog ad group: one template each product fills with its own title, text, price, image and link. One per ad group.",
+  args: schemaArgs(PRODUCT_ARGS)
+});
+var adsCreateProductCommand = defineCommand({
+  meta: {
+    name: "create-product",
+    description: `Stage a product ad for a catalog ad group (applies when the chat is published).
+
+Example:
+  baker ads chatgpt ads create-product --ad-group-id adgrp_123 --name "Catalog ad" --title "{{brand}}: {{product.title}}"`
+  },
+  args: PRODUCT_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(productAdCreateOp(args), REFERENCE);
+  }
+});
+export {
+  adCreateOp,
+  adsArchiveCommand,
+  adsCreateCommand,
+  adsCreateProductCommand,
+  adsPauseCommand,
+  adsResumeCommand,
+  adsUpdateCommand,
+  productAdCreateOp
+};
+//# sourceMappingURL=ad-writes-J3UVUH7D.js.map

package/dist/add-CKJXQUVI.js

@@ -0,0 +1,97 @@
+import {
+  reportError
+} from "./chunk-CZESYOCC.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/add.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "landing.inspiration.add",
+  description: "Add someone else's landing page to the reference library and save it to this company. Returns immediately \u2014 studying a page takes a few minutes, so never wait on it. Use it when the client names a site they admire, or when you find a competitor page worth learning from. Never point it at a page we built: it is refused, because the source is already in the project and reading a screenshot of it tells you less than opening the file.",
+  args: {
+    url: { type: "string", description: "Landing page address", required: true },
+    note: { type: "string", description: "Why this page is worth keeping", required: false },
+    refresh: {
+      type: "boolean",
+      description: "Study the page again even if it is already in the library. Use when the user says the page has changed or the saved sections look outdated",
+      required: false
+    }
+  }
+});
+function addHints(data, { refresh }) {
+  if (data.refreshDeclined === "studying") {
+    return [
+      "This page is already being studied \u2014 no second study was started. Search for it later in the turn or in a later one."
+    ];
+  }
+  if (data.refreshDeclined === "too_soon") {
+    return [
+      "This page was just studied a few minutes ago, so it was not studied again \u2014 its sections are already current.",
+      `Search it with: baker landing inspiration search --domain ${new URL(data.canonicalUrl).hostname}`
+    ];
+  }
+  if (data.alreadyKnown) {
+    return [
+      "This page was already in the library, so nothing was re-studied \u2014 its sections are searchable now.",
+      `Search it with: baker landing inspiration search --domain ${new URL(data.canonicalUrl).hostname}`,
+      "If the user says the live page looks different from what the library shows, run this again with --refresh."
+    ];
+  }
+  return [
+    refresh ? "Studying it again from the live site \u2014 this takes a few minutes. Until it lands, search results still show the old version, so don't build from them yet." : "Studying this page takes a few minutes. Don't wait on it \u2014 carry on, and search for it later in the turn or in a later one.",
+    "Meanwhile, search what is already in the library: baker landing inspiration search '<what you want to see>' --scope all",
+    "This is saved and being studied now, so it is listed as already applied \u2014 tell the user it is kept whatever they do with this chat.",
+    // The save is not a promise that the study succeeded. An agent that
+    // assumes it did will later search its own favorites, find nothing,
+    // and have no idea why.
+    "The save sticks even if the page turns out to be unreadable \u2014 `baker landing inspiration favorites` reports those separately as unreadable, so check there rather than assuming this page is searchable."
+  ];
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: "Add someone else's landing page to the reference library. Example: baker landing inspiration add https://linear.app --note 'the client likes this density'. Add --refresh to study a saved page again after the site changed"
+  },
+  args: {
+    url: { type: "positional", description: "Landing page address", required: true },
+    note: { type: "string", description: "Why this page is worth keeping", required: false },
+    refresh: {
+      type: "boolean",
+      description: "Study it again even if it is already in the library",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiPost("/api/landing-inspiration/add", {
+        url: args.url,
+        note: args.note,
+        favorite: true,
+        refresh: args.refresh || void 0
+      });
+      const hints = addHints(data, { refresh: args.refresh });
+      writeJson({
+        ok: true,
+        data: { id: data.sourceId, url: data.canonicalUrl, status: data.status, already_known: data.alreadyKnown },
+        hints
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+export {
+  addCommand,
+  addHints
+};
+//# sourceMappingURL=add-CKJXQUVI.js.map

package/dist/add-CSRB6GVJ.js

@@ -0,0 +1,80 @@
+import {
+  nextStepHints,
+  reportError,
+  validationError
+} from "./chunk-D7FJ5KHG.js";
+import {
+  postsAddRequestSchema
+} from "./chunk-WCU362Z6.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/posts/add.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "posts.add",
+  description: "Add one post by its link \u2014 the way in for a private profile's posts (many people's LinkedIn profiles are), or for a post by someone the company doesn't follow. Any link to the post works; the embed link isn't needed. Reads the post's text, author and numbers, works out whether it can run as an ad, and imports its images and videos into the libraries (not a YouTube video: the hint says how). Applies immediately and shows on the chat as an already-applied change. Costs one read.",
+  args: {
+    url: { type: "string", description: "The post's link", required: true },
+    media: {
+      type: "boolean",
+      description: "Import its images and videos into the libraries (default); --no-media records the post only",
+      required: false
+    }
+  }
+});
+function youtubeVideoId(url) {
+  return url.match(/(?:[?&]v=|\/shorts\/|youtu\.be\/)([\w-]{11})/)?.[1];
+}
+function addHints(data, link) {
+  const hints = nextStepHints(data.post);
+  if (data.media && data.media.failed > 0) {
+    hints.push(
+      `${data.media.failed} of its files couldn't be fetched, so they aren't in the libraries; the post itself is saved.`
+    );
+  }
+  const videoId = data.post.platform === "youtube" ? youtubeVideoId(link) : void 0;
+  if (videoId) {
+    hints.push(
+      `To put the video itself in the video library: \`baker videos ingest ${link} --source youtube --external-id youtube:${videoId}\`.`
+    );
+  }
+  return hints;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: "Add a post by its link, with its images and videos.\n\nExamples:\n  baker posts add https://www.linkedin.com/posts/jane-doe_we-closed-activity-7477679889043750912-K2pu\n  baker posts add https://www.instagram.com/p/Dek_RAKjMDJ/ --no-media"
+  },
+  args: {
+    url: { type: "positional", description: "The post's link", required: true },
+    media: {
+      type: "boolean",
+      description: "Import its images and videos into the libraries (default); --no-media records the post only",
+      default: true
+    }
+  },
+  run: async ({ args }) => {
+    const parsed = postsAddRequestSchema.safeParse({ url: String(args.url ?? ""), media: args.media !== false });
+    if (!parsed.success) validationError(parsed.error.issues[0]?.message ?? "Pass the post's link");
+    try {
+      const data = await apiPost("/api/posts/add", parsed.data, { timeoutMs: 12e4 });
+      writeJson({ ok: true, data, hints: addHints(data, parsed.data.url) });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addCommand,
+  addHints
+};
+//# sourceMappingURL=add-CSRB6GVJ.js.map