@koda-sl/baker-cli 0.554.0 → 0.556.0

package/dist/creatives-WBBN6G7H.js

@@ -0,0 +1,229 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-OTFHIGEO.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-QYH2UZAK.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import {
+  shapeListRows
+} from "./chunk-65Y3RCWP.js";
+import "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiGet
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/creatives.ts
+import { defineCommand } from "citty";
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function asString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function creativeDestination(content) {
+  if (!content) return { format: "unknown" };
+  const reference = asString(content.reference);
+  if (reference) return { format: "post", postUrn: reference };
+  const textAd = asRecord(content.textAd);
+  if (textAd) return { format: "text", landingUrl: asString(textAd.landingPage) };
+  const spotlight = asRecord(content.spotlight);
+  if (spotlight) return { format: "spotlight", landingUrl: asString(spotlight.landingPage) };
+  if (asRecord(content.follower)) return { format: "follower" };
+  if (asRecord(content.jobs)) return { format: "jobs" };
+  return { format: "unknown" };
+}
+var COMPACT_COLUMNS = [
+  "id",
+  "urn",
+  "campaign",
+  "intendedStatus",
+  "isServing",
+  "reviewStatus",
+  "format",
+  "landingUrl",
+  "postUrn",
+  "leadForm",
+  "leadFormButton"
+];
+function leadFormUrn(destination) {
+  const id = destination?.match(/(\d+)$/)?.[1];
+  return id ? `urn:li:leadGenForm:${id}` : void 0;
+}
+function compactRow(row) {
+  const destination = creativeDestination(row.content);
+  const leadForm = leadFormUrn(row.leadgenCallToAction?.destination);
+  return {
+    id: row.id,
+    urn: row.urn,
+    campaign: row.campaign,
+    intendedStatus: row.intendedStatus,
+    isServing: row.isServing,
+    reviewStatus: row.reviewStatus,
+    format: destination.format,
+    ...destination.landingUrl ? { landingUrl: destination.landingUrl } : {},
+    ...destination.postUrn ? { postUrn: destination.postUrn } : {},
+    ...leadForm ? { leadForm, leadFormButton: row.leadgenCallToAction?.label } : {}
+  };
+}
+function unmappedShapeWarnings(rows, rawContentReturned) {
+  const unmapped = rows.filter((row) => row.content && creativeDestination(row.content).format === "unknown");
+  if (unmapped.length === 0) return [];
+  const remedy = rawContentReturned ? "Their raw content is in this response \u2014 read it directly; this command cannot resolve a destination for them." : "Re-read those with --full before drawing any conclusion about where they point.";
+  return [
+    {
+      code: "UNMAPPED_CREATIVE_CONTENT",
+      message: `${unmapped.length} of ${rows.length} creatives have a content shape this command can't read, so their destination is missing (ids: ${unmapped.slice(0, 5).map((row) => row.id).join(", ")}). ${remedy}`
+    }
+  ];
+}
+var listArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+  "account-urn": { type: "string", description: "Alias for --account-id" },
+  "campaign-id": { type: "string", description: "Filter by campaign ID" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  statuses: { type: "string", description: statusesArgDescription("creatives") },
+  fields: {
+    type: "string",
+    description: "CSV of dotted paths to return instead of the compact row, e.g. id,content.textAd.landingPage"
+  },
+  full: { type: "boolean", description: "Return the complete raw records, including the opaque 'content' block" },
+  limit: { type: "string", description: "Max rows (default: 500)" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+};
+var creativesListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List LinkedIn creatives (ads). Runs by default when no subcommand is given."
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      const statuses = resolveStatusFilter(args, "creatives");
+      if (statuses) params.statuses = statuses.join(",");
+      if (args["campaign-id"]) params["campaign-id"] = String(args["campaign-id"]);
+      if (args.limit) params.limit = String(args.limit);
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/creatives", params);
+      const shaped = shapeListRows(data, args, {
+        row: compactRow,
+        columns: COMPACT_COLUMNS
+      });
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(shaped.rows, fmt, shaped.fields, shaped.hints);
+        return;
+      }
+      const warnings = unmappedShapeWarnings(data, args.full === true);
+      writeJsonEnvelope({
+        ok: true,
+        data: shaped.rows,
+        ...warnings.length > 0 ? { warnings } : {},
+        ...shaped.hints ? { hints: shaped.hints } : {}
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var creativesGetCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: `Read one ad as LinkedIn holds it: headline, intro text, landing URL, the lead gen form it opens, its review verdict (with rejection reasons) and why it is not serving (notServingBecause \u2014 e.g. FORM_HOLD, UNDER_REVIEW, CAMPAIGN_STOPPED).
+The listing can only name a post-based ad's post; this is where its headline and link come back.
+Example: baker ads linkedin creatives get 1584704523`
+  },
+  args: {
+    id: { type: "positional", description: "Creative id or urn:li:sponsoredCreative:N", required: true },
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const data = await apiGet("/api/ads/linkedin/creative", {
+        "account-id": accountId,
+        "creative-id": String(args.id)
+      });
+      writeJsonEnvelope({
+        ok: true,
+        data,
+        hints: [
+          `These are the stored fields, not what people see. To look at the ad as the feed shows it: baker ads linkedin preview ${String(args.id)} --account-id ${accountId}`
+        ]
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var creativesCommand = defineCommand({
+  meta: {
+    name: "creatives",
+    description: `List LinkedIn creatives (ads), or stage writes (create/update/pause/resume/duplicate).
+
+Defaults to ACTIVE intended-status. Pass --all-statuses or --statuses ACTIVE,PAUSED to widen.
+
+Rows are compact by default: id, urn, campaign, status, review status, format, and
+the resolved destination (landingUrl, or postUrn for post-based ads), and for a
+lead gen ad the form it opens (leadForm, leadFormButton). Use --fields
+for specific dotted paths, or --full for the complete raw records.
+
+Post-based ads (image, video, carousel, document, article, event, TLA) report a
+postUrn, not a landingUrl \u2014 their destination lives in the post itself.
+Use 'reviewStatus' to spot rejected/pending creatives during an audit.
+
+Write subcommands stage ops on this chat's draft \u2014 media comes from the Baker
+library and is uploaded to LinkedIn only at publish.
+
+Examples:
+  baker ads linkedin creatives --account-id 503001492
+  baker ads linkedin creatives --account-id 503001492 --fields id,intendedStatus,content.textAd.landingPage
+  baker ads linkedin creatives create --campaign 1234 --format image --image-id <bakerImageId> --intro "\u2026" --headline "Book a demo" --landing-url https://example.com --cta REQUEST_DEMO
+  baker ads linkedin creatives get 1584704523      # one ad: headline, landing URL, form, review, why not serving
+  baker ads linkedin creatives pause urn:li:sponsoredCreative:789`
+  },
+  subCommands: {
+    list: creativesListCommand,
+    get: creativesGetCommand,
+    create: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.creativesCreateCommand),
+    update: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.creativesUpdateCommand),
+    pause: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.creativesPauseCommand),
+    resume: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.creativesResumeCommand),
+    duplicate: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.creativesDuplicateCommand),
+    delete: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.creativesDeleteCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it *after* running
+  // the matched subcommand, so every write would also trigger a full live list.
+  // `args` stays here so citty's subcommand scan knows which flags take a value.
+  args: listArgs,
+  default: "list"
+});
+export {
+  compactRow,
+  creativeDestination,
+  creativesCommand,
+  unmappedShapeWarnings
+};
+//# sourceMappingURL=creatives-WBBN6G7H.js.map

