@koda-sl/baker-cli 0.457.0 → 0.458.0

package/dist/chunk-FCADB4RG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/search.ts"],"sourcesContent":["import {\n  type ScopedWinnersSearchResponse,\n  scopedWinnersSearchRequestSchema,\n  staticFormatPatternSchema,\n  winnerSearchScopeSchema,\n  winnersSortSchema,\n} from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { type OutputFormat, winningAdNormalizer, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { adFieldPlan, adRows } from \"./adRows.ts\";\nimport { reportError, splitList } from \"./shared.ts\";\n\n// Listed in full: agents probed junk values (xx, foo) only to be told the list.\nconst FORMAT_PATTERN_DESCRIPTION = `Comma list of static containers, the best proven ads in them from any category (\\`winning-ads formats\\` ranks them for a segment): ${staticFormatPatternSchema.options.join(\", \")}`;\nconst STAGE_DESCRIPTION =\n  \"Comma list of where the ad is in its life: new (≤7 days running), testing (≤21), proven (≤60), evergreen (longer), killed_early (stopped within 2 weeks: a lost test), retired, unverified (brand not checked recently). What competitors kept: --stage proven,evergreen\";\nconst SURVIVED_TEST_DESCRIPTION =\n  \"Only the version a brand kept after testing it against other versions of the same concept: the strongest public sign it works\";\nconst LANGUAGE_DESCRIPTION =\n  \"Comma list of ISO 639-1 codes (es,en) for the language the ad's copy and voiceover are in; where it ran is --country\";\n\nregisterSchema({\n  command: \"winning-ads.search\",\n  description:\n    \"Search the ad-dna corpus of scored winning ads, the company's followed brands first. Returns a lean shortlist (advertiser, summary, scores, days_active/active/winner_category as proof, media_url, visual/container/mechanism, and who the ad was made for: audience_temperature/funnel_stage/advertiser_size/presumes_brand_knowledge, when known) to pick a reference to reproduce. Each search is a paid reranker + judge call: one strong search, at most one adjusted retry. Each row carries its stage (new, testing, proven, evergreen, killed_early, retired, unverified) and survived_test when it is the version its brand kept after testing; --survived-test or --stage proven,evergreen keep only what competitors kept. Only designed pictures and videos come back by default (no Google search, Shopping or app ads); --format text asks for Google search ads (their words), --all-kinds for everything. A value outside a closed list (--platform, --format, --winner-category, --awareness, --audience-temperature, --funnel-stage, --advertiser-size, --format-pattern, --stage, --sort) is refused with error.fix.validValues.\",\n  args: {\n    query: { type: \"string\", description: \"Free-text natural-language query\", required: false },\n    scope: {\n      type: \"string\",\n      description:\n        \"Which brands to draw from: followed-first (default: followed brands first, topped up from the library when too few clear the relevance floor; the whole library when the company follows nobody), followed (only brands the company follows), all (the whole shared library). Every result carries source: followed|library.\",\n      required: false,\n      default: \"followed-first\",\n    },\n    \"ref-ad-id\": {\n      type: \"string\",\n      description: \"Find ads similar to this ad id (instead of free text)\",\n      required: false,\n    },\n    limit: { type: \"number\", description: \"Max results 1-100 (default 10)\", required: false, default: 10 },\n    \"max-per-advertiser\": {\n      type: \"number\",\n      description:\n        \"Spread per advertiser by default: each brand's best 3 first, the rest after the other brands, none dropped. Set 1-50 to drop past N (1 = one reference per brand), 0 for rank order\",\n      required: false,\n    },\n    \"min-relevance\": { type: \"number\", description: \"Relevance floor 0-1; trims weak matches\", required: false },\n    sort: {\n      type: \"string\",\n      description:\n        \"Order of a browse with no query: winner (default, by winner score), longest_running (by days active), newest (by first seen). Ignored when a query is given: a query ranks by relevance blended with winner score.\",\n      required: false,\n      default: \"winner\",\n    },\n    platform: {\n      type: \"string\",\n      description: \"Comma list: meta,linkedin,tiktok,google\",\n      required: false,\n    },\n    format: { type: \"string\", description: \"Comma list: video,static,carousel,text\", required: false },\n    \"winner-category\": {\n      type: \"string\",\n      description: \"Comma list: winner,scaled_winner,evergreen,rising,untested,dud,…\",\n      required: false,\n    },\n    awareness: {\n      type: \"string\",\n      description: \"Comma list: unaware,problem_aware,solution_aware,product_aware,most_aware\",\n      required: false,\n    },\n    \"audience-temperature\": {\n      type: \"string\",\n      description:\n        \"Comma list of who the ad was made for: 0_cold (strangers), 1_warm_engaged (engaged, not yet visited), 2_hot_visited (visited the site), 3_customer. A cold brief takes 0_cold references.\",\n      required: false,\n    },\n    \"funnel-stage\": { type: \"string\", description: \"Comma list: TOF,MOF,BOF\", required: false },\n    \"advertiser-size\": { type: \"string\", description: \"Comma list: solo,smb,mid,enterprise\", required: false },\n    \"exclude-brand-reliant\": {\n      type: \"boolean\",\n      description:\n        \"Drop ads whose copy only works if the viewer already knows the brand (an unexplained logo, mascot, nickname or promise). Ads not judged yet are kept and show no presumes_brand_knowledge. Use it whenever the ad you are making is for viewers who don't know the brand.\",\n      required: false,\n      default: false,\n    },\n    country: {\n      type: \"string\",\n      description:\n        \"Comma list of ISO country codes (US,GB): ads known to run there, plus ads with no country data (every Meta ad) in that country's main language. An unknown code is refused with the codes that have ads\",\n      required: false,\n    },\n    language: { type: \"string\", description: LANGUAGE_DESCRIPTION, required: false },\n    \"advertiser-id\": {\n      type: \"string\",\n      description: \"Restrict to these advertiser ids (browse one brand's winners)\",\n      required: false,\n    },\n    \"exclude-advertiser\": {\n      type: \"string\",\n      description: \"Drop these advertiser ids, usually your own brand (a reused ad is marked already_adapted instead)\",\n      required: false,\n    },\n    \"first-seen-after\": {\n      type: \"string\",\n      description: \"ISO date (2026-01-01) or datetime; only ads first seen after this\",\n      required: false,\n    },\n    \"first-seen-before\": {\n      type: \"string\",\n      description: \"ISO date (2026-01-01) or datetime; only ads first seen before this\",\n      required: false,\n    },\n    \"hook-archetype\": {\n      type: \"string\",\n      description: \"Comma list of hook SEEDS (from `winning-ads hooks`) — narrow to ads on a proven hook pattern\",\n      required: false,\n    },\n    \"format-pattern\": {\n      type: \"string\",\n      description: FORMAT_PATTERN_DESCRIPTION,\n      required: false,\n    },\n    stage: { type: \"string\", description: STAGE_DESCRIPTION, required: false },\n    \"survived-test\": { type: \"boolean\", description: SURVIVED_TEST_DESCRIPTION, required: false, default: false },\n    \"all-kinds\": {\n      type: \"boolean\",\n      description:\n        \"Also return ads nobody can build a creative on: Google search text, Shopping and app ads. By default a search returns only designed pictures and videos; --format text asks for search ads alone (their words: headlines, claims, offers).\",\n      required: false,\n      default: false,\n    },\n    diverse: {\n      type: \"boolean\",\n      description:\n        \"Return one varied set (different brands, containers, hooks) instead of rank order: one reference per concept in a single call\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nexport interface WinningAdsSearchArgs {\n  query?: string;\n  scope?: string;\n  refAdId?: string;\n  limit?: string | number;\n  maxPerAdvertiser?: string | number;\n  minRelevance?: string | number;\n  sort?: string;\n  platform?: string;\n  format?: string;\n  winnerCategory?: string;\n  awareness?: string;\n  audienceTemperature?: string;\n  funnelStage?: string;\n  advertiserSize?: string;\n  excludeBrandReliant?: boolean;\n  country?: string;\n  language?: string;\n  advertiserId?: string;\n  excludeAdvertiser?: string;\n  firstSeenAfter?: string;\n  firstSeenBefore?: string;\n  hookArchetype?: string;\n  formatPattern?: string;\n  stage?: string;\n  survivedTest?: boolean;\n  diverse?: boolean;\n}\n\nfunction setNumber(body: Record<string, unknown>, key: string, value: string | number | undefined): void {\n  if (value !== undefined && value !== \"\") {\n    body[key] = Number(value);\n  }\n}\n\nfunction setList(target: Record<string, unknown>, key: string, value: string | undefined): void {\n  const list = splitList(value);\n  if (list.length) {\n    target[key] = list;\n  }\n}\n\nfunction setString(target: Record<string, unknown>, key: string, value: string | undefined): void {\n  if (value) {\n    target[key] = value;\n  }\n}\n\n/**\n * Build the `/api/ad-library/winners/search` request body from CLI args. Pure —\n * only emits keys the caller set, so the service applies its own defaults.\n * `hard_filters` is omitted entirely when no filter flag is present. The winner\n * category key is `winner_category`; the awareness key is `awareness_stage`;\n * `--exclude-brand-reliant` is `presumes_brand_knowledge: false`.\n */\nexport function buildSearchBody(args: WinningAdsSearchArgs): Record<string, unknown> {\n  const body: Record<string, unknown> = {};\n  if (args.query) {\n    body.free_text_query = args.query;\n  }\n  if (args.refAdId) {\n    body.ref_ad_id = args.refAdId;\n  }\n  setString(body, \"scope\", args.scope);\n  setNumber(body, \"limit\", args.limit);\n  setNumber(body, \"max_per_advertiser\", args.maxPerAdvertiser);\n  setNumber(body, \"min_relevance\", args.minRelevance);\n  setString(body, \"sort\", args.sort);\n  if (args.diverse) {\n    body.diverse = true;\n  }\n\n  const hardFilters: Record<string, unknown> = {};\n  setList(hardFilters, \"platform\", args.platform);\n  setList(hardFilters, \"format\", args.format);\n  setList(hardFilters, \"winner_category\", args.winnerCategory);\n  setList(hardFilters, \"awareness_stage\", args.awareness);\n  setList(hardFilters, \"audience_temperature\", args.audienceTemperature);\n  setList(hardFilters, \"funnel_stage\", args.funnelStage);\n  setList(hardFilters, \"advertiser_size\", args.advertiserSize);\n  if (args.excludeBrandReliant) {\n    hardFilters.presumes_brand_knowledge = false;\n  }\n  setList(hardFilters, \"country\", args.country);\n  setList(hardFilters, \"language\", args.language?.toLowerCase());\n  setList(hardFilters, \"advertiser_ids\", args.advertiserId);\n  setList(hardFilters, \"exclude_advertiser_ids\", args.excludeAdvertiser);\n  setList(hardFilters, \"hook_archetype_seeds\", args.hookArchetype);\n  setList(hardFilters, \"static_format_patterns\", args.formatPattern);\n  setString(hardFilters, \"first_seen_after\", args.firstSeenAfter);\n  setString(hardFilters, \"first_seen_before\", args.firstSeenBefore);\n  setList(hardFilters, \"lifecycle_stage\", args.stage);\n  if (args.survivedTest) {\n    hardFilters.survived_test = true;\n  }\n  if (Object.keys(hardFilters).length) {\n    body.hard_filters = hardFilters;\n  }\n\n  return body;\n}\n\n/**\n * A search is for a reference to build on, so it asks for designed ads only\n * (pictures and videos a brand made; no Google search, Shopping or app ads)\n * unless `--all-kinds` is passed or `--format` names search text ads.\n */\nexport function designedByDefault(\n  body: Record<string, unknown>,\n  opts: { allKinds?: boolean },\n): Record<string, unknown> {\n  const filters = (body.hard_filters ?? {}) as Record<string, unknown>;\n  const wantsText = Array.isArray(filters.format) && filters.format.includes(\"text\");\n  if (opts.allKinds || wantsText) return body;\n  return { ...body, hard_filters: { ...filters, design_reference: true } };\n}\n\n/**\n * Nudges after a search. A company that follows nobody only ever gets\n * references from brands other Baker clients track, which may be nowhere near\n * its market, so the fix is to follow its competitors.\n */\nexport function searchHints(data: {\n  scope?: string | null;\n  following_count?: number | null;\n  results?: ReadonlyArray<unknown> | null;\n}): string[] {\n  const hints: string[] = [];\n  if ((data.following_count ?? 0) === 0) {\n    hints.push(\n      'The company follows no brands, so these references come from brands tracked by others and may be off-market. Follow competitors with `baker winning-ads follow-competitors \"<domain,domain>\"` to get on-market references, then search with --scope followed-first.',\n    );\n  } else if (data.scope === \"followed\" && (data.results?.length ?? 0) === 0) {\n    hints.push(\n      \"No followed brand has an ad on this brief. Re-run with --scope followed-first to top up from the whole library.\",\n    );\n  } else if ((data.results?.length ?? 0) === 0) {\n    hints.push(\n      \"No reference matched the brief and every filter. Search once more with ONE change: drop the narrowest filter (--country, --audience-temperature or one --awareness stage) or shorten the brief to the product and who it is for. For a container your concept needs, --format-pattern <container> with no query returns the best proven ads in it from any category.\",\n    );\n  }\n  const kept = keptHint(data.results ?? []);\n  if (kept) hints.push(kept);\n  const adapted = (data.results ?? []).filter(\n    (r) => (r as { baker_uses?: { ours?: boolean } } | null)?.baker_uses?.ours === true,\n  ).length;\n  if (adapted > 0) {\n    hints.push(\n      `${adapted} of these references you already adapted into a creative (already_adapted), so they are listed last. A second creative from the same ad is a variant, not a new concept: pick another unless the user asked for one.`,\n    );\n  }\n  return hints;\n}\n\nconst KEPT_STAGES = new Set([\"proven\", \"evergreen\"]);\nconst UNTESTED_STAGES = new Set([\"new\", \"testing\"]);\n\n/**\n * What competitors kept after testing (the version a test kept, or an ad\n * running past its test window) outranks what merely runs: an ad in its first\n * three weeks may be the version they cut next week.\n */\nfunction keptHint(results: ReadonlyArray<unknown>): string | null {\n  const rows = results.map((r) => (r ?? {}) as { stage?: unknown; survived_test?: unknown });\n  const kept = rows.filter((r) => r.survived_test === true || KEPT_STAGES.has(String(r.stage))).length;\n  if (kept > 0 && kept < rows.length) {\n    return `${kept} of these are what competitors kept after testing (survived_test, or stage proven/evergreen): prefer them as references; a new or testing ad may still be cut.`;\n  }\n  if (kept === 0 && rows.some((r) => UNTESTED_STAGES.has(String(r.stage)))) {\n    return \"None of these has outlived a test yet (stage new/testing): to reference what competitors kept, search once more with --survived-test or --stage proven,evergreen.\";\n  }\n  return null;\n}\n\nconst UNKNOWN_COUNTRY_RE = /Unknown country code\\(s\\): ([^.]+)\\. Countries with ads: ([^.]+)\\./;\n\n// A type alias so it fits the envelope's `{ action, explanation } & Record<string, unknown>` fix slot.\nexport type UnknownCountryFix = {\n  action: \"retry_with_a_valid_country\";\n  explanation: string;\n  unknownCountries: string[];\n  validCountries: string[];\n};\n\n/**\n * The library refuses a `--country` code it holds no ads for, listing the codes\n * it does hold, rather than answering with an empty result that reads like \"no\n * winners in that market\". Only `{ code, message }` crosses the HTTP boundary,\n * so the two lists are parsed back out here to hand the agent a retry it can\n * make in one call. Anything else returns null.\n */\nexport function unknownCountryFix(message: string): UnknownCountryFix | null {\n  const match = UNKNOWN_COUNTRY_RE.exec(message);\n  if (!match) {\n    return null;\n  }\n  const unknownCountries = splitList(match[1]);\n  const validCountries = splitList(match[2]);\n  if (unknownCountries.length === 0 || validCountries.length === 0) {\n    return null;\n  }\n  return {\n    action: \"retry_with_a_valid_country\",\n    explanation: `${unknownCountries.join(\", \")} is not a country the winning-ads library holds ads for. Re-run with codes from \\`validCountries\\`, or drop --country to search every market.`,\n    unknownCountries,\n    validCountries,\n  };\n}\n\nexport type RetryNarrowerFix = { action: \"retry_narrower_once\"; explanation: string };\n\n/** What an agent can do about a failed search, or null when the error is its own to correct. */\nexport function searchErrorFix(code: string, message: string): UnknownCountryFix | RetryNarrowerFix | null {\n  if (code === \"UNAVAILABLE\") {\n    return {\n      action: \"retry_narrower_once\",\n      explanation:\n        \"The library did not answer this search in time. Retry once with a shorter brief, a lower --limit or fewer filters. If it fails again, continue without a reference and say so; do not stop the creative work.\",\n    };\n  }\n  return unknownCountryFix(message);\n}\n\nfunction reportSearchError(err: unknown): never {\n  const fix = err instanceof ApiError ? searchErrorFix(err.code, err.message) : null;\n  if (err instanceof ApiError && fix) {\n    writeJson({ ok: false, error: { code: err.code, message: err.message, fix } });\n    process.exit(1);\n  }\n  reportError(err);\n}\n\n// A type alias so it fits the envelope's `{ action, explanation } & Record<string, unknown>` fix slot.\nexport type InvalidValuesFix = {\n  action: \"retry_with_valid_values\";\n  explanation: string;\n  flag: string;\n  invalidValues: string[];\n  validValues: string[];\n};\n\n/** The flag that sets each request field, so a refusal names what the agent typed. */\nconst FLAG_FOR_FIELD: Record<string, string> = {\n  limit: \"--limit\",\n  max_per_advertiser: \"--max-per-advertiser\",\n  min_relevance: \"--min-relevance\",\n  platform: \"--platform\",\n  format: \"--format\",\n  winner_category: \"--winner-category\",\n  awareness_stage: \"--awareness\",\n  audience_temperature: \"--audience-temperature\",\n  funnel_stage: \"--funnel-stage\",\n  advertiser_size: \"--advertiser-size\",\n  static_format_patterns: \"--format-pattern\",\n  first_seen_after: \"--first-seen-after\",\n  first_seen_before: \"--first-seen-before\",\n  lifecycle_stage: \"--stage\",\n};\n\nfunction flagFor(path: readonly PropertyKey[]): string {\n  const field = String(path[0] === \"hard_filters\" ? path[1] : path[0]);\n  return FLAG_FOR_FIELD[field] ?? field;\n}\n\n/** What the backend's own request schema refuses, said in flags, with the valid values for a closed list. */\nfunction schemaRejection(body: Record<string, unknown>): SearchRejection | null {\n  const parsed = scopedWinnersSearchRequestSchema.safeParse(body, { reportInput: true });\n  if (parsed.success) {\n    return null;\n  }\n  const [first] = parsed.error.issues;\n  if (!first) {\n    return { message: \"Invalid search\" };\n  }\n  const flag = flagFor(first.path);\n  if (first.code === \"invalid_value\") {\n    const sameFlag = parsed.error.issues.filter((i) => i.code === \"invalid_value\" && flagFor(i.path) === flag);\n    const invalidValues = sameFlag.map((i) => String(i.input));\n    const validValues = first.values.map(String);\n    return {\n      message: `Unknown ${flag} value${invalidValues.length > 1 ? \"s\" : \"\"} ${invalidValues.map((v) => `\"${v}\"`).join(\", \")}.`,\n      fix: {\n        action: \"retry_with_valid_values\",\n        explanation: `Re-run with values from \\`validValues\\` for ${flag}, or drop the flag.`,\n        flag,\n        invalidValues,\n        validValues,\n      },\n    };\n  }\n  return { message: first.path.length > 0 ? `${flag}: ${first.message}` : first.message };\n}\n\nexport interface SearchRejection {\n  message: string;\n  fix?: InvalidValuesFix;\n}\n\nconst NUMERIC_FLAGS = [\n  [\"--limit\", \"limit\"],\n  [\"--max-per-advertiser\", \"maxPerAdvertiser\"],\n  [\"--min-relevance\", \"minRelevance\"],\n] as const;\n\n/** Refuse a call the backend would refuse, before spending a round trip on it. */\nexport function searchRejection(args: WinningAdsSearchArgs, body: Record<string, unknown>): SearchRejection | null {\n  if (args.scope !== undefined && !winnerSearchScopeSchema.safeParse(args.scope).success) {\n    return { message: `Unknown --scope \"${args.scope}\". Use one of: ${winnerSearchScopeSchema.options.join(\", \")}.` };\n  }\n  if (args.sort !== undefined && !winnersSortSchema.safeParse(args.sort).success) {\n    return { message: `Unknown --sort \"${args.sort}\". Use one of: ${winnersSortSchema.options.join(\", \")}.` };\n  }\n  for (const [flag, key] of NUMERIC_FLAGS) {\n    const value = args[key];\n    if (value !== undefined && value !== \"\" && Number.isNaN(Number(value))) {\n      return { message: `${flag} must be a number, got \"${value}\".` };\n    }\n  }\n  if (!(\"free_text_query\" in body || \"ref_ad_id\" in body || \"hard_filters\" in body)) {\n    return { message: \"Provide a query, --ref-ad-id, or a filter flag\" };\n  }\n  return schemaRejection(body);\n}\n\n/**\n * The CLI projects to the minimal/decision set for EVERY format (incl. json)\n * so the agent's context only ever holds what it needs to choose.\n */\nfunction writeSearchResult(\n  data: ScopedWinnersSearchResponse | null | undefined,\n  opts: { output: OutputFormat; fields: string[] | undefined; full: boolean },\n): void {\n  const rawResults = Array.isArray(data?.results) ? data.results : [];\n  const hints = searchHints(data ?? {});\n  const withHints = hints.length > 0 ? { hints } : {};\n  if (opts.output === \"json\") {\n    const results = adRows(rawResults, opts);\n    writeJson({\n      ok: true,\n      data: {\n        results,\n        scope: data?.scope ?? null,\n        following_count: data?.following_count ?? null,\n        pool_size: data?.pool_size ?? null,\n        match_confidence: data?.match_confidence ?? null,\n        below_floor_count: data?.below_floor_count ?? null,\n        country_coverage: data?.country_coverage ?? null,\n      },\n      ...withHints,\n    });\n    return;\n  }\n  writeOutput({ ok: true, data: rawResults, ...withHints }, opts.output, opts.fields, opts.full, winningAdNormalizer);\n}\n\n// followed-first can run two library searches back to back, each allowed 45 s\n// upstream, so the default 60 s would give up on an answer still coming.\nconst SEARCH_TIMEOUT_MS = 120_000;\n\nexport const searchCommand = defineCommand({\n  meta: {\n    name: \"search\",\n    description:\n      \"Search winning reference ads, the company's followed brands first. Start here: baker winning-ads search 'B2B SaaS before/after AI automation' --platform meta --format static --exclude-advertiser adv_123 --output md. A set of references for N concepts in one call: add --diverse --limit N. The best proven ad in one container from any category: --format-pattern comparison_table (no query needed; add --sort longest_running to order by staying power). References for viewers who don't know the brand: --audience-temperature 0_cold --exclude-brand-reliant. What competitors kept after testing: --survived-test. Each search is a paid reranker + judge call: one strong search, at most one adjusted retry.\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Free-text search query\", required: false },\n    scope: {\n      type: \"string\",\n      description:\n        \"followed-first (default) | followed | all. followed-first = the company's followed brands first, topped up from the whole library (the whole library when it follows nobody)\",\n      required: false,\n    },\n    \"ref-ad-id\": { type: \"string\", description: \"Find ads similar to this ad id\", required: false },\n    limit: {\n      type: \"string\",\n      description: \"Max results 1-100 (default 10 — a shortlist)\",\n      required: false,\n      default: \"10\",\n    },\n    \"max-per-advertiser\": {\n      type: \"string\",\n      description:\n        \"Spread per advertiser by default: each brand's best 3 first, the rest after the other brands, none dropped. Set 1-50 to drop past N (1 = one reference per brand), 0 for rank order\",\n      required: false,\n    },\n    \"min-relevance\": { type: \"string\", description: \"Relevance floor 0-1\", required: false },\n    sort: {\n      type: \"string\",\n      description:\n        \"Order of a no-query browse: winner (default) | longest_running | newest. Ignored when a query is given\",\n      required: false,\n    },\n    platform: {\n      type: \"string\",\n      description: \"Comma list of platforms (meta,linkedin,tiktok,google) — search one or several\",\n      required: false,\n    },\n    format: { type: \"string\", description: \"Comma list of formats (video,static,carousel,text)\", required: false },\n    \"winner-category\": {\n      type: \"string\",\n      description: \"Comma list of winner categories (default: all)\",\n      required: false,\n    },\n    awareness: { type: \"string\", description: \"Comma list of awareness stages\", required: false },\n    \"audience-temperature\": {\n      type: \"string\",\n      description:\n        \"Comma list of who the ad was made for: 0_cold | 1_warm_engaged | 2_hot_visited | 3_customer (a cold brief takes 0_cold)\",\n      required: false,\n    },\n    \"funnel-stage\": { type: \"string\", description: \"Comma list: TOF,MOF,BOF\", required: false },\n    \"advertiser-size\": { type: \"string\", description: \"Comma list: solo,smb,mid,enterprise\", required: false },\n    \"exclude-brand-reliant\": {\n      type: \"boolean\",\n      description:\n        \"Drop ads that only work if the viewer already knows the brand (ads not judged yet are kept). Use it when making ads for viewers who don't know the brand\",\n      required: false,\n      default: false,\n    },\n    country: {\n      type: \"string\",\n      description:\n        \"Comma list of ISO country codes (US,GB): ads known to run there, plus ads with no country data (every Meta ad) in that country's main language. An unknown code is refused with the codes that have ads\",\n      required: false,\n    },\n    language: { type: \"string\", description: LANGUAGE_DESCRIPTION, required: false },\n    \"advertiser-id\": { type: \"string\", description: \"Restrict to these advertiser ids\", required: false },\n    \"exclude-advertiser\": {\n      type: \"string\",\n      description: \"Drop these advertiser ids, usually your own brand\",\n      required: false,\n    },\n    \"first-seen-after\": { type: \"string\", description: \"ISO date or datetime lower bound\", required: false },\n    \"first-seen-before\": { type: \"string\", description: \"ISO date or datetime upper bound\", required: false },\n    \"hook-archetype\": {\n      type: \"string\",\n      description: \"Comma list of proven hook seeds (from `winning-ads hooks`) to narrow the search\",\n      required: false,\n    },\n    \"format-pattern\": {\n      type: \"string\",\n      description: FORMAT_PATTERN_DESCRIPTION,\n      required: false,\n    },\n    stage: { type: \"string\", description: STAGE_DESCRIPTION, required: false },\n    \"survived-test\": { type: \"boolean\", description: SURVIVED_TEST_DESCRIPTION, required: false, default: false },\n    \"all-kinds\": {\n      type: \"boolean\",\n      description: \"Also return Google search text, Shopping and app ads (default: designed pictures and videos only)\",\n      required: false,\n      default: false,\n    },\n    diverse: {\n      type: \"boolean\",\n      description: \"One varied set (different brands, containers, hooks): a reference per concept in one call\",\n      required: false,\n      default: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: {\n      type: \"boolean\",\n      description:\n        \"Include DNA detail (angle, persona, hook, awareness, industry) + reach and media kind; mechanism, days_active, active, winner_category, audience_temperature, funnel_stage, advertiser_size and presumes_brand_knowledge are in the default output\",\n      required: false,\n      default: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const searchArgs: WinningAdsSearchArgs = {\n        query: args.query as string | undefined,\n        scope: args.scope as string | undefined,\n        refAdId: args[\"ref-ad-id\"] as string | undefined,\n        limit: args.limit as string | undefined,\n        maxPerAdvertiser: args[\"max-per-advertiser\"] as string | undefined,\n        minRelevance: args[\"min-relevance\"] as string | undefined,\n        sort: args.sort as string | undefined,\n        platform: args.platform as string | undefined,\n        format: args.format as string | undefined,\n        winnerCategory: args[\"winner-category\"] as string | undefined,\n        awareness: args.awareness as string | undefined,\n        audienceTemperature: args[\"audience-temperature\"] as string | undefined,\n        funnelStage: args[\"funnel-stage\"] as string | undefined,\n        advertiserSize: args[\"advertiser-size\"] as string | undefined,\n        excludeBrandReliant: args[\"exclude-brand-reliant\"] as boolean,\n        country: args.country as string | undefined,\n        language: args.language as string | undefined,\n        advertiserId: args[\"advertiser-id\"] as string | undefined,\n        excludeAdvertiser: args[\"exclude-advertiser\"] as string | undefined,\n        firstSeenAfter: args[\"first-seen-after\"] as string | undefined,\n        firstSeenBefore: args[\"first-seen-before\"] as string | undefined,\n        hookArchetype: args[\"hook-archetype\"] as string | undefined,\n        formatPattern: args[\"format-pattern\"] as string | undefined,\n        stage: args.stage as string | undefined,\n        survivedTest: args[\"survived-test\"] as boolean,\n        diverse: args.diverse as boolean,\n      };\n\n      const fieldPlan = adFieldPlan(args.fields, args.full);\n      const body = designedByDefault(buildSearchBody(searchArgs), { allKinds: args[\"all-kinds\"] as boolean });\n      const rejection = searchRejection(searchArgs, body);\n      if (rejection) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", ...rejection } });\n        process.exit(1);\n      }\n\n      const data = await apiPost<ScopedWinnersSearchResponse>(\"/api/ad-library/winners/search\", body, {\n        timeoutMs: SEARCH_TIMEOUT_MS,\n      });\n      writeSearchResult(data, { output: (args.output as OutputFormat) || \"json\", ...fieldPlan });\n    } catch (err) {\n      reportSearchError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/chunk-FIBL3EZN.js

@@ -0,0 +1,197 @@
+import {
+  mediaTagsCreateRequestSchema,
+  mediaTagsDeleteRequestSchema,
+  mediaTagsUpdateRequestSchema
+} from "./chunk-ZJVHZHYP.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-TOYLG3ZY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-ZZFYDAJQ.js";
+
+// src/lib/tags-command.ts
+import { defineCommand } from "citty";
+var OUTPUT_ARG = {
+  output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
+};
+var SHARED_POOL_HINT = "Custom tags are one pool shared by images, videos and testimonials \u2014 this change shows up in all three. Already applied: publishing or discarding this chat does not undo it.";
+function fail(err) {
+  const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
+  const message = err instanceof ApiError ? err.message : "Unexpected error";
+  writeJson({ ok: false, error: { code, message } });
+  process.exit(1);
+}
+function failInvalid(issue) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: issue?.message ?? "Invalid request" } });
+  process.exit(1);
+}
+function makeTagsCommand(command, label, endpoint) {
+  registerSchema({
+    command: `${command}.tags.list`,
+    description: `List the available ${label} tag taxonomy (built-in defaults + this company's custom tags).`,
+    args: OUTPUT_ARG
+  });
+  const listCommand = defineCommand({
+    meta: {
+      name: "list",
+      description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
+    },
+    args: OUTPUT_ARG,
+    run: async ({ args }) => {
+      try {
+        const { markdown } = await apiGet(endpoint);
+        if (args.output === "json") {
+          writeJson({ ok: true, data: { markdown } });
+          return;
+        }
+        process.stdout.write(`${markdown.trimEnd()}
+`);
+      } catch (err) {
+        const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
+        const message = err instanceof ApiError ? err.message : "Unexpected error";
+        if (args.output === "json") {
+          writeJson({ ok: false, error: { code, message } });
+        } else {
+          process.stderr.write(`Error: ${message}
+`);
+        }
+        process.exit(1);
+      }
+    }
+  });
+  const createArgs = {
+    name: { type: "positional", description: "Tag name (stored lowercased, spaces \u2192 hyphens)", required: true },
+    description: {
+      type: "string",
+      description: "What the tag means, so it gets applied consistently",
+      required: false
+    }
+  };
+  registerSchema({
+    command: `${command}.tags.create`,
+    description: "Create a custom media tag in the company's shared pool (images, videos and testimonials). Applies immediately. Use when no built-in or custom tag fits.",
+    args: {
+      name: { type: "string", description: "Tag name (stored lowercased, spaces \u2192 hyphens)", required: true },
+      description: createArgs.description
+    }
+  });
+  const createCommand = defineCommand({
+    meta: {
+      name: "create",
+      description: `Create a custom tag (shared by images, videos and testimonials). Applies immediately.
+
+Example: baker ${command} tags create "summer sale" --description "Assets for the summer sale campaign"`
+    },
+    args: createArgs,
+    run: async ({ args }) => {
+      const parsed = mediaTagsCreateRequestSchema.safeParse({
+        name: String(args.name ?? ""),
+        ...args.description ? { description: String(args.description) } : {}
+      });
+      if (!parsed.success) failInvalid(parsed.error.issues[0]);
+      try {
+        const data = await apiPost("/api/media-tags/create", parsed.data);
+        writeJson({
+          ok: true,
+          data,
+          hints: [
+            SHARED_POOL_HINT,
+            `Use it as \`--tags ${data.name}\`.`,
+            ...data.description ? [] : ["MISSING --description: add one with `tags update` so the tag is applied consistently."]
+          ]
+        });
+      } catch (err) {
+        fail(err);
+      }
+    }
+  });
+  registerSchema({
+    command: `${command}.tags.update`,
+    description: "Change what a custom tag means (its description). Built-in tags cannot be changed. Applies immediately.",
+    args: {
+      slug: { type: "string", description: "Custom tag name, as `tags` lists it", required: true },
+      description: { type: "string", description: "New description", required: true }
+    }
+  });
+  const updateCommand = defineCommand({
+    meta: {
+      name: "update",
+      description: `Change a custom tag's description. Built-in tags cannot be changed. Applies immediately.
+
+Example: baker ${command} tags update summer-sale --description "Assets for the 2026 summer sale"`
+    },
+    args: {
+      slug: { type: "positional", description: "Custom tag name, as `tags` lists it", required: true },
+      description: { type: "string", description: "New description", required: true }
+    },
+    run: async ({ args }) => {
+      const parsed = mediaTagsUpdateRequestSchema.safeParse({
+        slug: String(args.slug ?? ""),
+        description: String(args.description ?? "")
+      });
+      if (!parsed.success) failInvalid(parsed.error.issues[0]);
+      try {
+        const data = await apiPost("/api/media-tags/update", parsed.data);
+        writeJson({ ok: true, data, hints: [SHARED_POOL_HINT] });
+      } catch (err) {
+        fail(err);
+      }
+    }
+  });
+  registerSchema({
+    command: `${command}.tags.delete`,
+    description: "Delete a custom tag from the company's shared pool. Built-in tags cannot be deleted. Applies immediately. Confirm with the user first.",
+    args: { slug: { type: "string", description: "Custom tag name, as `tags` lists it", required: true } }
+  });
+  const deleteCommand = defineCommand({
+    meta: {
+      name: "delete",
+      description: `Delete a custom tag (shared by images, videos and testimonials). Built-in tags cannot be deleted. Applies immediately \u2014 confirm with the user first.
+
+Example: baker ${command} tags delete summer-sale`
+    },
+    args: { slug: { type: "positional", description: "Custom tag name, as `tags` lists it", required: true } },
+    run: async ({ args }) => {
+      const parsed = mediaTagsDeleteRequestSchema.safeParse({ slug: String(args.slug ?? "") });
+      if (!parsed.success) failInvalid(parsed.error.issues[0]);
+      try {
+        const data = await apiPost("/api/media-tags/delete", parsed.data);
+        writeJson({ ok: true, data, hints: [SHARED_POOL_HINT] });
+      } catch (err) {
+        fail(err);
+      }
+    }
+  });
+  return defineCommand({
+    meta: {
+      name: "tags",
+      description: `The ${label} tag taxonomy: built-in defaults plus the company's custom tags (one pool shared by images, videos and testimonials). Subcommands: list (default), create, update, delete.
+
+Examples:
+  baker ${command} tags                                   # list available tags
+  baker ${command} tags create "summer sale" --description "\u2026"
+  baker ${command} tags update summer-sale --description "\u2026"
+  baker ${command} tags delete summer-sale`
+    },
+    // Declared on the parent too: `default: "list"` dispatches the bare `tags --output json`
+    // form, and citty reads an undeclared flag's value as a subcommand name.
+    args: OUTPUT_ARG,
+    subCommands: {
+      list: listCommand,
+      create: createCommand,
+      update: updateCommand,
+      delete: deleteCommand
+    },
+    // `default`, never `run`: citty falls through to the parent's `run` after a subcommand.
+    default: "list"
+  });
+}
+
+export {
+  makeTagsCommand
+};
+//# sourceMappingURL=chunk-FIBL3EZN.js.map

