@koda-sl/baker-cli 0.387.0 → 0.389.0-dev.8065ad8f0

package/dist/chunk-LERWCRY5.js

@@ -0,0 +1,297 @@
+import {
+  REDDIT_LINK_REJECTED,
+  redditSearchHints,
+  redditSubredditsHints,
+  redditThreadHints
+} from "./chunk-H7XVKLIY.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-Y362QH54.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS
+} from "./chunk-SMIENBNX.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+
+// src/commands/research/reddit.ts
+import { defineCommand } from "citty";
+var TIMEOUT_MS = 18e4;
+var TEXT_PREVIEW_CHARS = 1500;
+var ITEM_FIELDS = {
+  kind: "post or comment",
+  subreddit: "Where it was said",
+  title: "The post's title (on a comment: the post it answers)",
+  text: "Verbatim \u2014 quote this, exactly",
+  text_truncated: "The text was cut; re-run with --full before quoting the end of it",
+  author: "Reddit username, or null once the account is deleted",
+  score: "Points",
+  comment_count: "Posts only",
+  created: "Date written (UTC)",
+  permalink: "Cite THIS link \u2014 it is built from where the words actually are",
+  depth: "Thread comments: 0 answers the post, 1 answers a comment",
+  source: "reddit_api / reddit_web = live Reddit; archive = the Arctic Shift archive of Reddit"
+};
+registerSchema({
+  command: "research.reddit.search",
+  description: "Search Reddit posts or comments for the audience's own words. Returns verbatim text with a real permalink for each hit. Start here for voice-of-customer work on Reddit.",
+  args: {
+    query: {
+      type: "string",
+      description: "Words to match \u2014 the audience's phrasing, not a description of it",
+      required: true
+    },
+    subreddit: {
+      type: "string",
+      description: "Subreddits to search (up to 10): comma-separated (couriersofreddit,AmazonFlexUK) or the flag repeated. Needed for --kind comments",
+      required: false
+    },
+    kind: {
+      type: "string",
+      description: "posts (default) or comments \u2014 the replies are where most of the voice is",
+      required: false,
+      enum: ["posts", "comments"]
+    },
+    since: { type: "string", description: "Only things written on or after this day, YYYY-MM-DD", required: false },
+    limit: { type: "number", description: "Results to return (1-50, default 25)", required: false },
+    full: {
+      type: "boolean",
+      description: "Return every text whole instead of a preview",
+      required: false,
+      default: false
+    }
+  }
+});
+registerSchema({
+  command: "research.reddit.thread",
+  description: "Read one Reddit thread verbatim: the post and its best comments, each with its own permalink. Use it on any Reddit link before quoting it \u2014 it also exposes links that point somewhere other than they claim.",
+  args: {
+    target: {
+      type: "string",
+      description: "The thread's link (any Reddit form, including share links) or post id",
+      required: true
+    },
+    comments: { type: "number", description: "Comments to return, best first (0-200, default 40)", required: false },
+    full: {
+      type: "boolean",
+      description: "Return every text whole instead of a preview",
+      required: false,
+      default: false
+    }
+  }
+});
+registerSchema({
+  command: "research.reddit.subreddits",
+  description: "Find the subreddits where an audience talks about a topic, with member counts and whether they can be read. Run it before searching, instead of guessing subreddit names.",
+  args: {
+    query: { type: "string", description: 'The audience or topic, e.g. "amazon flex uk", "deliveroo"', required: true },
+    limit: { type: "number", description: "Subreddits to return (1-25, default 10)", required: false }
+  }
+});
+function searchReddit(body) {
+  return apiPost("/api/research/reddit/search", body, { timeoutMs: TIMEOUT_MS });
+}
+function findSubreddits(body) {
+  return apiPost("/api/research/reddit/subreddits", body, { timeoutMs: TIMEOUT_MS });
+}
+function row(item, full) {
+  const cut = !full && item.text.length > TEXT_PREVIEW_CHARS;
+  return {
+    kind: item.kind,
+    subreddit: item.subreddit,
+    title: item.title,
+    text: cut ? `${item.text.slice(0, TEXT_PREVIEW_CHARS)}\u2026` : item.text,
+    ...cut ? { text_truncated: true } : {},
+    author: item.author,
+    score: item.score,
+    ...item.kind === "post" ? { comment_count: item.commentCount } : {},
+    created: item.createdAt.slice(0, 10),
+    permalink: item.permalink,
+    ...item.depth !== null ? { depth: item.depth } : {}
+  };
+}
+function redditFix(code) {
+  if (code === "NOT_FOUND") return REDDIT_LINK_REJECTED;
+  if (code === "BAD_REQUEST" || code === "VALIDATION_ERROR") {
+    return { action: "retry_with_changes", explanation: "Follow the message above and run the command again." };
+  }
+  return {
+    action: "continue_without",
+    explanation: "Don't loop on it. Finish the job with the other sources, say plainly that Reddit is a gap in this research, and never stand in a summary's paraphrase for a Reddit quote."
+  };
+}
+function failValidation(message) {
+  writeResearchJson({ ok: false, error: { code: "VALIDATION_ERROR", message, fix: redditFix("VALIDATION_ERROR") } });
+  process.exit(1);
+}
+function subredditsFromArgs(rawArgs, parsed) {
+  return repeatedValues(rawArgs, "subreddit", parsed).flatMap((value) => value.split(",")).map((name) => name.trim()).filter(Boolean);
+}
+var searchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: `Search Reddit for the audience's own words, verbatim, each with a permalink you can cite.
+
+Start here for Reddit voice-of-customer. Matches words, not meaning \u2014 search the way the audience writes, and quote a phrase to keep it together ('"right to work"').
+
+Examples:
+  baker research reddit search "agency never paid" --subreddit couriersofreddit,AmazonFlexUK
+  baker research reddit search '"right to work"' --subreddit UKJobs,AmazonFlexUK
+  baker research reddit search "visa" --subreddit UberEATS --kind comments --since 2025-01-01
+  baker research reddit search "side hustle student deliveries"`
+  },
+  args: {
+    query: { type: "positional", description: "Words to match", required: false },
+    subreddit: {
+      type: "string",
+      description: "Subreddits (up to 10): comma-separated, or repeat the flag",
+      required: false
+    },
+    kind: { type: "string", description: "posts (default) or comments", required: false },
+    since: { type: "string", description: "YYYY-MM-DD", required: false },
+    limit: { type: "string", description: "1-50, default 25", required: false },
+    full: { type: "boolean", description: "Whole texts, not previews", required: false }
+  },
+  run: async ({ args, rawArgs }) => {
+    const query = args.query?.trim();
+    if (!query) failValidation('Say what to search for: baker research reddit search "<words>"');
+    const kind = args.kind ?? "posts";
+    if (kind !== "posts" && kind !== "comments") failValidation("--kind must be posts or comments");
+    const body = {
+      query,
+      kind,
+      subreddits: subredditsFromArgs(rawArgs, args.subreddit)
+    };
+    if (args.since) body.since = args.since;
+    if (args.limit) body.limit = Number(args.limit);
+    try {
+      const data = await searchReddit(body);
+      writeResearchJson({
+        ok: true,
+        data: data.results.map((item) => row(item, Boolean(args.full))),
+        source: data.source,
+        fields: ITEM_FIELDS,
+        hints: redditSearchHints({ resultCount: data.results.length, kind, source: data.source })
+      });
+    } catch (err) {
+      handleResearchError(err, redditFix);
+    }
+  }
+});
+var threadCommand = defineCommand({
+  meta: {
+    name: "thread",
+    description: `Read one Reddit thread verbatim \u2014 the post and its best comments, each with its own permalink.
+
+Run it on every Reddit link before you quote from it, including links a research summary gave you: it refuses a link whose post is somewhere other than the link claims.
+
+Examples:
+  baker research reddit thread "https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/agency_still_hasnt_paid_me/"
+  baker research reddit thread "https://www.reddit.com/r/UberEATS/s/3TzXiyxaMD" --comments 100
+  baker research reddit thread 1abc2de --full`
+  },
+  args: {
+    target: { type: "positional", description: "Thread link or post id", required: false },
+    comments: { type: "string", description: "0-200, default 40", required: false },
+    full: { type: "boolean", description: "Whole texts, not previews", required: false }
+  },
+  run: async ({ args }) => {
+    const target = args.target?.trim();
+    if (!target) failValidation("Pass the thread's link or post id: baker research reddit thread <url>");
+    const commentsAsked = args.comments ? Number(args.comments) : RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS;
+    const body = { target, comments: commentsAsked };
+    try {
+      const data = await apiPost("/api/research/reddit/thread", body, {
+        timeoutMs: TIMEOUT_MS
+      });
+      const full = Boolean(args.full);
+      writeResearchJson({
+        ok: true,
+        data: { post: row(data.post, full), comments: data.comments.map((item) => row(item, full)) },
+        source: data.source,
+        fields: ITEM_FIELDS,
+        hints: redditThreadHints({
+          commentsShown: data.comments.length,
+          commentsAsked,
+          commentCount: data.post.commentCount,
+          source: data.source
+        })
+      });
+    } catch (err) {
+      handleResearchError(err, redditFix);
+    }
+  }
+});
+var subredditsCommand = defineCommand({
+  meta: {
+    name: "subreddits",
+    description: `Find the subreddits where an audience talks \u2014 name, members, and whether it can be read.
+
+Run it before \`reddit search\` instead of guessing names: a plausible-sounding subreddit can be dead (r/CouriersUK has one post), while the conversation sits in r/AmazonFlexUK or r/deliveroos.
+
+Examples:
+  baker research reddit subreddits "amazon flex uk"
+  baker research reddit subreddits "deliveroo" --limit 5`
+  },
+  args: {
+    query: { type: "positional", description: "Audience or topic", required: false },
+    limit: { type: "string", description: "1-25, default 10", required: false }
+  },
+  run: async ({ args }) => {
+    const query = args.query?.trim();
+    if (!query) failValidation('Say what to look for: baker research reddit subreddits "<audience or topic>"');
+    const body = { query };
+    if (args.limit) body.limit = Number(args.limit);
+    try {
+      const data = await findSubreddits(body);
+      writeResearchJson({
+        ok: true,
+        data: data.results,
+        source: data.source,
+        fields: {
+          name: "Pass this to --subreddit",
+          subscribers: "Members \u2014 size, not activity",
+          access: "public / restricted (readable, members post) / private (unreadable) / null when the source doesn't say",
+          description: "The subreddit's own summary",
+          url: "The subreddit"
+        },
+        hints: redditSubredditsHints({ resultCount: data.results.length })
+      });
+    } catch (err) {
+      handleResearchError(err, redditFix);
+    }
+  }
+});
+var redditCommand = defineCommand({
+  meta: {
+    name: "reddit",
+    description: `Read Reddit verbatim \u2014 the one site no page reader will open for us.
+
+Commands:
+  subreddits \u2014 Find where the audience talks (start here)
+  search     \u2014 Find posts or comments in the audience's own words
+  thread     \u2014 Read one thread: the post and its best comments
+
+Examples:
+  baker research reddit subreddits "amazon flex uk"
+  baker research reddit search "agency never paid" --subreddit couriersofreddit,AmazonFlexUK --kind comments
+  baker research reddit thread "https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/"
+Full guide: __tooling__/docs/tools/baker/research.md`
+  },
+  subCommands: { subreddits: subredditsCommand, search: searchCommand, thread: threadCommand }
+});
+
+export {
+  searchReddit,
+  findSubreddits,
+  subredditsFromArgs,
+  redditCommand
+};
+//# sourceMappingURL=chunk-LERWCRY5.js.map

