@koda-sl/baker-cli 0.574.0-dev.19539e5a8 → 0.575.0-dev.85f21462e

package/dist/chunk-6RWLCOAH.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/research/hints.ts"],"sourcesContent":["/**\n * The `research` family shipped with no `hints[]` on any command. Everything\n * here is one nudge for one dead end that an audited run actually hit — not a\n * running commentary on healthy results.\n */\n\nimport {\n  RESEARCH_GOOGLE_ADS_MAX_COPY,\n  type ResearchCompanyHiring,\n  type ResearchCompanyIndustry,\n  type ResearchRedditSource,\n} from \"@baker/api\";\nimport type { QueryContext } from \"../../geo-context.ts\";\nimport type { ResearchFix } from \"./output.ts\";\n\ntype Depth = \"medium\" | \"high\" | \"xhigh\";\n\n/**\n * `advertisers` is named after advertisers and returns none of their advertising.\n * A run read the name as \"SERP ad creative\", got domain economics, and wrote \"no\n * live paid ad copy captured\" into the client's vault without ever trying the\n * command that does return copy. So this fires on every call, not just empty ones.\n */\nexport const AD_COPY_ROUTE =\n  \"This returns competing domains and their SERP economics — no ad copy, no headlines, no creative. \" +\n  \"For a competitor's Google ads and their copy: `baker research google-ads <competitor.com> --copy` \" +\n  \"(Google's Ads Transparency Center: every ad, how long it has run, and the text ads' headline and description). \" +\n  'For Meta and LinkedIn: `baker winning-ads advertisers \"<brand>\"` → ' +\n  '`baker winning-ads search \"<brief>\" --advertiser-id <id>` → `baker winning-ads content <adId>` ' +\n  \"(`primary_text` / `headline` / `cta`, plus the spoken transcript and on-screen text for video). \" +\n  \"Do not keep querying this command for copy.\";\n\n/**\n * Empty SERP data has two causes and only one is worth a second call: the wrong\n * market. Once the market was explicit, a re-query is waste — say so, because\n * \"no rows\" otherwise reads as \"reword the keyword\".\n */\nexport function noSerpRowsHints(rowCount: number, queryContext: QueryContext): string[] {\n  if (rowCount > 0) {\n    return [];\n  }\n  const defaulted = queryContext.location_is_default || queryContext.language_is_default;\n  if (defaulted) {\n    return [\n      `No rows for ${queryContext.location} / ${queryContext.language} — the market you did not set. ` +\n        \"Set --location and --language for the client's actual market and re-run once \" +\n        \"(`baker research countries` / `baker research languages` for the accepted codes) \" +\n        \"before you touch the keyword.\",\n    ];\n  }\n  return [\n    `No rows for ${queryContext.location} / ${queryContext.language}, which you set explicitly. ` +\n      \"This term has no third-party SERP coverage in that market — move on rather than re-querying it. \" +\n      \"For demand signal try `baker research autocomplete`; for a competitor's actual terms, \" +\n      \"`baker research keywords-for-site <domain>`.\",\n  ];\n}\n\nexport function advertisersHints(rowCount: number, queryContext: QueryContext): string[] {\n  return [...noSerpRowsHints(rowCount, queryContext), AD_COPY_ROUTE];\n}\n\n/**\n * \"This competitor buys no paid search\" is a real competitive answer, but it\n * arrives as an empty array that looks like a broken call — so say which it is\n * before the agent re-runs the same query with a different sort.\n */\nexport function keywordsForSiteHints(\n  rowCount: number,\n  queryContext: QueryContext,\n  typeFilter: string | undefined,\n): string[] {\n  if (rowCount > 0) {\n    return [];\n  }\n  if (typeFilter === \"paid\" || typeFilter === \"organic\") {\n    return [\n      `No rows with --type ${typeFilter} in ${queryContext.location} / ${queryContext.language}. ` +\n        `A domain with zero ${typeFilter} keywords in a market is itself the finding — record it and move on. ` +\n        \"Confirm once with --type all (nothing at all there means the domain has no SERP coverage, \" +\n        \"not that it has no ads) instead of re-running with a different --sort or --limit.\",\n    ];\n  }\n  return noSerpRowsHints(rowCount, queryContext);\n}\n\nconst THIN_ANSWER_CHARS = 600;\nconst THIN_SOURCE_COUNT = 2;\n\n// Only `medium` and `high` have somewhere to escalate to; `xhigh` is the ceiling,\n// so a thin answer there is a fact about the web, not a flag the agent forgot.\nconst ESCALATION: Partial<Record<Depth, string>> = {\n  medium:\n    \"`medium` is a quick lookup, not a search. Re-ask the SAME question once with `--depth high` before \" +\n    \"concluding the web has nothing on it.\",\n  high:\n    \"`high` already thought hard about this. `--depth xhigh` is the only step left and it can run 15 minutes — \" +\n    \"take it only if this answer blocks a deliverable; otherwise record the gap and move on.\",\n};\n\n/**\n * Google grounding used to come back as opaque redirect links labelled by domain,\n * and the agent guessed the real paths, 404'd, and invented links. The backend\n * now follows them; this says what to do with the ones it could not, and with\n * an answer that rests on nothing.\n */\nexport function webSourceHints(sources: Array<{ resolved?: boolean }>): string[] {\n  if (sources.length === 0) {\n    return [\n      \"This answer came back with no sources. Treat every claim in it as Synthesis: — no source to cite. \" +\n        \"Do not attach a URL to it; to cite a fact, find the page that states it and read it with `baker research fetch`.\",\n    ];\n  }\n  // An older backend sends no `resolved`; only an explicit false is a link we know is opaque.\n  const unresolved = sources.filter((s) => s.resolved === false).length;\n  if (unresolved > 0) {\n    return [\n      `${unresolved} of ${sources.length} sources are Google links that could not be followed (resolved: false). ` +\n        \"Do not cite them or guess a path from the site name — cite only a resolved URL, or open the claim's page yourself.\",\n    ];\n  }\n  return [];\n}\n\n/**\n * The one thing worth saying about a page that came back fine is that you are\n * not looking at all of it — which the content itself cannot tell you.\n */\nexport function fetchHints({\n  truncated,\n  contentChars,\n  shownChars,\n}: {\n  truncated: boolean;\n  contentChars: number;\n  shownChars: number;\n}): string[] {\n  const hints: string[] = [];\n\n  if (shownChars < contentChars) {\n    hints.push(\n      `Showing the first ${shownChars.toLocaleString(\"en-US\")} of ${contentChars.toLocaleString(\"en-US\")} characters. ` +\n        \"Re-run the same command with `--full` for the whole page — the read is cached for 24h, so it costs no extra time and no extra credit.\",\n    );\n  }\n\n  if (truncated) {\n    hints.push(\n      \"This page is longer than one read returns, so the end of it is missing. \" +\n        \"Don't present this as the complete page; if the part you need is further down, fetch the deeper URL directly.\",\n    );\n  }\n\n  return hints;\n}\n\nexport function webDepthHints({\n  answer,\n  sourceCount,\n  depth,\n}: {\n  answer: string;\n  sourceCount: number;\n  depth: Depth;\n}): string[] {\n  const thin = answer.length < THIN_ANSWER_CHARS || sourceCount <= THIN_SOURCE_COUNT;\n  const escalation = ESCALATION[depth];\n  if (!thin || !escalation) {\n    return [];\n  }\n  return [`Thin answer (${answer.length} chars, ${sourceCount} source(s)). ${escalation}`];\n}\n\n/**\n * The volume DataForSEO returns is Google's own Keyword Planner figure resold,\n * so putting the two side by side validates nothing — a run did exactly that,\n * found all seven rows agreeing to the digit, and reported the agreement as\n * corroboration. This fires on every call rather than on a suspicious one,\n * because by the time the numbers are in a table the provenance is already gone.\n */\nexport function keywordMetricsHints({\n  rows,\n  asked,\n  clickstream,\n  queryContext,\n}: {\n  rows: Array<{ keyword: string; search_volume: number | null }>;\n  asked: string[];\n  clickstream: boolean;\n  queryContext: QueryContext;\n}): string[] {\n  if (rows.length === 0) {\n    return noSerpRowsHints(0, queryContext);\n  }\n\n  const provenance =\n    \"DataForSEO resells Google's Keyword Planner volume — planner_search_volume here is the SAME number \" +\n    \"`baker ads google keywords metrics` returns, not an independent reading of it. Quoting the two as agreeing \" +\n    \"sources is not corroboration.\" +\n    (clickstream\n      ? \" clickstream_search_volume IS independent (DataForSEO's own panels); when the two disagree, say which one you are quoting.\"\n      : \" For a genuinely independent estimate of demand, re-run with --clickstream (costs 2x), or use first-party data: \" +\n        \"`baker gsc query` for what already reaches the site, or the account's own search terms.\");\n\n  const hints = [provenance];\n\n  const empty = rows.filter((row) => row.search_volume === null).map((row) => row.keyword);\n  if (empty.length > 0) {\n    hints.push(\n      `${empty.length} of ${asked.length} keywords came back with no data in ${queryContext.location} / ${queryContext.language}: ` +\n        `${empty.join(\", \")}. That is missing coverage, NOT zero demand — do not report them as unsearched, and do not ` +\n        \"re-query them reworded. `baker research autocomplete` on the head term is the way to find the phrasing that market uses.\",\n    );\n  }\n\n  return hints;\n}\n\n/**\n * The archive keeps a post's words the moment it is written and its points\n * only once it has settled, so a number on something young is not the number\n * Reddit shows. Said once, when it applies, so a count is never quoted as live.\n */\nconst ARCHIVE_NOTE =\n  \"Read from the Reddit archive: the words are as posted, but points and comment counts on anything under ~36h old are as first captured — don't quote those numbers as current.\";\n\n/**\n * An empty Reddit search is almost always a phrasing miss, not a silent\n * audience: Reddit matches words, and people write in their own. A run that\n * came back empty on a posts search also never looked at the replies, which is\n * where most of the verbatim voice is.\n */\nexport function redditSearchHints({\n  resultCount,\n  kind,\n  source,\n}: {\n  resultCount: number;\n  kind: \"posts\" | \"comments\";\n  source: ResearchRedditSource;\n}): string[] {\n  const hints: string[] = [];\n  if (resultCount === 0) {\n    hints.push(\n      \"Nothing matched. Reddit search matches words, not meaning: try the audience's own phrasing (one distinctive word, \" +\n        \"or a seed from `baker research autocomplete`), a longer --since window, or other subreddits — \" +\n        '`baker research reddit subreddits \"<topic>\"` finds where the audience actually talks' +\n        (kind === \"posts\" ? \", and try --kind comments — most of the voice is in the replies.\" : \".\"),\n    );\n  } else if (kind === \"posts\") {\n    hints.push(\n      \"Titles rarely carry the voice. Read the promising threads with `baker research reddit thread <permalink>` \" +\n        \"for the replies, or search the replies directly with --kind comments.\",\n    );\n  }\n  if (source === \"archive\" && resultCount > 0) hints.push(ARCHIVE_NOTE);\n  return hints;\n}\n\n/** A thread whose replies no source would serve is still the post — but it must not read as a thread nobody answered. */\nexport function redditThreadHints({\n  commentsShown,\n  commentsAsked,\n  commentCount,\n  source,\n}: {\n  commentsShown: number;\n  commentsAsked: number;\n  commentCount: number | null;\n  source: ResearchRedditSource;\n}): string[] {\n  const hints: string[] = [];\n  if (commentsAsked > 0 && commentsShown === 0 && (commentCount ?? 0) > 0) {\n    hints.push(\n      `This thread has ${commentCount} comments but none could be read just now. Quote the post only, and don't describe the replies.`,\n    );\n  }\n  if (source === \"archive\") hints.push(ARCHIVE_NOTE);\n  return hints;\n}\n\nconst REDDIT_HOST = /(^|\\.)reddit\\.com$|^redd\\.it$/i;\n\n/**\n * A subreddit's member count is its size, not its pulse. The run that prompted\n * this command mined r/CouriersUK — a real subreddit, with one post in its whole\n * history — and found nothing. One dated search tells a living subreddit from a\n * dead one before it is relied on.\n */\nexport function redditSubredditsHints({ resultCount }: { resultCount: number }): string[] {\n  if (resultCount === 0) {\n    return [\n      'No subreddits matched. Try the audience\\'s role or the platform they work on (\"amazon flex\", \"deliveroo\", \"nurses\"), one word at a time, or a web search for `site:reddit.com <topic>`.',\n    ];\n  }\n  return [\n    'Members say how big a subreddit is, not how active it is. Before mining one, run `baker research reddit search \"<word>\" --subreddit <name> --since <a recent date>`: nothing back means it is quiet, so pick another. `restricted` can still be read; `private` cannot.',\n  ];\n}\n\n/** A Reddit link that does not lead to the words attributed to it. Shared by `reddit thread` and `fetch`. */\nexport const REDDIT_LINK_REJECTED: ResearchFix = {\n  action: \"reject\",\n  explanation:\n    \"Do not quote anything attributed to this link — it does not lead to those words. Find the real thread with `baker research reddit search`, and if you already wrote a quote from it, remove it.\",\n};\n\n/**\n * `research fetch` hands a Reddit URL to the Reddit reader, but its generic\n * remediation was written for ordinary pages: FORBIDDEN reads \"this will not\n * open, carry on without it\" and NOT_FOUND \"carry on\". For Reddit both are the\n * wrong advice. A page the reader will not turn into a thread is one `reddit`\n * command away, and a link that leads nowhere real must not be quoted at all.\n */\nexport function redditPageFix(url: string, code: string): ResearchFix | null {\n  let host: string;\n  try {\n    host = new URL(url).hostname;\n  } catch {\n    return null;\n  }\n  if (!REDDIT_HOST.test(host)) return null;\n  if (code === \"NOT_FOUND\") return REDDIT_LINK_REJECTED;\n  if (code !== \"FORBIDDEN\") return null;\n  return {\n    action: \"retry_with_changes\",\n    explanation:\n      'Read Reddit with its own commands: `baker research reddit search \"<words>\" --subreddit <name>` to find what people said, `baker research reddit thread <url>` for one thread.',\n  };\n}\n\n/**\n * `google-ads` replaces a browser trip through Google's Ads Transparency\n * Center, so its hints keep the agent out of one: no ads is an answer, and an\n * ad whose copy Google does not give is shown by its link, never opened.\n */\nexport function googleAdsHints({\n  target,\n  adCount,\n  located,\n  textWithoutCopy,\n  copyAsked,\n  copyUnread,\n  visual,\n}: {\n  target: string;\n  adCount: number;\n  located: boolean;\n  textWithoutCopy: number;\n  copyAsked: boolean;\n  copyUnread: number;\n  visual: number;\n}): string[] {\n  if (adCount === 0) {\n    return [\n      `No Google ads point to ${target}${located ? \" in that region\" : \"\"} — that is the answer, not a failed call: ` +\n        \"this competitor is not advertising on Google there, or its ads point to another domain. \" +\n        (located ? \"Re-run once without --location to see every region; then move on. \" : \"Move on. \") +\n        `Its paid search terms, if any: \\`baker research keywords-for-site ${target} --type paid\\`.`,\n    ];\n  }\n  const hints: string[] = [];\n  if (!copyAsked && textWithoutCopy > 0) {\n    hints.push(\n      `${textWithoutCopy} text ads came back without their words. Re-run with --copy to read the headline and description of up to ${RESEARCH_GOOGLE_ADS_MAX_COPY} (cached, so only the reading is new).`,\n    );\n  }\n  const pastCap = copyAsked ? textWithoutCopy - copyUnread : 0;\n  if (pastCap > 0) {\n    hints.push(\n      `${pastCap} text ads past the first ${RESEARCH_GOOGLE_ADS_MAX_COPY} were not read — one request reads at most ${RESEARCH_GOOGLE_ADS_MAX_COPY}. ` +\n        \"Narrow with --since, --location or --platform google_search and re-run for their words.\",\n    );\n  }\n  if (visual > 0 || copyUnread > 0) {\n    const without = [\n      visual > 0 ? `${visual} image or video ads (Google gives no text for those)` : \"\",\n      copyUnread > 0 ? `${copyUnread} text ads whose image could not be read` : \"\",\n    ].filter(Boolean);\n    hints.push(\n      `No copy for ${without.join(\" and \")}: show those by their \\`transparency_url\\`. ` +\n        \"Do not open the Transparency Center in agent-browser to read them — it is the browser load this command exists to avoid.\",\n    );\n  }\n  return hints;\n}\n\n/**\n * A person's profile is read to write one account's ads and pages, and that is\n * all it is for. Said on every read, because the next natural step — saving\n * them to Knowledge, or reading them again next week — is the one we don't take.\n */\nexport const LINKEDIN_PERSON_USE =\n  \"For ad and page messaging only; nothing is stored — quote their stated priorities into the creative brief \" +\n  \"for this account, and don't save the person to Knowledge or read them again to keep track of them.\";\n\nexport function linkedinPersonHints({ isPrivate, postCount }: { isPrivate: boolean; postCount: number }): string[] {\n  if (isPrivate) {\n    return [\n      \"LinkedIn doesn't show this profile publicly, and reading it again won't change that. \" +\n        \"Find their own words elsewhere — a keynote, podcast or earnings call through \" +\n        \"`baker research transcript <url>`, or an interview through `baker research fetch <url>` — \" +\n        \"or write the brief from the account's company-level priorities.\",\n    ];\n  }\n  if (postCount === 0) {\n    return [\n      LINKEDIN_PERSON_USE,\n      \"They have no recent posts, so their `about` is the only first-person line here. \" +\n        \"Their priorities are more often said aloud: a keynote, podcast or earnings call through `baker research transcript <url>`.\",\n    ];\n  }\n  return [LINKEDIN_PERSON_USE];\n}\n\n/**\n * A keynote runs to tens of thousands of words, which is why the default is an\n * excerpt; the transcript is cached for a week, so asking again for the rest\n * costs nothing.\n */\nexport function transcriptHints({ excerpted, truncated }: { excerpted: boolean; truncated: boolean }): string[] {\n  const hints: string[] = [];\n  if (excerpted) {\n    hints.push(\n      \"This is the opening excerpt. Re-run with `--out <file>` to write the whole text to a file and read the parts you need, \" +\n        \"or `--full` to have it all here — the transcript is cached for 7 days, so either costs nothing more.\",\n    );\n  }\n  if (truncated) {\n    hints.push(\n      \"The recording is longer than one transcript carries, so the end of the recording is missing. \" +\n        \"Don't quote this as the whole talk.\",\n    );\n  }\n  return hints;\n}\n\n/** The facts whose absence marks a profile as possibly another company's. */\nexport interface CompanyProfileFacts {\n  linkedinUrl: string | null;\n  hqCountry: string | null;\n  employees: string | null;\n}\n\n/**\n * A profile missing two of its anchor facts, or sized 1-10, is often a namesake\n * on the domain asked for while the company itself runs on another one.\n */\nfunction thinProfileHint(domain: string, profile: CompanyProfileFacts): string | null {\n  const missing = [\n    profile.linkedinUrl ? null : \"no LinkedIn page\",\n    profile.hqCountry ? null : \"no HQ country\",\n    profile.employees ? null : \"no employee band\",\n  ].filter((gap) => gap !== null);\n  const tiny = profile.employees === \"1-10\";\n  if (missing.length < 2 && !tiny) return null;\n  const why = [...missing, ...(tiny ? [\"1-10 employees\"] : [])].join(\", \");\n  return (\n    `This profile is thin (${why}). Check ${domain} is the company's main website — companies often run on another ` +\n    \"domain (e.g. factorial.es vs factorialhr.com) — before using these facts for tiering.\"\n  );\n}\n\n/**\n * Hiring is a signal on top of the profile, so a lookup without it still\n * answers — and says which half is missing, so the agent neither loops on it\n * nor reads \"no openings\" into a gap. A hiring read left out on purpose\n * (`--no-hiring`) says nothing.\n */\nexport function companyHints({\n  domain,\n  profile,\n  hiring,\n}: {\n  domain: string;\n  profile: CompanyProfileFacts | null;\n  hiring: ResearchCompanyHiring;\n}): string[] {\n  const hints: string[] = [];\n  if (!profile) {\n    hints.push(\n      \"There's no company profile for this domain, only its hiring. Check it is the company's main website; \" +\n        \"otherwise take size, industry and location from its LinkedIn page or its own site.\",\n    );\n  } else {\n    const thin = thinProfileHint(domain, profile);\n    if (thin) hints.push(thin);\n  }\n  if (hiring.status === \"unavailable\" && hiring.reason === \"not_configured\") {\n    hints.push(\n      \"Hiring signals aren't switched on for this workspace yet, so these are the firmographics alone. \" +\n        \"Score the account on them and leave hiring out of the reason.\",\n    );\n  }\n  if (hiring.status === \"unavailable\" && hiring.reason === \"failed\") {\n    hints.push(\n      \"Hiring signals couldn't be read this time; don't retry in a loop. Use the firmographics and say hiring is unknown for this account.\",\n    );\n  }\n  if (hiring.status === \"not_tracked\") {\n    hints.push(\n      \"No hiring data is kept for this company — that means unknown, not that it isn't hiring. Don't score it down for it.\",\n    );\n  }\n  return hints;\n}\n\nfunction industryList(industries: readonly ResearchCompanyIndustry[]): string {\n  return industries.map(({ slug, companies }) => `${slug} (${companies.toLocaleString(\"en-US\")})`).join(\", \");\n}\n\n/**\n * Neighbouring industries the search left out, so a thin market is widened on\n * purpose rather than guessed at. Each count is the companies it would add.\n */\nfunction relatedIndustriesHint(related: readonly ResearchCompanyIndustry[]): string | null {\n  if (related.length === 0) return null;\n  return (\n    `Related industries not included (companies each adds with your other filters): ${industryList(related)}` +\n    \" — add them with --industry a,b to widen.\"\n  );\n}\n\nexport function companySearchHints({\n  total,\n  returned,\n  page,\n  lastPage,\n  related,\n}: {\n  total: number;\n  returned: number;\n  page: number;\n  lastPage: number;\n  related: readonly ResearchCompanyIndustry[];\n}): string[] {\n  const hints: string[] = [];\n  if (total === 0) {\n    hints.push(\n      \"No company matches every filter. Widen one at a time — a neighbouring size band, a related industry, one more country.\",\n    );\n  } else if (page < lastPage && returned > 0) {\n    hints.push(\n      `${total} companies match and ${returned} came back (each one returned is billed). ` +\n        `Use \\`total\\` to size the market; ask for \\`--page ${page + 1}\\` only if you need the next rows for the list.`,\n    );\n  }\n  const widen = relatedIndustriesHint(related);\n  if (widen) hints.push(widen);\n  return hints;\n}\n\n/** An industry that is no slug refuses the search before anything is billed; the fix offers the real ones. */\nexport function unknownIndustriesFix(industries: readonly { input: string; closest: ResearchCompanyIndustry[] }[]): {\n  action: \"retry_with_changes\";\n  explanation: string;\n} {\n  const misses = industries.map(({ input, closest }) =>\n    closest.length > 0\n      ? `\"${input}\" is not an industry. Closest (companies each matches with your other filters): ${industryList(closest)}.`\n      : `\"${input}\" is not an industry, and none is named like it — try a broader word (software, logistics, retail).`,\n  );\n  return {\n    action: \"retry_with_changes\",\n    explanation: `${misses.join(\" \")} Pass one or several of these slugs with --industry a,b — several widen the search, any of them matching. Nothing was charged.`,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-6TNRSWNA.js

