@koda-sl/baker-cli 0.550.0 → 0.552.0

package/dist/add-4JUXMRNA.js

@@ -0,0 +1,148 @@
+import {
+  compactSource,
+  reportError
+} from "./chunk-PFNUAV22.js";
+import {
+  mediaSourcePlatformSchema,
+  mediaSourceRefreshIntervalSchema,
+  mediaSourcesAddRequestSchema
+} from "./chunk-QV6AST5T.js";
+import {
+  socialPersonRoleSchema
+} from "./chunk-WCU362Z6.js";
+import {
+  apiPost
+} from "./chunk-OQ7CLFEL.js";
+import "./chunk-S3TBE37M.js";
+import "./chunk-O4OPH3ZE.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-VYEFXIEM.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/media-sources/add.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "media-sources.add",
+  description: "Follow a public social account \u2014 a company page or a key person (CEO, CTO, head of sales\u2026) \u2014 on Instagram, TikTok, YouTube (videos only), LinkedIn (company pages and people's /in/ profiles) or Facebook. Its recent posts (up to a year back) go into Posts (`baker posts list`, text-only ones included, with likes and comments and whether each can run as an ad), and their images and videos into the libraries. A Google Drive folder is not added here: ask for it with request_connection (platform google-drive, choose media-folder) and the user picks it in the chat. Everything is described and made searchable in the background. Applies immediately and shows on the chat as an already-applied change. Adding a source that is already connected is a no-op.",
+  args: {
+    input: {
+      type: "string",
+      description: "Profile URL (names its own platform), or @handle together with --platform",
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: `Needed only for a bare handle: ${mediaSourcePlatformSchema.options.join("|")}`,
+      required: false
+    },
+    every: {
+      type: "string",
+      description: `Auto-sync cadence: ${mediaSourceRefreshIntervalSchema.options.join("|")} (default weekly for a page, daily for a person)`,
+      required: false
+    },
+    person: {
+      type: "string",
+      description: "Following a key person rather than a page: their name. A LinkedIn /in/ profile is always a person; pass this with --role for one on another platform.",
+      required: false
+    },
+    role: {
+      type: "string",
+      description: `Who they are: ${socialPersonRoleSchema.options.join("|")}. Scheduled agents can wait for "any CEO's post".`,
+      required: false,
+      enum: [...socialPersonRoleSchema.options]
+    },
+    title: { type: "string", description: "Their job title as written, e.g. 'VP Sales EMEA'", required: false },
+    "not-own": {
+      type: "boolean",
+      description: "A partner, a creator or another brand \u2014 not the company's own page or people. Its posts need the author's OK to run as ads.",
+      required: false
+    }
+  }
+});
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: 'Follow a social account \u2014 the company\'s page, or a key person such as the CEO \u2014 on Instagram, TikTok, YouTube, LinkedIn or Facebook. Start here with the profile URL. Its posts land in `baker posts`, its images and videos in the libraries. A Google Drive folder is never added by link: call request_connection with platform google-drive and choose media-folder, and the user picks the folder in the chat.\n\nExamples:\n  baker media-sources add https://www.linkedin.com/company/acme\n  baker media-sources add https://www.linkedin.com/in/jane-doe --role ceo\n  baker media-sources add https://www.tiktok.com/@acme\n  baker media-sources add @creator --platform instagram --person "Ana Ruiz" --role creator --not-own'
+  },
+  args: {
+    input: { type: "positional", description: "Profile URL or @handle", required: true },
+    platform: {
+      type: "string",
+      description: "instagram|tiktok|youtube|linkedin|facebook \u2014 only for a bare handle",
+      required: false
+    },
+    every: { type: "string", description: "Auto-sync: never|daily|weekly|monthly", required: false },
+    person: {
+      type: "string",
+      description: "A key person's name (implied for a LinkedIn /in/ profile)",
+      required: false
+    },
+    role: { type: "string", description: socialPersonRoleSchema.options.join("|"), required: false },
+    title: { type: "string", description: "Their job title", required: false },
+    "not-own": { type: "boolean", description: "A partner, creator or another brand", required: false }
+  },
+  run: async ({ args }) => {
+    const parsed = mediaSourcesAddRequestSchema.safeParse({
+      input: String(args.input ?? ""),
+      platform: args.platform ? String(args.platform).toLowerCase() : void 0,
+      every: args.every ? String(args.every).toLowerCase() : void 0,
+      person: args.person ? String(args.person) : void 0,
+      role: args.role ? String(args.role).toLowerCase() : void 0,
+      title: args.title ? String(args.title) : void 0,
+      own: args["not-own"] === true ? false : void 0
+    });
+    if (!parsed.success) {
+      const issue = parsed.error.issues[0];
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: issue ? `${issue.path.join(".") || "input"}: ${issue.message}` : "Invalid request"
+        }
+      });
+      process.exit(1);
+    }
+    try {
+      const data = await apiPost("/api/media-sources/add", parsed.data, {
+        timeoutMs: 12e4
+      });
+      const hints = addHints(data);
+      writeJson({
+        ok: true,
+        data: { created: data.created, source: compactSource(data.source), name: data.profile.displayName },
+        hints
+      });
+    } catch (err) {
+      reportError(err, parsed.data.input);
+    }
+  }
+});
+function addHints(data) {
+  const hints = data.profile.isPrivate ? [`Followed ${data.source.label} on LinkedIn.`] : [
+    data.created ? `Connected ${data.source.label} on ${data.source.platformLabel}. Its posts are importing in the background \u2014 they become searchable with \`baker images search\` / \`baker videos search\` as each one is analysed. Check progress with \`baker media-sources list\`.` : `${data.source.label} on ${data.source.platformLabel} was already connected; a fresh import was started if one wasn't running.`
+  ];
+  if (data.profile.isPrivate) {
+    hints.push(
+      `${data.profile.displayName}'s profile is private (or the link is wrong \u2014 LinkedIn answers both the same way), so Baker can't read their posts on its own. Add each post by its link: \`baker posts add <post link>\` (the user copies it from the post's \u22EF menu \u2192 Copy link). If the link was wrong: \`baker media-sources remove ${data.source.key}\`.`
+    );
+  } else {
+    hints.push(`Their posts: \`baker posts list --account ${data.source.key}\`.`);
+  }
+  if (data.source.platform === "youtube") {
+    hints.push(
+      "YouTube feeds the video library only, newest first, a batch per sync; videos over 20 minutes are skipped."
+    );
+  }
+  if (data.source.refreshInterval === "never" && !data.profile.isPrivate) {
+    hints.push(
+      `Auto-sync is off. If the user wants new posts to keep arriving: \`baker media-sources schedule ${data.source.key} --every weekly\`.`
+    );
+  }
+  return hints;
+}
+export {
+  addCommand
+};
+//# sourceMappingURL=add-4JUXMRNA.js.map

