@koda-sl/baker-cli 0.386.0 → 0.387.0-dev.3bafd569e

package/dist/google-52JRH7X3.js

@@ -0,0 +1,136 @@
+import {
+  activeFilterFlags,
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/google.ts
+import { defineCommand } from "citty";
+var GOOGLE_ERROR_FIX = {
+  action: "use_different_resource",
+  explanation: "Generate the asset instead of retrying Google. Google is the last-resort image provider. Run `baker studio generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
+};
+registerSchema({
+  command: "images.google",
+  description: "Google Images search via the official Custom Search JSON API. Unverified source \u2014 inspect before placing.",
+  args: {
+    query: { type: "string", description: "Search query", required: true },
+    type: {
+      type: "string",
+      description: "imgType: photo | clipart | lineart | stock | animated | face | news",
+      required: false
+    },
+    size: {
+      type: "string",
+      description: "imgSize: icon | small | medium | large | xlarge | xxlarge | huge",
+      required: false
+    },
+    color: {
+      type: "string",
+      description: "imgColorType: color | gray | mono | trans",
+      required: false
+    },
+    safe: { type: "string", description: "safe: off | active", required: false },
+    limit: { type: "number", description: "Max results (1-50, paginated 10 per call)", required: false, default: 10 },
+    "auto-ingest": {
+      type: "number",
+      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.google}, default 0) and return Baker-owned URLs on ingested hits`,
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to every auto-ingested hit (overrides Google title)",
+      required: false
+    }
+  }
+});
+var googleCommand = defineCommand({
+  meta: {
+    name: "google",
+    description: "Google Images via the official Custom Search JSON API ($0.005/query, free 100/day). \u26A0 Source unverified \u2014 watermarks, low-res, mislabeled results are common. Use as last resort. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExample: baker images google 'industrial workshop' --type photo --size large --limit 20"
+  },
+  args: {
+    query: { type: "positional", description: "Search query", required: false },
+    type: { type: "string", description: "imgType filter", required: false },
+    size: { type: "string", description: "imgSize filter", required: false },
+    color: { type: "string", description: "imgColorType filter", required: false },
+    safe: { type: "string", description: "safe (off|active)", required: false },
+    limit: { type: "string", description: "Max results (1-50)", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.google}) and return Baker-owned URLs on ingested hits`,
+      required: false
+    },
+    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
+        process.exit(1);
+      }
+      const body = { query };
+      if (args.type) body.type = args.type;
+      if (args.size) body.size = args.size;
+      if (args.color) body.color = args.color;
+      if (args.safe) body.safe = args.safe;
+      if (args.limit) body.limit = Number(args.limit);
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.google);
+        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.google}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/google", body);
+      const hints = emptyResultHints({
+        provider: "google",
+        hitCount: data.hits.length,
+        activeFilters: activeFilterFlags(args, ["type", "size", "color", "safe"])
+      });
+      writeJson({ ok: true, data, ...hints.length ? { hints } : {} });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({
+          ok: false,
+          error: { code: err.code, message: err.message, fix: GOOGLE_ERROR_FIX }
+        });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  googleCommand
+};
+//# sourceMappingURL=google-52JRH7X3.js.map

