@koda-sl/baker-cli 0.446.0-dev.c97e2d09a → 0.446.0

package/dist/feedback-record-UCXKGQNX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/feedback-record.ts","../src/commands/creatives/agent-option-note.ts"],"sourcesContent":["import {\n  CREATIVE_FEEDBACK_REASONS,\n  type CreativesFeedbackRecordResponse,\n  creativesFeedbackRecordRequestSchema,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { jevNoteJudge, readNoteAuthor } from \"./agent-option-note.ts\";\nimport { versionOf } from \"./version-of.ts\";\n\nconst DESCRIPTION = `Record what the user said about one version of a creative in this chat: an approval, or a rejection with reasons. Saved as their verdict (the person who wrote the latest message here) and read back by baker creatives feedback. One verdict per person per version or option: a later one replaces it.\nStart here: baker creatives feedback record --slug spring-offer --verdict rejected --reasons text_mistakes --note \"<their words>\"\nOnly record what the user said, never your own judgment. Picking one of several concepts is not a rejection of the others.`;\n\nconst ARGS = {\n  slug: { type: \"string\", description: \"The creative: its folder name under src/creatives/.\", required: true },\n  run: {\n    type: \"string\",\n    description: \"The version: its canvas run id (r_…) Left out, the version the creative shows now (its last render).\",\n    required: false,\n  },\n  option: {\n    type: \"string\",\n    description:\n      'One option of a version that made several: its label (\"ugc\"), its number (\"2\") or its slot. Left out, the whole version.',\n    required: false,\n  },\n  verdict: { type: \"string\", description: \"approved | rejected\", required: true },\n  reasons: {\n    type: \"string\",\n    description: `Why it was rejected, comma-separated: ${CREATIVE_FEEDBACK_REASONS.join(\", \")}. Map the user's words to these; \"other\" when none fits. On a video, voice_or_sound covers the voiceover, music and mix (\"the voice sounds robotic\", \"music too loud\") and pacing covers the timing (\"too slow\", \"the hook comes too late\").`,\n    required: false,\n  },\n  note: {\n    type: \"string\",\n    description: \"The user's own words, verbatim (not your summary). Up to 1000 characters.\",\n    required: false,\n  },\n} as const;\n\nregisterSchema({ command: \"creatives.feedback.record\", description: DESCRIPTION, args: ARGS });\n\nfunction splitList(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\" || value.trim() === \"\") return undefined;\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter((item) => item.length > 0);\n}\n\nfunction fail(code: string, message: string): never {\n  writeJson({ ok: false, error: { code, message } });\n  process.exit(1);\n}\n\n/**\n * A rejection whose note only answers the agent's own question, or that says nothing, is not the\n * person's feedback. Returns whether the note could not be confirmed as the person's words.\n */\nasync function refuseNotFeedback(body: {\n  verdict: string;\n  reasons?: readonly string[];\n  note?: string;\n}): Promise<boolean> {\n  if (body.verdict === \"rejected\" && !body.reasons?.length && !body.note) {\n    fail(\n      \"VALIDATION_ERROR\",\n      \"A rejection needs --reasons or --note (the user's words), so the next version knows what to change.\",\n    );\n  }\n  if (body.verdict !== \"rejected\" || !body.note) return false;\n  const author = await readNoteAuthor(body.note, jevNoteJudge);\n  if (author === \"agent_option\") {\n    fail(\n      \"AGENT_OPTION_NOT_FEEDBACK\",\n      `\"${body.note}\" is the answer to your own question, not the person's taste: a defect the checks found is yours to fix inside this version (\\`baker canvas run --fix\\`), never feedback to record. Record only what the person says about the ad in their own words.`,\n    );\n  }\n  return author === \"unconfirmed\";\n}\n\nexport const feedbackRecordCommand = defineCommand({\n  meta: { name: \"record\", description: DESCRIPTION },\n  args: ARGS,\n  run: async ({ args }) => {\n    const reasons = splitList(args.reasons);\n    const unknown = (reasons ?? []).filter(\n      (reason) => !(CREATIVE_FEEDBACK_REASONS as readonly string[]).includes(reason),\n    );\n    if (unknown.length > 0) {\n      fail(\"VALIDATION_ERROR\", `Unknown reason ${unknown.join(\", \")}. Use: ${CREATIVE_FEEDBACK_REASONS.join(\", \")}.`);\n    }\n    const parsed = creativesFeedbackRecordRequestSchema.safeParse({\n      slug: args.slug,\n      runId: await versionOf(String(args.slug), args.run).then(\n        (run) => run ?? fail(\"VALIDATION_ERROR\", \"--run: this creative has no rendered version here; name one (r_…).\"),\n      ),\n      ...(typeof args.option === \"string\" && args.option.trim() ? { option: args.option.trim() } : {}),\n      verdict: args.verdict,\n      ...(reasons ? { reasons } : {}),\n      ...(typeof args.note === \"string\" && args.note.trim() ? { note: args.note } : {}),\n    });\n    if (!parsed.success) {\n      const issue = parsed.error.issues[0];\n      fail(\"VALIDATION_ERROR\", `--${String(issue?.path[0] ?? \"args\")}: ${issue?.message ?? \"invalid\"}`);\n    }\n    const body = parsed.data;\n    const noteUnconfirmed = await refuseNotFeedback(body);\n    try {\n      const response = await apiPost<CreativesFeedbackRecordResponse>(\n        \"/api/creatives/feedback/record\",\n        noteUnconfirmed ? { ...body, noteUnconfirmed } : body,\n      );\n      writeJson(response);\n    } catch (err) {\n      if (err instanceof ApiError) fail(err.code, err.message);\n      fail(\"INTERNAL_ERROR\", \"Unexpected error\");\n    }\n  },\n});\n","/**\n * Whether a rejection's note is the agent's own words rather than the person's taste: the label\n * of an option the agent offered (\"Sí, corrige todo (Recomendado)\") or the answer to its own\n * \"fix what is pending?\" (\"Fix everything\"). Production Oct 2026: both were recorded as\n * rejections, so every fix became a new version and later chats read the agent's own defects as\n * the company's taste. The agent writes those options in the marketer's language, so the decision\n * model reads the note in whatever language it is in (docs/decision-model.md).\n */\nimport { askJev } from \"../../engine/nodes/local/lib/jev.ts\";\nimport type { ReviewUsage } from \"../../engine/nodes/local/lib/render-review.ts\";\nimport { holdWorkspaceSpend } from \"../canvas/unbilled-spend.ts\";\n\n/**\n * The bands, measured 2026-10-07 on 30 notes in 8 languages (scripts/agent-option-note-evals,\n * three runs). A recommended tag scored 0.92 or more on the agent's labels and 0.03 or less on\n * people's notes. A bare yes to fixing scored 0.59 or more on the agent's untagged answers and\n * 0.31 or less on people's, except \"fix all the typos\" (0.52-0.56), which names its problem\n * (0.86; the agent's answers 0.12 or less).\n */\nexport const NOTE_BANDS = { tagged: 0.5, bareFix: 0.45, namesProblem: 0.5 } as const;\n\nconst TAGGED = \"Does `note` end with a tag marking it as the recommended option, like (Recommended), in any language?\";\nconst BARE_FIX =\n  'Is `note` a bare yes to an offer to fix things, like \"fix everything\" or \"fix what is pending\", naming no particular problem? A note that names what is wrong or what to change (the typos, the price, cut-off text, redo the pieces) is not.';\nconst NAMES_PROBLEM =\n  \"Does `note` name a particular problem, element or part of an ad (a typo, the price, the logo, the audio, the text, the colours, a person), apart from a whole format or size?\";\n\n/** Three judgments about one note, each a probability; one judgment per question, combined in code. */\nexport type NoteReading = { tagged: number; bareFix: number; namesProblem: number };\n\n/** The decision model's reading of `note`; null when no judgment came back. */\nexport type NoteJudge = (note: string) => Promise<NoteReading | null>;\n\n/** The decision model as the judge: three Nouls in one request. */\nexport const jevNoteJudge: NoteJudge = async (note) => {\n  const spent: ReviewUsage[] = [];\n  const answers = await askJev(\n    [TAGGED, BARE_FIX, NAMES_PROBLEM].map((question) => ({ instructions: { note, question } })),\n    (usage) => spent.push(usage),\n  );\n  await holdWorkspaceSpend(spent);\n  if (answers === null) return null;\n  const [tagged = 0, bareFix = 0, namesProblem = 1] = answers;\n  return { tagged, bareFix, namesProblem };\n};\n\n/** The agent's option label, or its bare fix answer naming nothing of the ad. Pure. */\nexport function readsAsAgentOption(reading: NoteReading): boolean {\n  if (reading.tagged >= NOTE_BANDS.tagged) return true;\n  return reading.bareFix >= NOTE_BANDS.bareFix && reading.namesProblem < NOTE_BANDS.namesProblem;\n}\n\n/** Whose words a note is: the agent's own option, the person's, or unconfirmed when no judgment came back. */\nexport type NoteAuthor = \"agent_option\" | \"person\" | \"unconfirmed\";\n\n/**\n * Who wrote `note`, as the decision model reads it. No judgment (no key, a timeout, an outage) is\n * \"unconfirmed\", never the person's: Baker keeps that note but does not read it as taste (B5).\n */\nexport async function readNoteAuthor(note: string, judge: NoteJudge): Promise<NoteAuthor> {\n  const text = note.trim();\n  if (!text) return \"person\";\n  const reading = await judge(text).catch(() => null);\n  if (reading === null) return \"unconfirmed\";\n  return readsAsAgentOption(reading) ? \"agent_option\" : \"person\";\n}\n"],"mappings":"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","names":[]}

