@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/upload-L5SYZB3X.js

@@ -0,0 +1,150 @@
+import {
+  detectImageContentType,
+  uploadLocalImage
+} from "./chunk-75FDTDLH.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/upload.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.upload",
+  description: "Upload an image to the library \u2014 local file path or remote http(s) URL.",
+  args: {
+    file: { type: "string", description: "Local file path or remote http(s) URL", required: true },
+    source: { type: "string", description: "Source identifier (default: uploaded)", required: false },
+    "content-type": {
+      type: "string",
+      description: "MIME type (local files only \u2014 auto-detected from extension if omitted; ignored for URLs)",
+      required: false
+    },
+    "external-id": {
+      type: "string",
+      description: "Provider asset id (URL mode only \u2014 enables per-source dedup before bytes are fetched)",
+      required: false
+    },
+    "external-url": {
+      type: "string",
+      description: "Canonical page URL (URL mode only \u2014 parent page for scraped/Google hits, provider page for stock)",
+      required: false
+    },
+    "dry-run": {
+      type: "boolean",
+      description: "Preview the operation without executing",
+      required: false,
+      default: false
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint passed to Gemini describe to bias the generated description and tags",
+      required: false
+    }
+  }
+});
+function isRemoteUrl(value) {
+  return /^https?:\/\//i.test(value);
+}
+var uploadCommand = defineCommand({
+  meta: {
+    name: "upload",
+    description: "Upload an image to the library \u2014 accepts a local file path OR a remote http(s) URL.\n\nLocal: reads bytes, sends to /api/images/upload, content-type auto-detected from extension.\nRemote: dispatches to /api/images/ingest with hash-dedup on bytes + externalId.\n\nExamples:\n  baker images upload ./logo.png --source uploaded\n  baker images upload ./cert.png --context 'ISO 27001 badge \u2014 enterprise tier'\n  baker images upload https://acme.com/hero.png --source firecrawl --context 'Acme competitor pricing hero'"
+  },
+  args: {
+    file: { type: "positional", description: "Local file path or remote http(s) URL", required: false },
+    source: { type: "string", description: "Source identifier", required: false },
+    "content-type": {
+      type: "string",
+      description: "MIME type (local only \u2014 auto-detected if omitted)",
+      required: false
+    },
+    "external-id": { type: "string", description: "Provider asset id (URL mode only)", required: false },
+    "external-url": { type: "string", description: "Canonical page URL (URL mode only)", required: false },
+    "dry-run": { type: "boolean", description: "Preview without executing", required: false, default: false },
+    context: { type: "string", description: "Description context hint", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const target = args.file;
+      if (!target) {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "File path or URL is required" }
+        });
+        process.exit(1);
+      }
+      if (isRemoteUrl(target)) {
+        await uploadRemote(target, args);
+      } else {
+        await uploadLocal(target, args);
+      }
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+async function uploadRemote(target, args) {
+  const source = args.source ?? "uploaded";
+  if (args["dry-run"]) {
+    writeJson({
+      ok: true,
+      dryRun: true,
+      operation: "images.upload (remote)",
+      params: {
+        url: target,
+        source,
+        externalId: args["external-id"] ?? null,
+        externalUrl: args["external-url"] ?? null,
+        descriptionContext: args.context ?? null
+      }
+    });
+    return;
+  }
+  const body = { url: target, source };
+  if (args["external-id"]) body.externalId = args["external-id"];
+  if (args["external-url"]) body.externalUrl = args["external-url"];
+  if (args.context) body.descriptionContext = args.context;
+  const data = await apiPost("/api/images/ingest", body);
+  writeJson({ ok: true, data });
+}
+async function uploadLocal(target, args) {
+  const contentType = args["content-type"] || detectImageContentType(target);
+  if (args["dry-run"]) {
+    writeJson({
+      ok: true,
+      dryRun: true,
+      operation: "images.upload (local)",
+      params: {
+        file: target,
+        contentType,
+        source: args.source ?? null,
+        descriptionContext: args.context ?? null
+      }
+    });
+    return;
+  }
+  const data = await uploadLocalImage({
+    file: target,
+    contentType,
+    source: args.source,
+    descriptionContext: args.context
+  });
+  writeJson({ ok: true, data });
+}
+export {
+  uploadCommand
+};
+//# sourceMappingURL=upload-L5SYZB3X.js.map

package/dist/upload-L5SYZB3X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/upload.ts"],"sourcesContent":["import type { ImagesIngestRequest, ImagesIngestResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { detectImageContentType, uploadLocalImage } from \"./api.ts\";\n\nregisterSchema({\n  command: \"images.upload\",\n  description: \"Upload an image to the library — local file path or remote http(s) URL.\",\n  args: {\n    file: { type: \"string\", description: \"Local file path or remote http(s) URL\", required: true },\n    source: { type: \"string\", description: \"Source identifier (default: uploaded)\", required: false },\n    \"content-type\": {\n      type: \"string\",\n      description: \"MIME type (local files only — auto-detected from extension if omitted; ignored for URLs)\",\n      required: false,\n    },\n    \"external-id\": {\n      type: \"string\",\n      description: \"Provider asset id (URL mode only — enables per-source dedup before bytes are fetched)\",\n      required: false,\n    },\n    \"external-url\": {\n      type: \"string\",\n      description: \"Canonical page URL (URL mode only — parent page for scraped/Google hits, provider page for stock)\",\n      required: false,\n    },\n    \"dry-run\": {\n      type: \"boolean\",\n      description: \"Preview the operation without executing\",\n      required: false,\n      default: false,\n    },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint passed to Gemini describe to bias the generated description and tags\",\n      required: false,\n    },\n  },\n});\n\nfunction isRemoteUrl(value: string): boolean {\n  return /^https?:\\/\\//i.test(value);\n}\n\nexport const uploadCommand = defineCommand({\n  meta: {\n    name: \"upload\",\n    description:\n      \"Upload an image to the library — accepts a local file path OR a remote http(s) URL.\\n\\nLocal: reads bytes, sends to /api/images/upload, content-type auto-detected from extension.\\nRemote: dispatches to /api/images/ingest with hash-dedup on bytes + externalId.\\n\\nExamples:\\n  baker images upload ./logo.png --source uploaded\\n  baker images upload ./cert.png --context 'ISO 27001 badge — enterprise tier'\\n  baker images upload https://acme.com/hero.png --source firecrawl --context 'Acme competitor pricing hero'\",\n  },\n  args: {\n    file: { type: \"positional\", description: \"Local file path or remote http(s) URL\", required: false },\n    source: { type: \"string\", description: \"Source identifier\", required: false },\n    \"content-type\": {\n      type: \"string\",\n      description: \"MIME type (local only — auto-detected if omitted)\",\n      required: false,\n    },\n    \"external-id\": { type: \"string\", description: \"Provider asset id (URL mode only)\", required: false },\n    \"external-url\": { type: \"string\", description: \"Canonical page URL (URL mode only)\", required: false },\n    \"dry-run\": { type: \"boolean\", description: \"Preview without executing\", required: false, default: false },\n    context: { type: \"string\", description: \"Description context hint\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const target = args.file as string | undefined;\n      if (!target) {\n        writeJson({\n          ok: false,\n          error: { code: \"VALIDATION_ERROR\", message: \"File path or URL is required\" },\n        });\n        process.exit(1);\n      }\n\n      if (isRemoteUrl(target)) {\n        await uploadRemote(target, args);\n      } else {\n        await uploadLocal(target, args);\n      }\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n\ntype UploadArgs = Record<string, unknown>;\n\nasync function uploadRemote(target: string, args: UploadArgs): Promise<void> {\n  const source = (args.source as string | undefined) ?? \"uploaded\";\n\n  if (args[\"dry-run\"]) {\n    writeJson({\n      ok: true,\n      dryRun: true,\n      operation: \"images.upload (remote)\",\n      params: {\n        url: target,\n        source,\n        externalId: args[\"external-id\"] ?? null,\n        externalUrl: args[\"external-url\"] ?? null,\n        descriptionContext: args.context ?? null,\n      },\n    });\n    return;\n  }\n\n  const body: ImagesIngestRequest = { url: target, source: source as ImagesIngestRequest[\"source\"] };\n  if (args[\"external-id\"]) body.externalId = args[\"external-id\"] as string;\n  if (args[\"external-url\"]) body.externalUrl = args[\"external-url\"] as string;\n  if (args.context) body.descriptionContext = args.context as string;\n\n  const data = await apiPost<ImagesIngestResponse>(\"/api/images/ingest\", body);\n  writeJson({ ok: true, data });\n}\n\nasync function uploadLocal(target: string, args: UploadArgs): Promise<void> {\n  const contentType = (args[\"content-type\"] as string | undefined) || detectImageContentType(target);\n\n  if (args[\"dry-run\"]) {\n    writeJson({\n      ok: true,\n      dryRun: true,\n      operation: \"images.upload (local)\",\n      params: {\n        file: target,\n        contentType,\n        source: args.source ?? null,\n        descriptionContext: args.context ?? null,\n      },\n    });\n    return;\n  }\n\n  const data = await uploadLocalImage({\n    file: target,\n    contentType,\n    source: args.source as string | undefined,\n    descriptionContext: args.context as string | undefined,\n  });\n  writeJson({ ok: true, data });\n}\n"],"mappings":"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","names":[]}

