@koda-sl/baker-cli 0.535.0 → 0.537.0

package/dist/experiments-2XOC77Y7.js

@@ -0,0 +1,236 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  parseDateFlag,
+  requireTarget,
+  stageOp
+} from "./chunk-G6KE737R.js";
+import {
+  handleLinkedinError
+} from "./chunk-NNG4QCKJ.js";
+import "./chunk-MM6CCIL7.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-NRMJWNX3.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-EAHBTBVR.js";
+import "./chunk-W3PJ7V4W.js";
+import "./chunk-CM2LECNX.js";
+import "./chunk-ZPF253G5.js";
+import "./chunk-AXSSATJW.js";
+import "./chunk-DNRXEP4A.js";
+import "./chunk-OYYAR5TD.js";
+import "./chunk-3LH5ANM4.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-TI4UL56R.js";
+import {
+  apiGet
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/experiments.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads linkedin draft`.";
+var accountArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+  "account-urn": { type: "string", description: "Alias for --account-id" }
+};
+var STOP_AT = {
+  "end-date": "AUTO_STOP_AT_END_DATE",
+  winner: "AUTO_STOP_AT_WINNER",
+  never: "AUTO_STOP_DISABLED"
+};
+function stopAtArg(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const mapped = STOP_AT[String(value)];
+  if (!mapped) {
+    failWriteValidation(`--stop-at must be one of ${Object.keys(STOP_AT).join("|")}`);
+  }
+  return mapped;
+}
+function numberArg(value, flag) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed)) {
+    failWriteValidation(`${flag} must be a whole number`);
+  }
+  return parsed;
+}
+var experimentsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List the ad account's A/B tests, newest first: name, state (what was asked), running (what LinkedIn is doing: PENDING|RUNNING|ON_HOLD|STOPPED|ENDED), metric, dates and the two versions (ad sets + traffic split). Runs by default."
+  },
+  args: { ...accountArgs },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/experiments", {
+        "account-id": bareAccountId(args)
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var experimentsGetCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: "One A/B test with LinkedIn's setup checks (an ERROR keeps it from running \u2014 e.g. NO_ACTIVE_CREATIVES; a WARNING may skew it) and its latest result: the winning version, p-value, and each version's confidence interval for the metric. `result: null` until LinkedIn computes the first one (daily)."
+  },
+  args: {
+    id: { type: "positional", description: "A/B test id from `experiments`", required: true },
+    ...accountArgs
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/experiments", {
+        "account-id": bareAccountId(args),
+        id: requireTarget(args, "A/B test")
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var experimentsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage an A/B test between two ad sets of the SAME campaign: LinkedIn splits the audience so each member sees only one version, and calls a winner on the metric. ${STAGED_NOTE}
+Rules LinkedIn enforces: exactly 2 ad sets, same campaign, that campaign must NOT share its budget across ad sets, at most 90 days, confidence 51\u201399 (90+ recommended), each ad set needs an active ad. Best practice: two new ad sets identical but for the one thing tested, equal budgets, 3+ weeks.
+Examples:
+  baker ads linkedin experiments create --name "Image vs video" --version-a li_temp_x1 --version-b li_temp_x2 --metric CPC --start 2026-11-01 --end 2026-11-28
+  baker ads linkedin experiments create --name "Headline test" --version-a 896802423 --name-a "Pain" --version-b 896812053 --name-b "Gain" --metric CPM --start 2026-11-01 --end 2026-12-01 --stop-at winner --confidence 95`
+  },
+  args: {
+    ...accountArgs,
+    name: { type: "string", description: "Test name (\u2264100)", required: true },
+    description: { type: "string", description: "What is being tested" },
+    "version-a": { type: "string", description: "Ad set id/URN or li_temp_* ref for version A", required: true },
+    "version-b": { type: "string", description: "Ad set id/URN or li_temp_* ref for version B", required: true },
+    "name-a": { type: "string", description: "Version A label (default A)" },
+    "name-b": { type: "string", description: "Version B label (default B)" },
+    "weight-a": { type: "string", description: "Version A share of the audience, 1\u201399 (default 50; B gets the rest)" },
+    metric: { type: "string", description: "CPC|CPM|CPV (video ad sets)|CPMS (message ads)", required: true },
+    confidence: { type: "string", description: "51\u201399 (default 90)" },
+    start: { type: "string", description: "Start date (ISO or epoch ms)", required: true },
+    end: { type: "string", description: "End date (\u226490 days after start)", required: true },
+    "stop-at": {
+      type: "string",
+      description: "end-date (default, pauses both) | winner | never (ad sets keep running)"
+    },
+    draft: { type: "boolean", description: "Create it set up but not running" }
+  },
+  run: async ({ args }) => {
+    const weightA = numberArg(args["weight-a"], "--weight-a") ?? 50;
+    await stageOp({
+      kind: "experiment.create",
+      accountId: bareAccountId(args),
+      payload: {
+        name: args.name,
+        description: args.description,
+        keyMetric: args.metric ? String(args.metric).toUpperCase() : void 0,
+        confidence: numberArg(args.confidence, "--confidence"),
+        start: parseDateFlag(args.start, "--start"),
+        end: parseDateFlag(args.end, "--end"),
+        autoStop: stopAtArg(args["stop-at"]),
+        state: args.draft ? "DRAFT" : void 0,
+        cells: [
+          { name: args["name-a"] ?? "A", campaign: args["version-a"], trafficWeight: weightA },
+          { name: args["name-b"] ?? "B", campaign: args["version-b"], trafficWeight: 100 - weightA }
+        ]
+      }
+    });
+  }
+});
+var experimentsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage changes to an A/B test. Once it has started only the name, description, end date (still \u226490 days from start), confidence and when it stops can change \u2014 the versions are fixed. ${STAGED_NOTE}
+Example: baker ads linkedin experiments update 5633011 --end 2026-12-15 --stop-at winner`
+  },
+  args: {
+    id: { type: "positional", description: "A/B test id", required: true },
+    ...accountArgs,
+    name: { type: "string", description: "New name" },
+    description: { type: "string", description: "New description" },
+    end: { type: "string", description: "New end date" },
+    confidence: { type: "string", description: "51\u201399" },
+    "stop-at": { type: "string", description: "end-date|winner|never" }
+  },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "experiment.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "A/B test"),
+      payload: {
+        name: args.name,
+        description: args.description,
+        end: parseDateFlag(args.end, "--end"),
+        confidence: numberArg(args.confidence, "--confidence"),
+        autoStop: stopAtArg(args["stop-at"])
+      }
+    });
+  }
+});
+function experimentStateCommand(name, state, what) {
+  return defineCommand({
+    meta: {
+      name,
+      description: `Stage ${what}. ${STAGED_NOTE}
+Example: baker ads linkedin experiments ${name} 5633011`
+    },
+    args: {
+      id: { type: "positional", description: "A/B test id", required: true },
+      ...accountArgs
+    },
+    run: async ({ args }) => {
+      await stageOp({
+        kind: "experiment.update",
+        accountId: bareAccountId(args),
+        target: requireTarget(args, "A/B test"),
+        payload: { state }
+      });
+    }
+  });
+}
+var experimentsCommand = defineCommand({
+  meta: {
+    name: "experiments",
+    description: `LinkedIn A/B tests: two ad sets of one campaign shown to separate halves of the audience, with a winner called on CPC/CPM/CPV/CPMS.
+Examples:
+  baker ads linkedin experiments                       # list
+  baker ads linkedin experiments get 5633011           # setup checks + result
+  baker ads linkedin experiments create --name "Image vs video" --version-a <ad set> --version-b <ad set> --metric CPC --start 2026-11-01 --end 2026-11-28
+  baker ads linkedin experiments pause|start|end 5633011`
+  },
+  subCommands: {
+    list: experimentsListCommand,
+    get: experimentsGetCommand,
+    create: experimentsCreateCommand,
+    update: experimentsUpdateCommand,
+    start: experimentStateCommand("start", "ACTIVE", "starting (or resuming) an A/B test"),
+    pause: experimentStateCommand("pause", "PAUSED", "pausing an A/B test \u2014 both ad sets pause, the end date stays"),
+    end: experimentStateCommand("end", "CANCELED", "ending an A/B test for good")
+  },
+  args: { ...accountArgs },
+  default: "list"
+});
+export {
+  experimentsCommand
+};
+//# sourceMappingURL=experiments-2XOC77Y7.js.map

package/dist/export-LRPJXAFA.js

@@ -0,0 +1,168 @@
+import {
+  reportError
+} from "./chunk-JQSN5K5B.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/export.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+function exportStartHints(args) {
+  const hints = [
+    "This downloads the PUBLISHED site \u2014 landings changed in this chat and not yet published are not included. Publish first if the user wants them in it.",
+    "It takes a few minutes. Don't wait on it: carry on, then run `baker landing export status <id>` for the link. The user also sees it in this chat's changes, with a download button once it is ready."
+  ];
+  if (args.stagedProfilePending && !args.profileOverridden) {
+    hints.push(
+      "This chat has a download-format change waiting on Publish; this export uses the saved format. The staged format applies after publish \u2014 pass `--profile` to try it now."
+    );
+  }
+  return hints;
+}
+function exportStatusHints(view) {
+  if (view.status === "ready") {
+    return view.downloadUrl ? ["Give the user this link to download the ZIP \u2014 it is also on this chat's changes."] : ["This export is ready but its file is gone. Start a new one with `baker landing export start`."];
+  }
+  if (view.status === "error") {
+    return [
+      "This export failed. Tell the user it could not be prepared and start a new one with `baker landing export start`; if it fails again, they can export from Landings."
+    ];
+  }
+  return ["Still being prepared. Carry on with other work and check again in a minute \u2014 never sleep-loop on it."];
+}
+function parseProfileFlag(raw, readFile = (path) => readFileSync(path, "utf8")) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw.startsWith("@") ? readFile(raw.slice(1)) : raw);
+  } catch (error) {
+    return {
+      ok: false,
+      message: `--profile must be a JSON object or @<file> holding one: ${error instanceof Error ? error.message : String(error)}`
+    };
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    return { ok: false, message: `--profile must be a JSON object, e.g. '{"htmlOutput":"fragment"}'.` };
+  }
+  return { ok: true, profile: parsed };
+}
+function failValidation(message) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+registerSchema({
+  command: "landing.export.start",
+  description: "Start a download (ZIP of plain HTML) of the company's PUBLISHED landings \u2014 the same pack Landings \u2192 Export makes. Returns at once with an id; the pack takes a few minutes. Unpublished changes in this chat are not in it. No password option: a protected pack is made from the dashboard.",
+  args: {
+    profile: {
+      type: "string",
+      description: `Download-format fields for this export only, on top of the saved format: a JSON object or @<file>. Example: '{"htmlOutput":"fragment","inlineCss":true}'`,
+      required: false
+    }
+  }
+});
+registerSchema({
+  command: "landing.export.status",
+  description: "Where one download got to, and its link once it is ready.",
+  args: { id: { type: "string", description: "Export id from `start` or `list`", required: true } }
+});
+registerSchema({
+  command: "landing.export.list",
+  description: "The company's last 10 downloads, newest first, with their status. `status <id>` gives the link.",
+  args: {}
+});
+var startCommand = defineCommand({
+  meta: {
+    name: "start",
+    description: "Start a download of the published landings. Examples: baker landing export start | baker landing export start --profile @export-profile.json"
+  },
+  args: {
+    profile: {
+      type: "string",
+      description: "Download-format fields for this export only (JSON object or @file)",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    const rawProfile = typeof args.profile === "string" ? args.profile : void 0;
+    const body = {};
+    if (rawProfile !== void 0) {
+      const parsed = parseProfileFlag(rawProfile);
+      if (!parsed.ok) failValidation(parsed.message);
+      body.profile = parsed.profile;
+    }
+    try {
+      const response = await apiPost("/api/landings/export/start", body);
+      writeJson({
+        ok: true,
+        data: { exportId: response.data.exportId },
+        hints: exportStartHints({
+          stagedProfilePending: response.data.stagedProfilePending,
+          profileOverridden: rawProfile !== void 0
+        })
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+var statusCommand = defineCommand({
+  meta: {
+    name: "status",
+    description: "Where a download got to, and its link once ready. Example: baker landing export status <id>"
+  },
+  args: { id: { type: "positional", description: "Export id", required: true } },
+  run: async ({ args }) => {
+    try {
+      const response = await apiGet("/api/landings/export/status", {
+        id: String(args.id)
+      });
+      writeJson({ ok: true, data: response.data, hints: exportStatusHints(response.data) });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+var listCommand = defineCommand({
+  meta: { name: "list", description: "The company's last 10 downloads. Example: baker landing export list" },
+  args: {},
+  run: async () => {
+    try {
+      const response = await apiGet("/api/landings/export/list");
+      writeJson({ ok: true, data: response.data });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+var exportCommand = defineCommand({
+  meta: {
+    name: "export",
+    description: `Download the company's published landings as a ZIP of plain HTML.
+
+Start here: \`baker landing export start\`, then \`baker landing export status <id>\` for the link.
+
+Subcommands:
+  baker landing export start [--profile <json|@file>] \u2014 start a download (returns at once)
+  baker landing export status <id>                    \u2014 progress, and the link once ready
+  baker landing export list                           \u2014 the last 10 downloads
+
+Full guide: __tooling__/docs/tools/baker/landing.md`
+  },
+  subCommands: { start: startCommand, status: statusCommand, list: listCommand }
+});
+export {
+  exportCommand,
+  exportStartHints,
+  exportStatusHints,
+  parseProfileFlag
+};
+//# sourceMappingURL=export-LRPJXAFA.js.map