@@ -1,207 +0,0 @@
-import {
-  handleConnectionError,
-  needsConnectionFix,
-  writeAdsJson
-} from "./chunk-MPTNN35I.js";
-import {
-  LINKEDIN_SEARCH_STATUSES,
-  unsupportedLinkedinSearchStatuses
-} from "./chunk-5N77IAOT.js";
-import {
-  ApiError
-} from "./chunk-LJEJCIHR.js";
-import {
-  MissingChatIdError,
-  getEnv
-} from "./chunk-B64KJW5C.js";
-
-// src/commands/ads/linkedin/shared.ts
-import { readFileSync } from "fs";
-var DAY_MS = 864e5;
-function handleLinkedinError(err) {
-  if (err instanceof ApiError) {
-    if (needsConnectionFix(err.code, err.message)) {
-      handleConnectionError("linkedin_ads", err.message);
-    }
-    if (isNoAccountsSelectedError(err.code, err.message)) {
-      handleConnectionError("linkedin_ads", err.message);
-    }
-    const explanation = explainLinkedinError(err);
-    const envelope = {
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        fix: {
-          action: explanation.action,
-          explanation: explanation.message,
-          correctedCommand: explanation.correctedCommand
-        },
-        retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE" || err.code === "INTERNAL_ERROR"
-      }
-    };
-    writeAdsJson(envelope);
-    process.exit(1);
-  }
-  writeAdsJson(unexpectedErrorEnvelope(err));
-  process.exit(1);
-}
-function unexpectedErrorEnvelope(err) {
-  if (err instanceof MissingChatIdError) {
-    return {
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        fix: {
-          action: "reject",
-          explanation: "LinkedIn changes are staged in a chat and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here."
-        },
-        retryable: false
-      }
-    };
-  }
-  const message = err instanceof Error ? err.message : "Unexpected error";
-  return { ok: false, error: { code: "NETWORK_ERROR", message } };
-}
-function isNoAccountsSelectedError(code, message) {
-  return code === "VALIDATION_ERROR" && /no linkedin ad accounts selected/i.test(message);
-}
-function explainLinkedinError(err) {
-  const lower = err.message.toLowerCase();
-  if (err.code === "VALIDATION_ERROR" && lower.includes("granularity") && lower.includes("daily")) {
-    return {
-      action: "retry_with_flag",
-      message: "LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.",
-      correctedCommand: void 0
-    };
-  }
-  if (err.code === "RATE_LIMITED") {
-    return {
-      action: "wait_and_retry",
-      message: "LinkedIn asked Baker to wait. A short wait is already sat out for you, so this one is long \u2014 up to LinkedIn's daily limit, which resets at midnight UTC. Don't retry in a loop: carry on with the rest of the job without this LinkedIn data, and tell the user it can be read again later."
-    };
-  }
-  if (err.code === "INTERNAL_ERROR" && lower.includes("deprecat")) {
-    return {
-      action: "reject",
-      message: "LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped \u2014 file an issue or update the constant."
-    };
-  }
-  return { action: "reject", message: err.message };
-}
-var LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\d+$/;
-function resolveAccountIdArg(args) {
-  const fromArgs = args["account-id"] ?? args["account-urn"];
-  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;
-  if (!id) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "MISSING_ACCOUNT_ID",
-        message: "Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs."
-      }
-    });
-    process.exit(1);
-  }
-  if (!LI_ACCOUNT_ID_RE.test(id)) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "INVALID_ACCOUNT_ID",
-        message: `Invalid LinkedIn account ID "${id}". Expected numeric or urn:li:sponsoredAccount:N.`
-      }
-    });
-    process.exit(1);
-  }
-  return id.startsWith("urn:") ? id.split(":").pop() ?? id : id;
-}
-function todayIso() {
-  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-}
-function daysAgoIso(days) {
-  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);
-}
-function csvOrJson(args) {
-  return args.output ?? "json";
-}
-function statusesArgDescription(level) {
-  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(",")})`;
-}
-function statusFilterError(level, statuses) {
-  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);
-  if (unsupported.length === 0) {
-    return null;
-  }
-  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(",");
-  return {
-    ok: false,
-    error: {
-      code: "INVALID_STATUS",
-      message: `LinkedIn does not accept status ${unsupported.join(", ")} for this listing.`,
-      fix: {
-        action: "retry_with_flag",
-        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`
-      },
-      retryable: false
-    }
-  };
-}
-function resolveStatusFilter(args, level) {
-  if (args["all-statuses"]) {
-    return void 0;
-  }
-  const explicit = args.statuses;
-  if (!explicit) {
-    return ["ACTIVE"];
-  }
-  const statuses = explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
-  const error = statusFilterError(level, statuses);
-  if (error) {
-    writeAdsJson(error);
-    process.exit(1);
-  }
-  return statuses;
-}
-function loadTargetingArg(args) {
-  const inline = args.targeting;
-  if (inline) {
-    try {
-      return JSON.parse(inline);
-    } catch {
-      handleLinkedinError(new Error("--targeting must be valid JSON. See LinkedIn 'targetingCriteria' shape."));
-    }
-  }
-  const file = args["targeting-file"];
-  if (file) {
-    try {
-      return JSON.parse(readFileSync(file, "utf-8"));
-    } catch (e) {
-      handleLinkedinError(
-        new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
-      );
-    }
-  }
-  handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
-}
-function exitOnInvalidArgs(issues, flagByField) {
-  const messages = issues.map((issue) => {
-    const field = String(issue.path[0] ?? "");
-    return `${flagByField[field] ?? (field || "args")}: ${issue.message}`;
-  });
-  writeAdsJson({ ok: false, error: { code: "INVALID_ARGS", message: messages.join("; ") } });
-  process.exit(1);
-}
-
-export {
-  handleLinkedinError,
-  resolveAccountIdArg,
-  todayIso,
-  daysAgoIso,
-  csvOrJson,
-  statusesArgDescription,
-  resolveStatusFilter,
-  loadTargetingArg,
-  exitOnInvalidArgs
-};
-//# sourceMappingURL=chunk-6TNRSWNA.js.map