package/dist/creatives-WBBN6G7H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/creatives.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { shapeListRows } from \"../list-rows.ts\";\nimport { writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport type { AdsWarning } from \"../types.ts\";\nimport {\n  csvOrJson,\n  handleLinkedinError,\n  resolveAccountIdArg,\n  resolveStatusFilter,\n  statusesArgDescription,\n} from \"./shared.ts\";\n\ninterface LinkedinCreativeRow {\n  id: string;\n  urn: string;\n  account: string;\n  campaign?: string;\n  intendedStatus?: string;\n  isServing?: boolean;\n  reviewStatus?: string;\n  type?: string;\n  content?: Record<string, unknown>;\n  leadgenCallToAction?: { destination?: string; label?: string };\n  createdAt?: number;\n}\n\n/**\n * The shape of a creative's `content` depends on its format, and LinkedIn wraps\n * each one differently. Callers overwhelmingly want one thing from it — where\n * the ad sends people — so resolve that here instead of making every reader\n * re-learn the union.\n *\n * Post-based ads (image, video, carousel, document, article, event, TLA) only\n * carry a post reference: their destination lives inside the post and is not\n * readable — or writable — through the ads API.\n */\nexport interface CreativeDestination {\n  format: string;\n  landingUrl?: string;\n  postUrn?: string;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction asString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nexport function creativeDestination(content: Record<string, unknown> | undefined): CreativeDestination {\n  if (!content) return { format: \"unknown\" };\n\n  const reference = asString(content.reference);\n  if (reference) return { format: \"post\", postUrn: reference };\n\n  const textAd = asRecord(content.textAd);\n  if (textAd) return { format: \"text\", landingUrl: asString(textAd.landingPage) };\n\n  const spotlight = asRecord(content.spotlight);\n  if (spotlight) return { format: \"spotlight\", landingUrl: asString(spotlight.landingPage) };\n\n  if (asRecord(content.follower)) return { format: \"follower\" };\n  if (asRecord(content.jobs)) return { format: \"jobs\" };\n\n  return { format: \"unknown\" };\n}\n\n/**\n * Every column a compact row can carry, in order. `compactRow` omits the destination\n * keys it has no value for, so the tabular writers cannot infer the header from a row:\n * a first row that is post-based would drop `landingUrl` from every later row.\n */\nconst COMPACT_COLUMNS = [\n  \"id\",\n  \"urn\",\n  \"campaign\",\n  \"intendedStatus\",\n  \"isServing\",\n  \"reviewStatus\",\n  \"format\",\n  \"landingUrl\",\n  \"postUrn\",\n  \"leadForm\",\n  \"leadFormButton\",\n] as const;\n\n/** LinkedIn hands the creative's form back as `urn:li:adForm:N`; every other command names it `urn:li:leadGenForm:N`. */\nfunction leadFormUrn(destination: string | undefined): string | undefined {\n  const id = destination?.match(/(\\d+)$/)?.[1];\n  return id ? `urn:li:leadGenForm:${id}` : undefined;\n}\n\n/** The fields worth spending context on by default — everything else needs --fields or --full. */\nexport function compactRow(row: LinkedinCreativeRow): Record<string, unknown> {\n  const destination = creativeDestination(row.content);\n  const leadForm = leadFormUrn(row.leadgenCallToAction?.destination);\n  return {\n    id: row.id,\n    urn: row.urn,\n    campaign: row.campaign,\n    intendedStatus: row.intendedStatus,\n    isServing: row.isServing,\n    reviewStatus: row.reviewStatus,\n    format: destination.format,\n    ...(destination.landingUrl ? { landingUrl: destination.landingUrl } : {}),\n    ...(destination.postUrn ? { postUrn: destination.postUrn } : {}),\n    ...(leadForm ? { leadForm, leadFormButton: row.leadgenCallToAction?.label } : {}),\n  };\n}\n\n/**\n * `content` crosses the wire as an unvalidated bag, so if LinkedIn renames a\n * wrapper key nothing else in the stack would notice — the destination would\n * just quietly stop resolving. Counting the shapes this mapper couldn't read is\n * the cheapest signal that the contract moved.\n */\nexport function unmappedShapeWarnings(rows: LinkedinCreativeRow[], rawContentReturned: boolean): AdsWarning[] {\n  const unmapped = rows.filter((row) => row.content && creativeDestination(row.content).format === \"unknown\");\n  if (unmapped.length === 0) return [];\n  // Under --full the caller already holds the raw `content`, so \"re-read with\n  // --full\" is a dead end — point them at what they are already holding.\n  const remedy = rawContentReturned\n    ? \"Their raw content is in this response — read it directly; this command cannot resolve a destination for them.\"\n    : \"Re-read those with --full before drawing any conclusion about where they point.\";\n  return [\n    {\n      code: \"UNMAPPED_CREATIVE_CONTENT\",\n      message: `${unmapped.length} of ${rows.length} creatives have a content shape this command can't read, so their destination is missing (ids: ${unmapped\n        .slice(0, 5)\n        .map((row) => row.id)\n        .join(\", \")}). ${remedy}`,\n    },\n  ];\n}\n\nconst listArgs = {\n  \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n  \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n  \"campaign-id\": { type: \"string\", description: \"Filter by campaign ID\" },\n  \"all-statuses\": { type: \"boolean\", description: \"Drop the default ACTIVE filter\" },\n  statuses: { type: \"string\", description: statusesArgDescription(\"creatives\") },\n  fields: {\n    type: \"string\",\n    description: \"CSV of dotted paths to return instead of the compact row, e.g. id,content.textAd.landingPage\",\n  },\n  full: { type: \"boolean\", description: \"Return the complete raw records, including the opaque 'content' block\" },\n  limit: { type: \"string\", description: \"Max rows (default: 500)\" },\n  \"no-cache\": NO_CACHE_ARG,\n  output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n} as const;\n\nconst creativesListCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description: \"List LinkedIn creatives (ads). Runs by default when no subcommand is given.\",\n  },\n  args: listArgs,\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      const statuses = resolveStatusFilter(args, \"creatives\");\n      if (statuses) params.statuses = statuses.join(\",\");\n      if (args[\"campaign-id\"]) params[\"campaign-id\"] = String(args[\"campaign-id\"]);\n      if (args.limit) params.limit = String(args.limit);\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n\n      const data = await apiGet<LinkedinCreativeRow[]>(\"/api/ads/linkedin/creatives\", params);\n      const shaped = shapeListRows(data, args as Record<string, unknown>, {\n        row: compactRow,\n        columns: COMPACT_COLUMNS,\n      });\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(shaped.rows, fmt, shaped.fields, shaped.hints);\n        return;\n      }\n      const warnings = unmappedShapeWarnings(data, args.full === true);\n      writeJsonEnvelope({\n        ok: true,\n        data: shaped.rows,\n        ...(warnings.length > 0 ? { warnings } : {}),\n        ...(shaped.hints ? { hints: shaped.hints } : {}),\n      });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nconst creativesGetCommand = defineCommand({\n  meta: {\n    name: \"get\",\n    description: `Read one ad as LinkedIn holds it: headline, intro text, landing URL, the lead gen form it opens, its review verdict (with rejection reasons) and why it is not serving (notServingBecause — e.g. FORM_HOLD, UNDER_REVIEW, CAMPAIGN_STOPPED).\nThe listing can only name a post-based ad's post; this is where its headline and link come back.\nExample: baker ads linkedin creatives get 1584704523`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Creative id or urn:li:sponsoredCreative:N\", required: true },\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const data = await apiGet<Record<string, unknown>>(\"/api/ads/linkedin/creative\", {\n        \"account-id\": accountId,\n        \"creative-id\": String(args.id),\n      });\n      writeJsonEnvelope({\n        ok: true,\n        data,\n        hints: [\n          `These are the stored fields, not what people see. To look at the ad as the feed shows it: baker ads linkedin preview ${String(args.id)} --account-id ${accountId}`,\n        ],\n      });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nexport const creativesCommand = defineCommand({\n  meta: {\n    name: \"creatives\",\n    description: `List LinkedIn creatives (ads), or stage writes (create/update/pause/resume/duplicate).\n\nDefaults to ACTIVE intended-status. Pass --all-statuses or --statuses ACTIVE,PAUSED to widen.\n\nRows are compact by default: id, urn, campaign, status, review status, format, and\nthe resolved destination (landingUrl, or postUrn for post-based ads), and for a\nlead gen ad the form it opens (leadForm, leadFormButton). Use --fields\nfor specific dotted paths, or --full for the complete raw records.\n\nPost-based ads (image, video, carousel, document, article, event, TLA) report a\npostUrn, not a landingUrl — their destination lives in the post itself.\nUse 'reviewStatus' to spot rejected/pending creatives during an audit.\n\nWrite subcommands stage ops on this chat's draft — media comes from the Baker\nlibrary and is uploaded to LinkedIn only at publish.\n\nExamples:\n  baker ads linkedin creatives --account-id 503001492\n  baker ads linkedin creatives --account-id 503001492 --fields id,intendedStatus,content.textAd.landingPage\n  baker ads linkedin creatives create --campaign 1234 --format image --image-id <bakerImageId> --intro \"…\" --headline \"Book a demo\" --landing-url https://example.com --cta REQUEST_DEMO\n  baker ads linkedin creatives get 1584704523      # one ad: headline, landing URL, form, review, why not serving\n  baker ads linkedin creatives pause urn:li:sponsoredCreative:789`,\n  },\n  subCommands: {\n    list: creativesListCommand,\n    get: creativesGetCommand,\n    create: () => import(\"./write-commands.ts\").then((m) => m.creativesCreateCommand),\n    update: () => import(\"./write-commands.ts\").then((m) => m.creativesUpdateCommand),\n    pause: () => import(\"./write-commands.ts\").then((m) => m.creativesPauseCommand),\n    resume: () => import(\"./write-commands.ts\").then((m) => m.creativesResumeCommand),\n    duplicate: () => import(\"./write-commands.ts\").then((m) => m.creativesDuplicateCommand),\n    delete: () => import(\"./write-commands.ts\").then((m) => m.creativesDeleteCommand),\n  },\n  // A parent must never declare `run`: citty falls through to it *after* running\n  // the matched subcommand, so every write would also trigger a full live list.\n  // `args` stays here so citty's subcommand scan knows which flags take a value.\n  args: listArgs,\n  default: \"list\",\n});\n"],"mappings":"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","names":[]}