package/dist/add-4NK4DIER.js

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

package/dist/add-AO3F6EJY.js

@@ -0,0 +1,107 @@
+import {
+  compactSource,
+  reportError,
+  reportInvalid
+} from "./chunk-4HHIW7PR.js";
+import {
+  testimonialSourceRefreshIntervalSchema,
+  testimonialSourceTypeSchema,
+  testimonialSourcesAddRequestSchema
+} from "./chunk-RCNAKWK7.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-OQ7CLFEL.js";
+import "./chunk-S3TBE37M.js";
+import "./chunk-O4OPH3ZE.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-VYEFXIEM.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/add.ts
+import { defineCommand } from "citty";
+var SITES = testimonialSourceTypeSchema.options.join("|");
+registerSchema({
+  command: "testimonials.sources.add",
+  description: "Add a review page as a testimonial source \u2014 Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store or Google Play. Pass the page's link (it names its own site), or a business name for Google Maps. Its reviews (up to 700) are imported, tagged and made searchable in the background over the next minutes. Each imported review costs a little, so add only the client's own listings the user asked for. Applies immediately and shows on the chat as an already-applied change. Adding a listing that is already a source is a no-op that starts a fresh import.",
+  args: {
+    input: {
+      type: "string",
+      description: "The review page's link, or a business name (Google Maps only)",
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: `Only to force a site: ${SITES}. A bare domain with trustpilot is that company's Trustpilot page.`,
+      required: false
+    },
+    every: {
+      type: "string",
+      description: `Auto-sync cadence: ${testimonialSourceRefreshIntervalSchema.options.join("|")} (default never)`,
+      required: false
+    }
+  }
+});
+function addSourceHints(input, { created, source }) {
+  const hints = [
+    created ? `Added ${source.label} on ${source.platformLabel}. Its reviews are importing in the background \u2014 they become searchable with \`baker testimonials search\` as each one is analysed, usually within a few minutes. Don't wait on them in this turn; check with \`baker testimonials sources list\`.` : `${source.label} on ${source.platformLabel} was already a source; a fresh import was started if one wasn't running.`
+  ];
+  if (created && source.platform === "google" && !/^https?:\/\/|\.[a-z]{2,}\//i.test(input.trim())) {
+    hints.push(
+      `Matched the name to ${source.label} on Google Maps (${source.pageUrl ?? "no link"}). If that is not the client's business, run \`baker testimonials sources remove ${source.id}\` at once and add the listing's Google Maps link instead.`
+    );
+  }
+  if (source.refreshInterval === "never") {
+    hints.push(
+      `Auto-sync is off. If the user wants new reviews to keep arriving: \`baker testimonials sources schedule ${source.id} --every monthly\`.`
+    );
+  }
+  return hints;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: `Add a review page as a testimonial source. Start here with the page's link; for Google Maps a business name also works.
+
+Examples:
+  baker testimonials sources add https://www.yelp.com/biz/acme-bakery-madrid
+  baker testimonials sources add https://www.g2.com/products/acme --every monthly
+  baker testimonials sources add "Acme Bakery Madrid"          # Google Maps, found by name
+  baker testimonials sources add acme.com --platform trustpilot`
+  },
+  args: {
+    input: { type: "positional", description: "Review page link, or a business name for Google Maps", required: true },
+    platform: { type: "string", description: `Force a site: ${SITES}`, required: false },
+    every: { type: "string", description: "Auto-sync: never|daily|weekly|monthly", required: false }
+  },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesAddRequestSchema.safeParse({
+      input: String(args.input ?? ""),
+      platform: args.platform ? String(args.platform).toLowerCase().replace(/[\s-]/g, "_") : void 0,
+      every: args.every ? String(args.every).toLowerCase() : void 0
+    });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/add", parsed.data, {
+        timeoutMs: 12e4
+      });
+      const hints = addSourceHints(parsed.data.input, data);
+      writeJson({ ok: true, data: { created: data.created, source: compactSource(data.source) }, hints });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addCommand,
+  addSourceHints
+};
+//# sourceMappingURL=add-AO3F6EJY.js.map