package/dist/chunk-6TNRSWNA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/ads/linkedin/shared.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { LINKEDIN_SEARCH_STATUSES, type LinkedinSearchLevel, unsupportedLinkedinSearchStatuses } from \"@baker/api\";\nimport { ApiError } from \"../../../client.ts\";\nimport { getEnv, MissingChatIdError } from \"../../../env.ts\";\nimport { handleConnectionError, needsConnectionFix } from \"../../../error-handler.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport type { AdsErrorEnvelope } from \"../types.ts\";\n\nconst DAY_MS = 86_400_000;\n\n/**\n * Map LinkedIn-flavored API errors into the shared CLI error envelope. The\n * backend already maps LinkedIn `serviceErrorCode` → tagged HTTP status, so by\n * the time we get here we just need to attach an actionable `fix` and exit.\n */\nexport function handleLinkedinError(err: unknown): never {\n  if (err instanceof ApiError) {\n    if (needsConnectionFix(err.code, err.message)) {\n      handleConnectionError(\"linkedin_ads\", err.message);\n    }\n    if (isNoAccountsSelectedError(err.code, err.message)) {\n      handleConnectionError(\"linkedin_ads\", err.message);\n    }\n    const explanation = explainLinkedinError(err);\n    const envelope: AdsErrorEnvelope = {\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: {\n          action: explanation.action,\n          explanation: explanation.message,\n          correctedCommand: explanation.correctedCommand,\n        },\n        retryable: err.code === \"RATE_LIMITED\" || err.code === \"UNAVAILABLE\" || err.code === \"INTERNAL_ERROR\",\n      },\n    };\n    writeAdsJson(envelope);\n    process.exit(1);\n  }\n  writeAdsJson(unexpectedErrorEnvelope(err));\n  process.exit(1);\n}\n\n/**\n * Any failure that is not an API answer. A missing chat id gets its own code\n * and a fix — no retry can supply it — and anything else reads as the network.\n */\nexport function unexpectedErrorEnvelope(err: unknown): {\n  ok: false;\n  error: Pick<AdsErrorEnvelope[\"error\"], \"code\" | \"message\"> &\n    Partial<Pick<AdsErrorEnvelope[\"error\"], \"fix\" | \"retryable\">>;\n} {\n  if (err instanceof MissingChatIdError) {\n    return {\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: {\n          action: \"reject\",\n          explanation:\n            \"LinkedIn changes are staged in a chat and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here.\",\n        },\n        retryable: false,\n      },\n    };\n  }\n  const message = err instanceof Error ? err.message : \"Unexpected error\";\n  return { ok: false, error: { code: \"NETWORK_ERROR\", message } };\n}\n\n/**\n * \"No ad accounts selected\" comes back as a 400 (→ VALIDATION_ERROR), which\n * reads like a bad flag but is really an unfinished connection: the user has to\n * pick their accounts again. Route it to the connect flow, not flag advice.\n */\nexport function isNoAccountsSelectedError(code: string, message: string): boolean {\n  return code === \"VALIDATION_ERROR\" && /no linkedin ad accounts selected/i.test(message);\n}\n\nfunction explainLinkedinError(err: ApiError): {\n  action: AdsErrorEnvelope[\"error\"][\"fix\"][\"action\"];\n  message: string;\n  correctedCommand?: string;\n} {\n  const lower = err.message.toLowerCase();\n  if (err.code === \"VALIDATION_ERROR\" && lower.includes(\"granularity\") && lower.includes(\"daily\")) {\n    return {\n      action: \"retry_with_flag\",\n      message:\n        \"LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.\",\n      correctedCommand: undefined,\n    };\n  }\n  if (err.code === \"RATE_LIMITED\") {\n    return {\n      action: \"wait_and_retry\",\n      message:\n        \"LinkedIn asked Baker to wait. A short wait is already sat out for you, so this one is long — up to LinkedIn's daily limit, which resets at midnight UTC. Don't retry in a loop: carry on with the rest of the job without this LinkedIn data, and tell the user it can be read again later.\",\n    };\n  }\n  if (err.code === \"INTERNAL_ERROR\" && lower.includes(\"deprecat\")) {\n    return {\n      action: \"reject\",\n      message:\n        \"LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped — file an issue or update the constant.\",\n    };\n  }\n  return { action: \"reject\", message: err.message };\n}\n\nconst LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\\d+$/;\n\n/** Pull the default LinkedIn ad account ID from `--account-id` arg or env. */\nexport function resolveAccountIdArg(args: Record<string, unknown>): string {\n  const fromArgs = (args[\"account-id\"] as string | undefined) ?? (args[\"account-urn\"] as string | undefined);\n  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;\n  if (!id) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"MISSING_ACCOUNT_ID\",\n        message:\n          \"Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs.\",\n      },\n    });\n    process.exit(1);\n  }\n  if (!LI_ACCOUNT_ID_RE.test(id)) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"INVALID_ACCOUNT_ID\",\n        message: `Invalid LinkedIn account ID \"${id}\". Expected numeric or urn:li:sponsoredAccount:N.`,\n      },\n    });\n    process.exit(1);\n  }\n  return id.startsWith(\"urn:\") ? (id.split(\":\").pop() ?? id) : id;\n}\n\nexport function todayIso(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\nexport function daysAgoIso(days: number): string {\n  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);\n}\n\nexport function csvOrJson(args: Record<string, unknown>): string {\n  return (args.output as string | undefined) ?? \"json\";\n}\n\n/** The `--statuses` help line, listing exactly what LinkedIn accepts at this level. */\nexport function statusesArgDescription(level: LinkedinSearchLevel): string {\n  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(\",\")})`;\n}\n\n/**\n * One status LinkedIn does not know fails the whole listing, so refuse it here\n * with the accepted values instead of forwarding LinkedIn's enum error.\n */\nexport function statusFilterError(level: LinkedinSearchLevel, statuses: readonly string[]): AdsErrorEnvelope | null {\n  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);\n  if (unsupported.length === 0) {\n    return null;\n  }\n  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(\",\");\n  return {\n    ok: false,\n    error: {\n      code: \"INVALID_STATUS\",\n      message: `LinkedIn does not accept status ${unsupported.join(\", \")} for this listing.`,\n      fix: {\n        action: \"retry_with_flag\",\n        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`,\n      },\n      retryable: false,\n    },\n  };\n}\n\n/**\n * Default to ACTIVE-only on listings — almost always what an AI agent or human\n * glance wants. `--all-statuses` widens; `--statuses ACTIVE,PAUSED` overrides.\n */\nexport function resolveStatusFilter(args: Record<string, unknown>, level: LinkedinSearchLevel): string[] | undefined {\n  if (args[\"all-statuses\"]) {\n    return undefined;\n  }\n  const explicit = args.statuses as string | undefined;\n  if (!explicit) {\n    return [\"ACTIVE\"];\n  }\n  const statuses = explicit\n    .split(\",\")\n    .map((s) => s.trim().toUpperCase())\n    .filter(Boolean);\n  const error = statusFilterError(level, statuses);\n  if (error) {\n    writeAdsJson(error);\n    process.exit(1);\n  }\n  return statuses;\n}\n\n/**\n * Read targeting JSON from --targeting (inline JSON) or --targeting-file.\n * Failure exits via handleLinkedinError.\n */\nexport function loadTargetingArg(args: Record<string, unknown>): unknown {\n  const inline = args.targeting as string | undefined;\n  if (inline) {\n    try {\n      return JSON.parse(inline);\n    } catch {\n      handleLinkedinError(new Error(\"--targeting must be valid JSON. See LinkedIn 'targetingCriteria' shape.\"));\n    }\n  }\n  const file = args[\"targeting-file\"] as string | undefined;\n  if (file) {\n    try {\n      return JSON.parse(readFileSync(file, \"utf-8\"));\n    } catch (e) {\n      handleLinkedinError(\n        new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : \"I/O error\"}`),\n      );\n    }\n  }\n  handleLinkedinError(new Error(\"Pass --targeting-file <path> or --targeting '{...JSON...}'\"));\n}\n\n/**\n * Exit with an INVALID_ARGS envelope naming the flag behind each schema issue,\n * so a bad value fails here instead of as a LinkedIn error.\n */\nexport function exitOnInvalidArgs(\n  issues: ReadonlyArray<{ path: ReadonlyArray<PropertyKey>; message: string }>,\n  flagByField: Record<string, string>,\n): never {\n  const messages = issues.map((issue) => {\n    const field = String(issue.path[0] ?? \"\");\n    return `${flagByField[field] ?? (field || \"args\")}: ${issue.message}`;\n  });\n  writeAdsJson({ ok: false, error: { code: \"INVALID_ARGS\", message: messages.join(\"; \") } });\n  process.exit(1);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA,SAAS,oBAAoB;AAQ7B,IAAM,SAAS;AAOR,SAAS,oBAAoB,KAAqB;AACvD,MAAI,eAAe,UAAU;AAC3B,QAAI,mBAAmB,IAAI,MAAM,IAAI,OAAO,GAAG;AAC7C,4BAAsB,gBAAgB,IAAI,OAAO;AAAA,IACnD;AACA,QAAI,0BAA0B,IAAI,MAAM,IAAI,OAAO,GAAG;AACpD,4BAAsB,gBAAgB,IAAI,OAAO;AAAA,IACnD;AACA,UAAM,cAAc,qBAAqB,GAAG;AAC5C,UAAM,WAA6B;AAAA,MACjC,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM,IAAI;AAAA,QACV,SAAS,IAAI;AAAA,QACb,KAAK;AAAA,UACH,QAAQ,YAAY;AAAA,UACpB,aAAa,YAAY;AAAA,UACzB,kBAAkB,YAAY;AAAA,QAChC;AAAA,QACA,WAAW,IAAI,SAAS,kBAAkB,IAAI,SAAS,iBAAiB,IAAI,SAAS;AAAA,MACvF;AAAA,IACF;AACA,iBAAa,QAAQ;AACrB,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,eAAa,wBAAwB,GAAG,CAAC;AACzC,UAAQ,KAAK,CAAC;AAChB;AAMO,SAAS,wBAAwB,KAItC;AACA,MAAI,eAAe,oBAAoB;AACrC,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM,IAAI;AAAA,QACV,SAAS,IAAI;AAAA,QACb,KAAK;AAAA,UACH,QAAQ;AAAA,UACR,aACE;AAAA,QACJ;AAAA,QACA,WAAW;AAAA,MACb;AAAA,IACF;AAAA,EACF;AACA,QAAM,UAAU,eAAe,QAAQ,IAAI,UAAU;AACrD,SAAO,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,iBAAiB,QAAQ,EAAE;AAChE;AAOO,SAAS,0BAA0B,MAAc,SAA0B;AAChF,SAAO,SAAS,sBAAsB,oCAAoC,KAAK,OAAO;AACxF;AAEA,SAAS,qBAAqB,KAI5B;AACA,QAAM,QAAQ,IAAI,QAAQ,YAAY;AACtC,MAAI,IAAI,SAAS,sBAAsB,MAAM,SAAS,aAAa,KAAK,MAAM,SAAS,OAAO,GAAG;AAC/F,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SACE;AAAA,MACF,kBAAkB;AAAA,IACpB;AAAA,EACF;AACA,MAAI,IAAI,SAAS,gBAAgB;AAC/B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SACE;AAAA,IACJ;AAAA,EACF;AACA,MAAI,IAAI,SAAS,oBAAoB,MAAM,SAAS,UAAU,GAAG;AAC/D,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SACE;AAAA,IACJ;AAAA,EACF;AACA,SAAO,EAAE,QAAQ,UAAU,SAAS,IAAI,QAAQ;AAClD;AAEA,IAAM,mBAAmB;AAGlB,SAAS,oBAAoB,MAAuC;AACzE,QAAM,WAAY,KAAK,YAAY,KAA6B,KAAK,aAAa;AAClF,QAAM,KAAK,YAAY,OAAO,EAAE;AAChC,MAAI,CAAC,IAAI;AACP,iBAAa;AAAA,MACX,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SACE;AAAA,MACJ;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,MAAI,CAAC,iBAAiB,KAAK,EAAE,GAAG;AAC9B,iBAAa;AAAA,MACX,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS,gCAAgC,EAAE;AAAA,MAC7C;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,SAAO,GAAG,WAAW,MAAM,IAAK,GAAG,MAAM,GAAG,EAAE,IAAI,KAAK,KAAM;AAC/D;AAEO,SAAS,WAAmB;AACjC,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE;AAC7C;AAEO,SAAS,WAAW,MAAsB;AAC/C,SAAO,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE;AACvE;AAEO,SAAS,UAAU,MAAuC;AAC/D,SAAQ,KAAK,UAAiC;AAChD;AAGO,SAAS,uBAAuB,OAAoC;AACzE,SAAO,oBAAoB,yBAAyB,KAAK,EAAE,KAAK,GAAG,CAAC;AACtE;AAMO,SAAS,kBAAkB,OAA4B,UAAsD;AAClH,QAAM,cAAc,kCAAkC,OAAO,QAAQ;AACrE,MAAI,YAAY,WAAW,GAAG;AAC5B,WAAO;AAAA,EACT;AACA,QAAM,WAAW,yBAAyB,KAAK,EAAE,KAAK,GAAG;AACzD,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS,mCAAmC,YAAY,KAAK,IAAI,CAAC;AAAA,MAClE,KAAK;AAAA,QACH,QAAQ;AAAA,QACR,aAAa,+BAA+B,QAAQ;AAAA,MACtD;AAAA,MACA,WAAW;AAAA,IACb;AAAA,EACF;AACF;AAMO,SAAS,oBAAoB,MAA+B,OAAkD;AACnH,MAAI,KAAK,cAAc,GAAG;AACxB,WAAO;AAAA,EACT;AACA,QAAM,WAAW,KAAK;AACtB,MAAI,CAAC,UAAU;AACb,WAAO,CAAC,QAAQ;AAAA,EAClB;AACA,QAAM,WAAW,SACd,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,EACjC,OAAO,OAAO;AACjB,QAAM,QAAQ,kBAAkB,OAAO,QAAQ;AAC/C,MAAI,OAAO;AACT,iBAAa,KAAK;AAClB,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,SAAO;AACT;AAMO,SAAS,iBAAiB,MAAwC;AACvE,QAAM,SAAS,KAAK;AACpB,MAAI,QAAQ;AACV,QAAI;AACF,aAAO,KAAK,MAAM,MAAM;AAAA,IAC1B,QAAQ;AACN,0BAAoB,IAAI,MAAM,yEAAyE,CAAC;AAAA,IAC1G;AAAA,EACF;AACA,QAAM,OAAO,KAAK,gBAAgB;AAClC,MAAI,MAAM;AACR,QAAI;AACF,aAAO,KAAK,MAAM,aAAa,MAAM,OAAO,CAAC;AAAA,IAC/C,SAAS,GAAG;AACV;AAAA,QACE,IAAI,MAAM,oCAAoC,aAAa,QAAQ,EAAE,UAAU,WAAW,EAAE;AAAA,MAC9F;AAAA,IACF;AAAA,EACF;AACA,sBAAoB,IAAI,MAAM,4DAA4D,CAAC;AAC7F;AAMO,SAAS,kBACd,QACA,aACO;AACP,QAAM,WAAW,OAAO,IAAI,CAAC,UAAU;AACrC,UAAM,QAAQ,OAAO,MAAM,KAAK,CAAC,KAAK,EAAE;AACxC,WAAO,GAAG,YAAY,KAAK,MAAM,SAAS,OAAO,KAAK,MAAM,OAAO;AAAA,EACrE,CAAC;AACD,eAAa,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,gBAAgB,SAAS,SAAS,KAAK,IAAI,EAAE,EAAE,CAAC;AACzF,UAAQ,KAAK,CAAC;AAChB;","names":[]}