package/dist/chunk-FJDTR2IN.js

@@ -0,0 +1,363 @@
+import {
+  MAX_VIDEO_INGEST_BYTES,
+  MAX_VIDEO_INGEST_SECONDS,
+  directDedupeKey,
+  downloadTimeoutMs,
+  isDirectMediaUrl,
+  isDrmProtected,
+  isRegionBlocked,
+  isToolingOrBlockFailure,
+  refuseByDuration,
+  resolveIngestSource,
+  worthDownloadingInstead
+} from "./chunk-FKOECEVC.js";
+import {
+  YtDlpError,
+  canonicalUrl,
+  durationSeconds,
+  isAudioOnly,
+  isVimeoAuthFailure,
+  probeYtDlp,
+  runYtDlp,
+  ytDlpBlockSignal
+} from "./chunk-LCMGWIEQ.js";
+import {
+  videosIngestRequestSchema
+} from "./chunk-ZJVHZHYP.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-TOYLG3ZY.js";
+import {
+  captureVimeoCookie,
+  isProxyFailure
+} from "./chunk-YKSIHGIL.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-ZZFYDAJQ.js";
+
+// src/commands/videos/ingest.ts
+import { mkdtemp, rm, stat } from "fs/promises";
+import { tmpdir } from "os";
+import path from "path";
+import { defineCommand } from "citty";
+
+// src/lib/streamUpload.ts
+import { createHash } from "crypto";
+import { createReadStream } from "fs";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+async function hashFile(filePath) {
+  const hash = createHash("sha256");
+  await pipeline(createReadStream(filePath), hash);
+  return hash.digest("hex");
+}
+async function putFileStreamed(args) {
+  const body = Readable.toWeb(createReadStream(args.filePath));
+  return await fetch(args.putUrl, {
+    method: "PUT",
+    body,
+    headers: {
+      "Content-Type": args.contentType,
+      "Content-Length": String(args.sizeBytes)
+    },
+    duplex: "half"
+  });
+}
+
+// src/commands/videos/ingest.ts
+registerSchema({
+  command: "videos.ingest",
+  description: "Add a video to the library from a URL \u2014 a direct file, or a YouTube/TikTok/Vimeo page.",
+  args: {
+    url: { type: "string", description: "Video URL (direct file or a watch/post page)", required: true },
+    source: { type: "string", description: "Provenance: url | youtube", required: false },
+    "external-id": { type: "string", description: "Provider asset id (deduped on)", required: false },
+    "external-url": { type: "string", description: "Canonical page URL", required: false },
+    download: {
+      type: "boolean",
+      description: "Force the download path instead of letting Baker fetch the URL directly",
+      required: false,
+      default: false
+    },
+    country: {
+      type: "string",
+      description: "Two-letter country to fetch from (e.g. US, DE, JP) \u2014 use when a video is blocked in your region",
+      required: false
+    },
+    context: {
+      type: "string",
+      description: "What you know that the video cannot show \u2014 the campaign, whether the person on camera is a real customer, what it is for. Highest-leverage flag here: it is what makes the clip findable later.",
+      required: false
+    },
+    "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
+  }
+});
+var ingestCommand = defineCommand({
+  meta: {
+    name: "ingest",
+    description: "Add a video to the library from a URL. A direct file URL is handed straight to Baker, which fetches it. A page URL (YouTube, TikTok, Vimeo, Instagram) is downloaded here first, then uploaded \u2014 and a direct URL that Baker cannot fetch falls back to that same path automatically.\n\nExample: baker videos ingest https://www.youtube.com/watch?v=abc123"
+  },
+  args: {
+    url: { type: "positional", description: "Video URL", required: false },
+    source: { type: "string", description: "Provenance: url | youtube", required: false },
+    "external-id": { type: "string", description: "Provider asset id", required: false },
+    "external-url": { type: "string", description: "Canonical page URL", required: false },
+    download: { type: "boolean", description: "Force the download path", required: false, default: false },
+    country: { type: "string", description: "Two-letter country to fetch from, e.g. US", required: false },
+    context: {
+      type: "string",
+      description: "Context for the analysis \u2014 campaign, who is on camera, intended use",
+      required: false
+    },
+    "dry-run": { type: "boolean", description: "Preview without executing", required: false, default: false }
+  },
+  run: ({ args }) => runVideoIngest({
+    url: args.url,
+    source: args.source,
+    externalId: args["external-id"],
+    externalUrl: args["external-url"],
+    forceDownload: args.download === true,
+    country: args.country,
+    context: args.context,
+    dryRun: args["dry-run"] === true
+  })
+});
+async function runVideoIngest(opts) {
+  const url = opts.url;
+  if (!url) {
+    writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "URL is required" } });
+    process.exit(1);
+  }
+  const direct = !opts.forceDownload && isDirectMediaUrl(url);
+  const country = opts.country?.trim() || void 0;
+  const args = {
+    url,
+    source: resolveIngestSource(opts.source, url),
+    externalId: opts.externalId,
+    // Deliberately NOT pre-filled with the pasted URL. Doing so shadowed the
+    // canonical URL the probe resolves (`?? canonicalUrl(...)` below could never
+    // run), so the same video filed under a different `externalUrl` depending on
+    // whether the link was copied from a share sheet, a shorts page or the
+    // address bar. `downloadThenIngest` falls back to `args.url` when the probe
+    // resolves nothing, which is the value this used to hard-code.
+    externalUrl: opts.externalUrl,
+    descriptionContext: opts.context?.trim() || void 0
+  };
+  const validation = videosIngestRequestSchema.safeParse({ ...args, url });
+  if (!validation.success) {
+    const problem = validation.error.issues[0];
+    writeJson({
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: problem ? `${problem.path.join(".") || "request"}: ${problem.message}` : "Invalid request"
+      }
+    });
+    process.exit(1);
+  }
+  if (opts.dryRun) {
+    reportDryRun(args, direct, country);
+    return;
+  }
+  try {
+    const data = await ingestByRoute(args, direct, country);
+    writeJson({ ok: true, data, hints: ingestHints(data) });
+  } catch (err) {
+    reportIngestFailure(err);
+  }
+}
+function ingestHints(data) {
+  if (data.reducedQuality !== true) return void 0;
+  return [
+    "Added, but at standard quality (360p): the site refused to release the full-quality file and this was the best it would hand over. Tell the user \u2014 the clip is in the library and usable, it is just not high-resolution. If they need the crisp version, ask them for the original file and use `baker videos upload <file>`."
+  ];
+}
+function reportDryRun(args, direct, country) {
+  writeJson({
+    ok: true,
+    dryRun: true,
+    operation: "videos.ingest",
+    params: {
+      url: args.url,
+      source: args.source,
+      // Known up front on the direct route, because it is derived from the URL
+      // alone. The download route's key comes from the probe, which a dry run
+      // does not perform, so there it stays null rather than becoming a guess.
+      externalId: args.externalId ?? (direct ? directDedupeKey(args.source, args.url) : null),
+      // A page URL's canonical form is only known after the probe, which a dry
+      // run does not perform — so this is null rather than a guess.
+      externalUrl: args.externalUrl ?? null,
+      direct,
+      country: country ?? null,
+      descriptionContext: args.descriptionContext ?? null
+    }
+  });
+}
+async function ingestByRoute(args, direct, country) {
+  if (!direct) {
+    return { ...await downloadThenIngest(args, country), via: "download" };
+  }
+  try {
+    const externalId = args.externalId ?? directDedupeKey(args.source, args.url);
+    return { ...await ingestUrl({ ...args, externalId }), via: "direct" };
+  } catch (err) {
+    if (!(err instanceof ApiError) || !worthDownloadingInstead(err.code)) throw err;
+    return { ...await downloadThenIngest(args, country), via: "download", fallbackFrom: err.message };
+  }
+}
+function reportYtDlpFailure(err) {
+  const detail = `${err.stderrTail} ${err.message}`;
+  if (isProxyFailure(ytDlpBlockSignal(detail))) {
+    fail(
+      "Couldn't download that video: our connection to the internet was refused.",
+      "This is Baker's egress proxy, not the link \u2014 its credentials look wrong or expired. The link is probably fine. Report it; retrying won't help until the proxy is fixed."
+    );
+  }
+  if (isDrmProtected(detail)) {
+    fail(
+      "That video is copy-protected, so it can't be added to the library.",
+      "The publisher encrypted this one against downloading. Nothing will change that \u2014 not retrying, not a different region. Ask whoever owns the video for the original file and add it with `baker videos upload <file>`."
+    );
+  }
+  if (isVimeoAuthFailure(detail)) {
+    fail(
+      "Vimeo wouldn't hand over that video \u2014 Baker isn't signed in to Vimeo.",
+      "Vimeo now refuses anonymous downloads entirely, so this needs a signed-in session and the one Baker holds has either expired or was never set. Nothing is wrong with the link. Report it so the Vimeo cookie can be refreshed; meanwhile download the file and use `baker videos upload <file>`."
+    );
+  }
+  if (isRegionBlocked(detail)) {
+    fail(
+      `That video isn't available in the region we're fetching from. ${err.stderrTail || err.message}`,
+      "Re-run with `--country <two-letter code>` for a country where the video plays \u2014 e.g. `--country US`. Pick the one the video belongs to (the uploader's country is the usual answer); each attempt costs a paid connection, so choose rather than work through the list."
+    );
+  }
+  fail(
+    `Couldn't download that video. ${err.stderrTail || err.message}`,
+    isToolingOrBlockFailure(detail) ? "The site wouldn't hand over the video \u2014 usually the downloader being out of date against a site that changed, or the request being blocked. Retrying won't help, and the link is probably fine. Report it so the tool can be updated; meanwhile download the file and use `baker videos upload <file>`." : "Check the link is public and playable. Private or age-restricted videos can't be downloaded \u2014 download the file yourself and use `baker videos upload <file>`."
+  );
+}
+function fail(message, fix, code = "INGEST_FAILED") {
+  writeJson({ ok: false, error: { code, message, fix } });
+  process.exit(1);
+}
+function reportIngestFailure(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  if (err instanceof YtDlpError) reportYtDlpFailure(err);
+  const detail = err instanceof Error ? err.message : String(err);
+  if (detail.includes("timed out after")) {
+    fail(
+      "That video took too long to download and was stopped part-way.",
+      "Long or slow-serving videos can outrun the download window. Try a shorter clip, or download this one yourself and use `baker videos upload <file>`.",
+      "INTERNAL_ERROR"
+    );
+  }
+  fail(
+    `Couldn't add that video. ${detail}`,
+    "This is a fault on Baker's side, not a problem with the link. Report it.",
+    "INTERNAL_ERROR"
+  );
+}
+function dedupeKey(args, info) {
+  const id = typeof info.id === "string" ? info.id : void 0;
+  if (!id) return void 0;
+  if (info.extractor === "generic") return `${args.source}:${canonicalUrl(info) ?? args.url}`;
+  return `${args.source}:${id}`;
+}
+function ingestUrl(args) {
+  const body = {
+    url: args.url,
+    source: args.source
+  };
+  if (args.externalId) body.externalId = args.externalId;
+  if (args.externalUrl) body.externalUrl = args.externalUrl;
+  if (args.descriptionContext) body.descriptionContext = args.descriptionContext;
+  return apiPost("/api/videos/ingest", body);
+}
+async function downloadThenIngest(args, country) {
+  const vimeoCookie = captureVimeoCookie();
+  const workDir = await mkdtemp(path.join(tmpdir(), "videos-ingest-"));
+  try {
+    const probe = await probeYtDlp({ url: args.url, country, vimeoCookie, cookieDir: workDir });
+    if (isAudioOnly(probe.info)) {
+      throw new ApiError(
+        "VALIDATION_ERROR",
+        "That link is audio, not video, so it can't go in the video library. Music and podcast links have no picture to store."
+      );
+    }
+    const tooLong = refuseByDuration(durationSeconds(probe.info), MAX_VIDEO_INGEST_SECONDS);
+    if (tooLong) {
+      throw new ApiError("VALIDATION_ERROR", tooLong);
+    }
+    const externalId = args.externalId ?? dedupeKey(args, probe.info);
+    const { filePath, tier, reducedQuality } = await runYtDlp({
+      url: args.url,
+      audioOnly: false,
+      workDir,
+      // Deliberately uncapped: take the best the site will release and let Mux
+      // decide what to serve. The 1080p ceiling this replaces was reasoning
+      // about the wrong cost — it saved download bytes by throwing away source
+      // pixels *before* the one system that can make renditions from them ever
+      // saw them, so a 4K master became a 1080p master permanently, for
+      // everything the library is ever asked to do with that clip afterwards.
+      // Downscaling is Mux's job and it is cheap; re-acquiring a master is not.
+      country,
+      vimeoCookie,
+      // Budgeted from the probed length, so the duration we accept and the time
+      // we allow to fetch it cannot drift apart.
+      timeoutMs: downloadTimeoutMs(durationSeconds(probe.info))
+    });
+    const stats = await stat(filePath);
+    if (stats.size > MAX_VIDEO_INGEST_BYTES) {
+      throw new ApiError(
+        "VALIDATION_ERROR",
+        `That video is ${(stats.size / 1024 ** 3).toFixed(1)} GB, over the ${Math.round(MAX_VIDEO_INGEST_BYTES / 1024 ** 3)} GB limit for this route.`
+      );
+    }
+    const publicUrl = await uploadToAssetStore(filePath, stats.size);
+    return {
+      ...await ingestUrl({
+        ...args,
+        url: publicUrl,
+        externalId,
+        externalUrl: args.externalUrl ?? canonicalUrl(probe.info) ?? args.url
+      }),
+      egress: tier,
+      // Named in the result for the same reason `egress` is: a geo-targeted exit
+      // is a deliberate, billable choice and must not be invisible afterwards.
+      ...country ? { country } : {},
+      // Third member of the same family. The site refused the good formats and
+      // the download quietly took the one it would release, which is the right
+      // call — but a clip that is 360p because of that must say so here, or the
+      // only way to find out is to watch it.
+      ...reducedQuality ? { reducedQuality: true } : {}
+    };
+  } finally {
+    await rm(workDir, { recursive: true, force: true }).catch(() => {
+    });
+  }
+}
+async function uploadToAssetStore(filePath, sizeBytes) {
+  const sha256 = await hashFile(filePath);
+  const { putUrl, publicUrl } = await apiPost("/api/canvas/assets/presign", {
+    sha256,
+    mime: "video/mp4",
+    purpose: "source"
+  });
+  const putRes = await putFileStreamed({ putUrl, filePath, contentType: "video/mp4", sizeBytes });
+  if (!putRes.ok) {
+    throw new ApiError("INTERNAL_ERROR", `Storing the downloaded video failed: HTTP ${putRes.status}`);
+  }
+  return publicUrl;
+}
+
+export {
+  ingestCommand,
+  runVideoIngest,
+  ingestHints
+};
+//# sourceMappingURL=chunk-FJDTR2IN.js.map