package/dist/google-52JRH7X3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/google.ts"],"sourcesContent":["import type { ImagesGoogleRequest, ImagesGoogleResponse } 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 { activeFilterFlags, emptyResultHints } from \"./searchHints.ts\";\n\nconst GOOGLE_ERROR_FIX = {\n  action: \"use_different_resource\",\n  explanation:\n    \"Generate the asset instead of retrying Google. Google is the last-resort image provider. Run `baker studio generate` to make the asset. Never sleep-and-retry this command — the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it.\",\n};\n\nregisterSchema({\n  command: \"images.google\",\n  description:\n    \"Google Images search via the official Custom Search JSON API. Unverified source — inspect before placing.\",\n  args: {\n    query: { type: \"string\", description: \"Search query\", required: true },\n    type: {\n      type: \"string\",\n      description: \"imgType: photo | clipart | lineart | stock | animated | face | news\",\n      required: false,\n    },\n    size: {\n      type: \"string\",\n      description: \"imgSize: icon | small | medium | large | xlarge | xxlarge | huge\",\n      required: false,\n    },\n    color: {\n      type: \"string\",\n      description: \"imgColorType: color | gray | mono | trans\",\n      required: false,\n    },\n    safe: { type: \"string\", description: \"safe: off | active\", required: false },\n    limit: { type: \"number\", description: \"Max results (1-50, paginated 10 per call)\", required: false, default: 10 },\n    \"auto-ingest\": {\n      type: \"number\",\n      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.google}, default 0) and return Baker-owned URLs on ingested hits`,\n      required: false,\n      default: 0,\n    },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint applied to every auto-ingested hit (overrides Google title)\",\n      required: false,\n    },\n  },\n});\n\nexport const googleCommand = defineCommand({\n  meta: {\n    name: \"google\",\n    description:\n      \"Google Images via the official Custom Search JSON API ($0.005/query, free 100/day). ⚠ Source unverified — watermarks, low-res, mislabeled results are common. Use as last resort. With --auto-ingest, ingested hits return Baker-owned URLs.\\n\\nExample: baker images google 'industrial workshop' --type photo --size large --limit 20\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Search query\", required: false },\n    type: { type: \"string\", description: \"imgType filter\", required: false },\n    size: { type: \"string\", description: \"imgSize filter\", required: false },\n    color: { type: \"string\", description: \"imgColorType filter\", required: false },\n    safe: { type: \"string\", description: \"safe (off|active)\", required: false },\n    limit: { type: \"string\", description: \"Max results (1-50)\", required: false },\n    \"auto-ingest\": {\n      type: \"string\",\n      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.google}) and return Baker-owned URLs on ingested hits`,\n      required: false,\n    },\n    context: { type: \"string\", description: \"Description context hint applied to auto-ingested hits\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const query = args.query as string | undefined;\n      if (!query) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Query is required\" } });\n        process.exit(1);\n      }\n      const body: ImagesGoogleRequest = { query };\n      if (args.type) body.type = args.type as string;\n      if (args.size) body.size = args.size as string;\n      if (args.color) body.color = args.color as string;\n      if (args.safe) body.safe = args.safe as ImagesGoogleRequest[\"safe\"];\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.google);\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.google}.`,\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<ImagesGoogleResponse>(\"/api/images/google\", body);\n      const hints = emptyResultHints({\n        provider: \"google\",\n        hitCount: data.hits.length,\n        activeFilters: activeFilterFlags(args, [\"type\", \"size\", \"color\", \"safe\"]),\n      });\n      writeJson({ ok: true, data, ...(hints.length ? { hints } : {}) });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({\n          ok: false,\n          error: { code: err.code, message: err.message, fix: GOOGLE_ERROR_FIX },\n        });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/google-ads-PWX7OF5Z.js