package/dist/chunk-7NBQQOCU.js

@@ -1,97 +0,0 @@
-import {
-  ApiError,
-  apiGet,
-  apiPost
-} from "./chunk-LJEJCIHR.js";
-
-// src/commands/images/api.ts
-import { readFile } from "fs/promises";
-import { basename, extname } from "path";
-var imageProcessingTimeoutMs = 18e4;
-var imageReadyPollIntervalMs = 2e3;
-var mimeMap = {
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".webp": "image/webp",
-  ".svg": "image/svg+xml",
-  ".avif": "image/avif"
-};
-var defaultImageApiDeps = {
-  readFile,
-  post: apiPost,
-  get: apiGet,
-  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
-};
-function detectImageContentType(filePath, opts = {}) {
-  const ext = extname(filePath).toLowerCase();
-  const contentType = mimeMap[ext];
-  if (!contentType || opts.allowedContentTypes && !opts.allowedContentTypes.includes(contentType)) {
-    throw new ApiError(
-      "VALIDATION_ERROR",
-      opts.unsupportedMessage ?? `Cannot detect content type for extension "${ext}". Use --content-type.`
-    );
-  }
-  return contentType;
-}
-async function uploadLocalImage(args, deps = defaultImageApiDeps) {
-  return uploadImageBytes(
-    {
-      bytes: await deps.readFile(args.file),
-      contentType: args.contentType,
-      // Only the bytes used to be sent, so "iso27001-badge.png" arrived as an
-      // anonymous blob. The describe pass treats this as a hint, not gospel.
-      originalFilename: basename(args.file),
-      source: args.source,
-      descriptionContext: args.descriptionContext
-    },
-    deps
-  );
-}
-function uploadImageBytes(args, deps = defaultImageApiDeps) {
-  const body = {
-    base64: args.bytes.toString("base64"),
-    contentType: args.contentType,
-    originalFilename: args.originalFilename
-  };
-  if (args.source) body.source = args.source;
-  if (args.descriptionContext) body.descriptionContext = args.descriptionContext;
-  if (args.group) body.group = args.group;
-  return deps.post("/api/images/upload", body, { timeoutMs: imageProcessingTimeoutMs });
-}
-function getImage(deps, imageId) {
-  return deps.get("/api/images/get", { id: imageId });
-}
-function publishImageAsCreative(deps, args) {
-  return deps.post("/api/creatives/publish", args);
-}
-async function waitForReadyImage(deps, imageId, opts = {}) {
-  const timeoutMs = opts.timeoutMs ?? imageProcessingTimeoutMs;
-  const pollIntervalMs = opts.pollIntervalMs ?? imageReadyPollIntervalMs;
-  const deadline = Date.now() + timeoutMs;
-  let lastStatus = "unknown";
-  while (Date.now() <= deadline) {
-    const image = await getImage(deps, imageId);
-    lastStatus = image.status;
-    if (image.status === "ready") {
-      return image;
-    }
-    if (image.status === "error") {
-      throw new ApiError("IMAGE_PROCESSING_ERROR", "Image processing failed");
-    }
-    await deps.sleep(pollIntervalMs);
-  }
-  throw new ApiError("TIMEOUT", `Image was not ready before timeout; last status: ${lastStatus}`);
-}
-
-export {
-  imageProcessingTimeoutMs,
-  defaultImageApiDeps,
-  detectImageContentType,
-  uploadLocalImage,
-  uploadImageBytes,
-  publishImageAsCreative,
-  waitForReadyImage
-};
-//# sourceMappingURL=chunk-7NBQQOCU.js.map