package/dist/extract-7IAAZ6RS.js

@@ -0,0 +1,121 @@
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-35FLLWSQ.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/extract.ts
+import { defineCommand } from "citty";
+
+// src/commands/images/extractErrors.ts
+var RETRYABLE = /* @__PURE__ */ new Set(["UNAVAILABLE", "RATE_LIMITED", "TIMEOUT", "NETWORK_ERROR"]);
+function extractErrorEnvelope(err, url) {
+  const retryable = RETRYABLE.has(err.code);
+  const fallback = `use \`baker images screenshot ${url}\` to capture the page as one image, or \`baker images logo <domain>\` for the brand's mark, and carry on with the rest of the job.`;
+  return {
+    ok: false,
+    error: {
+      code: err.code,
+      message: err.message,
+      retryable,
+      fix: retryable ? { action: "retry_once", explanation: `Run the same command once more. If it fails again, ${fallback}` } : { action: "use_fallback", explanation: `Retrying the same address will fail the same way \u2014 ${fallback}` }
+    }
+  };
+}
+
+// src/commands/images/extract.ts
+registerSchema({
+  command: "images.extract",
+  description: "Extract images from a URL via Firecrawl (formats: images).",
+  args: {
+    url: { type: "string", description: "URL to scrape", required: true },
+    "wait-for": { type: "number", description: "JS render wait ms", required: false },
+    limit: { type: "number", description: "Limit returned images", required: false, default: 50 },
+    "auto-ingest": {
+      type: "number",
+      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.extract}, default 0)`,
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to every auto-ingested hit (overrides provider-derived context)",
+      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 }
+  }
+});
+var extractCommand = defineCommand({
+  meta: {
+    name: "extract",
+    description: "Pull every image from a single URL via Firecrawl. ~$0.001/scrape. Cap auto-ingest at 20.\n\nExample: baker images extract https://stripe.com --auto-ingest 5"
+  },
+  args: {
+    url: { type: "positional", description: "URL to scrape", required: false },
+    "wait-for": { type: "string", description: "JS render wait ms", required: false },
+    limit: { type: "string", description: "Max returned images", required: false },
+    "auto-ingest": { type: "string", description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.extract})`, required: false },
+    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const url = args.url;
+      if (!url) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "URL is required" } });
+        process.exit(1);
+      }
+      const body = { url };
+      if (args["wait-for"]) body.waitFor = Number(args["wait-for"]);
+      if (args.limit) body.limit = Number(args.limit);
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.extract);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.extract}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/extract", body);
+      writeProviderHits(data, data.hits, args, []);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson(extractErrorEnvelope(err, String(args.url)));
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  extractCommand
+};
+//# sourceMappingURL=extract-7IAAZ6RS.js.map