package/dist/chunk-LERWCRY5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/reddit.ts"],"sourcesContent":["import {\n  RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS,\n  type ResearchRedditItem,\n  type ResearchRedditSearchRequest,\n  type ResearchRedditSearchResponse,\n  type ResearchRedditSubredditsRequest,\n  type ResearchRedditSubredditsResponse,\n  type ResearchRedditThreadRequest,\n  type ResearchRedditThreadResponse,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { repeatedValues } from \"../../lib/repeatedFlags.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { REDDIT_LINK_REJECTED, redditSearchHints, redditSubredditsHints, redditThreadHints } from \"./hints.ts\";\nimport { handleResearchError, type ResearchFix, writeResearchJson } from \"./output.ts\";\n\n/**\n * Up to three sources may be asked in turn, and the archive waits out its own\n * rate limit before giving up — so a read can legitimately take a minute.\n */\nconst TIMEOUT_MS = 180_000;\n\n/** Long enough for almost every comment; a longer one says it was cut, so a partial quote is never mistaken for a whole one. */\nconst TEXT_PREVIEW_CHARS = 1_500;\n\nconst ITEM_FIELDS: Record<string, string> = {\n  kind: \"post or comment\",\n  subreddit: \"Where it was said\",\n  title: \"The post's title (on a comment: the post it answers)\",\n  text: \"Verbatim — quote this, exactly\",\n  text_truncated: \"The text was cut; re-run with --full before quoting the end of it\",\n  author: \"Reddit username, or null once the account is deleted\",\n  score: \"Points\",\n  comment_count: \"Posts only\",\n  created: \"Date written (UTC)\",\n  permalink: \"Cite THIS link — it is built from where the words actually are\",\n  depth: \"Thread comments: 0 answers the post, 1 answers a comment\",\n  source: \"reddit_api / reddit_web = live Reddit; archive = the Arctic Shift archive of Reddit\",\n};\n\nregisterSchema({\n  command: \"research.reddit.search\",\n  description:\n    \"Search Reddit posts or comments for the audience's own words. Returns verbatim text with a real permalink for each hit. Start here for voice-of-customer work on Reddit.\",\n  args: {\n    query: {\n      type: \"string\",\n      description: \"Words to match — the audience's phrasing, not a description of it\",\n      required: true,\n    },\n    subreddit: {\n      type: \"string\",\n      description:\n        \"Subreddits to search (up to 10): comma-separated (couriersofreddit,AmazonFlexUK) or the flag repeated. Needed for --kind comments\",\n      required: false,\n    },\n    kind: {\n      type: \"string\",\n      description: \"posts (default) or comments — the replies are where most of the voice is\",\n      required: false,\n      enum: [\"posts\", \"comments\"],\n    },\n    since: { type: \"string\", description: \"Only things written on or after this day, YYYY-MM-DD\", required: false },\n    limit: { type: \"number\", description: \"Results to return (1-50, default 25)\", required: false },\n    full: {\n      type: \"boolean\",\n      description: \"Return every text whole instead of a preview\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nregisterSchema({\n  command: \"research.reddit.thread\",\n  description:\n    \"Read one Reddit thread verbatim: the post and its best comments, each with its own permalink. Use it on any Reddit link before quoting it — it also exposes links that point somewhere other than they claim.\",\n  args: {\n    target: {\n      type: \"string\",\n      description: \"The thread's link (any Reddit form, including share links) or post id\",\n      required: true,\n    },\n    comments: { type: \"number\", description: \"Comments to return, best first (0-200, default 40)\", required: false },\n    full: {\n      type: \"boolean\",\n      description: \"Return every text whole instead of a preview\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nregisterSchema({\n  command: \"research.reddit.subreddits\",\n  description:\n    \"Find the subreddits where an audience talks about a topic, with member counts and whether they can be read. Run it before searching, instead of guessing subreddit names.\",\n  args: {\n    query: { type: \"string\", description: 'The audience or topic, e.g. \"amazon flex uk\", \"deliveroo\"', required: true },\n    limit: { type: \"number\", description: \"Subreddits to return (1-25, default 10)\", required: false },\n  },\n});\n\n/** One Reddit search, as `reddit search` and `research customers` both ask it. */\nexport function searchReddit(body: ResearchRedditSearchRequest): Promise<ResearchRedditSearchResponse> {\n  return apiPost<ResearchRedditSearchResponse>(\"/api/research/reddit/search\", body, { timeoutMs: TIMEOUT_MS });\n}\n\n/** Where an audience talks, as `reddit subreddits` and `research customers` both ask it. */\nexport function findSubreddits(body: ResearchRedditSubredditsRequest): Promise<ResearchRedditSubredditsResponse> {\n  return apiPost<ResearchRedditSubredditsResponse>(\"/api/research/reddit/subreddits\", body, { timeoutMs: TIMEOUT_MS });\n}\n\nfunction row(item: ResearchRedditItem, full: boolean) {\n  const cut = !full && item.text.length > TEXT_PREVIEW_CHARS;\n  return {\n    kind: item.kind,\n    subreddit: item.subreddit,\n    title: item.title,\n    text: cut ? `${item.text.slice(0, TEXT_PREVIEW_CHARS)}…` : item.text,\n    ...(cut ? { text_truncated: true } : {}),\n    author: item.author,\n    score: item.score,\n    ...(item.kind === \"post\" ? { comment_count: item.commentCount } : {}),\n    created: item.createdAt.slice(0, 10),\n    permalink: item.permalink,\n    ...(item.depth !== null ? { depth: item.depth } : {}),\n  };\n}\n\n/**\n * The failures split three ways, and the split is the whole point: a link that\n * leads nowhere real must never be quoted, a question asked the wrong way should\n * be asked again, and a Reddit nobody will serve today is a named gap, not a\n * reason to stop the job.\n */\nfunction redditFix(code: string): ResearchFix {\n  if (code === \"NOT_FOUND\") return REDDIT_LINK_REJECTED;\n  if (code === \"BAD_REQUEST\" || code === \"VALIDATION_ERROR\") {\n    return { action: \"retry_with_changes\", explanation: \"Follow the message above and run the command again.\" };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"Don't loop on it. Finish the job with the other sources, say plainly that Reddit is a gap in this research, and never stand in a summary's paraphrase for a Reddit quote.\",\n  };\n}\n\nfunction failValidation(message: string): never {\n  writeResearchJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message, fix: redditFix(\"VALIDATION_ERROR\") } });\n  process.exit(1);\n}\n\n/** `--subreddit a,b` and `--subreddit a --subreddit b` both name every subreddit given. */\nexport function subredditsFromArgs(rawArgs: readonly string[] | undefined, parsed: unknown): string[] {\n  return repeatedValues(rawArgs, \"subreddit\", parsed)\n    .flatMap((value) => value.split(\",\"))\n    .map((name) => name.trim())\n    .filter(Boolean);\n}\n\nconst searchCommand = defineCommand({\n  meta: {\n    name: \"search\",\n    description: `Search Reddit for the audience's own words, verbatim, each with a permalink you can cite.\n\nStart here for Reddit voice-of-customer. Matches words, not meaning — search the way the audience writes, and quote a phrase to keep it together ('\"right to work\"').\n\nExamples:\n  baker research reddit search \"agency never paid\" --subreddit couriersofreddit,AmazonFlexUK\n  baker research reddit search '\"right to work\"' --subreddit UKJobs,AmazonFlexUK\n  baker research reddit search \"visa\" --subreddit UberEATS --kind comments --since 2025-01-01\n  baker research reddit search \"side hustle student deliveries\"`,\n  },\n  args: {\n    query: { type: \"positional\", description: \"Words to match\", required: false },\n    subreddit: {\n      type: \"string\",\n      description: \"Subreddits (up to 10): comma-separated, or repeat the flag\",\n      required: false,\n    },\n    kind: { type: \"string\", description: \"posts (default) or comments\", required: false },\n    since: { type: \"string\", description: \"YYYY-MM-DD\", required: false },\n    limit: { type: \"string\", description: \"1-50, default 25\", required: false },\n    full: { type: \"boolean\", description: \"Whole texts, not previews\", required: false },\n  },\n  run: async ({ args, rawArgs }) => {\n    const query = (args.query as string | undefined)?.trim();\n    if (!query) failValidation('Say what to search for: baker research reddit search \"<words>\"');\n    const kind = (args.kind as string | undefined) ?? \"posts\";\n    if (kind !== \"posts\" && kind !== \"comments\") failValidation(\"--kind must be posts or comments\");\n\n    const body: ResearchRedditSearchRequest = {\n      query,\n      kind,\n      subreddits: subredditsFromArgs(rawArgs, args.subreddit),\n    };\n    if (args.since) body.since = args.since as string;\n    if (args.limit) body.limit = Number(args.limit);\n\n    try {\n      const data = await searchReddit(body);\n      writeResearchJson({\n        ok: true,\n        data: data.results.map((item) => row(item, Boolean(args.full))),\n        source: data.source,\n        fields: ITEM_FIELDS,\n        hints: redditSearchHints({ resultCount: data.results.length, kind, source: data.source }),\n      });\n    } catch (err) {\n      handleResearchError(err, redditFix);\n    }\n  },\n});\n\nconst threadCommand = defineCommand({\n  meta: {\n    name: \"thread\",\n    description: `Read one Reddit thread verbatim — the post and its best comments, each with its own permalink.\n\nRun it on every Reddit link before you quote from it, including links a research summary gave you: it refuses a link whose post is somewhere other than the link claims.\n\nExamples:\n  baker research reddit thread \"https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/agency_still_hasnt_paid_me/\"\n  baker research reddit thread \"https://www.reddit.com/r/UberEATS/s/3TzXiyxaMD\" --comments 100\n  baker research reddit thread 1abc2de --full`,\n  },\n  args: {\n    target: { type: \"positional\", description: \"Thread link or post id\", required: false },\n    comments: { type: \"string\", description: \"0-200, default 40\", required: false },\n    full: { type: \"boolean\", description: \"Whole texts, not previews\", required: false },\n  },\n  run: async ({ args }) => {\n    const target = (args.target as string | undefined)?.trim();\n    if (!target) failValidation(\"Pass the thread's link or post id: baker research reddit thread <url>\");\n\n    const commentsAsked = args.comments ? Number(args.comments) : RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS;\n    const body: ResearchRedditThreadRequest = { target, comments: commentsAsked };\n\n    try {\n      const data = await apiPost<ResearchRedditThreadResponse>(\"/api/research/reddit/thread\", body, {\n        timeoutMs: TIMEOUT_MS,\n      });\n      const full = Boolean(args.full);\n      writeResearchJson({\n        ok: true,\n        data: { post: row(data.post, full), comments: data.comments.map((item) => row(item, full)) },\n        source: data.source,\n        fields: ITEM_FIELDS,\n        hints: redditThreadHints({\n          commentsShown: data.comments.length,\n          commentsAsked,\n          commentCount: data.post.commentCount,\n          source: data.source,\n        }),\n      });\n    } catch (err) {\n      handleResearchError(err, redditFix);\n    }\n  },\n});\n\nconst subredditsCommand = defineCommand({\n  meta: {\n    name: \"subreddits\",\n    description: `Find the subreddits where an audience talks — name, members, and whether it can be read.\n\nRun it before \\`reddit search\\` instead of guessing names: a plausible-sounding subreddit can be dead (r/CouriersUK has one post), while the conversation sits in r/AmazonFlexUK or r/deliveroos.\n\nExamples:\n  baker research reddit subreddits \"amazon flex uk\"\n  baker research reddit subreddits \"deliveroo\" --limit 5`,\n  },\n  args: {\n    query: { type: \"positional\", description: \"Audience or topic\", required: false },\n    limit: { type: \"string\", description: \"1-25, default 10\", required: false },\n  },\n  run: async ({ args }) => {\n    const query = (args.query as string | undefined)?.trim();\n    if (!query) failValidation('Say what to look for: baker research reddit subreddits \"<audience or topic>\"');\n    const body: ResearchRedditSubredditsRequest = { query };\n    if (args.limit) body.limit = Number(args.limit);\n\n    try {\n      const data = await findSubreddits(body);\n      writeResearchJson({\n        ok: true,\n        data: data.results,\n        source: data.source,\n        fields: {\n          name: \"Pass this to --subreddit\",\n          subscribers: \"Members — size, not activity\",\n          access:\n            \"public / restricted (readable, members post) / private (unreadable) / null when the source doesn't say\",\n          description: \"The subreddit's own summary\",\n          url: \"The subreddit\",\n        },\n        hints: redditSubredditsHints({ resultCount: data.results.length }),\n      });\n    } catch (err) {\n      handleResearchError(err, redditFix);\n    }\n  },\n});\n\nexport const redditCommand = defineCommand({\n  meta: {\n    name: \"reddit\",\n    description: `Read Reddit verbatim — the one site no page reader will open for us.\n\nCommands:\n  subreddits — Find where the audience talks (start here)\n  search     — Find posts or comments in the audience's own words\n  thread     — Read one thread: the post and its best comments\n\nExamples:\n  baker research reddit subreddits \"amazon flex uk\"\n  baker research reddit search \"agency never paid\" --subreddit couriersofreddit,AmazonFlexUK --kind comments\n  baker research reddit thread \"https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/\"\nFull guide: __tooling__/docs/tools/baker/research.md`,\n  },\n  subCommands: { subreddits: subredditsCommand, search: searchCommand, thread: threadCommand },\n});\n"],"mappings":"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","names":[]}