package/dist/{fetch-UTTJAOLC.js → fetch-ZFPJ7DEZ.js}

@@ -1,11 +1,16 @@
 import {
   fetchHints,
   redditPageFix
-} from "./chunk-PIWMNKWI.js";
+} from "./chunk-3CWL2LY4.js";
 import {
   handleResearchError,
   writeResearchJson
-} from "./chunk-TBEUMOEL.js";
+} from "./chunk-WNFIJAUO.js";
+import "./chunk-NDXBU22S.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-WYCVJIHD.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -168,4 +173,4 @@ Examples:
 export {
   fetchCommand
 };
-//# sourceMappingURL=fetch-UTTJAOLC.js.map
+//# sourceMappingURL=fetch-ZFPJ7DEZ.js.map

package/dist/{fetch-UTTJAOLC.js.map → fetch-ZFPJ7DEZ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/research/fetch.ts"],"sourcesContent":["import type { ResearchFetchRequest, ResearchFetchResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { fetchHints, redditPageFix } from \"./hints.ts\";\nimport { handleResearchError, type ResearchFix, writeResearchJson } from \"./output.ts\";\n\n/**\n * A page big enough to matter is bigger than a turn wants to carry, and the\n * read is cached — so the default shows the top of it and `--full` returns for\n * the rest at no extra cost.\n */\nconst CONTENT_PREVIEW_CHARS = 20_000;\n\n/** A page behind a bot wall can take a while to clear; the default 60s is not enough. */\nconst TIMEOUT_MS = 180_000;\n\nregisterSchema({\n  command: \"research.fetch\",\n  description:\n    \"Read a page an ordinary web fetch could not — bot walls and JavaScript-rendered pages are resolved for you. Use it when your normal page read came back with a security check, an error page, or an empty shell.\",\n  args: {\n    url: { type: \"string\", description: \"Full URL of the page to read\", required: true },\n    format: {\n      type: \"string\",\n      description: \"markdown (default, best for reading) or html (when you need the markup)\",\n      required: false,\n      enum: [\"markdown\", \"html\"],\n    },\n    \"wait-for\": {\n      type: \"number\",\n      description: \"Extra ms to let late content settle (0-30000). Only for pages that fill in after load\",\n      required: false,\n    },\n    \"whole-page\": {\n      type: \"boolean\",\n      description: \"Include nav, footer and sidebars (default: main content only)\",\n      required: false,\n      default: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: `Return the whole page instead of the first ${CONTENT_PREVIEW_CHARS} characters`,\n      required: false,\n      default: false,\n    },\n  },\n});\n\nconst FIELDS: Record<string, string> = {\n  url: \"The URL as asked for\",\n  final_url: \"Where the read landed after redirects\",\n  title: \"Page title, or null when the page declares none\",\n  content: \"The page text (markdown by default)\",\n  content_chars: \"Length of the full page available on the server\",\n  content_shown: \"Characters in `content` — below content_chars unless --full\",\n  truncated: \"The page was longer than one read returns, so the tail is missing\",\n  provider: \"Who resolved the read\",\n};\n\n/**\n * Every failure here is one source out of a larger job, so the remediation is\n * about finishing the job: name the gap, keep going. The only case worth a\n * second attempt is a page that never settled.\n */\nfunction fetchFix(code: string): ResearchFix {\n  if (code === \"VALIDATION_ERROR\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation: \"Re-run with a complete address, including https://.\",\n    };\n  }\n  if (code === \"TIMEOUT\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation:\n        \"The page never settled. Retry this URL once with `--wait-for 10000`; if that fails too, carry on with the rest of the job and say this page couldn't be read.\",\n    };\n  }\n  if (code === \"RATE_LIMITED\") {\n    return {\n      action: \"continue_without\",\n      explanation:\n        \"The page reader is busy. Do the rest of the job first and come back to this URL once, later — don't loop on it.\",\n    };\n  }\n  if (code === \"FORBIDDEN\" || code === \"NOT_FOUND\") {\n    return {\n      action: \"continue_without\",\n      explanation:\n        \"This page will not open for us, and retrying will not change that. Carry on with the sources you can reach and say plainly which page you couldn't read.\",\n    };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"This read failed. Don't build a retry ladder around it — finish the rest of the job with what you can reach and name this page as a gap.\",\n  };\n}\n\nexport const fetchCommand = defineCommand({\n  meta: {\n    name: \"fetch\",\n    description: `Read a page an ordinary web fetch could not. Bot walls and JavaScript-rendered pages are resolved for you — you never have to retry, wait, or drive a browser yourself.\n\nReach for this the moment a normal page read comes back with a security check, an error page, or an empty shell. One call, no escalation ladder.\n\nExamples:\n  baker research fetch \"https://competitor.com/pricing\"\n  baker research fetch \"https://competitor.com/pricing\" --full\n  baker research fetch \"https://app.competitor.com/blog/post\" --wait-for 5000\n  baker research fetch \"https://competitor.com\" --format html --whole-page`,\n  },\n  args: {\n    url: { type: \"positional\", description: \"URL of the page to read\", required: false },\n    format: { type: \"string\", description: \"markdown (default) or html\", required: false },\n    \"wait-for\": { type: \"string\", description: \"Extra ms to let late content settle (0-30000)\", required: false },\n    \"whole-page\": { type: \"boolean\", description: \"Include nav, footer and sidebars\", required: false },\n    full: { type: \"boolean\", description: \"Return the whole page, not just the first chunk\", required: false },\n  },\n  run: async ({ args }) => {\n    const url = args.url as string | undefined;\n    if (!url) {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"A URL is required\",\n          fix: fetchFix(\"VALIDATION_ERROR\"),\n        },\n      });\n      process.exit(1);\n    }\n\n    const format = (args.format as string | undefined) ?? \"markdown\";\n    if (format !== \"markdown\" && format !== \"html\") {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"Format must be markdown or html\",\n          fix: { action: \"retry_with_changes\", explanation: \"Re-run with --format markdown or --format html.\" },\n        },\n      });\n      process.exit(1);\n    }\n\n    const body: ResearchFetchRequest = { url, format };\n    if (args[\"wait-for\"]) body.waitFor = Number(args[\"wait-for\"]);\n    if (args[\"whole-page\"]) body.onlyMainContent = false;\n\n    try {\n      const page = await apiPost<ResearchFetchResponse>(\"/api/research/fetch\", body, { timeoutMs: TIMEOUT_MS });\n      const content = args.full ? page.content : page.content.slice(0, CONTENT_PREVIEW_CHARS);\n\n      writeResearchJson({\n        ok: true,\n        data: {\n          url: page.url,\n          final_url: page.finalUrl,\n          title: page.title,\n          content_chars: page.contentChars,\n          content_shown: content.length,\n          truncated: page.truncated,\n          provider: page.provider,\n          content,\n        },\n        fields: FIELDS,\n        hints: fetchHints({\n          truncated: page.truncated,\n          contentChars: page.contentChars,\n          shownChars: content.length,\n        }),\n      });\n    } catch (err) {\n      handleResearchError(err, (code) => redditPageFix(url, code) ?? fetchFix(code));\n    }\n  },\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/commands/research/fetch.ts"],"sourcesContent":["import type { ResearchFetchRequest, ResearchFetchResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { fetchHints, redditPageFix } from \"./hints.ts\";\nimport { handleResearchError, type ResearchFix, writeResearchJson } from \"./output.ts\";\n\n/**\n * A page big enough to matter is bigger than a turn wants to carry, and the\n * read is cached — so the default shows the top of it and `--full` returns for\n * the rest at no extra cost.\n */\nconst CONTENT_PREVIEW_CHARS = 20_000;\n\n/** A page behind a bot wall can take a while to clear; the default 60s is not enough. */\nconst TIMEOUT_MS = 180_000;\n\nregisterSchema({\n  command: \"research.fetch\",\n  description:\n    \"Read a page an ordinary web fetch could not — bot walls and JavaScript-rendered pages are resolved for you. Use it when your normal page read came back with a security check, an error page, or an empty shell.\",\n  args: {\n    url: { type: \"string\", description: \"Full URL of the page to read\", required: true },\n    format: {\n      type: \"string\",\n      description: \"markdown (default, best for reading) or html (when you need the markup)\",\n      required: false,\n      enum: [\"markdown\", \"html\"],\n    },\n    \"wait-for\": {\n      type: \"number\",\n      description: \"Extra ms to let late content settle (0-30000). Only for pages that fill in after load\",\n      required: false,\n    },\n    \"whole-page\": {\n      type: \"boolean\",\n      description: \"Include nav, footer and sidebars (default: main content only)\",\n      required: false,\n      default: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: `Return the whole page instead of the first ${CONTENT_PREVIEW_CHARS} characters`,\n      required: false,\n      default: false,\n    },\n  },\n});\n\nconst FIELDS: Record<string, string> = {\n  url: \"The URL as asked for\",\n  final_url: \"Where the read landed after redirects\",\n  title: \"Page title, or null when the page declares none\",\n  content: \"The page text (markdown by default)\",\n  content_chars: \"Length of the full page available on the server\",\n  content_shown: \"Characters in `content` — below content_chars unless --full\",\n  truncated: \"The page was longer than one read returns, so the tail is missing\",\n  provider: \"Who resolved the read\",\n};\n\n/**\n * Every failure here is one source out of a larger job, so the remediation is\n * about finishing the job: name the gap, keep going. The only case worth a\n * second attempt is a page that never settled.\n */\nfunction fetchFix(code: string): ResearchFix {\n  if (code === \"VALIDATION_ERROR\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation: \"Re-run with a complete address, including https://.\",\n    };\n  }\n  if (code === \"TIMEOUT\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation:\n        \"The page never settled. Retry this URL once with `--wait-for 10000`; if that fails too, carry on with the rest of the job and say this page couldn't be read.\",\n    };\n  }\n  if (code === \"RATE_LIMITED\") {\n    return {\n      action: \"continue_without\",\n      explanation:\n        \"The page reader is busy. Do the rest of the job first and come back to this URL once, later — don't loop on it.\",\n    };\n  }\n  if (code === \"FORBIDDEN\" || code === \"NOT_FOUND\") {\n    return {\n      action: \"continue_without\",\n      explanation:\n        \"This page will not open for us, and retrying will not change that. Carry on with the sources you can reach and say plainly which page you couldn't read.\",\n    };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"This read failed. Don't build a retry ladder around it — finish the rest of the job with what you can reach and name this page as a gap.\",\n  };\n}\n\nexport const fetchCommand = defineCommand({\n  meta: {\n    name: \"fetch\",\n    description: `Read a page an ordinary web fetch could not. Bot walls and JavaScript-rendered pages are resolved for you — you never have to retry, wait, or drive a browser yourself.\n\nReach for this the moment a normal page read comes back with a security check, an error page, or an empty shell. One call, no escalation ladder.\n\nExamples:\n  baker research fetch \"https://competitor.com/pricing\"\n  baker research fetch \"https://competitor.com/pricing\" --full\n  baker research fetch \"https://app.competitor.com/blog/post\" --wait-for 5000\n  baker research fetch \"https://competitor.com\" --format html --whole-page`,\n  },\n  args: {\n    url: { type: \"positional\", description: \"URL of the page to read\", required: false },\n    format: { type: \"string\", description: \"markdown (default) or html\", required: false },\n    \"wait-for\": { type: \"string\", description: \"Extra ms to let late content settle (0-30000)\", required: false },\n    \"whole-page\": { type: \"boolean\", description: \"Include nav, footer and sidebars\", required: false },\n    full: { type: \"boolean\", description: \"Return the whole page, not just the first chunk\", required: false },\n  },\n  run: async ({ args }) => {\n    const url = args.url as string | undefined;\n    if (!url) {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"A URL is required\",\n          fix: fetchFix(\"VALIDATION_ERROR\"),\n        },\n      });\n      process.exit(1);\n    }\n\n    const format = (args.format as string | undefined) ?? \"markdown\";\n    if (format !== \"markdown\" && format !== \"html\") {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"Format must be markdown or html\",\n          fix: { action: \"retry_with_changes\", explanation: \"Re-run with --format markdown or --format html.\" },\n        },\n      });\n      process.exit(1);\n    }\n\n    const body: ResearchFetchRequest = { url, format };\n    if (args[\"wait-for\"]) body.waitFor = Number(args[\"wait-for\"]);\n    if (args[\"whole-page\"]) body.onlyMainContent = false;\n\n    try {\n      const page = await apiPost<ResearchFetchResponse>(\"/api/research/fetch\", body, { timeoutMs: TIMEOUT_MS });\n      const content = args.full ? page.content : page.content.slice(0, CONTENT_PREVIEW_CHARS);\n\n      writeResearchJson({\n        ok: true,\n        data: {\n          url: page.url,\n          final_url: page.finalUrl,\n          title: page.title,\n          content_chars: page.contentChars,\n          content_shown: content.length,\n          truncated: page.truncated,\n          provider: page.provider,\n          content,\n        },\n        fields: FIELDS,\n        hints: fetchHints({\n          truncated: page.truncated,\n          contentChars: page.contentChars,\n          shownChars: content.length,\n        }),\n      });\n    } catch (err) {\n      handleResearchError(err, (code) => redditPageFix(url, code) ?? fetchFix(code));\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/{fit-KXHYKIA4.js → fit-275H7ETA.js}

@@ -10,13 +10,13 @@ import {
   readCachedFit,
   readKnowledge,
   reviewsForFit
-} from "./chunk-OC5IJSIW.js";
+} from "./chunk-2LY4RW5O.js";
 import "./chunk-K3PN7TN5.js";
 import "./chunk-HIPDMQZ6.js";
-import "./chunk-4SJDDGPV.js";
+import "./chunk-GTRZUWT2.js";
 import "./chunk-DGCUPJZD.js";
 import "./chunk-HO3IUJ4K.js";
-import "./chunk-OBDAYP2P.js";
+import "./chunk-KY4MPR6R.js";
 import "./chunk-RX6F3GEA.js";
 import "./chunk-VAJBWA2U.js";
 import "./chunk-OTFHEHIU.js";
@@ -40,4 +40,4 @@ export {
   readKnowledge,
   reviewsForFit
 };
-//# sourceMappingURL=fit-KXHYKIA4.js.map
+//# sourceMappingURL=fit-275H7ETA.js.map

package/dist/{flows-Q454EFMN.js → flows-I3MWA5EX.js}

@@ -5,16 +5,16 @@ import {
   readFlowTree,
   redactTree,
   requestFlowInputCall
-} from "./chunk-MJABIGKT.js";
+} from "./chunk-BSC33FLJ.js";
 import {
   FLOW_AGENT_DESTINATION_KINDS,
   driftRepairHint,
   flowNodeTriggers
-} from "./chunk-ASVKZQUU.js";
+} from "./chunk-NDXBU22S.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-WYCVJIHD.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -222,13 +222,13 @@ Full guide: __tooling__/docs/tools/baker/flows.md`
   subCommands: {
     list: listCommand,
     show: showCommand,
-    schema: () => import("./schema-UW772MB2.js").then((m) => m.schemaCommand),
-    "add-node": () => import("./add-ID4XAPM5.js").then((m) => m.addNodeCommand),
-    "add-side-effect": () => import("./add-ID4XAPM5.js").then((m) => m.addSideEffectCommand),
-    options: () => import("./options-OZGAYIXG.js").then((m) => m.optionsCommand),
-    connect: () => import("./connect-A3SJQKSE.js").then((m) => m.connectCommand),
-    map: () => import("./map-62RLXP7R.js").then((m) => m.mapCommand),
-    normalize: () => import("./normalize-YALLU2FS.js").then((m) => m.normalizeCommand)
+    schema: () => import("./schema-3WYVJU6M.js").then((m) => m.schemaCommand),
+    "add-node": () => import("./add-WF3IIZK5.js").then((m) => m.addNodeCommand),
+    "add-side-effect": () => import("./add-WF3IIZK5.js").then((m) => m.addSideEffectCommand),
+    options: () => import("./options-JVNCBJWI.js").then((m) => m.optionsCommand),
+    connect: () => import("./connect-OKTOFEHL.js").then((m) => m.connectCommand),
+    map: () => import("./map-B4M6M7LK.js").then((m) => m.mapCommand),
+    normalize: () => import("./normalize-55FXLIBJ.js").then((m) => m.normalizeCommand)
   },
   // Bare `baker flows` lists the Forms. This must be `default`, not `run`: citty falls
   // through to `run` after dispatching a subcommand, so a `run` here would also print
