@koda-sl/baker-cli 0.568.0 → 0.569.0-dev.1b455b3fe

package/dist/experiments-ERXZYY5E.js

@@ -0,0 +1,237 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  parseDateFlag,
+  requireTarget,
+  stageOp
+} from "./chunk-7YMQEAGA.js";
+import {
+  handleLinkedinError
+} from "./chunk-34MZGC2Y.js";
+import "./chunk-LZR7LSYO.js";
+import "./chunk-55AX6DOP.js";
+import "./chunk-MX5NQAK6.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-4H6XLX7E.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MK4HCMEA.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-YOHGEF2N.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-IMS53EQU.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.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-ERXZYY5E.js.map

package/dist/experiments-ERXZYY5E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/experiments.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleLinkedinError } from \"./shared.ts\";\nimport { bareAccountId, failWriteValidation, parseDateFlag, requireTarget, stageOp } from \"./write-shared.ts\";\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads linkedin draft`.\";\n\nconst accountArgs = {\n  \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n  \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n} as const;\n\nconst STOP_AT: Record<string, string> = {\n  \"end-date\": \"AUTO_STOP_AT_END_DATE\",\n  winner: \"AUTO_STOP_AT_WINNER\",\n  never: \"AUTO_STOP_DISABLED\",\n};\n\nfunction stopAtArg(value: unknown): string | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  const mapped = STOP_AT[String(value)];\n  if (!mapped) {\n    failWriteValidation(`--stop-at must be one of ${Object.keys(STOP_AT).join(\"|\")}`);\n  }\n  return mapped;\n}\n\nfunction numberArg(value: unknown, flag: string): number | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed)) {\n    failWriteValidation(`${flag} must be a whole number`);\n  }\n  return parsed;\n}\n\nconst experimentsListCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"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.\",\n  },\n  args: { ...accountArgs },\n  run: async ({ args }) => {\n    try {\n      const data = await apiGet<unknown[]>(\"/api/ads/linkedin/experiments\", {\n        \"account-id\": bareAccountId(args as Record<string, unknown>),\n      });\n      writeJsonEnvelope({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nconst experimentsGetCommand = defineCommand({\n  meta: {\n    name: \"get\",\n    description:\n      \"One A/B test with LinkedIn's setup checks (an ERROR keeps it from running — 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).\",\n  },\n  args: {\n    id: { type: \"positional\", description: \"A/B test id from `experiments`\", required: true },\n    ...accountArgs,\n  },\n  run: async ({ args }) => {\n    try {\n      const data = await apiGet<unknown>(\"/api/ads/linkedin/experiments\", {\n        \"account-id\": bareAccountId(args as Record<string, unknown>),\n        id: requireTarget(args as Record<string, unknown>, \"A/B test\"),\n      });\n      writeJsonEnvelope({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nconst experimentsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    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}\nRules LinkedIn enforces: exactly 2 ad sets, same campaign, that campaign must NOT share its budget across ad sets, at most 90 days, confidence 51–99 (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.\nExamples:\n  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\n  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`,\n  },\n  args: {\n    ...accountArgs,\n    name: { type: \"string\", description: \"Test name (≤100)\", required: true },\n    description: { type: \"string\", description: \"What is being tested\" },\n    \"version-a\": { type: \"string\", description: \"Ad set id/URN or li_temp_* ref for version A\", required: true },\n    \"version-b\": { type: \"string\", description: \"Ad set id/URN or li_temp_* ref for version B\", required: true },\n    \"name-a\": { type: \"string\", description: \"Version A label (default A)\" },\n    \"name-b\": { type: \"string\", description: \"Version B label (default B)\" },\n    \"weight-a\": { type: \"string\", description: \"Version A share of the audience, 1–99 (default 50; B gets the rest)\" },\n    metric: { type: \"string\", description: \"CPC|CPM|CPV (video ad sets)|CPMS (message ads)\", required: true },\n    confidence: { type: \"string\", description: \"51–99 (default 90)\" },\n    start: { type: \"string\", description: \"Start date (ISO or epoch ms)\", required: true },\n    end: { type: \"string\", description: \"End date (≤90 days after start)\", required: true },\n    \"stop-at\": {\n      type: \"string\",\n      description: \"end-date (default, pauses both) | winner | never (ad sets keep running)\",\n    },\n    draft: { type: \"boolean\", description: \"Create it set up but not running\" },\n  },\n  run: async ({ args }) => {\n    const weightA = numberArg(args[\"weight-a\"], \"--weight-a\") ?? 50;\n    await stageOp({\n      kind: \"experiment.create\",\n      accountId: bareAccountId(args as Record<string, unknown>),\n      payload: {\n        name: args.name,\n        description: args.description,\n        keyMetric: args.metric ? String(args.metric).toUpperCase() : undefined,\n        confidence: numberArg(args.confidence, \"--confidence\"),\n        start: parseDateFlag(args.start, \"--start\"),\n        end: parseDateFlag(args.end, \"--end\"),\n        autoStop: stopAtArg(args[\"stop-at\"]),\n        state: args.draft ? \"DRAFT\" : undefined,\n        cells: [\n          { name: args[\"name-a\"] ?? \"A\", campaign: args[\"version-a\"], trafficWeight: weightA },\n          { name: args[\"name-b\"] ?? \"B\", campaign: args[\"version-b\"], trafficWeight: 100 - weightA },\n        ],\n      },\n    });\n  },\n});\n\nconst experimentsUpdateCommand = defineCommand({\n  meta: {\n    name: \"update\",\n    description: `Stage changes to an A/B test. Once it has started only the name, description, end date (still ≤90 days from start), confidence and when it stops can change — the versions are fixed. ${STAGED_NOTE}\nExample: baker ads linkedin experiments update 5633011 --end 2026-12-15 --stop-at winner`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"A/B test id\", required: true },\n    ...accountArgs,\n    name: { type: \"string\", description: \"New name\" },\n    description: { type: \"string\", description: \"New description\" },\n    end: { type: \"string\", description: \"New end date\" },\n    confidence: { type: \"string\", description: \"51–99\" },\n    \"stop-at\": { type: \"string\", description: \"end-date|winner|never\" },\n  },\n  run: async ({ args }) => {\n    await stageOp({\n      kind: \"experiment.update\",\n      accountId: bareAccountId(args as Record<string, unknown>),\n      target: requireTarget(args as Record<string, unknown>, \"A/B test\"),\n      payload: {\n        name: args.name,\n        description: args.description,\n        end: parseDateFlag(args.end, \"--end\"),\n        confidence: numberArg(args.confidence, \"--confidence\"),\n        autoStop: stopAtArg(args[\"stop-at\"]),\n      },\n    });\n  },\n});\n\nfunction experimentStateCommand(\n  name: \"start\" | \"pause\" | \"end\",\n  state: \"ACTIVE\" | \"PAUSED\" | \"CANCELED\",\n  what: string,\n) {\n  return defineCommand({\n    meta: {\n      name,\n      description: `Stage ${what}. ${STAGED_NOTE}\nExample: baker ads linkedin experiments ${name} 5633011`,\n    },\n    args: {\n      id: { type: \"positional\", description: \"A/B test id\", required: true },\n      ...accountArgs,\n    },\n    run: async ({ args }) => {\n      await stageOp({\n        kind: \"experiment.update\",\n        accountId: bareAccountId(args as Record<string, unknown>),\n        target: requireTarget(args as Record<string, unknown>, \"A/B test\"),\n        payload: { state },\n      });\n    },\n  });\n}\n\nexport const experimentsCommand = defineCommand({\n  meta: {\n    name: \"experiments\",\n    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.\nExamples:\n  baker ads linkedin experiments                       # list\n  baker ads linkedin experiments get 5633011           # setup checks + result\n  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\n  baker ads linkedin experiments pause|start|end 5633011`,\n  },\n  subCommands: {\n    list: experimentsListCommand,\n    get: experimentsGetCommand,\n    create: experimentsCreateCommand,\n    update: experimentsUpdateCommand,\n    start: experimentStateCommand(\"start\", \"ACTIVE\", \"starting (or resuming) an A/B test\"),\n    pause: experimentStateCommand(\"pause\", \"PAUSED\", \"pausing an A/B test — both ad sets pause, the end date stays\"),\n    end: experimentStateCommand(\"end\", \"CANCELED\", \"ending an A/B test for good\"),\n  },\n  args: { ...accountArgs },\n  default: \"list\",\n});\n"],"mappings":"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","names":[]}