package/dist/upload-SSOPA7ZT.js

@@ -0,0 +1,126 @@
+import {
+  runVideoIngest
+} from "./chunk-SJDPHVGE.js";
+import "./chunk-FKOECEVC.js";
+import {
+  detectVideoContentType,
+  uploadLocalVideo
+} from "./chunk-KNY76UGC.js";
+import "./chunk-VVZBBKRC.js";
+import "./chunk-XWH7CCBL.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-WYCVJIHD.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-XML7AJM3.js";
+import {
+  ApiError
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/upload.ts
+import { stat } from "fs/promises";
+import { basename } from "path";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "videos.upload",
+  description: "Upload a video to Baker \u2014 a local file (via Mux direct upload) or a remote http(s) URL.",
+  args: {
+    file: { type: "string", description: "Local video file path, or a remote http(s) URL", required: true },
+    "content-type": {
+      type: "string",
+      description: "MIME type (auto-detected from extension if omitted)",
+      required: false
+    },
+    context: {
+      type: "string",
+      description: "What this clip is and what it is for. Feeds the analysis, so it is the single highest-leverage flag here. Example: --context 'Customer testimonial from Maria, shot on her phone for the Q3 retargeting push'",
+      required: false
+    },
+    "dry-run": {
+      type: "boolean",
+      description: "Preview the operation without executing",
+      required: false,
+      default: false
+    }
+  }
+});
+function isRemoteUrl(value) {
+  return /^https?:\/\//i.test(value);
+}
+var uploadCommand = defineCommand({
+  meta: {
+    name: "upload",
+    description: "Upload a video to Baker \u2014 accepts a local file path OR a remote http(s) URL.\n\nLocal: auto-detects content type and uploads via Mux direct upload.\nRemote: hands off to `videos ingest` (direct fetch, or download-then-upload for a YouTube/TikTok/Vimeo page).\n\nExamples:\n  baker videos upload ./demo.mp4\n  baker videos upload https://www.youtube.com/watch?v=abc123"
+  },
+  args: {
+    file: { type: "positional", description: "Local video file path or remote http(s) URL", required: false },
+    "content-type": { type: "string", description: "MIME type (local only \u2014 auto-detected)", required: false },
+    context: {
+      type: "string",
+      description: "What this clip is and what it is for \u2014 who is on camera, which campaign, how it was shot. Start here: the analysis reads it, so it is what makes the clip findable later.",
+      required: false
+    },
+    source: { type: "string", description: "Provenance (URL mode only): url | youtube", required: false },
+    "external-id": { type: "string", description: "Provider asset id (URL mode only)", required: false },
+    "external-url": { type: "string", description: "Canonical page URL (URL mode only)", required: false },
+    "dry-run": { type: "boolean", description: "Preview without executing", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const filePath = args.file;
+      if (!filePath) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "File path or URL is required" } });
+        process.exit(1);
+      }
+      if (isRemoteUrl(filePath)) {
+        await runVideoIngest({
+          url: filePath,
+          source: args.source,
+          externalId: args["external-id"],
+          externalUrl: args["external-url"],
+          context: args.context,
+          dryRun: args["dry-run"] === true
+        });
+        return;
+      }
+      const contentType = args["content-type"] || detectVideoContentType(filePath);
+      const descriptionContext = args.context;
+      if (args["dry-run"]) {
+        const fileStats = await stat(filePath);
+        const originalFilename = basename(filePath);
+        writeJson({
+          ok: true,
+          dryRun: true,
+          operation: "videos.upload",
+          params: { file: filePath, contentType, sizeBytes: fileStats.size, originalFilename, descriptionContext }
+        });
+        return;
+      }
+      const { videoId } = await uploadLocalVideo({ file: filePath, contentType, descriptionContext });
+      writeJson({
+        ok: true,
+        data: { videoId },
+        hints: descriptionContext ? void 0 : [
+          "No --context given. Analysis runs on the frames and audio alone, so who is on camera and which campaign this belongs to will be guessed. Pass --context next time."
+        ]
+      });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  uploadCommand
+};
+//# sourceMappingURL=upload-SSOPA7ZT.js.map