@@ -241,4 +241,4 @@ export {
   funnelPlacementHint,
   inertSideEffectHints
 };
-//# sourceMappingURL=flows-Q454EFMN.js.map
+//# sourceMappingURL=flows-I3MWA5EX.js.map

package/dist/{fonts-YWGD2B4N.js → fonts-KHEHZFW5.js}

@@ -5,20 +5,20 @@ import {
   fontsCommand,
   fontsFetchCommand,
   lookupGoogleCss
-} from "./chunk-XL3UIAMJ.js";
-import "./chunk-676WE6CY.js";
-import "./chunk-ENUZU5LQ.js";
+} from "./chunk-T3BDNJIX.js";
+import "./chunk-EH4C4CZK.js";
+import "./chunk-G7UTTEBS.js";
 import "./chunk-K3PN7TN5.js";
 import "./chunk-HIPDMQZ6.js";
 import "./chunk-RX6F3GEA.js";
 import "./chunk-OTFHEHIU.js";
 import "./chunk-VVZBBKRC.js";
 import "./chunk-YBMVHGY3.js";
-import "./chunk-ASVKZQUU.js";
+import "./chunk-NDXBU22S.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-WYCVJIHD.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import "./chunk-IFWP3ZDO.js";
 import "./chunk-NAWWC5I3.js";
 import "./chunk-NU7JSWVA.js";