package/dist/extract-QMY6WPTV.js

@@ -0,0 +1,143 @@
+import {
+  parseRequestFlags
+} from "./chunk-4N3Y5QWW.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-KNA3OWJC.js";
+import "./chunk-I7OJZ7QE.js";
+import {
+  IMAGES_EXTRACT_LIMIT_MAX,
+  imagesExtractRequestSchema
+} from "./chunk-YOHGEF2N.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-IMS53EQU.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.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"]);
+var PAGE_FAILURES = /* @__PURE__ */ new Set(["VALIDATION_ERROR", "INTERNAL_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.`;
+  const fix = retryable ? { action: "retry_once", explanation: `Run the same command once more. If it fails again, ${fallback}` } : PAGE_FAILURES.has(err.code) ? { action: "use_fallback", explanation: `Retrying the same address will fail the same way \u2014 ${fallback}` } : err.fix;
+  return {
+    ok: false,
+    error: { code: err.code, message: err.message, retryable, ...fix ? { fix } : {} }
+  };
+}
+
+// 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: `Most images to return (1-${IMAGES_EXTRACT_LIMIT_MAX}, default ${IMAGES_EXTRACT_LIMIT_MAX})`,
+      required: false,
+      default: IMAGES_EXTRACT_LIMIT_MAX
+    },
+    "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: `Most images to return (1-${IMAGES_EXTRACT_LIMIT_MAX})`, 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 request = parseRequestFlags(imagesExtractRequestSchema, body, { limit: "--limit", waitFor: "--wait-for" });
+      if (!request.ok) {
+        writeJson(request.envelope);
+        process.exit(1);
+      }
+      const data = await apiPost("/api/images/extract", request.data);
+      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-QMY6WPTV.js.map