@@ -0,0 +1,195 @@
+import {
+  googleAdsHints
+} from "./chunk-H7XVKLIY.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-Y362QH54.js";
+import {
+  RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT,
+  RESEARCH_GOOGLE_ADS_MAX_COPY,
+  RESEARCH_GOOGLE_ADS_MAX_LIMIT,
+  researchGoogleAdsFormatSchema,
+  researchGoogleAdsPlatformSchema
+} from "./chunk-SMIENBNX.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-XX6ZMCY5.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/google-ads.ts
+import { defineCommand } from "citty";
+var TIMEOUT_MS = 18e4;
+var PLATFORMS = researchGoogleAdsPlatformSchema.options;
+var FORMATS = ["all", ...researchGoogleAdsFormatSchema.options];
+registerSchema({
+  command: "research.google-ads",
+  description: "A competitor's Google ads, from Google's Ads Transparency Center: who runs each one, its format (text, image, video), when it was first and last shown and how many days it has run \u2014 the longest-running are the ones that pay. With --copy, the headline, description and display URL of up to 20 text ads. Start here: `baker research google-ads <competitor.com> --location <cc> --copy`. Never drive the Transparency Center in a browser instead.",
+  args: {
+    target: {
+      type: "string",
+      description: "Competitor domain (competitor.com, or any URL on it) or a Transparency advertiser id (AR\u2026)",
+      required: true
+    },
+    location: {
+      type: "string",
+      description: "Country code (es, mx, us\u2026) where the ads were shown. Omit for every region",
+      required: false
+    },
+    platform: { type: "string", description: "Where they ran", required: false, enum: [...PLATFORMS] },
+    format: { type: "string", description: "Only one ad format", required: false, enum: [...FORMATS] },
+    since: { type: "string", description: "Only ads shown on or after this day (YYYY-MM-DD)", required: false },
+    limit: {
+      type: "number",
+      description: `Max ads (1-${RESEARCH_GOOGLE_ADS_MAX_LIMIT}, default ${RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT}; billed per 40)`,
+      required: false
+    },
+    copy: {
+      type: "boolean",
+      description: `Read headline, description and display URL of up to ${RESEARCH_GOOGLE_ADS_MAX_COPY} text ads`,
+      required: false,
+      default: false
+    },
+    full: {
+      type: "boolean",
+      description: "Add creative/advertiser ids, verification and preview image URL",
+      required: false,
+      default: false
+    }
+  }
+});
+var FIELDS = {
+  advertiser: "The Google Ads account that runs the ad (a brand can run several)",
+  format: "text | image | video",
+  first_shown: "First day Google showed it (UTC)",
+  last_shown: "Most recent day Google showed it (UTC) \u2014 recent means still running",
+  days_running: "First to last shown, inclusive: how long the advertiser has kept paying for it",
+  copy: "headline / description / display_url, read off the text ad's image (--copy); null otherwise",
+  transparency_url: "The ad on Google's Ads Transparency Center \u2014 the link to show the user"
+};
+function compact(ad) {
+  return {
+    advertiser: ad.advertiser,
+    format: ad.format,
+    first_shown: ad.first_shown,
+    last_shown: ad.last_shown,
+    days_running: ad.days_running,
+    copy: ad.copy,
+    transparency_url: ad.transparency_url
+  };
+}
+function googleAdsFix(code) {
+  if (code === "BAD_REQUEST" || code === "VALIDATION_ERROR") {
+    return {
+      action: "retry_with_changes",
+      explanation: "Pass the competitor's domain (competitor.com) or an advertiser id (AR\u2026), and check the flag values."
+    };
+  }
+  return {
+    action: "continue_without",
+    explanation: "This read failed. Finish the rest of the job and name the competitor's Google ads as a gap \u2014 do not open the Transparency Center in a browser instead."
+  };
+}
+function invalid(message) {
+  writeResearchJson({ ok: false, error: { code: "VALIDATION_ERROR", message, fix: googleAdsFix("VALIDATION_ERROR") } });
+  process.exit(1);
+}
+var googleAdsCommand = defineCommand({
+  meta: {
+    name: "google-ads",
+    description: `A competitor's Google ads, read from Google's Ads Transparency Center \u2014 no browser. Each ad: who runs it, format, first and last shown, days running, and its Transparency link. --copy reads the headline and description of the text ads.
+
+Examples:
+  baker research google-ads competitor.com --location es --copy
+  baker research google-ads competitor.com --platform google_search --format text --copy
+  baker research google-ads competitor.com --since 2026-07-01 --limit 80
+  baker research google-ads AR06744629793381154817 --output md`
+  },
+  args: {
+    target: { type: "positional", description: "Competitor domain or advertiser id (AR\u2026)", required: false },
+    location: {
+      type: "string",
+      description: "Country code where the ads were shown (default: every region)",
+      required: false
+    },
+    platform: { type: "string", description: `${PLATFORMS.join("|")} (default all)`, required: false },
+    format: { type: "string", description: `${FORMATS.join("|")} (default all)`, required: false },
+    since: { type: "string", description: "Only ads shown on or after YYYY-MM-DD", required: false },
+    limit: {
+      type: "string",
+      description: `Max ads (default ${RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT}, max ${RESEARCH_GOOGLE_ADS_MAX_LIMIT})`,
+      required: false
+    },
+    copy: { type: "boolean", description: "Read the text ads' headline and description", required: false },
+    full: { type: "boolean", description: "Add ids, verification and preview image URL", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip the 6h server cache", required: false }
+  },
+  run: async ({ args }) => {
+    const target = args.target?.trim();
+    if (!target) invalid("A competitor domain or advertiser id is required");
+    const platform = args.platform ?? "all";
+    if (!researchGoogleAdsPlatformSchema.safeParse(platform).success) {
+      invalid(`--platform must be one of ${PLATFORMS.join(", ")}`);
+    }
+    const format = args.format ?? "all";
+    if (!FORMATS.includes(format)) invalid(`--format must be one of ${FORMATS.join(", ")}`);
+    const body = {
+      target,
+      platform,
+      format,
+      copy: Boolean(args.copy)
+    };
+    if (args.location) body.location = args.location;
+    if (args.since) body.since = args.since;
+    if (args.limit) body.limit = Number(args.limit);
+    if (args["no-cache"]) body.skipCache = true;
+    try {
+      const result = await apiPost("/api/research/google-ads", body, {
+        timeoutMs: TIMEOUT_MS
+      });
+      const hints = googleAdsHints({
+        target: result.target,
+        adCount: result.ads.length,
+        located: body.location !== void 0,
+        textWithoutCopy: result.ads.filter((ad) => ad.format === "text" && ad.copy === null).length,
+        copyAsked: body.copy === true,
+        copyUnread: result.copy_unread,
+        visual: result.ads.filter((ad) => ad.format !== "text").length
+      });
+      const ads = args.full ? result.ads : result.ads.map(compact);
+      const output = args.output || "json";
+      if (output !== "json") {
+        writeResearchOutput(ads, output);
+        writeResearchHints(hints, output);
+        return;
+      }
+      writeResearchJson({
+        ok: true,
+        data: ads,
+        fields: FIELDS,
+        target: result.target,
+        total_ads: result.total_ads,
+        check_url: result.check_url,
+        hints
+      });
+    } catch (err) {
+      handleResearchError(err, googleAdsFix);
+    }
+  }
+});
+export {
+  googleAdsCommand
+};
+//# sourceMappingURL=google-ads-PWX7OF5Z.js.map

package/dist/google-ads-PWX7OF5Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/google-ads.ts"],"sourcesContent":["import {\n  RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT,\n  RESEARCH_GOOGLE_ADS_MAX_COPY,\n  RESEARCH_GOOGLE_ADS_MAX_LIMIT,\n  type ResearchGoogleAd,\n  type ResearchGoogleAdsRequest,\n  type ResearchGoogleAdsResponse,\n  researchGoogleAdsFormatSchema,\n  researchGoogleAdsPlatformSchema,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { googleAdsHints } from \"./hints.ts\";\nimport {\n  handleResearchError,\n  type ResearchFix,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\n/** Reading twenty ad images takes a vision call on top of the search; the default 60s is too tight. */\nconst TIMEOUT_MS = 180_000;\n\nconst PLATFORMS = researchGoogleAdsPlatformSchema.options;\nconst FORMATS = [\"all\", ...researchGoogleAdsFormatSchema.options] as const;\n\nregisterSchema({\n  command: \"research.google-ads\",\n  description:\n    \"A competitor's Google ads, from Google's Ads Transparency Center: who runs each one, its format (text, image, video), when it was first and last shown and how many days it has run — the longest-running are the ones that pay. With --copy, the headline, description and display URL of up to 20 text ads. Start here: `baker research google-ads <competitor.com> --location <cc> --copy`. Never drive the Transparency Center in a browser instead.\",\n  args: {\n    target: {\n      type: \"string\",\n      description: \"Competitor domain (competitor.com, or any URL on it) or a Transparency advertiser id (AR…)\",\n      required: true,\n    },\n    location: {\n      type: \"string\",\n      description: \"Country code (es, mx, us…) where the ads were shown. Omit for every region\",\n      required: false,\n    },\n    platform: { type: \"string\", description: \"Where they ran\", required: false, enum: [...PLATFORMS] },\n    format: { type: \"string\", description: \"Only one ad format\", required: false, enum: [...FORMATS] },\n    since: { type: \"string\", description: \"Only ads shown on or after this day (YYYY-MM-DD)\", required: false },\n    limit: {\n      type: \"number\",\n      description: `Max ads (1-${RESEARCH_GOOGLE_ADS_MAX_LIMIT}, default ${RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT}; billed per 40)`,\n      required: false,\n    },\n    copy: {\n      type: \"boolean\",\n      description: `Read headline, description and display URL of up to ${RESEARCH_GOOGLE_ADS_MAX_COPY} text ads`,\n      required: false,\n      default: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"Add creative/advertiser ids, verification and preview image URL\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nconst FIELDS: Record<string, string> = {\n  advertiser: \"The Google Ads account that runs the ad (a brand can run several)\",\n  format: \"text | image | video\",\n  first_shown: \"First day Google showed it (UTC)\",\n  last_shown: \"Most recent day Google showed it (UTC) — recent means still running\",\n  days_running: \"First to last shown, inclusive: how long the advertiser has kept paying for it\",\n  copy: \"headline / description / display_url, read off the text ad's image (--copy); null otherwise\",\n  transparency_url: \"The ad on Google's Ads Transparency Center — the link to show the user\",\n};\n\nfunction compact(ad: ResearchGoogleAd) {\n  return {\n    advertiser: ad.advertiser,\n    format: ad.format,\n    first_shown: ad.first_shown,\n    last_shown: ad.last_shown,\n    days_running: ad.days_running,\n    copy: ad.copy,\n    transparency_url: ad.transparency_url,\n  };\n}\n\nfunction googleAdsFix(code: string): ResearchFix {\n  if (code === \"BAD_REQUEST\" || code === \"VALIDATION_ERROR\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation:\n        \"Pass the competitor's domain (competitor.com) or an advertiser id (AR…), and check the flag values.\",\n    };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"This read failed. Finish the rest of the job and name the competitor's Google ads as a gap — do not open the Transparency Center in a browser instead.\",\n  };\n}\n\nfunction invalid(message: string): never {\n  writeResearchJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message, fix: googleAdsFix(\"VALIDATION_ERROR\") } });\n  process.exit(1);\n}\n\nexport const googleAdsCommand = defineCommand({\n  meta: {\n    name: \"google-ads\",\n    description: `A competitor's Google ads, read from Google's Ads Transparency Center — no browser. Each ad: who runs it, format, first and last shown, days running, and its Transparency link. --copy reads the headline and description of the text ads.\n\nExamples:\n  baker research google-ads competitor.com --location es --copy\n  baker research google-ads competitor.com --platform google_search --format text --copy\n  baker research google-ads competitor.com --since 2026-07-01 --limit 80\n  baker research google-ads AR06744629793381154817 --output md`,\n  },\n  args: {\n    target: { type: \"positional\", description: \"Competitor domain or advertiser id (AR…)\", required: false },\n    location: {\n      type: \"string\",\n      description: \"Country code where the ads were shown (default: every region)\",\n      required: false,\n    },\n    platform: { type: \"string\", description: `${PLATFORMS.join(\"|\")} (default all)`, required: false },\n    format: { type: \"string\", description: `${FORMATS.join(\"|\")} (default all)`, required: false },\n    since: { type: \"string\", description: \"Only ads shown on or after YYYY-MM-DD\", required: false },\n    limit: {\n      type: \"string\",\n      description: `Max ads (default ${RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT}, max ${RESEARCH_GOOGLE_ADS_MAX_LIMIT})`,\n      required: false,\n    },\n    copy: { type: \"boolean\", description: \"Read the text ads' headline and description\", required: false },\n    full: { type: \"boolean\", description: \"Add ids, verification and preview image URL\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip the 6h server cache\", required: false },\n  },\n  run: async ({ args }) => {\n    const target = (args.target as string | undefined)?.trim();\n    if (!target) invalid(\"A competitor domain or advertiser id is required\");\n    const platform = (args.platform as string | undefined) ?? \"all\";\n    if (!researchGoogleAdsPlatformSchema.safeParse(platform).success) {\n      invalid(`--platform must be one of ${PLATFORMS.join(\", \")}`);\n    }\n    const format = (args.format as string | undefined) ?? \"all\";\n    if (!(FORMATS as readonly string[]).includes(format)) invalid(`--format must be one of ${FORMATS.join(\", \")}`);\n\n    const body: ResearchGoogleAdsRequest = {\n      target,\n      platform: platform as ResearchGoogleAdsRequest[\"platform\"],\n      format: format as ResearchGoogleAdsRequest[\"format\"],\n      copy: Boolean(args.copy),\n    };\n    if (args.location) body.location = args.location as string;\n    if (args.since) body.since = args.since as string;\n    if (args.limit) body.limit = Number(args.limit);\n    if (args[\"no-cache\"]) body.skipCache = true;\n\n    try {\n      const result = await apiPost<ResearchGoogleAdsResponse>(\"/api/research/google-ads\", body, {\n        timeoutMs: TIMEOUT_MS,\n      });\n      const hints = googleAdsHints({\n        target: result.target,\n        adCount: result.ads.length,\n        located: body.location !== undefined,\n        textWithoutCopy: result.ads.filter((ad) => ad.format === \"text\" && ad.copy === null).length,\n        copyAsked: body.copy === true,\n        copyUnread: result.copy_unread,\n        visual: result.ads.filter((ad) => ad.format !== \"text\").length,\n      });\n      const ads = args.full ? result.ads : result.ads.map(compact);\n      const output = (args.output as string) || \"json\";\n      if (output !== \"json\") {\n        writeResearchOutput(ads as unknown as Array<Record<string, unknown>>, output);\n        writeResearchHints(hints, output);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data: ads,\n        fields: FIELDS,\n        target: result.target,\n        total_ads: result.total_ads,\n        check_url: result.check_url,\n        hints,\n      });\n    } catch (err) {\n      handleResearchError(err, googleAdsFix);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/group-AAZ5QKC3.js

@@ -0,0 +1,43 @@
+import {
+  runMediaGroupLookup
+} from "./chunk-2SQJL7ZN.js";
+import "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/group.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "videos.group",
+  description: "List every clip and image that arrived in the same set as this video (carousel slides, one page)",
+  args: {
+    id: { type: "string", description: "A video or image id \u2014 returns that asset's whole set", required: false },
+    "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
+  }
+});
+var groupCommand = defineCommand({
+  meta: {
+    name: "group",
+    description: "List every asset that arrived in the same set as this clip \u2014 the other slides of the Instagram post it came from, stills included. A carousel is authored to be read in order, so a clip pulled out of one is usually missing half its meaning. Example: baker videos group <videoId>"
+  },
+  args: {
+    id: { type: "positional", description: "A video or image id from the set", required: false },
+    "group-key": { type: "string", description: "The set key, if you already have it", required: false }
+  },
+  run: async ({ args }) => {
+    await runMediaGroupLookup({
+      id: args.id,
+      groupKey: args["group-key"],
+      path: "/api/videos/group",
+      idLabel: "a video or image id"
+    });
+  }
+});
+export {
+  groupCommand
+};
+//# sourceMappingURL=group-AAZ5QKC3.js.map

package/dist/group-AAZ5QKC3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/videos/group.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { runMediaGroupLookup } from \"../mediaGroup.ts\";\n\nregisterSchema({\n  command: \"videos.group\",\n  description: \"List every clip and image that arrived in the same set as this video (carousel slides, one page)\",\n  args: {\n    id: { type: \"string\", description: \"A video or image id — returns that asset's whole set\", required: false },\n    \"group-key\": { type: \"string\", description: \"The set key directly, when you already have it\", required: false },\n  },\n});\n\nexport const groupCommand = defineCommand({\n  meta: {\n    name: \"group\",\n    description:\n      \"List every asset that arrived in the same set as this clip — the other slides of the Instagram post it came from, stills included. A carousel is authored to be read in order, so a clip pulled out of one is usually missing half its meaning. Example: baker videos group <videoId>\",\n  },\n  args: {\n    id: { type: \"positional\", description: \"A video or image id from the set\", required: false },\n    \"group-key\": { type: \"string\", description: \"The set key, if you already have it\", required: false },\n  },\n  run: async ({ args }) => {\n    await runMediaGroupLookup({\n      id: args.id as string | undefined,\n      groupKey: args[\"group-key\"] as string | undefined,\n      path: \"/api/videos/group\",\n      idLabel: \"a video or image id\",\n    });\n  },\n});\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAI9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,UAAU,aAAa,6DAAwD,UAAU,MAAM;AAAA,IAC3G,aAAa,EAAE,MAAM,UAAU,aAAa,kDAAkD,UAAU,MAAM;AAAA,EAChH;AACF,CAAC;AAEM,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,oCAAoC,UAAU,MAAM;AAAA,IAC3F,aAAa,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,oBAAoB;AAAA,MACxB,IAAI,KAAK;AAAA,MACT,UAAU,KAAK,WAAW;AAAA,MAC1B,MAAM;AAAA,MACN,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF,CAAC;","names":[]}