@@ -31,4 +31,4 @@ export {
   fontsFetchCommand,
   lookupGoogleCss
 };
-//# sourceMappingURL=fonts-YWGD2B4N.js.map
+//# sourceMappingURL=fonts-KHEHZFW5.js.map

package/dist/{forecast-TQNRU5ZY.js → forecast-O5DQVRVJ.js}

@@ -1,18 +1,18 @@
 import {
   handleLinkedinError,
   resolveAccountIdArg
-} from "./chunk-3U3RUPKR.js";
+} from "./chunk-6DB2B3GF.js";
 import {
   writeAdsJson
 } from "./chunk-VFIOJD5M.js";
 import {
   NO_CACHE_ARG
 } from "./chunk-X7ZODEXJ.js";
-import "./chunk-ASVKZQUU.js";
+import "./chunk-NDXBU22S.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-WYCVJIHD.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -101,4 +101,4 @@ Examples:
 export {
   forecastCommand
 };
-//# sourceMappingURL=forecast-TQNRU5ZY.js.map
+//# sourceMappingURL=forecast-O5DQVRVJ.js.map

package/dist/{funnel-YVSYSLT4.js → funnel-EM26VOTO.js}

@@ -1,10 +1,10 @@
 import {
   flowEventKeys
-} from "./chunk-S42CGOGT.js";
+} from "./chunk-PDTB5EX6.js";
 import {
   flowDataPath,
   listFlowSlugs
-} from "./chunk-MJABIGKT.js";
+} from "./chunk-BSC33FLJ.js";
 import {
   parseEventKey
 } from "./chunk-SSJK7FEV.js";