package/dist/chunk-7YXBMYSM.js

@@ -1,91 +0,0 @@
-import {
-  definitionPlatformOf,
-  parseDefinitionDelivery,
-  resolveDelivery,
-  resolveFormatList
-} from "./chunk-AUDVBN6H.js";
-import {
-  AD_PLACEMENTS
-} from "./chunk-F3CZFUXZ.js";
-import {
-  CAPABILITY_SURFACES
-} from "./chunk-R7XDGNZD.js";
-import {
-  apiPost
-} from "./chunk-LJEJCIHR.js";
-
-// src/commands/canvas/scaffold-delivery.ts
-var flagText = (value) => typeof value === "string" || typeof value === "number" ? String(value).trim() || void 0 : void 0;
-function deliveryInputOf(flags, definition, idea) {
-  const platformsFlag = flagText(flags.platforms);
-  const legacyPlatform = flagText(flags.platform);
-  const legacyPlacements = flagText(flags.placements);
-  const aspect = flagText(flags.aspect);
-  const formatsFlag = flagText(flags.formats);
-  const targetAdSet = flagText(flags["target-adset"]);
-  return {
-    ...platformsFlag ? { platformsFlag } : {},
-    ...legacyPlatform ? { legacyPlatform } : {},
-    ...legacyPlacements ? { legacyPlacements } : {},
-    ...aspect ? { aspect } : {},
-    ...formatsFlag ? { formatsFlag } : {},
-    ...idea && idea.length > 0 ? { idea } : {},
-    definition,
-    ...targetAdSet ? { targetAdSet } : {}
-  };
-}
-function namesDelivery(flags) {
-  return [flags.platforms, flags.platform, flags.placements, flags.formats].some((f) => flagText(f) !== void 0);
-}
-var SURFACE_PLATFORMS = {
-  "meta-ads": "meta",
-  "linkedin-ads": "linkedin",
-  "google-ads": "google_demandgen",
-  "x-ads": "x",
-  "chatgpt-ads": "chatgpt"
-};
-async function connectedAdPlatforms() {
-  try {
-    const response = await apiPost("/api/capabilities", {}, { timeoutMs: 15e3 });
-    return response.data.surfaces.filter((s) => s.connected && CAPABILITY_SURFACES.includes(s.surface)).flatMap((s) => SURFACE_PLATFORMS[s.surface] ? [SURFACE_PLATFORMS[s.surface]] : []);
-  } catch {
-    return [];
-  }
-}
-async function scaffoldDelivery(flags, definitionText, idea) {
-  const definition = definitionText === null ? null : parseDefinitionDelivery(definitionText);
-  const input = deliveryInputOf(flags, definition, idea);
-  const resolved = resolveDelivery(input);
-  if (resolved.ok || resolved.error.code !== "platform_required") return resolved;
-  return resolveDelivery({ ...input, connected: await connectedAdPlatforms() });
-}
-function deliveryDefinitionFields(delivery) {
-  const platforms = delivery.platforms.map((p) => p.trim());
-  return {
-    // The collection names whole platforms; a placement named alone records its platform.
-    platforms: [...new Set(platforms.map(platformOfName))],
-    platform: definitionPlatformOf(platforms[0] ?? ""),
-    formats: resolveFormatList(delivery.formats)
-  };
-}
-function platformOfName(name) {
-  return AD_PLACEMENTS.find((p) => p.id === name)?.platform ?? name;
-}
-function deliveryNote(delivery, renderRatio) {
-  const from = {
-    flag: "as asked",
-    idea: "from the idea",
-    definition: "from _definition.md",
-    legacy_definition: "from _definition.md's platform",
-    adset: "from its Meta ad set"
-  };
-  return `Made for ${delivery.platforms.join(", ")} (${from[delivery.source]}): delivers ${delivery.formats.join(", ")}, the ${delivery.lead} designed first (rendered at ${renderRatio}) and every other size re-laid out from it.`;
-}
-
-export {
-  namesDelivery,
-  scaffoldDelivery,
-  deliveryDefinitionFields,
-  deliveryNote
-};
-//# sourceMappingURL=chunk-7YXBMYSM.js.map