package/dist/group-GSYCZORC.js

@@ -0,0 +1,43 @@
+import {
+  runMediaGroupLookup
+} from "./chunk-2SQJL7ZN.js";
+import "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/group.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.group",
+  description: "List every image and clip that arrived in the same set as this one (carousel slides, one page's images)",
+  args: {
+    id: { type: "string", description: "An image or video id \u2014 returns that asset's whole set", required: false },
+    "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
+  }
+});
+var groupCommand = defineCommand({
+  meta: {
+    name: "group",
+    description: "List every asset that arrived in the same set \u2014 the slides of one Instagram carousel, the images off one scraped page. Start here whenever a hit looks like part of a sequence: carousel slides are authored to be read in order and usually only make sense together. Takes an image or a video id, since one carousel can contain both. Example: baker images group <imageId>"
+  },
+  args: {
+    id: { type: "positional", description: "An image or video id from the set", required: false },
+    "group-key": { type: "string", description: "The set key, if you already have it", required: false }
+  },
+  run: async ({ args }) => {
+    await runMediaGroupLookup({
+      id: args.id,
+      groupKey: args["group-key"],
+      path: "/api/images/group",
+      idLabel: "an image or video id"
+    });
+  }
+});
+export {
+  groupCommand
+};
+//# sourceMappingURL=group-GSYCZORC.js.map