@@ -12,11 +12,11 @@ import "./chunk-EDLZGTGN.js";
 import {
   writeJsonEnvelope
 } from "./chunk-VFIOJD5M.js";
-import "./chunk-ASVKZQUU.js";
+import "./chunk-NDXBU22S.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-WYCVJIHD.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   ApiError,
   apiPost
@@ -834,4 +834,4 @@ function workspaceForms() {
 export {
   funnelCommand
 };
-//# sourceMappingURL=funnel-YVSYSLT4.js.map
+//# sourceMappingURL=funnel-EM26VOTO.js.map

package/dist/{generate-DMQUS665.js → generate-6DDI42Y2.js}

@@ -3,7 +3,7 @@ import {
   IMAGE_QUALITIES,
   IMAGE_SIZES,
   resolveLibraryImageIds
-} from "./chunk-HYCIBVDW.js";
+} from "./chunk-RWPQW73R.js";
 import {
   awaitBatch,
   batchHints,
@@ -20,7 +20,7 @@ import {
   DEFAULT_IMAGE_GENERATE_MODEL,
   MODEL_REGISTRY,
   maxInputReferences
-} from "./chunk-OBDAYP2P.js";
+} from "./chunk-KY4MPR6R.js";
 import "./chunk-YBMVHGY3.js";
 import {
   ApiError,
@@ -259,4 +259,4 @@ export {
   generateCommand,
   referenceLimitFor
 };
-//# sourceMappingURL=generate-DMQUS665.js.map
+//# sourceMappingURL=generate-6DDI42Y2.js.map

package/dist/{get-756GD6EF.js → get-DVEBT257.js}

@@ -1,12 +1,12 @@
 import {
   failApi,
   failValidation
-} from "./chunk-DQPTUBCB.js";
-import "./chunk-ASVKZQUU.js";
+} from "./chunk-E4MDJBLO.js";
+import "./chunk-NDXBU22S.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-WYCVJIHD.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   apiPost,
   validateConvexId