package/dist/facets-QHM2IQ3E.js

@@ -0,0 +1,117 @@
+import {
+  csvOrJson,
+  handleLinkedinError
+} from "./chunk-34MZGC2Y.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-MK4HCMEA.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-YOHGEF2N.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-IMS53EQU.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.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-QHM2IQ3E.js.map

package/dist/feedback-NLPTKWOH.js

@@ -0,0 +1,114 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-LNYM4PQS.js";
+import {
+  PLATFORM_REPORT_KINDS,
+  feedbackReportRequestSchema
+} from "./chunk-YOHGEF2N.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-IMS53EQU.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/feedback/index.ts
+import { defineCommand } from "citty";
+var DOC = "__tooling__/docs/tools/baker/feedback.md";
+var ARGS = {
+  kind: {
+    type: "string",
+    description: "bug \u2014 something in Baker is broken (a command, check, hook, skill or doc does the wrong thing). feature \u2014 Baker has no way to do what the work needs.",
+    required: true
+  },
+  title: {
+    type: "string",
+    description: `One sentence, what is wrong or missing, in Baker's terms: "baker winning-ads has no way to read one country's ads".`,
+    required: true
+  },
+  body: {
+    type: "string",
+    description: "What you ran, what came back (the exact message), what you expected, and what you ruled out. Describe the problem, not the client: no names, emails or figures from their accounts.",
+    required: true
+  },
+  "user-asked": {
+    type: "boolean",
+    description: "Set when the user asked you to tell the Baker team. Leave it off when you are reporting on your own; the team reads which it was.",
+    required: false,
+    default: false
+  }
+};
+registerSchema({
+  command: "feedback.report",
+  description: `Start here when Baker itself is in the way: a command, check, hook, skill or doc that is broken, or a capability the work needs that Baker does not have. Example: baker feedback report --kind bug --title "verify fails on an archived test version" --body "\u2026" (add --user-asked when the user asked you to). Answers as soon as it is saved; it reaches the Baker team on its own, with the client's details taken out. Never a Task, never a message for the user to pass on. Then say one plain line to the user and keep going with what you can still do.`,
+  args: ARGS
+});
+var REPORT_HINTS = [
+  "The Baker team has it: once saved, the report reaches their tracker on its own, so a status of sending is the normal answer and there is nothing more to do or to tell the user about delivery. Tell the user in one plain line that you let the Baker team know \u2014 no ids, commands or file names \u2014 and never ask them to pass it on.",
+  "Then keep going: work around it with what this workspace still lets you change (the pages, Forms, Knowledge and Brand you own, a staged change instead of a blocked one), finish the rest of the job, and say plainly what is left undone. One broken piece should not stop the whole task.",
+  "It is not a Task: don't also file one for it."
+];
+function reportBody(args) {
+  if (!PLATFORM_REPORT_KINDS.includes(args.kind ?? "")) {
+    return { ok: false, error: `--kind is ${PLATFORM_REPORT_KINDS.join(" or ")}, got "${args.kind ?? ""}".` };
+  }
+  const parsed = feedbackReportRequestSchema.safeParse({
+    kind: args.kind,
+    title: args.title,
+    body: args.body,
+    askedByUser: args["user-asked"] === true
+  });
+  if (!parsed.success) {
+    return {
+      ok: false,
+      error: "A report needs a --title of at least 10 characters (one sentence, what is wrong or missing) and a --body of at least 20 (what you ran, what came back, what you expected)."
+    };
+  }
+  return { ok: true, body: parsed.data };
+}
+var reportCommand = defineCommand({
+  meta: {
+    name: "report",
+    description: `Tell the Baker team about a defect in Baker or a capability it lacks; sent to their tracker at once.
+Start here: baker feedback report --kind bug --title "<what is wrong, one sentence>" --body "<what you ran, what came back, what you expected>"`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const parsed = reportBody(args);
+    if (!parsed.ok) {
+      failValidation(parsed.error);
+    }
+    try {
+      const response = await apiPost("/api/feedback/report", parsed.body);
+      writeJson({ ok: true, data: response.data, hints: REPORT_HINTS });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var feedbackCommand = defineCommand({
+  meta: {
+    name: "feedback",
+    description: `Report a defect in Baker, or a capability it lacks, to the Baker team \u2014 never to the user, never as a Task. Subcommands: report.
+Full guide: ${DOC}`
+  },
+  subCommands: { report: reportCommand }
+});
+export {
+  REPORT_HINTS,
+  feedbackCommand,
+  reportBody
+};
+//# sourceMappingURL=feedback-NLPTKWOH.js.map