package/dist/credentials-J5DMQJWN.js

@@ -0,0 +1,290 @@
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  failApi,
+  failValidation
+} from "./chunk-BS2MC62Y.js";
+import "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import {
+  getPublicSuffix,
+  parse
+} from "./chunk-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// ../api/src/credentials/contract.ts
+import { z } from "zod";
+
+// ../api/src/credentials/hosts.ts
+function normaliseHost(host) {
+  return host.trim().toLowerCase().replace(/\.$/, "");
+}
+function asciiHost(host) {
+  if (!/[\u0080-\u{10FFFF}]/u.test(host) || /[/?#@:\\%[\]\s]/.test(host)) return host;
+  const url = `http://${host}`;
+  return URL.canParse(url) ? new URL(url).hostname : host;
+}
+function validateHostPattern(raw) {
+  const typed = normaliseHost(raw);
+  const wildcard = typed.startsWith("*.");
+  const host = asciiHost(wildcard ? typed.slice(2) : typed);
+  const pattern = wildcard ? `*.${host}` : host;
+  if (host === "" || host.includes("*")) {
+    return { ok: false, reason: "Use a website address like api.example.com or *.example.com." };
+  }
+  const parsed = parse(host);
+  if (parsed.isIp || host.startsWith("[")) {
+    return { ok: false, reason: "Use a website address, not an IP address." };
+  }
+  if (parsed.hostname !== host || parsed.domain === null) {
+    return { ok: false, reason: "Use only the website address, like api.example.com." };
+  }
+  if (wildcard && !wildcardSafe(host)) {
+    return { ok: false, reason: `*.${host} would allow any website. Name the company's own address.` };
+  }
+  return { ok: true, pattern };
+}
+var OPEN_HOSTING_DOMAINS = ["amazonaws.com", "cloudfront.net", "googleapis.com", "on.aws"];
+var WITH_PRIVATE = { allowPrivateDomains: true };
+function wildcardSafe(host) {
+  if (OPEN_HOSTING_DOMAINS.some((domain) => host === domain || host.endsWith(`.${domain}`))) return false;
+  const suffix = getPublicSuffix(host, WITH_PRIVATE);
+  return suffix !== host && getPublicSuffix(`zz.${host}`, WITH_PRIVATE) === suffix;
+}
+
+// ../api/src/credentials/placeholder.ts
+var CREDENTIAL_NAME_PATTERN = "[a-z0-9][a-z0-9_-]{0,63}";
+var CREDENTIAL_NAME_RE = new RegExp(`^${CREDENTIAL_NAME_PATTERN}$`);
+var PLACEHOLDER_SOURCE = `\\{\\{credential:(${CREDENTIAL_NAME_PATTERN})\\}\\}`;
+var WHOLE_PLACEHOLDER_RE = new RegExp(`^${PLACEHOLDER_SOURCE}$`);
+
+// ../api/src/credentials/contract.ts
+var MAX_CREDENTIAL_VALUE_LENGTH = 16384;
+var MAX_CREDENTIAL_HOSTS = 20;
+var credentialNameSchema = z.string().regex(new RegExp(`^${CREDENTIAL_NAME_PATTERN}$`), "Use lowercase letters, digits, - and _ (max 64).");
+var credentialHostsSchema = z.array(z.string()).max(MAX_CREDENTIAL_HOSTS).transform((hosts, ctx) => {
+  const patterns = [];
+  for (const host of hosts) {
+    const result = validateHostPattern(host);
+    if (result.ok) patterns.push(result.pattern);
+    else ctx.addIssue({ code: "custom", message: `${host}: ${result.reason}` });
+  }
+  return [...new Set(patterns)];
+});
+var credentialSourceSchema = z.enum(["user", "agent", "chat-detected", "requested"]);
+var credentialSummarySchema = z.object({
+  name: z.string(),
+  label: z.string(),
+  placeholder: z.string(),
+  allowedHosts: z.array(z.string()),
+  source: credentialSourceSchema,
+  lastUsedAt: z.number().nullable()
+});
+var credentialsListResponseSchema = z.object({ credentials: z.array(credentialSummarySchema) });
+var credentialsPutRequestSchema = z.object({
+  name: credentialNameSchema,
+  label: z.string().trim().min(1).max(80).optional(),
+  value: z.string().min(1).max(MAX_CREDENTIAL_VALUE_LENGTH),
+  allowedHosts: credentialHostsSchema
+});
+var credentialsPutResponseSchema = z.object({
+  name: z.string(),
+  placeholder: z.string(),
+  replaced: z.boolean()
+});
+var credentialsDeleteRequestSchema = z.object({ name: credentialNameSchema });
+var credentialsDeleteResponseSchema = z.object({ name: z.string(), deleted: z.literal(true) });
+var brokerResolveResponseSchema = z.object({
+  credentials: z.array(z.object({ name: z.string(), value: z.string(), allowedHosts: z.array(z.string()) }))
+});
+var brokerUsageRequestSchema = z.object({
+  uses: z.array(z.object({ name: credentialNameSchema, host: z.string().max(253) })).max(100)
+});
+
+// src/commands/credentials/index.ts
+import { defineCommand } from "citty";
+var DOC = "__tooling__/docs/tools/baker/credentials.md";
+var STDIN_ONLY = 'The value is read from stdin only, never from the command line (argv is visible to other processes and lands in logs). Pipe it: printf %s "$VALUE" | baker credentials put <name> --host <host>. For a credential the user owns, call request_credential instead.';
+registerSchema({
+  command: "credentials.list",
+  description: "Start here: the credentials (API keys, tokens, passwords) this company stored, by name \u2014 never their values. Write the `placeholder` ({{credential:NAME}}) into an HTTPS request (curl header, URL, SDK config, JSON body) and the sandbox proxy sends the real value, only to the credential's allowedHosts. Nothing listed? Ask the user with the request_credential tool. Compact by default; --full adds source and lastUsedAt.",
+  args: {
+    full: { type: "boolean", description: "Add source and lastUsedAt per credential", required: false, default: false }
+  }
+});
+registerSchema({
+  command: "credentials.put",
+  description: `Store a credential YOU created on the user's behalf (e.g. a key you just generated through an API), so later requests can use {{credential:NAME}}. Example: printf %s "$KEY" | baker credentials put stripe-key --host api.stripe.com --label "Stripe key". The value comes from stdin ONLY. For a credential the user owns, call request_credential instead \u2014 never ask for it in chat. Replacing is allowed only for credentials the agent created.`,
+  args: {
+    name: { type: "positional", description: "Lowercase name: letters, digits, - and _ (max 64)", required: true },
+    host: {
+      type: "string",
+      description: "Website the value may be sent to (repeatable, or comma-separated): api.stripe.com, acme-store.myshopify.com",
+      required: true
+    },
+    label: { type: "string", description: "Human-readable label shown in Settings \u2192 Credentials", required: false }
+  }
+});
+registerSchema({
+  command: "credentials.delete",
+  description: "Delete a credential the agent created (e.g. a key it rotated out). Credentials the user added can only be removed by the user, in Settings \u2192 Credentials.",
+  args: {
+    name: { type: "positional", description: "Credential name", required: true }
+  }
+});
+async function readPipedValue() {
+  const stdin = process.stdin;
+  if (stdin.isTTY) return "";
+  const chunks = [];
+  for await (const chunk of stdin) {
+    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+  }
+  return Buffer.concat(chunks).toString("utf8").replace(/\r?\n$/, "");
+}
+function parseName(raw) {
+  const parsed = credentialNameSchema.safeParse(raw);
+  if (!parsed.success) {
+    failValidation(`Invalid credential name "${String(raw)}": use lowercase letters, digits, - and _ (max 64).`);
+  }
+  return parsed.data;
+}
+function parseHosts(rawArgs, parsed) {
+  const hosts = repeatedValues(rawArgs, "host", parsed).flatMap((value) => value.split(",")).map((host) => host.trim()).filter((host) => host !== "");
+  if (hosts.length === 0) {
+    failValidation("Name at least one website the value may be sent to: --host api.example.com (repeatable).");
+  }
+  const result = credentialHostsSchema.safeParse(hosts);
+  if (!result.success) {
+    failValidation(`Invalid --host: ${result.error.issues.map((issue) => issue.message).join("; ")}`);
+  }
+  return result.data;
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Start here: stored credentials by name with their {{credential:NAME}} placeholder and allowed websites. Never shows values."
+  },
+  args: {
+    full: { type: "boolean", description: "Add source and lastUsedAt", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const response = await apiPost("/api/credentials/list", {});
+      const credentials = response.data.credentials.map(
+        (credential) => args.full ? credential : {
+          name: credential.name,
+          placeholder: credential.placeholder,
+          allowedHosts: credential.allowedHosts,
+          label: credential.label
+        }
+      );
+      writeJson({
+        ok: true,
+        data: { credentials },
+        meta: { count: credentials.length },
+        ...credentials.length === 0 ? {
+          hints: [
+            "No credentials stored. When the task needs one the user owns, call the request_credential tool (label, reason, allowedHosts) \u2014 never ask them to paste it in chat."
+          ]
+        } : {}
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var putCommand = defineCommand({
+  meta: {
+    name: "put",
+    description: `Store a credential you created on the user's behalf; the value is read from stdin only.
+Start here: printf %s "$KEY" | baker credentials put stripe-key --host api.stripe.com
+For a credential the user owns, call request_credential instead.`
+  },
+  args: {
+    name: { type: "positional", description: "Lowercase name: letters, digits, - and _ (max 64)", required: true },
+    host: {
+      type: "string",
+      description: "Website the value may be sent to (repeatable, or comma-separated)",
+      required: false
+    },
+    label: { type: "string", description: "Label shown in Settings \u2192 Credentials", required: false },
+    value: {
+      type: "string",
+      description: "Refused \u2014 never put a value on the command line. Pipe it on stdin.",
+      required: false
+    }
+  },
+  run: async ({ args, rawArgs }) => {
+    if (args.value !== void 0 || args._.length > 1) {
+      failValidation(STDIN_ONLY);
+    }
+    const name = parseName(args.name);
+    const allowedHosts = parseHosts(rawArgs, args.host);
+    const value = await readPipedValue();
+    if (value === "") {
+      failValidation(`Nothing was piped on stdin. ${STDIN_ONLY}`);
+    }
+    if (value.length > MAX_CREDENTIAL_VALUE_LENGTH) {
+      failValidation(`The value is longer than ${MAX_CREDENTIAL_VALUE_LENGTH} characters.`);
+    }
+    const body = { name, value, allowedHosts, ...args.label ? { label: args.label } : {} };
+    try {
+      const response = await apiPost("/api/credentials/put", body);
+      writeJson({
+        ok: true,
+        data: { name: response.data.name, placeholder: response.data.placeholder },
+        hints: [
+          `Use ${response.data.placeholder} in the request; the value is sent only to: ${allowedHosts.join(", ")}.`,
+          "Never echo, print or write the value anywhere \u2014 unset the shell variable that held it."
+        ]
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var deleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: "Delete a credential the agent created. User-added credentials are removed by the user in Settings \u2192 Credentials."
+  },
+  args: {
+    name: { type: "positional", description: "Credential name", required: true }
+  },
+  run: async ({ args }) => {
+    const name = parseName(args.name);
+    try {
+      const response = await apiPost("/api/credentials/delete", { name });
+      writeJson({ ok: true, data: response.data });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var credentialsCommand = defineCommand({
+  meta: {
+    name: "credentials",
+    description: `Credentials (API keys, tokens, passwords) by name: write {{credential:NAME}} in an HTTPS request and the value is sent only to the websites it is bound to. You never see values.
+Full guide: ${DOC}`
+  },
+  subCommands: { list: listCommand, put: putCommand, delete: deleteCommand }
+});
+export {
+  credentialsCommand
+};
+//# sourceMappingURL=credentials-J5DMQJWN.js.map