package/dist/upload-SSOPA7ZT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/videos/upload.ts"],"sourcesContent":["import { stat } from \"node:fs/promises\";\nimport { basename } from \"node:path\";\nimport { defineCommand } from \"citty\";\nimport { ApiError } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { detectVideoContentType, uploadLocalVideo } from \"./api.ts\";\nimport { runVideoIngest } from \"./ingest.ts\";\n\nregisterSchema({\n  command: \"videos.upload\",\n  description: \"Upload a video to Baker — a local file (via Mux direct upload) or a remote http(s) URL.\",\n  args: {\n    file: { type: \"string\", description: \"Local video file path, or a remote http(s) URL\", required: true },\n    \"content-type\": {\n      type: \"string\",\n      description: \"MIME type (auto-detected from extension if omitted)\",\n      required: false,\n    },\n    context: {\n      type: \"string\",\n      description:\n        \"What this clip is and what it is for. Feeds the analysis, so it is the single highest-leverage flag here. Example: --context 'Customer testimonial from Maria, shot on her phone for the Q3 retargeting push'\",\n      required: false,\n    },\n    \"dry-run\": {\n      type: \"boolean\",\n      description: \"Preview the operation without executing\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nfunction isRemoteUrl(value: string): boolean {\n  return /^https?:\\/\\//i.test(value);\n}\n\nexport const uploadCommand = defineCommand({\n  meta: {\n    name: \"upload\",\n    description:\n      \"Upload a video to Baker — accepts a local file path OR a remote http(s) URL.\\n\\nLocal: auto-detects content type and uploads via Mux direct upload.\\nRemote: hands off to `videos ingest` (direct fetch, or download-then-upload for a YouTube/TikTok/Vimeo page).\\n\\nExamples:\\n  baker videos upload ./demo.mp4\\n  baker videos upload https://www.youtube.com/watch?v=abc123\",\n  },\n  args: {\n    file: { type: \"positional\", description: \"Local video file path or remote http(s) URL\", required: false },\n    \"content-type\": { type: \"string\", description: \"MIME type (local only — auto-detected)\", required: false },\n    context: {\n      type: \"string\",\n      description:\n        \"What this clip is and what it is for — who is on camera, which campaign, how it was shot. Start here: the analysis reads it, so it is what makes the clip findable later.\",\n      required: false,\n    },\n    source: { type: \"string\", description: \"Provenance (URL mode only): url | youtube\", required: false },\n    \"external-id\": { type: \"string\", description: \"Provider asset id (URL mode only)\", required: false },\n    \"external-url\": { type: \"string\", description: \"Canonical page URL (URL mode only)\", required: false },\n    \"dry-run\": { type: \"boolean\", description: \"Preview without executing\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const filePath = args.file as string | undefined;\n      if (!filePath) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"File path or URL is required\" } });\n        process.exit(1);\n      }\n\n      // A URL is the ingest command's job — same routing `images upload` does, so\n      // one verb covers both and a pasted link never fails with ENOENT.\n      if (isRemoteUrl(filePath)) {\n        // Every option this verb shares with `ingest` is forwarded. `--context`\n        // in particular: both commands call it the highest-leverage flag, and\n        // dropping it here meant a pasted link was analysed with strictly less\n        // to go on than the same file uploaded by hand — silently, since no\n        // error fired and the \"no context given\" hint did not either.\n        await runVideoIngest({\n          url: filePath,\n          source: args.source as string | undefined,\n          externalId: args[\"external-id\"] as string | undefined,\n          externalUrl: args[\"external-url\"] as string | undefined,\n          context: args.context as string | undefined,\n          dryRun: args[\"dry-run\"] === true,\n        });\n        return;\n      }\n\n      const contentType = (args[\"content-type\"] as string | undefined) || detectVideoContentType(filePath);\n      const descriptionContext = args.context as string | undefined;\n\n      if (args[\"dry-run\"]) {\n        const fileStats = await stat(filePath);\n        const originalFilename = basename(filePath);\n        writeJson({\n          ok: true,\n          dryRun: true,\n          operation: \"videos.upload\",\n          params: { file: filePath, contentType, sizeBytes: fileStats.size, originalFilename, descriptionContext },\n        });\n        return;\n      }\n\n      const { videoId } = await uploadLocalVideo({ file: filePath, contentType, descriptionContext });\n\n      writeJson({\n        ok: true,\n        data: { videoId },\n        hints: descriptionContext\n          ? undefined\n          : [\n              \"No --context given. Analysis runs on the frames and audio alone, so who is on camera and which campaign this belongs to will be guessed. Pass --context next time.\",\n            ],\n      });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\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":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,YAAY;AACrB,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAO9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,UAAU,aAAa,kDAAkD,UAAU,KAAK;AAAA,IACtG,gBAAgB;AAAA,MACd,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,EACF;AACF,CAAC;AAED,SAAS,YAAY,OAAwB;AAC3C,SAAO,gBAAgB,KAAK,KAAK;AACnC;AAEO,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,cAAc,aAAa,+CAA+C,UAAU,MAAM;AAAA,IACxG,gBAAgB,EAAE,MAAM,UAAU,aAAa,+CAA0C,UAAU,MAAM;AAAA,IACzG,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,QAAQ,EAAE,MAAM,UAAU,aAAa,6CAA6C,UAAU,MAAM;AAAA,IACpG,eAAe,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,IACnG,gBAAgB,EAAE,MAAM,UAAU,aAAa,sCAAsC,UAAU,MAAM;AAAA,IACrG,WAAW,EAAE,MAAM,WAAW,aAAa,6BAA6B,UAAU,OAAO,SAAS,MAAM;AAAA,EAC1G;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,WAAW,KAAK;AACtB,UAAI,CAAC,UAAU;AACb,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,SAAS,+BAA+B,EAAE,CAAC;AACrG,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAIA,UAAI,YAAY,QAAQ,GAAG;AAMzB,cAAM,eAAe;AAAA,UACnB,KAAK;AAAA,UACL,QAAQ,KAAK;AAAA,UACb,YAAY,KAAK,aAAa;AAAA,UAC9B,aAAa,KAAK,cAAc;AAAA,UAChC,SAAS,KAAK;AAAA,UACd,QAAQ,KAAK,SAAS,MAAM;AAAA,QAC9B,CAAC;AACD;AAAA,MACF;AAEA,YAAM,cAAe,KAAK,cAAc,KAA4B,uBAAuB,QAAQ;AACnG,YAAM,qBAAqB,KAAK;AAEhC,UAAI,KAAK,SAAS,GAAG;AACnB,cAAM,YAAY,MAAM,KAAK,QAAQ;AACrC,cAAM,mBAAmB,SAAS,QAAQ;AAC1C,kBAAU;AAAA,UACR,IAAI;AAAA,UACJ,QAAQ;AAAA,UACR,WAAW;AAAA,UACX,QAAQ,EAAE,MAAM,UAAU,aAAa,WAAW,UAAU,MAAM,kBAAkB,mBAAmB;AAAA,QACzG,CAAC;AACD;AAAA,MACF;AAEA,YAAM,EAAE,QAAQ,IAAI,MAAM,iBAAiB,EAAE,MAAM,UAAU,aAAa,mBAAmB,CAAC;AAE9F,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ,MAAM,EAAE,QAAQ;AAAA,QAChB,OAAO,qBACH,SACA;AAAA,UACE;AAAA,QACF;AAAA,MACN,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,UAAI,eAAe,UAAU;AAC3B,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,gBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/upscale-YWRLFU22.js

