@koda-sl/baker-cli 0.498.0 → 0.499.0

package/dist/add-6TDY6LPL.js

@@ -0,0 +1,148 @@
+import {
+  compactSource,
+  reportError
+} from "./chunk-FQWZIYFC.js";
+import {
+  mediaSourcePlatformSchema,
+  mediaSourceRefreshIntervalSchema,
+  mediaSourcesAddRequestSchema
+} from "./chunk-CAZGM2NX.js";
+import {
+  socialPersonRoleSchema
+} from "./chunk-NZS3KEQ2.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-6TDY6LPL.js.map

package/dist/add-CGHX6D4N.js

@@ -0,0 +1,97 @@
+import {
+  reportError
+} from "./chunk-XV5TBA5P.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-CGHX6D4N.js.map

package/dist/add-EVFOCMOM.js

@@ -0,0 +1,81 @@
+import {
+  PLATFORM_NAMES,
+  reportError
+} from "./chunk-XB63MQ6E.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  brandAccountInput,
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-EVFOCMOM.js.map

package/dist/add-RNU2PVXW.js

@@ -0,0 +1,80 @@
+import {
+  nextStepHints,
+  reportError,
+  validationError
+} from "./chunk-JRCYNIXC.js";
+import {
+  postsAddRequestSchema
+} from "./chunk-NZS3KEQ2.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/posts/add.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "posts.add",
+  description: "Add one post by its link \u2014 the way in for a private profile's posts (many people's LinkedIn profiles are), or for a post by someone the company doesn't follow. Any link to the post works; the embed link isn't needed. Reads the post's text, author and numbers, works out whether it can run as an ad, and imports its images and videos into the libraries (not a YouTube video: the hint says how). Applies immediately and shows on the chat as an already-applied change. Costs one read.",
+  args: {
+    url: { type: "string", description: "The post's link", required: true },
+    media: {
+      type: "boolean",
+      description: "Import its images and videos into the libraries (default); --no-media records the post only",
+      required: false
+    }
+  }
+});
+function youtubeVideoId(url) {
+  return url.match(/(?:[?&]v=|\/shorts\/|youtu\.be\/)([\w-]{11})/)?.[1];
+}
+function addHints(data, link) {
+  const hints = nextStepHints(data.post);
+  if (data.media && data.media.failed > 0) {
+    hints.push(
+      `${data.media.failed} of its files couldn't be fetched, so they aren't in the libraries; the post itself is saved.`
+    );
+  }
+  const videoId = data.post.platform === "youtube" ? youtubeVideoId(link) : void 0;
+  if (videoId) {
+    hints.push(
+      `To put the video itself in the video library: \`baker videos ingest ${link} --source youtube --external-id youtube:${videoId}\`.`
+    );
+  }
+  return hints;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: "Add a post by its link, with its images and videos.\n\nExamples:\n  baker posts add https://www.linkedin.com/posts/jane-doe_we-closed-activity-7477679889043750912-K2pu\n  baker posts add https://www.instagram.com/p/Dek_RAKjMDJ/ --no-media"
+  },
+  args: {
+    url: { type: "positional", description: "The post's link", required: true },
+    media: {
+      type: "boolean",
+      description: "Import its images and videos into the libraries (default); --no-media records the post only",
+      default: true
+    }
+  },
+  run: async ({ args }) => {
+    const parsed = postsAddRequestSchema.safeParse({ url: String(args.url ?? ""), media: args.media !== false });
+    if (!parsed.success) validationError(parsed.error.issues[0]?.message ?? "Pass the post's link");
+    try {
+      const data = await apiPost("/api/posts/add", parsed.data, { timeoutMs: 12e4 });
+      writeJson({ ok: true, data, hints: addHints(data, parsed.data.url) });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addCommand,
+  addHints
+};
+//# sourceMappingURL=add-RNU2PVXW.js.map