package/dist/group-GSYCZORC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/group.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { runMediaGroupLookup } from \"../mediaGroup.ts\";\n\nregisterSchema({\n  command: \"images.group\",\n  description:\n    \"List every image and clip that arrived in the same set as this one (carousel slides, one page's images)\",\n  args: {\n    id: { type: \"string\", description: \"An image or video id — returns that asset's whole set\", required: false },\n    \"group-key\": { type: \"string\", description: \"The set key directly, when you already have it\", required: false },\n  },\n});\n\nexport const groupCommand = defineCommand({\n  meta: {\n    name: \"group\",\n    description:\n      \"List every asset that arrived in the same set — the slides of one Instagram carousel, the images off one scraped page. Start here whenever a hit looks like part of a sequence: carousel slides are authored to be read in order and usually only make sense together. Takes an image or a video id, since one carousel can contain both. Example: baker images group <imageId>\",\n  },\n  args: {\n    id: { type: \"positional\", description: \"An image or video id from the set\", required: false },\n    \"group-key\": { type: \"string\", description: \"The set key, if you already have it\", required: false },\n  },\n  run: async ({ args }) => {\n    await runMediaGroupLookup({\n      id: args.id as string | undefined,\n      groupKey: args[\"group-key\"] as string | undefined,\n      path: \"/api/images/group\",\n      idLabel: \"an image or video id\",\n    });\n  },\n});\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAI9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,UAAU,aAAa,8DAAyD,UAAU,MAAM;AAAA,IAC5G,aAAa,EAAE,MAAM,UAAU,aAAa,kDAAkD,UAAU,MAAM;AAAA,EAChH;AACF,CAAC;AAEM,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,qCAAqC,UAAU,MAAM;AAAA,IAC5F,aAAa,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,oBAAoB;AAAA,MACxB,IAAI,KAAK;AAAA,MACT,UAAU,KAAK,WAAW;AAAA,MAC1B,MAAM;AAAA,MACN,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF,CAAC;","names":[]}