@@ -0,0 +1,109 @@
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/upscale.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.upscale",
+  description: "Upscale a library image via the backend (Replicate, cost-tracked). Waits for completion by default. The image must be status 'ready' and raster (not SVG/AVIF).",
+  args: {
+    "image-id": { type: "string", description: "Library image ID to upscale", required: true },
+    "max-wait": {
+      type: "number",
+      description: "Max wait ms (default 120000 = 2 min). Set 0 to fire-and-forget.",
+      required: false,
+      default: 12e4
+    },
+    remove: {
+      type: "boolean",
+      description: "Drop the upscaled copy and go back to the original instead (free, applies immediately)",
+      required: false,
+      default: false
+    }
+  }
+});
+var POLL_INTERVAL_MS = 1500;
+var upscaleCommand = defineCommand({
+  meta: {
+    name: "upscale",
+    description: "Upscale a library image via the Convex backend (Replicate, cost-tracked at $0.05/image). Waits for completion by default.\n\nExample: baker images upscale j571abc123def\nExample: baker images upscale j571abc123def --max-wait 0   # fire-and-forget\nExample: baker images upscale j571abc123def --remove      # back to the original"
+  },
+  args: {
+    "image-id": { type: "positional", description: "Library image ID", required: false },
+    "max-wait": { type: "string", description: "Max wait ms (default 120000, 0 = no wait)", required: false },
+    remove: {
+      type: "boolean",
+      description: "Drop the upscaled copy and go back to the original instead",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const imageId = args["image-id"];
+      if (!imageId) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "image-id is required" } });
+        process.exit(1);
+      }
+      if (args.remove) {
+        const data = await apiPost("/api/images/upscale/remove", { id: imageId });
+        writeJson({
+          ok: true,
+          data,
+          hints: [
+            "Back to the original. Its description is being re-read from the original; already applied \u2014 publishing or discarding this chat does not undo it."
+          ]
+        });
+        return;
+      }
+      const maxWait = args["max-wait"] ? Number(args["max-wait"]) : 12e4;
+      await apiPost("/api/images/upscale", { imageId });
+      if (maxWait === 0) {
+        writeJson({ ok: true, data: { imageId, status: "processing" } });
+        return;
+      }
+      const start = Date.now();
+      while (Date.now() - start < maxWait) {
+        const doc = await apiGet("/api/images/get", { id: imageId });
+        if (doc.upscaleConfig?.status === "completed") {
+          writeJson({ ok: true, data: { imageId, status: "completed", image: doc } });
+          return;
+        }
+        if (!doc.upscaleConfig) {
+          writeJson({
+            ok: false,
+            error: { code: "IMAGE_PROCESSING_ERROR", message: "Upscale failed" }
+          });
+          process.exit(1);
+        }
+        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+      }
+      writeJson({ ok: false, error: { code: "TIMEOUT", message: `Image not ready within ${maxWait}ms` } });
+      process.exit(1);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({
+        ok: false,
+        error: { code: "INTERNAL_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+      });
+      process.exit(1);
+    }
+  }
+});
+export {
+  upscaleCommand
+};
+//# sourceMappingURL=upscale-YWRLFU22.js.map