package/dist/chunk-A6LOIUWB.js

@@ -1,51 +0,0 @@
-import {
-  failApi
-} from "./chunk-C3XJ46C2.js";
-import {
-  HUBSPOT_MISSING_GRANT_MARKER,
-  HUBSPOT_NOT_CONNECTED_MESSAGE
-} from "./chunk-5N77IAOT.js";
-import {
-  ApiError
-} from "./chunk-LJEJCIHR.js";
-import {
-  writeJson
-} from "./chunk-NXNOXZGB.js";
-
-// src/commands/hubspot/refusal.ts
-var CONTINUE = "Keep going with the wider task: say which part you could not read, skip it, and finish everything else. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Platforms \u2192 HubSpot.";
-function hubspotRefusal(code, message, reason = "so I can count a contact becoming a customer") {
-  if (code === "NOT_FOUND" && message.includes(HUBSPOT_NOT_CONNECTED_MESSAGE)) {
-    return {
-      code: "NO_HUBSPOT_CONNECTION",
-      fix: {
-        action: "request_connection",
-        explanation: `AGENT INSTRUCTION: HubSpot is not connected, and only the user can connect it. Call the \`request_connection\` tool with { platform: "hubspot", reason } \u2014 reason in their words, e.g. "${reason}" \u2014 and they connect it inside the chat; then run this command again. ` + CONTINUE
-      }
-    };
-  }
-  if (code === "FORBIDDEN" && message.includes(HUBSPOT_MISSING_GRANT_MARKER)) {
-    return {
-      code: "HUBSPOT_RECONNECT_REQUIRED",
-      fix: {
-        action: "request_connection",
-        explanation: 'AGENT INSTRUCTION: HubSpot is connected \u2014 do not tell the user it is missing, and do not retry. Its access does not cover this read (it was connected before Baker asked for it, or the access was withdrawn), and only the user can widen it. Call the `request_connection` tool with { platform: "hubspot", reason } naming what you need to read; the card offers them a Reconnect button. Run this command again once they have. ' + CONTINUE
-      }
-    };
-  }
-  return null;
-}
-function failNotConnected(err, reason) {
-  const refusal = err instanceof ApiError ? hubspotRefusal(err.code, err.message, reason) : null;
-  if (err instanceof ApiError && refusal !== null) {
-    writeJson({ ok: false, error: { code: refusal.code, message: err.message, fix: refusal.fix } });
-    process.exit(1);
-  }
-  failApi(err);
-}
-
-export {
-  hubspotRefusal,
-  failNotConnected
-};
-//# sourceMappingURL=chunk-A6LOIUWB.js.map