@@ -51,4 +51,4 @@ var getCommand = defineCommand({
 export {
   getCommand
 };
-//# sourceMappingURL=get-756GD6EF.js.map
+//# sourceMappingURL=get-DVEBT257.js.map

package/dist/{get-7PZP4HJ3.js → get-FF64VI2N.js}

@@ -3,15 +3,15 @@ import {
   failValidation,
   isTempScheduledAgentId,
   validateScheduledAgentRef
-} from "./chunk-DXB5YV6S.js";
+} from "./chunk-2GK33EJV.js";
 import {
   CHAT_READ_ARG
 } from "./chunk-PFBQERWX.js";
-import "./chunk-ASVKZQUU.js";
+import "./chunk-NDXBU22S.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-WYCVJIHD.js";
 import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
+import "./chunk-NE4F3FHN.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -75,4 +75,4 @@ var getCommand = defineCommand({
 export {
   getCommand
 };
-//# sourceMappingURL=get-7PZP4HJ3.js.map
+//# sourceMappingURL=get-FF64VI2N.js.map

package/dist/{google-KIBLORXX.js → google-35GDU3G3.js}

@@ -14,7 +14,7 @@ import {
   stageGoogleOps,
   stageTarget,
   stageUpdate
-} from "./chunk-EIP4PYCL.js";
+} from "./chunk-TIOQ7ZFQ.js";
 import {
   repeatedFlagValues,
   repeatedValues
@@ -28,7 +28,7 @@ import "./chunk-F2S5BLPE.js";
 import {
   ACCOUNT_URL_OPTIONS_LOCATION,
   ACCOUNT_URL_OPTIONS_NOT_STAGEABLE
-} from "./chunk-EVYXTT7V.js";
+} from "./chunk-XCM6XWOB.js";
 import {
   writeJsonEnvelope
 } from "./chunk-VFIOJD5M.js";