package/dist/extract-7IAAZ6RS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/extract.ts","../src/commands/images/extractErrors.ts"],"sourcesContent":["import type { ImagesExtractRequest, ImagesExtractResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { AUTO_INGEST_MAX, parseAutoIngest } from \"./autoIngest.ts\";\nimport { extractErrorEnvelope } from \"./extractErrors.ts\";\nimport { OUTPUT_ARGS, writeProviderHits } from \"./providerHits.ts\";\n\nregisterSchema({\n  command: \"images.extract\",\n  description: \"Extract images from a URL via Firecrawl (formats: images).\",\n  args: {\n    url: { type: \"string\", description: \"URL to scrape\", required: true },\n    \"wait-for\": { type: \"number\", description: \"JS render wait ms\", required: false },\n    limit: { type: \"number\", description: \"Limit returned images\", required: false, default: 50 },\n    \"auto-ingest\": {\n      type: \"number\",\n      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.extract}, default 0)`,\n      required: false,\n      default: 0,\n    },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint applied to every auto-ingested hit (overrides provider-derived context)\",\n      required: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n  },\n});\n\nexport const extractCommand = defineCommand({\n  meta: {\n    name: \"extract\",\n    description:\n      \"Pull every image from a single URL via Firecrawl. ~$0.001/scrape. Cap auto-ingest at 20.\\n\\nExample: baker images extract https://stripe.com --auto-ingest 5\",\n  },\n  args: {\n    url: { type: \"positional\", description: \"URL to scrape\", required: false },\n    \"wait-for\": { type: \"string\", description: \"JS render wait ms\", required: false },\n    limit: { type: \"string\", description: \"Max returned images\", required: false },\n    \"auto-ingest\": { type: \"string\", description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.extract})`, required: false },\n    context: { type: \"string\", description: \"Description context hint applied to auto-ingested hits\", required: false },\n    ...OUTPUT_ARGS,\n  },\n  run: async ({ args }) => {\n    try {\n      const url = args.url as string | undefined;\n      if (!url) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"URL is required\" } });\n        process.exit(1);\n      }\n      const body: ImagesExtractRequest = { url };\n      if (args[\"wait-for\"]) body.waitFor = Number(args[\"wait-for\"]);\n      if (args.limit) body.limit = Number(args.limit);\n      if (args[\"auto-ingest\"] !== undefined) {\n        const parsed = parseAutoIngest(args[\"auto-ingest\"], AUTO_INGEST_MAX.extract);\n        if (!parsed.ok) {\n          writeJson({\n            ok: false,\n            error: {\n              code: \"VALIDATION_ERROR\",\n              message: parsed.message,\n              fix: {\n                action: \"retry_with_changes\",\n                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.extract}.`,\n              },\n            },\n          });\n          process.exit(1);\n        }\n        body.autoIngest = parsed.value;\n      }\n      if (args.context) body.descriptionContext = args.context as string;\n\n      const data = await apiPost<ImagesExtractResponse>(\"/api/images/extract\", body);\n      writeProviderHits(data, data.hits, args as Record<string, unknown>, []);\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson(extractErrorEnvelope(err, String(args.url)));\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n","import type { ApiError } from \"../../client.ts\";\n\n/** Failures a second attempt can change: the reader or the connection had a bad moment. */\nconst RETRYABLE = new Set([\"UNAVAILABLE\", \"RATE_LIMITED\", \"TIMEOUT\", \"NETWORK_ERROR\"]);\n\ninterface ExtractErrorEnvelope {\n  ok: false;\n  error: {\n    code: string;\n    message: string;\n    retryable: boolean;\n    fix?: { action: string; explanation: string };\n  };\n}\n\n/**\n * The envelope for a failed `baker images extract`. Without `retryable` an\n * agent cannot tell a reader that hiccupped from a page nobody can read, and it\n * abandons the page for an image search. Either way the job carries on: the\n * page can still be captured whole, and the brand's mark fetched on its own.\n */\nexport function extractErrorEnvelope(err: ApiError, url: string): ExtractErrorEnvelope {\n  const retryable = RETRYABLE.has(err.code);\n  const fallback = `use \\`baker images screenshot ${url}\\` to capture the page as one image, or \\`baker images logo <domain>\\` for the brand's mark, and carry on with the rest of the job.`;\n  return {\n    ok: false,\n    error: {\n      code: err.code,\n      message: err.message,\n      retryable,\n      fix: retryable\n        ? { action: \"retry_once\", explanation: `Run the same command once more. If it fails again, ${fallback}` }\n        : { action: \"use_fallback\", explanation: `Retrying the same address will fail the same way — ${fallback}` },\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/facets-7Q36JF2D.js

@@ -0,0 +1,117 @@
+import {
+  csvOrJson,
+  handleLinkedinError
+} from "./chunk-NNG4QCKJ.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-EAHBTBVR.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-3PG7O3ZW.js";
+import "./chunk-3LH5ANM4.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-TI4UL56R.js";
+import {
+  apiGet
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/facets.ts
+import { defineCommand } from "citty";
+var listCmd = defineCommand({
+  meta: {
+    name: "list",
+    description: `List every targeting facet LinkedIn supports.
+
+Cached 7 days. Use this to discover what dimensions you can target on (industries,
+seniorities, titles, employers, growthRate, companyCategory, skills, etc.).`
+  },
+  args: {
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = {};
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/facets", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var valuesCmd = defineCommand({
+  meta: {
+    name: "values",
+    description: `Look up entity values for a single facet \u2014 full list or typeahead search.
+
+Examples:
+  baker ads linkedin facets values --facet seniorities                          \u2014 all seniority URNs
+  baker ads linkedin facets values --facet titles --query "marketing director"  \u2014 typeahead
+  baker ads linkedin facets values --facet industries --output csv
+
+The --facet flag accepts the bare name (industries, seniorities, titles, etc.)
+or the full URN (urn:li:adTargetingFacet:industries).`
+  },
+  args: {
+    facet: { type: "string", description: "Facet name (e.g. industries) or URN", required: true },
+    query: { type: "string", description: "Typeahead query (auto-switches finder to typeahead)" },
+    finder: { type: "string", description: "adTargetingFacet | typeahead | similarEntities (default: auto)" },
+    locale: { type: "string", description: "Locale (default: en_US)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = { facet: String(args.facet) };
+      const finder = args.finder ?? (args.query ? "typeahead" : "adTargetingFacet");
+      params.finder = finder;
+      if (args.query) params.query = String(args.query);
+      if (args.locale) params.locale = String(args.locale);
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/facets/entities", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var facetsCommand = defineCommand({
+  meta: {
+    name: "facets",
+    description: `LinkedIn targeting facets and entity lookup.
+
+Subcommands:
+  list                          \u2014 every facet (industries, seniorities, titles, employers, \u2026)
+  values --facet titles         \u2014 entity URNs for one facet
+  values --facet titles --query "marketing director"  \u2014 typeahead`
+  },
+  subCommands: {
+    list: listCmd,
+    values: valuesCmd
+  }
+});
+export {
+  facetsCommand
+};
+//# sourceMappingURL=facets-7Q36JF2D.js.map