package/dist/add-NQUHPVZ5.js

@@ -0,0 +1,81 @@
+import {
+  PLATFORM_NAMES,
+  reportError
+} from "./chunk-P4TA3B4C.js";
+import {
+  apiPost
+} from "./chunk-OQ7CLFEL.js";
+import "./chunk-S3TBE37M.js";
+import "./chunk-O4OPH3ZE.js";
+import {
+  brandAccountInput,
+  registerSchema,
+  writeJson
+} from "./chunk-VYEFXIEM.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/add.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.add",
+  description: "Add a brand to Baker's ads library WITHOUT following it: every account its website links, on every platform (Meta, LinkedIn, TikTok, Google Ads) and in every country, collected into the library so `profile`, `ads` and `landings` can read it. Nobody follows it and it never shows in anyone's feed. For a brand you study rather than track \u2014 above all a client being set up, from an organization's workspace. Start here: baker winning-ads advertisers \"<domain>\"; when the brand is not there, baker winning-ads add \"<domain>\". A company's own competitor is `follow`, not this.",
+  args: {
+    input: {
+      type: "string",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    }
+  }
+});
+function readNext(advertiserId) {
+  return `baker winning-ads profile ${advertiserId} (the platforms it runs on, how many ads, its estimated spend, its landing pages), then baker winning-ads ads ${advertiserId} --running running for the creatives and baker winning-ads landings ${advertiserId} --analyse for what each landing sells and how`;
+}
+function addHints(data) {
+  const names = data.suggestions.map((s) => `${s.name} (${PLATFORM_NAMES[s.platform]})`).join(", ");
+  if (data.status === "unconfirmed") {
+    const [first] = data.suggestions;
+    return [
+      `Nothing added: we found no account we're sure is this brand's, only accounts named like it: ${names}. Check each one's ad library, then add the brand's own by its link, e.g. baker winning-ads add "${first ? brandAccountInput(first) : ""}". Or retry with the brand's website.`
+    ];
+  }
+  if (data.status === "ambiguous" || data.advertiser_id === null) {
+    return [
+      "These accounts belong to more than one brand already in the library. Read the one in `candidates` that is this brand (its name and website), with baker winning-ads profile <advertiser_id>."
+    ];
+  }
+  const hints = data.collecting > 0 ? [
+    `Its ads are being collected from ${data.collecting} account${data.collecting === 1 ? "" : "s"}: a few minutes, longer for a big advertiser. Read the other sources meanwhile, then ${readNext(data.advertiser_id)}. An empty profile means they are still arriving.`
+  ] : [`Already in the library. Read ${readNext(data.advertiser_id)}.`];
+  if (data.suggestions.length > 0) {
+    hints.push(
+      `Also found accounts only named like this brand, not added: ${names}. Add one that is its own (another country's page) with baker winning-ads add "<its link>".`
+    );
+  }
+  return hints;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: `Add a brand's ads to Baker's library without following it, so profile, ads and landings can read them. Example: baker winning-ads add "barkibu.com"`
+  },
+  args: {
+    input: {
+      type: "positional",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiPost("/api/ad-library/add", { input: String(args.input) });
+      writeJson({ ok: true, data, hints: addHints(data) });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addCommand,
+  addHints
+};
+//# sourceMappingURL=add-NQUHPVZ5.js.map