package/dist/gsc-TS5T7ML2.js

@@ -0,0 +1,30 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/gsc/index.ts
+import { defineCommand } from "citty";
+var gscCommand = defineCommand({
+  meta: {
+    name: "gsc",
+    description: `Google Search Console commands. PPC-SEO arbitrage, brand halo analysis, negative keyword discovery.
+
+Start here:
+  baker gsc sites                         \u2014 list verified sites
+  baker gsc query --list-presets          \u2014 see available query presets
+
+Examples:
+  baker gsc query --preset cannibalization                          \u2014 find PPC-SEO overlap
+  baker gsc query --preset brand-halo --brand "Acme" --days 90      \u2014 brand search trends
+  baker gsc query --dimensions "query,page" --days 28               \u2014 free-form query
+  baker gsc sitemaps                                                \u2014 check sitemap health
+Full guide: __tooling__/docs/tools/baker/gsc.md`
+  },
+  subCommands: {
+    sites: () => import("./sites-WMBY2HJV.js").then((m) => m.sitesCommand),
+    query: () => import("./query-UN2P6DBA.js").then((m) => m.queryCommand),
+    sitemaps: () => import("./sitemaps-XPGLW24S.js").then((m) => m.sitemapsCommand)
+  }
+});
+export {
+  gscCommand
+};
+//# sourceMappingURL=gsc-TS5T7ML2.js.map