package/dist/chunk-LLPFY3NI.js

@@ -0,0 +1,207 @@
+import {
+  nodeParamsPreview
+} from "./chunk-NHU33T2S.js";
+import {
+  creativeSlugFromCanvasPath,
+  parseDefinitionSeriesPlace,
+  parseDefinitionSourceFields,
+  parseDefinitionStrategyFields
+} from "./chunk-EDNKALM6.js";
+import {
+  prepareCanvas
+} from "./chunk-TIFVHGQL.js";
+import {
+  BackendClient
+} from "./chunk-KZUHRZ2C.js";
+import {
+  nodeDependencies
+} from "./chunk-66USKCVY.js";
+import {
+  requireCredentialsFromEnv
+} from "./chunk-U7BBXM67.js";
+
+// src/commands/canvas/sync-definition.ts
+import { readdir, readFile, stat } from "fs/promises";
+import path from "path";
+import { parseDocument } from "yaml";
+import { defineCommand } from "citty";
+
+// src/commands/canvas/definition-graph.ts
+var MAX_NODES = 300;
+var PREVIEWABLE_INGEST_EXPECTS = /* @__PURE__ */ new Set(["image"]);
+function nodeInputPreviewUrl(type, params) {
+  if (type !== "ingest" || !params || typeof params !== "object") return void 0;
+  const p = params;
+  if (p.source !== "url" || typeof p.url !== "string") return void 0;
+  if (!/^https?:\/\//i.test(p.url)) return void 0;
+  if (typeof p.expect === "string" && !PREVIEWABLE_INGEST_EXPECTS.has(p.expect)) return void 0;
+  return p.url;
+}
+function canvasToDefinitionGraph(canvas) {
+  const rawNodes = canvas?.nodes;
+  if (!Array.isArray(rawNodes)) return null;
+  const parsed = [];
+  for (const raw of rawNodes) {
+    const id = raw?.id;
+    const type = raw?.type;
+    if (typeof id !== "string" || typeof type !== "string") continue;
+    parsed.push({ id, type, inputs: raw.inputs, params: raw.params });
+    if (parsed.length >= MAX_NODES) break;
+  }
+  if (parsed.length === 0) return null;
+  const ids = new Set(parsed.map((n) => n.id));
+  const nodes = parsed.map(({ id, type, inputs, params }) => {
+    const deps = nodeDependencies({ id, inputs, params }, ids);
+    deps.delete(id);
+    const depList = [...deps];
+    const paramsPreview = nodeParamsPreview(params, depList);
+    const base = { id, type };
+    if (depList.length > 0) base.deps = depList;
+    if (paramsPreview) base.paramsPreview = paramsPreview;
+    const inputPreviewUrl = nodeInputPreviewUrl(type, params);
+    if (inputPreviewUrl) base.inputPreviewUrl = inputPreviewUrl;
+    return base;
+  });
+  const rawOutput = canvas?.output;
+  const outNode = rawOutput?.node;
+  const outSlot = rawOutput?.output;
+  const output = typeof outNode === "string" && typeof outSlot === "string" ? { node: outNode, output: outSlot } : void 0;
+  return { nodes, output };
+}
+
+// src/commands/canvas/sync-definition.ts
+function buildDefinitionSyncPayload(input, graph, chatId) {
+  const { canvas: _canvas, ...fields } = input;
+  return Object.fromEntries([
+    ...Object.entries(fields).filter(([, v]) => v !== void 0),
+    ["graph", graph],
+    ["chatId", chatId]
+  ]);
+}
+async function readDefinitionSourceFields(canvasPath) {
+  try {
+    return parseDefinitionSourceFields(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8"));
+  } catch {
+    return {};
+  }
+}
+async function readDefinitionTitle(canvasPath) {
+  try {
+    const raw = await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8");
+    const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+    const doc = match ? parseDocument(match[1] ?? "") : null;
+    const title = doc && doc.errors.length === 0 ? doc.get("title") : void 0;
+    return typeof title === "string" && title.trim() ? title.trim() : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function readDefinitionStrategyFields(canvasPath) {
+  try {
+    return parseDefinitionStrategyFields(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8"));
+  } catch {
+    return {};
+  }
+}
+async function readDefinitionSeriesPlace(canvasPath) {
+  try {
+    return parseDefinitionSeriesPlace(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8")) ?? {};
+  } catch {
+    return {};
+  }
+}
+async function syncCreativeDefinitionBestEffort(input) {
+  const chatId = process.env.BAKER_CHAT_ID;
+  if (!chatId) return;
+  const graph = canvasToDefinitionGraph(input.canvas);
+  if (!graph || graph.nodes.length === 0) return;
+  try {
+    const creds = requireCredentialsFromEnv();
+    const client = new BackendClient({ baseUrl: creds.url, apiKey: creds.apiKey });
+    await client.syncCreativeDefinition(buildDefinitionSyncPayload(input, graph, chatId));
+    process.stdout.write(`[definition] synced workflow graph (${graph.nodes.length} nodes) \u2014 view it in the dashboard
+`);
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    process.stderr.write(`[warn] workflow graph not synced (${msg})
+`);
+  }
+}
+async function resolveCanvasPath(inputPath) {
+  const resolved = path.resolve(inputPath);
+  let dir = resolved;
+  try {
+    if ((await stat(resolved)).isFile()) {
+      if (resolved.endsWith(".canvas.json")) return resolved;
+      dir = path.dirname(resolved);
+    }
+  } catch {
+    dir = resolved.endsWith(".canvas.json") ? path.dirname(resolved) : resolved;
+  }
+  let entries;
+  try {
+    entries = await readdir(dir);
+  } catch {
+    return null;
+  }
+  const canvases = entries.filter((name) => name.endsWith(".canvas.json"));
+  const slug = creativeSlugFromCanvasPath(`${dir}/x/`);
+  const chosen = (slug ? canvases.find((name) => name === `${slug}.canvas.json`) : void 0) ?? canvases[0];
+  return chosen ? path.join(dir, chosen) : null;
+}
+var syncDefinitionCommand = defineCommand({
+  meta: {
+    name: "sync-definition",
+    description: "Push a creative's current node-graph + input thumbnails to the dashboard without rendering. The graph has the creative's blueprint applied (prompt.json and scenes/*.json edits), exactly as `run` would render it, without changing any file. Runs automatically when you edit a creative's canvas.json or prompt.json."
+  },
+  args: {
+    file: {
+      type: "positional",
+      required: true,
+      description: "A path under src/creatives/<slug>/ (the .canvas.json, its prompt.json, or the folder)"
+    },
+    title: {
+      type: "boolean",
+      description: "Also record the title its _definition.md gives. Only for a creative just made from another (a series ad, a translation), never on an edit re-sync."
+    }
+  },
+  async run({ args }) {
+    const canvasPath = await resolveCanvasPath(String(args.file));
+    if (!canvasPath) {
+      return;
+    }
+    const slug = creativeSlugFromCanvasPath(canvasPath);
+    if (!slug) return;
+    let canvas;
+    let sourceSha;
+    try {
+      const prepared = await prepareCanvas(canvasPath, { write: false });
+      canvas = prepared.fileGraph;
+      sourceSha = prepared.sourceSha;
+    } catch {
+      return;
+    }
+    const title = args.title ? await readDefinitionTitle(canvasPath) : void 0;
+    await syncCreativeDefinitionBestEffort({
+      slug,
+      canvas,
+      sourceSha,
+      ...title ? { title } : {},
+      ...await readDefinitionSourceFields(canvasPath),
+      ...await readDefinitionStrategyFields(canvasPath),
+      ...await readDefinitionSeriesPlace(canvasPath)
+    });
+  }
+});
+
+export {
+  buildDefinitionSyncPayload,
+  readDefinitionSourceFields,
+  readDefinitionTitle,
+  readDefinitionStrategyFields,
+  readDefinitionSeriesPlace,
+  syncCreativeDefinitionBestEffort,
+  resolveCanvasPath,
+  syncDefinitionCommand
+};
+//# sourceMappingURL=chunk-LLPFY3NI.js.map

package/dist/chunk-LLPFY3NI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/sync-definition.ts","../src/commands/canvas/definition-graph.ts"],"sourcesContent":["import { readdir, readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { parseDocument } from \"yaml\";\nimport { defineCommand } from \"citty\";\nimport { BackendClient } from \"../../engine/index.ts\";\nimport { requireCredentialsFromEnv } from \"../../engine/client/env.ts\";\nimport {\n  type DefinitionSeriesPlace,\n  type DefinitionSourceFields,\n  type DefinitionStrategyFields,\n  parseDefinitionSeriesPlace,\n  parseDefinitionSourceFields,\n  parseDefinitionStrategyFields,\n} from \"./creative-definition.ts\";\nimport { canvasToDefinitionGraph } from \"./definition-graph.ts\";\nimport { prepareCanvas } from \"./prepare-canvas.ts\";\nimport { creativeSlugFromCanvasPath } from \"./run-record.ts\";\n\n/** Why the creative exists (`_definition.md` idea / message / evidence / angle / persona / awareness / hypothesis). */\ntype DefinitionSyncInput = Omit<DefinitionStrategyFields, \"seriesLead\" | \"language\"> & {\n  slug: string;\n  /** The series lead and language: omitted when not read (the backend keeps them), null when the definition names none (cleared). */\n  seriesLead?: string | null;\n  language?: string | null;\n  /** Omitted on an edit re-sync so the backend keeps the creative's existing title. */\n  title?: string;\n  platform?: string;\n  formats?: string[];\n  sourceReferenceUrl?: string;\n  /** The library ad it adapted (`_definition.md` sourceAdId / sourcePlatform / sourceAdvertiserId). */\n  sourceAdId?: string;\n  sourcePlatform?: string;\n  sourceAdvertiserId?: string;\n  canvas: unknown;\n  /** The creative's source fingerprint (`computeSourceSha`): powers the \"edited since last render\" staleness signal. */\n  sourceSha?: string;\n};\n\n/**\n * The body `POST /api/creatives/definition` receives. Absent fields are left out rather than\n * sent as undefined so the backend's `?? existing` keeps what an earlier sync recorded.\n */\nexport function buildDefinitionSyncPayload(\n  input: DefinitionSyncInput,\n  graph: unknown,\n  chatId: string,\n): Record<string, unknown> {\n  const { canvas: _canvas, ...fields } = input;\n  return Object.fromEntries([\n    ...Object.entries(fields).filter(([, v]) => v !== undefined),\n    [\"graph\", graph],\n    [\"chatId\", chatId],\n  ]);\n}\n\n/** The library ids the creative's `_definition.md` names, read from beside its canvas; empty when there is none. */\nexport async function readDefinitionSourceFields(canvasPath: string): Promise<DefinitionSourceFields> {\n  try {\n    return parseDefinitionSourceFields(await readFile(path.join(path.dirname(canvasPath), \"_definition.md\"), \"utf8\"));\n  } catch {\n    return {};\n  }\n}\n\n/** The creative's title, read from the `_definition.md` beside its canvas; undefined when it names none. */\nexport async function readDefinitionTitle(canvasPath: string): Promise<string | undefined> {\n  try {\n    const raw = await readFile(path.join(path.dirname(canvasPath), \"_definition.md\"), \"utf8\");\n    const match = raw.match(/^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/);\n    const doc = match ? parseDocument(match[1] ?? \"\") : null;\n    const title = doc && doc.errors.length === 0 ? doc.get(\"title\") : undefined;\n    return typeof title === \"string\" && title.trim() ? title.trim() : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** The creative's strategy, read from the `_definition.md` beside its canvas; empty when there is none. */\nexport async function readDefinitionStrategyFields(canvasPath: string): Promise<DefinitionStrategyFields> {\n  try {\n    return parseDefinitionStrategyFields(await readFile(path.join(path.dirname(canvasPath), \"_definition.md\"), \"utf8\"));\n  } catch {\n    return {};\n  }\n}\n\n/** The series place the `_definition.md` beside the canvas names; empty when it cannot be read, so nothing is cleared. */\nexport async function readDefinitionSeriesPlace(canvasPath: string): Promise<DefinitionSeriesPlace | Record<never, never>> {\n  try {\n    return (\n      parseDefinitionSeriesPlace(await readFile(path.join(path.dirname(canvasPath), \"_definition.md\"), \"utf8\")) ?? {}\n    );\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Push a creative's parsed node-graph to the backend so the dashboard can draw\n * its workflow (and its wired input thumbnails) BEFORE — and BETWEEN — billed\n * runs. Best-effort: a missing chat id, missing creds, an unparseable canvas, or\n * a failed POST warns and returns — it must never fail the caller (a scaffold\n * that just did the real work, or a watcher reacting to an edit).\n */\nexport async function syncCreativeDefinitionBestEffort(input: DefinitionSyncInput): Promise<void> {\n  const chatId = process.env.BAKER_CHAT_ID;\n  if (!chatId) return; // Not chat-attached — nothing to preview against.\n  const graph = canvasToDefinitionGraph(input.canvas);\n  if (!graph || graph.nodes.length === 0) return;\n  try {\n    const creds = requireCredentialsFromEnv();\n    const client = new BackendClient({ baseUrl: creds.url, apiKey: creds.apiKey });\n    await client.syncCreativeDefinition(buildDefinitionSyncPayload(input, graph, chatId));\n    process.stdout.write(`[definition] synced workflow graph (${graph.nodes.length} nodes) — view it in the dashboard\\n`);\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    process.stderr.write(`[warn] workflow graph not synced (${msg})\\n`);\n  }\n}\n\n/**\n * Resolve the canvas file backing a creative from ANY path under its dir — the\n * `{slug}.canvas.json` itself, its sibling `prompt.json`, or the creative\n * directory. Lets a file watcher hand us whichever file changed and still find\n * the one canvas to project. Prefers `{slug}.canvas.json`, else the sole\n * `*.canvas.json` in the directory; null when there is no single canvas.\n */\nexport async function resolveCanvasPath(inputPath: string): Promise<string | null> {\n  const resolved = path.resolve(inputPath);\n  let dir = resolved;\n  try {\n    if ((await stat(resolved)).isFile()) {\n      if (resolved.endsWith(\".canvas.json\")) return resolved;\n      dir = path.dirname(resolved);\n    }\n  } catch {\n    // A deleted/renamed file: fall back to treating the path as its directory.\n    dir = resolved.endsWith(\".canvas.json\") ? path.dirname(resolved) : resolved;\n  }\n  let entries: string[];\n  try {\n    entries = await readdir(dir);\n  } catch {\n    return null;\n  }\n  const canvases = entries.filter((name) => name.endsWith(\".canvas.json\"));\n  const slug = creativeSlugFromCanvasPath(`${dir}/x/`);\n  const chosen = (slug ? canvases.find((name) => name === `${slug}.canvas.json`) : undefined) ?? canvases[0];\n  return chosen ? path.join(dir, chosen) : null;\n}\n\nexport const syncDefinitionCommand = defineCommand({\n  meta: {\n    name: \"sync-definition\",\n    description:\n      \"Push a creative's current node-graph + input thumbnails to the dashboard without rendering. The graph has the creative's blueprint applied (prompt.json and scenes/*.json edits), exactly as `run` would render it, without changing any file. Runs automatically when you edit a creative's canvas.json or prompt.json.\",\n  },\n  args: {\n    file: {\n      type: \"positional\",\n      required: true,\n      description: \"A path under src/creatives/<slug>/ (the .canvas.json, its prompt.json, or the folder)\",\n    },\n    title: {\n      type: \"boolean\",\n      description:\n        \"Also record the title its _definition.md gives. Only for a creative just made from another (a series ad, a translation), never on an edit re-sync.\",\n    },\n  },\n  async run({ args }) {\n    const canvasPath = await resolveCanvasPath(String(args.file));\n    if (!canvasPath) {\n      // Nothing to sync (not a creative path, or no canvas yet) — a no-op, not an error.\n      return;\n    }\n    const slug = creativeSlugFromCanvasPath(canvasPath);\n    if (!slug) return;\n    // The same preflight `run` uses, so the dashboard draws the graph that will render\n    // (the scene and copy projections included), in the file's canvas-relative spelling,\n    // never this machine's absolute paths. Read-only: the watcher runs this over every\n    // creative on every edit, and must never rewrite a creative nobody touched. The\n    // fingerprint is taken over the projected graph, as `run` and `baker canvas stale` take it.\n    let canvas: unknown;\n    let sourceSha: string | undefined;\n    try {\n      const prepared = await prepareCanvas(canvasPath, { write: false });\n      canvas = prepared.fileGraph;\n      sourceSha = prepared.sourceSha;\n    } catch {\n      // Mid-edit invalid JSON (canvas, prompt.json or a scene): skip this tick; the next\n      // save re-fires the watcher.\n      return;\n    }\n    // No title/platform/formats: an edit re-sync must never rename or re-classify\n    // the creative — the backend preserves what the scaffold already set. The library\n    // ids are re-read from `_definition.md`, so an agent that adds or fixes them after\n    // the scaffold still gets them recorded without waiting for Publish — and so is the\n    // creative's strategy, the moment the agent writes it.\n    const title = args.title ? await readDefinitionTitle(canvasPath) : undefined;\n    await syncCreativeDefinitionBestEffort({\n      slug,\n      canvas,\n      sourceSha,\n      ...(title ? { title } : {}),\n      ...(await readDefinitionSourceFields(canvasPath)),\n      ...(await readDefinitionStrategyFields(canvasPath)),\n      ...(await readDefinitionSeriesPlace(canvasPath)),\n    });\n  },\n});\n","import { nodeDependencies } from \"../../engine/engine/graph.ts\";\nimport { nodeParamsPreview } from \"./node-preview.ts\";\n\nexport type DefinitionGraphNode = {\n  id: string;\n  type: string;\n  deps?: string[];\n  paramsPreview?: string;\n  /**\n   * A directly-viewable input image/video for the node BEFORE any run — today\n   * an `ingest` node's `source:\"url\"` src. Lets the dashboard show a real\n   * thumbnail (a swapped logo/hero) the moment the canvas changes, with no\n   * render. Path-source ingests carry no preview (their bytes aren't uploaded\n   * outside a run); the graph still shows the `path:` line via paramsPreview.\n   */\n  inputPreviewUrl?: string;\n};\nexport type CanvasDefinitionGraph = {\n  nodes: DefinitionGraphNode[];\n  output?: { node: string; output: string };\n};\n\n// Keep the synced blueprint bounded — matches the backend's cap.\nconst MAX_NODES = 300;\n\n// Only image ingests become a pre-run thumbnail: absent `expect` defaults to an\n// image, and a still renders unambiguously in the graph card. Video/font/json\n// ingests carry no preview (a video would need its own player wiring) — their\n// `url:`/`path:` line still shows via paramsPreview.\nconst PREVIEWABLE_INGEST_EXPECTS = new Set([\"image\"]);\n\n/**\n * A directly-viewable input URL for a node's pre-run thumbnail: an `ingest`\n * node pulling an image from a `source:\"url\"` src. Everything else (path-source\n * ingests, generators, non-image expects) returns undefined — only image bytes\n * the dashboard can already fetch become a thumbnail without a run.\n */\nfunction nodeInputPreviewUrl(type: string, params: unknown): string | undefined {\n  if (type !== \"ingest\" || !params || typeof params !== \"object\") return undefined;\n  const p = params as { source?: unknown; url?: unknown; expect?: unknown };\n  if (p.source !== \"url\" || typeof p.url !== \"string\") return undefined;\n  if (!/^https?:\\/\\//i.test(p.url)) return undefined;\n  if (typeof p.expect === \"string\" && !PREVIEWABLE_INGEST_EXPECTS.has(p.expect)) return undefined;\n  return p.url;\n}\n\n/**\n * Parse a canvas JSON into the compact node-graph the dashboard draws before any\n * run — shares the engine's `nodeDependencies` ($ref edges from inputs AND params) so\n * the pre-run blueprint matches the eventual run graph. Best-effort and defensive:\n * a not-yet-valid canvas (mid-edit) returns whatever nodes it can read, or null\n * if there are none, so a caller can skip the sync without failing the command.\n */\nexport function canvasToDefinitionGraph(canvas: unknown): CanvasDefinitionGraph | null {\n  const rawNodes = (canvas as { nodes?: unknown })?.nodes;\n  if (!Array.isArray(rawNodes)) return null;\n\n  const parsed: Array<{ id: string; type: string; inputs: unknown; params: unknown }> = [];\n  for (const raw of rawNodes) {\n    const id = (raw as { id?: unknown })?.id;\n    const type = (raw as { type?: unknown })?.type;\n    if (typeof id !== \"string\" || typeof type !== \"string\") continue;\n    parsed.push({ id, type, inputs: (raw as { inputs?: unknown }).inputs, params: (raw as { params?: unknown }).params });\n    if (parsed.length >= MAX_NODES) break;\n  }\n  if (parsed.length === 0) return null;\n\n  const ids = new Set(parsed.map((n) => n.id));\n  const nodes: DefinitionGraphNode[] = parsed.map(({ id, type, inputs, params }) => {\n    const deps = nodeDependencies({ id, inputs, params }, ids);\n    deps.delete(id);\n    const depList = [...deps];\n    // The pre-run graph carries each node's spec (model / aspect / size / expect …) +\n    // its wired props so a freshly-scaffolded creative shows full node detail in the\n    // inspector BEFORE the first billed run, matching what a run later records.\n    const paramsPreview = nodeParamsPreview(params, depList);\n    const base: DefinitionGraphNode = { id, type };\n    if (depList.length > 0) base.deps = depList;\n    if (paramsPreview) base.paramsPreview = paramsPreview;\n    const inputPreviewUrl = nodeInputPreviewUrl(type, params);\n    if (inputPreviewUrl) base.inputPreviewUrl = inputPreviewUrl;\n    return base;\n  });\n\n  const rawOutput = (canvas as { output?: unknown })?.output;\n  const outNode = (rawOutput as { node?: unknown })?.node;\n  const outSlot = (rawOutput as { output?: unknown })?.output;\n  const output =\n    typeof outNode === \"string\" && typeof outSlot === \"string\" ? { node: outNode, output: outSlot } : undefined;\n\n  return { nodes, output };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-M6UNISGO.js

@@ -0,0 +1,66 @@
+// src/commands/ads/x/error-parser.ts
+function mapXErrorCode(message) {
+  if (/UNAUTHORIZED_ACCESS|authentication/i.test(message)) return "AUTH_ERROR";
+  if (/UNAUTHORIZED_CLIENT_APPLICATION/i.test(message)) return "PERMISSION_DENIED";
+  if (/ACCOUNT_NOT_FOUND|NOT_FOUND/i.test(message)) return "ACCOUNT_NOT_FOUND";
+  if (/CAMPAIGN_NOT_FOUND/i.test(message)) return "CAMPAIGN_NOT_FOUND";
+  if (/LINE_ITEM_NOT_FOUND/i.test(message)) return "LINE_ITEM_NOT_FOUND";
+  if (/MEDIA_NOT_FOUND|TWEET_NOT_FOUND|TAILORED_AUDIENCE_NOT_FOUND/i.test(message)) return "RESOURCE_NOT_FOUND";
+  if (/TOO_MANY_REQUESTS|TWEET_RATE_LIMIT_EXCEEDED|rate.*limit/i.test(message)) return "QUOTA_EXCEEDED";
+  if (/SPEND_EXCEEDS_BUDGET/i.test(message)) return "BUDGET_EXCEEDED";
+  if (/INVALID_PARAMETER|MISSING_PARAMETER|EXCLUSIVE_PARAMETERS|INCLUSIVE_PARAMETERS/i.test(message))
+    return "INVALID_PARAMETER";
+  if (/SERVICE_UNAVAILABLE|OVER_CAPACITY|INTERNAL_ERROR/i.test(message)) return "SERVICE_UNAVAILABLE";
+  if (/CANCELLED_REQUEST|timeout|DEADLINE_EXCEEDED/i.test(message)) return "TIMEOUT";
+  return "API_ERROR";
+}
+function isRetryable(code) {
+  return code === "QUOTA_EXCEEDED" || code === "TIMEOUT" || code === "SERVICE_UNAVAILABLE";
+}
+function getRetryDelay(code) {
+  if (code === "QUOTA_EXCEEDED") return 6e4;
+  if (code === "SERVICE_UNAVAILABLE") return 15e3;
+  if (code === "TIMEOUT") return 5e3;
+  return void 0;
+}
+function parseXApiError(errorMessage, accountId) {
+  const code = mapXErrorCode(errorMessage);
+  return {
+    ok: false,
+    error: {
+      code,
+      message: errorMessage,
+      fix: {
+        action: code === "AUTH_ERROR" ? "authenticate" : code === "PERMISSION_DENIED" ? "authenticate" : isRetryable(code) ? "wait_and_retry" : "reject",
+        explanation: explainFix(code, accountId, errorMessage)
+      },
+      retryable: isRetryable(code),
+      retryAfterMs: getRetryDelay(code)
+    }
+  };
+}
+function explainFix(code, accountId, message) {
+  switch (code) {
+    case "AUTH_ERROR":
+      return "Token rejected by X. Reconnect the X Ads provider in Baker dashboard settings.";
+    case "PERMISSION_DENIED":
+      return "App not authorized for this resource. Verify Ads API access at ads.x.com/help and reconnect the provider.";
+    case "ACCOUNT_NOT_FOUND":
+      return `Account ${accountId} not accessible. Run 'baker ads x accounts' to list visible accounts.`;
+    case "QUOTA_EXCEEDED":
+      return "X Ads rate limit exceeded. Wait until the x-rate-limit-reset window passes and retry.";
+    case "INVALID_PARAMETER":
+      return `Invalid parameter sent to X Ads API: ${message}`;
+    case "BUDGET_EXCEEDED":
+      return "Spend exceeds available budget on the funding instrument.";
+    case "SERVICE_UNAVAILABLE":
+      return "X Ads API is temporarily unavailable. Retry after a short backoff.";
+    default:
+      return `Unrecognized X Ads error \u2014 verify request shape against X Ads API docs (${code}).`;
+  }
+}
+
+export {
+  parseXApiError
+};
+//# sourceMappingURL=chunk-M6UNISGO.js.map