package/dist/upscale-YWRLFU22.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/upscale.ts"],"sourcesContent":["import type { ImageDoc, ImagesUpscaleRemoveResponse, ImagesUpscaleResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiGet, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\n\nregisterSchema({\n  command: \"images.upscale\",\n  description:\n    \"Upscale a library image via the backend (Replicate, cost-tracked). Waits for completion by default. The image must be status 'ready' and raster (not SVG/AVIF).\",\n  args: {\n    \"image-id\": { type: \"string\", description: \"Library image ID to upscale\", required: true },\n    \"max-wait\": {\n      type: \"number\",\n      description: \"Max wait ms (default 120000 = 2 min). Set 0 to fire-and-forget.\",\n      required: false,\n      default: 120000,\n    },\n    remove: {\n      type: \"boolean\",\n      description: \"Drop the upscaled copy and go back to the original instead (free, applies immediately)\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nconst POLL_INTERVAL_MS = 1500;\n\nexport const upscaleCommand = defineCommand({\n  meta: {\n    name: \"upscale\",\n    description:\n      \"Upscale a library image via the Convex backend (Replicate, cost-tracked at $0.05/image). Waits for completion by default.\\n\\nExample: baker images upscale j571abc123def\\nExample: baker images upscale j571abc123def --max-wait 0   # fire-and-forget\\nExample: baker images upscale j571abc123def --remove      # back to the original\",\n  },\n  args: {\n    \"image-id\": { type: \"positional\", description: \"Library image ID\", required: false },\n    \"max-wait\": { type: \"string\", description: \"Max wait ms (default 120000, 0 = no wait)\", required: false },\n    remove: {\n      type: \"boolean\",\n      description: \"Drop the upscaled copy and go back to the original instead\",\n      required: false,\n      default: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const imageId = args[\"image-id\"] as string | undefined;\n      if (!imageId) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"image-id is required\" } });\n        process.exit(1);\n      }\n      if (args.remove) {\n        const data = await apiPost<ImagesUpscaleRemoveResponse>(\"/api/images/upscale/remove\", { id: imageId });\n        writeJson({\n          ok: true,\n          data,\n          hints: [\n            \"Back to the original. Its description is being re-read from the original; already applied — publishing or discarding this chat does not undo it.\",\n          ],\n        });\n        return;\n      }\n      const maxWait = args[\"max-wait\"] ? Number(args[\"max-wait\"]) : 120000;\n\n      await apiPost<ImagesUpscaleResponse>(\"/api/images/upscale\", { imageId });\n\n      if (maxWait === 0) {\n        writeJson({ ok: true, data: { imageId, status: \"processing\" } });\n        return;\n      }\n\n      const start = Date.now();\n      while (Date.now() - start < maxWait) {\n        const doc = await apiGet<ImageDoc>(\"/api/images/get\", { id: imageId });\n        if (doc.upscaleConfig?.status === \"completed\") {\n          writeJson({ ok: true, data: { imageId, status: \"completed\", image: doc } });\n          return;\n        }\n        // Backend clears upscaleConfig back to undefined on failure instead of an \"error\" status (no such status exists).\n        if (!doc.upscaleConfig) {\n          writeJson({\n            ok: false,\n            error: { code: \"IMAGE_PROCESSING_ERROR\", message: \"Upscale failed\" },\n          });\n          process.exit(1);\n        }\n        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));\n      }\n      writeJson({ ok: false, error: { code: \"TIMEOUT\", message: `Image not ready within ${maxWait}ms` } });\n      process.exit(1);\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({\n        ok: false,\n        error: { code: \"INTERNAL_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" },\n      });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/url-options-QEWKRKZ3.js