package/dist/gsc-TS5T7ML2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/gsc/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\nexport const gscCommand = defineCommand({\n  meta: {\n    name: \"gsc\",\n    description: `Google Search Console commands. PPC-SEO arbitrage, brand halo analysis, negative keyword discovery.\n\nStart here:\n  baker gsc sites                         — list verified sites\n  baker gsc query --list-presets          — see available query presets\n\nExamples:\n  baker gsc query --preset cannibalization                          — find PPC-SEO overlap\n  baker gsc query --preset brand-halo --brand \"Acme\" --days 90      — brand search trends\n  baker gsc query --dimensions \"query,page\" --days 28               — free-form query\n  baker gsc sitemaps                                                — check sitemap health\nFull guide: __tooling__/docs/tools/baker/gsc.md`,\n  },\n  subCommands: {\n    sites: () => import(\"./sites.ts\").then((m) => m.sitesCommand),\n    query: () => import(\"./query.ts\").then((m) => m.queryCommand),\n    sitemaps: () => import(\"./sitemaps.ts\").then((m) => m.sitemapsCommand),\n  },\n});\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAEvB,IAAM,aAAa,cAAc;AAAA,EACtC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYf;AAAA,EACA,aAAa;AAAA,IACX,OAAO,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;AAAA,IAC5D,OAAO,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;AAAA,IAC5D,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,EACvE;AACF,CAAC;","names":[]}

package/dist/history-EW6LFFCX.js

@@ -0,0 +1,67 @@
+import {
+  schemaArgs
+} from "./chunk-4MH6LONO.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-IOCSDFF2.js";
+import "./chunk-BVM5IRZW.js";
+import {
+  apiGet
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/history.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  days: { type: "string", description: "The last N days, 1-90 (default 7)" },
+  limit: { type: "string", description: "Changes to show, 1-100 (default 50), newest first" },
+  "campaign-id": { type: "string", description: "Only this campaign and what is under it" },
+  "ad-group-id": { type: "string", description: "Only this ad group and its ads" },
+  "ad-id": { type: "string", description: "Only this ad" }
+};
+registerSchema({
+  command: "ads.chatgpt.history",
+  description: "What changed in the ChatGPT Ads account \u2014 by Baker or anyone in Ads Manager \u2014 newest first: each change, what it touched, and each field before and after (money in micros).",
+  args: schemaArgs(ARGS)
+});
+var historyCommand = defineCommand({
+  meta: {
+    name: "history",
+    description: `What changed in the account, and when.
+
+Examples:
+  baker ads chatgpt history
+  baker ads chatgpt history --campaign-id cmpn_123 --days 30`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const params = {};
+    for (const [flag, name] of [
+      ["days", "days"],
+      ["limit", "limit"],
+      ["campaign-id", "campaign_id"],
+      ["ad-group-id", "ad_group_id"],
+      ["ad-id", "ad_id"]
+    ]) {
+      const value = args[flag];
+      if (typeof value === "string" && value.trim()) {
+        params[name] = value.trim();
+      }
+    }
+    await runChatgptRead(
+      CHATGPT_ADS_REFERENCE.overview,
+      () => apiGet("/api/ads/chatgpt/history", params),
+      (entries) => entries.length === 0 ? ["No change in this window. Widen it with --days (up to 90)."] : []
+    );
+  }
+});
+export {
+  historyCommand
+};
+//# sourceMappingURL=history-EW6LFFCX.js.map

package/dist/history-EW6LFFCX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/history.ts"],"sourcesContent":["import type { ChatgptAdsHistoryEntry } from \"@baker/api/ads-chatgpt\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHATGPT_ADS_REFERENCE, runChatgptRead } from \"./shared.ts\";\nimport { schemaArgs } from \"./write-shared.ts\";\n\n/**\n * The account's change history — every create, update and status change, by\n * Baker or by anyone in Ads Manager. The answer to \"what changed, and when\"\n * before blaming a drop in results on the ads themselves.\n */\n\nconst ARGS = {\n  days: { type: \"string\", description: \"The last N days, 1-90 (default 7)\" },\n  limit: { type: \"string\", description: \"Changes to show, 1-100 (default 50), newest first\" },\n  \"campaign-id\": { type: \"string\", description: \"Only this campaign and what is under it\" },\n  \"ad-group-id\": { type: \"string\", description: \"Only this ad group and its ads\" },\n  \"ad-id\": { type: \"string\", description: \"Only this ad\" },\n} as const;\n\nregisterSchema({\n  command: \"ads.chatgpt.history\",\n  description:\n    \"What changed in the ChatGPT Ads account — by Baker or anyone in Ads Manager — newest first: each change, what it touched, and each field before and after (money in micros).\",\n  args: schemaArgs(ARGS),\n});\n\nexport const historyCommand = defineCommand({\n  meta: {\n    name: \"history\",\n    description: `What changed in the account, and when.\n\nExamples:\n  baker ads chatgpt history\n  baker ads chatgpt history --campaign-id cmpn_123 --days 30`,\n  },\n  args: ARGS,\n  run: async ({ args }) => {\n    const params: Record<string, string> = {};\n    for (const [flag, name] of [\n      [\"days\", \"days\"],\n      [\"limit\", \"limit\"],\n      [\"campaign-id\", \"campaign_id\"],\n      [\"ad-group-id\", \"ad_group_id\"],\n      [\"ad-id\", \"ad_id\"],\n    ] as const) {\n      const value = args[flag];\n      if (typeof value === \"string\" && value.trim()) {\n        params[name] = value.trim();\n      }\n    }\n    await runChatgptRead(\n      CHATGPT_ADS_REFERENCE.overview,\n      () => apiGet<ChatgptAdsHistoryEntry[]>(\"/api/ads/chatgpt/history\", params),\n      (entries) => (entries.length === 0 ? [\"No change in this window. Widen it with --days (up to 90).\"] : []),\n    );\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAY9B,IAAM,OAAO;AAAA,EACX,MAAM,EAAE,MAAM,UAAU,aAAa,oCAAoC;AAAA,EACzE,OAAO,EAAE,MAAM,UAAU,aAAa,oDAAoD;AAAA,EAC1F,eAAe,EAAE,MAAM,UAAU,aAAa,0CAA0C;AAAA,EACxF,eAAe,EAAE,MAAM,UAAU,aAAa,iCAAiC;AAAA,EAC/E,SAAS,EAAE,MAAM,UAAU,aAAa,eAAe;AACzD;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,WAAW,IAAI;AACvB,CAAC;AAEM,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAiC,CAAC;AACxC,eAAW,CAAC,MAAM,IAAI,KAAK;AAAA,MACzB,CAAC,QAAQ,MAAM;AAAA,MACf,CAAC,SAAS,OAAO;AAAA,MACjB,CAAC,eAAe,aAAa;AAAA,MAC7B,CAAC,eAAe,aAAa;AAAA,MAC7B,CAAC,SAAS,OAAO;AAAA,IACnB,GAAY;AACV,YAAM,QAAQ,KAAK,IAAI;AACvB,UAAI,OAAO,UAAU,YAAY,MAAM,KAAK,GAAG;AAC7C,eAAO,IAAI,IAAI,MAAM,KAAK;AAAA,MAC5B;AAAA,IACF;AACA,UAAM;AAAA,MACJ,sBAAsB;AAAA,MACtB,MAAM,OAAiC,4BAA4B,MAAM;AAAA,MACzE,CAAC,YAAa,QAAQ,WAAW,IAAI,CAAC,4DAA4D,IAAI,CAAC;AAAA,IACzG;AAAA,EACF;AACF,CAAC;","names":[]}