@@ -45,7 +45,7 @@ import {
   CONVERSION_ORIGINS,
   NEGATIVE_GEO_TARGET_TYPES,
   POSITIVE_GEO_TARGET_TYPES
-} from "./chunk-XML7AJM3.js";
+} from "./chunk-NE4F3FHN.js";
 import "./chunk-XBOK23HI.js";
 import "./chunk-IFWP3ZDO.js";
 import "./chunk-NAWWC5I3.js";
@@ -69,10 +69,10 @@ Examples:
   baker ads google keywords languages`
   },
   subCommands: {
-    discover: () => import("./discover-M3ZKKFEL.js").then((m) => m.discoverCommand),
-    metrics: () => import("./metrics-AY4RP54F.js").then((m) => m.metricsCommand),
-    locations: () => import("./locations-S4U6IJIS.js").then((m) => m.locationsCommand),
-    languages: () => import("./languages-JDYL2N5F.js").then((m) => m.languagesCommand)
+    discover: () => import("./discover-BJPZNXUQ.js").then((m) => m.discoverCommand),
+    metrics: () => import("./metrics-SQDJ5NQO.js").then((m) => m.metricsCommand),
+    locations: () => import("./locations-J4G5RNPH.js").then((m) => m.locationsCommand),
+    languages: () => import("./languages-HORKPDNH.js").then((m) => m.languagesCommand)
   }
 });
 
@@ -1438,8 +1438,8 @@ function imageAssetHints(payload) {
     return [];
   }
   return [
-    "This image publishes into the advertiser's Google Ads asset library \u2014 that half works. What Google refuses is the link that puts it on a Search campaign, so the `assets attach` for it never stores: it is skipped with the reason, and staging it anyway is what tells Baker which campaign these images belong on.",
-    "Finish the handover rather than reporting a limitation: tell the user the images are already in their Google Ads account and only need adding to the campaign under Assets, and name the ones you staged. Baker stages the Task for that step itself the moment you stage the image, so it is already in this chat's changes \u2014 do not stage a second one with `baker actions`. Stage the `assets attach` too if you know which campaign they belong on: it is skipped rather than stored, and it is what puts the campaign's name in that Task. Never tell them to upload images they already have. (A Performance Max asset group is different \u2014 images do link there, with `asset-groups attach`.)"
+    "This image publishes into the advertiser's Google Ads asset library. Stage the `assets attach` too, with field type AD_IMAGE on the campaign (or ad group) it belongs on: Google opens Search image links per account, so Baker asks Google as you stage \u2014 where the account takes them the link is staged and applies at publish, and where it does not the link is skipped and names the campaign in the handover Task.",
+    "Until a link to it is staged, Baker keeps a Task for this image in this chat's changes \u2014 the user adding it to the campaign under Assets \u2014 and withdraws it when an accepted link names the image; do not stage a second one with `baker actions`. If that Task is still there after the attach, tell the user the images are already in their Google Ads account and only need adding to the campaign under Assets, and name them. Never tell them to upload images they already have. (A Performance Max asset group is different \u2014 images link there with `asset-groups attach`.)"
   ];
 }
 var assetsUpdateCommand = defineCommand2({
@@ -1482,7 +1482,7 @@ var assetsUpdateCommand = defineCommand2({
 var assetsCommand = defineCommand2({
   meta: {
     name: "assets",
-    description: "Stage asset create/update + asset-link attach/detach (via --file). For a high-performance Search campaign add \u22654 sitelinks, \u22653 callouts and \u22651 structured snippet per campaign. Image extensions are the one thing you cannot finish here \u2014 `create` uploads the image into the advertiser's account, but Google refuses the link that puts it on a Search campaign, so hand that one step over rather than telling them to upload anything (stage the `attach` regardless: it is skipped, and it is what records the handover Task). The image a Search campaign does take through a link is the advertiser's logo \u2014 BUSINESS_LOGO, at campaign or customer level, on a verified account."
+    description: "Stage asset create/update + asset-link attach/detach (via --file). For a high-performance Search campaign add \u22654 sitelinks, \u22653 callouts and \u22651 structured snippet per campaign. Image extensions: `create` uploads the image into the advertiser's account, then `attach` links it with field type AD_IMAGE (campaign or ad group). Google opens image links per account, so Baker asks Google as you stage: an account that takes them stages the link like a sitelink; one that does not skips it and stages a handover Task instead \u2014 never tell them to upload anything. The advertiser's logo links as BUSINESS_LOGO, at campaign or customer level, on a verified account."
   },
   subCommands: {
     create: fileCreateCommand(
@@ -1493,7 +1493,7 @@ var assetsCommand = defineCommand2({
     ),
     update: assetsUpdateCommand,
     attach: fileCreateCommand("attach", "google.assetLink.attach", "Attach an asset to a campaign/adGroup/customer", [
-      "Image extensions cannot be linked \u2014 Google refuses AD_IMAGE and every marketing-image field type at every level, on every API version \u2014 but stage the link anyway: it is skipped rather than stored, the rest of a batch is unaffected, and it is what records the handover Task naming those images and that campaign. That is the only record when the images are already in the account and you are uploading nothing. Then tell the user they are already in their Google Ads account and only need adding to the campaign under Assets; do not stage a second Task with `baker actions`. Two images that do link: the advertiser's logo through this command (`BUSINESS_LOGO`, campaign or customer level, on a verified account), and Performance Max asset-group images, which are a different mechanism (`asset-groups attach`)."
+      'Search image extensions link as AD_IMAGE, at campaign or ad group level: `{"level":"campaign","parent":"<campaign id>","asset":"<image asset id or g_temp_ ref>","fieldType":"AD_IMAGE"}`. Google opens these per advertiser account, so Baker asks Google (a check that changes nothing) as you stage. The image must be 1.91:1 or 1:1 \u2014 any other shape is sent back to crop. Accepted \u2192 the link is staged and applies at publish. Refused or not confirmed \u2192 it is skipped rather than stored, the rest of a batch is unaffected, and Baker stages the handover Task naming those images and that campaign; then tell the user they are already in their Google Ads account and only need adding to the campaign under Assets, and do not stage a second Task with `baker actions`. MARKETING_IMAGE / SQUARE_MARKETING_IMAGE are Performance Max asset-group slots (`asset-groups attach`), never a Search link. The advertiser\'s logo links as `BUSINESS_LOGO` (campaign or customer level, on a verified account).'
     ]),
     detach: statusCommand("google.assetLink.detach", "asset link", [
       "Pass the resource name Google gave you \u2014 `SELECT campaign_asset.resource_name \u2026 FROM campaign_asset WHERE campaign_asset.status != 'REMOVED'` (or `ad_group_asset` / `customer_asset`) \u2014 never one composed out of an owner id and an asset id. A link's own status is not its campaign's and not its ad group's, so an inventory read scoped only to those lists extensions that are already detached, and a link between an asset and an owner that never held it parses fine and exists nowhere. Either way the target is read back before it is staged, and a detach of a link that is not there is refused here rather than at publish."
@@ -1644,7 +1644,7 @@ var conversionsCommand = defineCommand2({
     description: "Stage conversion action create/update (via --file), the account-level goal, and manual conversion uploads for a period where tracking was broken"
   },
   subCommands: {
-    upload: () => import("./conversion-upload-command-JULHGVIR.js").then((m) => m.conversionsUploadCommand),
+    upload: () => import("./conversion-upload-command-TZTHU2CD.js").then((m) => m.conversionsUploadCommand),
     create: fileCreateCommand(
       "create",
       "google.conversionAction.create",
@@ -1857,16 +1857,16 @@ Full guide: __tooling__/docs/tools/baker/ads-google.md`
   },
   subCommands: {
     accounts: () => import("./accounts-KYJO3JC6.js").then((m) => m.accountsCommand),
-    currency: () => import("./currency-DJDVIR3C.js").then((m) => m.currencyCommand),
-    "url-options": () => import("./url-options-QEWKRKZ3.js").then((m) => m.urlOptionsCommand),
-    changes: () => import("./changes-6QBJMGJC.js").then((m) => m.changesCommand),
-    query: () => import("./query-CPZZNMDY.js").then((m) => m.queryCommand),
+    currency: () => import("./currency-XCGKQ7FE.js").then((m) => m.currencyCommand),
+    "url-options": () => import("./url-options-GGXAL3J4.js").then((m) => m.urlOptionsCommand),
+    changes: () => import("./changes-TP7ZZHB3.js").then((m) => m.changesCommand),
+    query: () => import("./query-IEZRY6HV.js").then((m) => m.queryCommand),
     keywords: keywordsWithWrites,
     ...googleWriteCommands,
-    draft: () => import("./draft-U6CT6LCC.js").then((m) => m.draftCommand)
+    draft: () => import("./draft-BV2QRPZ4.js").then((m) => m.draftCommand)
   }
 });
 export {
   googleCommand
 };
-//# sourceMappingURL=google-KIBLORXX.js.map
+//# sourceMappingURL=google-35GDU3G3.js.map