@@ -0,0 +1,127 @@
+import {
+  mappingCommandFor,
+  proposeMappingFromTemplate
+} from "./chunk-SSJK7FEV.js";
+import "./chunk-EDLZGTGN.js";
+import {
+  parseApiError
+} from "./chunk-KWAOTV7F.js";
+import {
+  urlOptionsHints
+} from "./chunk-EVYXTT7V.js";
+import {
+  getManagerIdForCustomer,
+  resolveCustomerId,
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-VFIOJD5M.js";
+import "./chunk-XML7AJM3.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/url-options.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/google/mapping-hints.ts
+function observedTemplates(report) {
+  const values = [
+    report.account.final_url_suffix,
+    report.account.tracking_url_template,
+    ...report.campaigns.overrides.flatMap((campaign) => [campaign.final_url_suffix, campaign.tracking_url_template])
+  ];
+  return values.flatMap((value) => value.state === "set" ? [value.value] : []);
+}
+function mappingHints(report) {
+  const proposed = {};
+  const unexplained = /* @__PURE__ */ new Map();
+  for (const template of observedTemplates(report)) {
+    const proposal = proposeMappingFromTemplate(template, "google");
+    Object.assign(proposed, proposal.proposed);
+    for (const param of proposal.unexplained) unexplained.set(param.name, param.value);
+  }
+  const hints = [];
+  const command = mappingCommandFor("google", proposed);
+  if (command !== "") {
+    hints.push(
+      `These URLs carry campaign parameters Baker does not read yet: ${Object.keys(proposed).join(", ")}. Until it is told, their values are not stored at all \u2014 only that the name appeared \u2014 so every keyword and campaign breakdown for this account will come back empty rather than wrong. The placeholders say what each one is, so run: ${command}`
+    );
+  }
+  if (unexplained.size > 0) {
+    const named = [...unexplained].map(([name, value]) => `${name}=${value}`).join(", ");
+    hints.push(
+      `These carry something no placeholder explains: ${named}. Do not guess \u2014 if it is a dimension, map it by name with \`baker analytics map --platform google --set <name>=<role>\`; if it is a session token or a cache buster, \`=ignore\` stops it being listed as something to deal with.`
+    );
+  }
+  return hints;
+}
+
+// src/commands/ads/google/url-options.ts
+registerSchema({
+  command: "ads.google.url-options",
+  description: "Report the Google Ads URL/tracking options in force: the account-level final URL suffix and tracking template, plus every campaign that overrides them. Every value is tagged set | not_set | not_read, so an unread level is never mistaken for an unset one. Read this before answering any UTM / tracking-parameter question. Compact by default: only overriding campaigns are listed; --full lists every campaign read.",
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "List every campaign read, including those with no override of their own.",
+      required: false
+    },
+    "no-cache": { type: "boolean", description: "Skip the read cache", required: false }
+  }
+});
+var urlOptionsCommand = defineCommand({
+  meta: {
+    name: "url-options",
+    description: `Show the URL/tracking options in force \u2014 account-level final URL suffix and tracking template, plus campaign overrides.
+
+Start here for any "add utm_\u2026 / tracking parameter / agency tag" question: it tells you which level already carries one.
+Each value is tagged: set | not_set (Google carries no value there) | not_read (never observed \u2014 NOT a finding).
+Judgment on which level to use and what to put in it: /google-ads-playbook \u2192 18-naming-utm.md.
+
+Examples:
+  baker ads google url-options --customer-id 1234567890
+  baker ads google url-options --customer-id 1234567890 --full`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID (10 digits)", required: false },
+    full: { type: "boolean", description: "List every campaign read, not only the overriding ones", required: false },
+    "no-cache": { type: "boolean", description: "Skip the read cache", required: false }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    try {
+      const managerId = getManagerIdForCustomer(customerId);
+      const data = await apiPost("/api/ads/google/url-options", {
+        customerId,
+        ...managerId ? { managerId } : {},
+        ...args.full ? { full: true } : {},
+        ...args["no-cache"] ? { skipCache: true } : {}
+      });
+      const hints = [...urlOptionsHints(data), ...mappingHints(data)];
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseApiError(err.message, "", customerId, err.code));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  urlOptionsCommand
+};
+//# sourceMappingURL=url-options-QEWKRKZ3.js.map

package/dist/url-options-QEWKRKZ3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/url-options.ts","../src/commands/ads/google/mapping-hints.ts"],"sourcesContent":["import { type GoogleUrlOptionsResponse, urlOptionsHints } from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { getManagerIdForCustomer } from \"../cache.ts\";\nimport { resolveCustomerId, writeAdsJson, writeJsonEnvelope } from \"../output.ts\";\nimport { parseApiError } from \"./error-parser.ts\";\nimport { mappingHints } from \"./mapping-hints.ts\";\n\nregisterSchema({\n  command: \"ads.google.url-options\",\n  description:\n    \"Report the Google Ads URL/tracking options in force: the account-level final URL suffix and tracking template, plus every campaign that overrides them. Every value is tagged set | not_set | not_read, so an unread level is never mistaken for an unset one. Read this before answering any UTM / tracking-parameter question. Compact by default: only overriding campaigns are listed; --full lists every campaign read.\",\n  args: {\n    \"customer-id\": {\n      type: \"string\",\n      description: \"Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.\",\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"List every campaign read, including those with no override of their own.\",\n      required: false,\n    },\n    \"no-cache\": { type: \"boolean\", description: \"Skip the read cache\", required: false },\n  },\n});\n\nexport const urlOptionsCommand = defineCommand({\n  meta: {\n    name: \"url-options\",\n    description: `Show the URL/tracking options in force — account-level final URL suffix and tracking template, plus campaign overrides.\n\nStart here for any \"add utm_… / tracking parameter / agency tag\" question: it tells you which level already carries one.\nEach value is tagged: set | not_set (Google carries no value there) | not_read (never observed — NOT a finding).\nJudgment on which level to use and what to put in it: /google-ads-playbook → 18-naming-utm.md.\n\nExamples:\n  baker ads google url-options --customer-id 1234567890\n  baker ads google url-options --customer-id 1234567890 --full`,\n  },\n  args: {\n    \"customer-id\": { type: \"string\", description: \"Google Ads customer ID (10 digits)\", required: false },\n    full: { type: \"boolean\", description: \"List every campaign read, not only the overriding ones\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip the read cache\", required: false },\n  },\n  run: async ({ args }) => {\n    const customerId = await resolveCustomerId(args);\n    try {\n      const managerId = getManagerIdForCustomer(customerId);\n      const data = await apiPost<GoogleUrlOptionsResponse>(\"/api/ads/google/url-options\", {\n        customerId,\n        ...(managerId ? { managerId } : {}),\n        ...(args.full ? { full: true } : {}),\n        ...(args[\"no-cache\"] ? { skipCache: true } : {}),\n      });\n      const hints = [...urlOptionsHints(data), ...mappingHints(data)];\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        // `err.code` is what tells `parseApiError` a missing Google Ads connection\n        // apart from a fixable query error. Dropped, a never-connected account gets\n        // the query-correction path instead — and since the query here is empty, the\n        // \"add a LIMIT\" rule matches and hands the agent a `correctedCommand` it is\n        // told to run, sending it off to execute an empty GAQL query instead of\n        // asking the user to connect.\n        writeAdsJson(parseApiError(err.message, \"\", customerId, err.code));\n        process.exit(1);\n      }\n      writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n","/**\n * The bridge between a Google tracking template and Baker's reading of it.\n *\n * These two facts sat one command apart and nothing joined them: `url-options`\n * reports that the account's URLs carry `searchword={keyword}`, and\n * `baker analytics map` is what makes Baker read `searchword` as a keyword.\n * Until it is told, the values are not stored at all — only the fact that the\n * name appeared — so every keyword report for that account is empty and reads\n * as \"this campaign brought no keywords\" rather than \"nobody has said what\n * `searchword` is\".\n *\n * The template is the client's own answer, already written down, so this is\n * naming what arrives rather than proposing a change to their account — which\n * `baker analytics` refuses to do and this does not do either.\n */\nimport type { GoogleUrlOptionsResponse } from \"@baker/api/ads-google\";\nimport type { AdParamRole } from \"@baker/api/analytics\";\nimport { mappingCommandFor, proposeMappingFromTemplate } from \"@baker/api/analytics\";\n\n/** Every template and suffix this report actually observed, at any level. */\nfunction observedTemplates(report: GoogleUrlOptionsResponse): string[] {\n  const values = [\n    report.account.final_url_suffix,\n    report.account.tracking_url_template,\n    ...report.campaigns.overrides.flatMap((campaign) => [campaign.final_url_suffix, campaign.tracking_url_template]),\n  ];\n  return values.flatMap((value) => (value.state === \"set\" ? [value.value] : []));\n}\n\nexport function mappingHints(report: GoogleUrlOptionsResponse): string[] {\n  const proposed: Record<string, AdParamRole> = {};\n  const unexplained = new Map<string, string>();\n\n  for (const template of observedTemplates(report)) {\n    const proposal = proposeMappingFromTemplate(template, \"google\");\n    Object.assign(proposed, proposal.proposed);\n    for (const param of proposal.unexplained) unexplained.set(param.name, param.value);\n  }\n\n  const hints: string[] = [];\n  const command = mappingCommandFor(\"google\", proposed);\n  if (command !== \"\") {\n    hints.push(\n      `These URLs carry campaign parameters Baker does not read yet: ${Object.keys(proposed).join(\", \")}. Until it is told, their values are not stored at all — only that the name appeared — so every keyword and campaign breakdown for this account will come back empty rather than wrong. The placeholders say what each one is, so run: ${command}`,\n    );\n  }\n  if (unexplained.size > 0) {\n    const named = [...unexplained].map(([name, value]) => `${name}=${value}`).join(\", \");\n    hints.push(\n      `These carry something no placeholder explains: ${named}. Do not guess — if it is a dimension, map it by name with \\`baker analytics map --platform google --set <name>=<role>\\`; if it is a session token or a cache buster, \\`=ignore\\` stops it being listed as something to deal with.`,\n    );\n  }\n  return hints;\n}\n"],"mappings":"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","names":[]}