@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/chunk-L3OLEAJN.js

@@ -0,0 +1,92 @@
+import {
+  claimNewCreativeInWorkspace,
+  creativeLimitRefusal
+} from "./chunk-MLU6STIN.js";
+import {
+  leadVersion,
+  writeSeriesMemberCanvas
+} from "./chunk-IKGWQBKJ.js";
+import {
+  definitionFieldsOf,
+  setDefinitionFields,
+  setSpecMessage
+} from "./chunk-QJE6ZYGI.js";
+import {
+  IDEAS_DIR
+} from "./chunk-27NMXSC3.js";
+
+// src/commands/creatives/make-series.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { parseDocument } from "yaml";
+var LEAD_ONLY = ["idea", "message", "evidence", "angle", "persona", "awareness", "hypothesis", "series", "title"];
+function withoutFields(raw, keys) {
+  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+  if (!match) return raw;
+  const doc = parseDocument(match[1] ?? "");
+  if (doc.errors.length > 0) return raw;
+  for (const key of keys) doc.delete(key);
+  return `---
+${doc.toString()}---${raw.slice(match[0].length)}`;
+}
+async function makeSeriesAd(root, idea, slug, lead, evidence, deps) {
+  if (slug === lead) {
+    return {
+      code: "series_of_itself",
+      message: `"${slug}" is the lead itself.`,
+      fix: "Give the new ad its own --slug."
+    };
+  }
+  const version = await leadVersion(root, lead);
+  if ("refused" in version) return version.refused;
+  const dir = path.join(root, "src", "creatives", slug);
+  const definitionPath = path.join(dir, "_definition.md");
+  const claim = await claimNewCreativeInWorkspace(path.join(root, "canvas"), slug, deps.chatId, definitionPath);
+  if (!claim.allowed) return creativeLimitRefusal(slug).error;
+  await mkdir(dir, { recursive: true });
+  await writeFile(path.join(dir, "prompt.json"), setSpecMessage(JSON.stringify(version.spec), idea.message), "utf8");
+  const leadDefinition = await readFile(path.join(root, "src", "creatives", lead, "_definition.md"), "utf8").catch(
+    () => "---\nkind: static\n---\n"
+  );
+  const definition = setDefinitionFields(withoutFields(leadDefinition, LEAD_ONLY), {
+    title: idea.message.slice(0, 120),
+    series: lead,
+    status: "draft",
+    ...definitionFieldsOf(idea, evidence)
+  });
+  await writeFile(definitionPath, definition, "utf8");
+  const made = await writeSeriesMemberCanvas(root, slug, { leadWords: true });
+  if (made === null || "refused" in made) {
+    return made?.refused ?? { code: "series_not_made", message: `"${slug}" could not be made in the series of "${lead}".` };
+  }
+  if (idea.status === "idea") {
+    const ideaPath = path.join(root, IDEAS_DIR, `${idea.id}.md`);
+    const raw = await readFile(ideaPath, "utf8").catch(() => null);
+    if (raw !== null) await writeFile(ideaPath, setDefinitionFields(raw, { status: "built" }), "utf8");
+  }
+  await deps.sync(dir);
+  return { slug, lead, leadRunId: version.lead.runId, canvasPath: made.canvasPath };
+}
+function seriesMadeEnvelope(made, idea) {
+  return {
+    ok: true,
+    data: {
+      creative: made.slug,
+      idea: idea.id,
+      message: idea.message,
+      series: made.lead,
+      canvas_path: made.canvasPath
+    },
+    hints: [
+      `Write this ad's words in src/creatives/${made.slug}/prompt.json \`copy\`: one line for each of the lead's, in the same roles and about as long, saying this idea's message. Change nothing else: the picture, layout and colours are the lead's (${made.lead}), and every word you write replaces the lead's line in its place.`,
+      `When every ad of the series has its words: baker canvas run --series ${made.lead} (renders them all at once, each reviewed and corrected on its own).`
+    ]
+  };
+}
+
+export {
+  withoutFields,
+  makeSeriesAd,
+  seriesMadeEnvelope
+};
+//# sourceMappingURL=chunk-L3OLEAJN.js.map

package/dist/chunk-L3OLEAJN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/make-series.ts"],"sourcesContent":["/**\n * `baker creatives make <idea> --series <lead>`: another message in the lead ad's style. Nothing is\n * searched, described or rendered: the ad starts as the lead's ready version with the idea's\n * message, and its words are the agent's to write. Its picture is the lead's with those words\n * (`series-member.ts`), so a series of ten messages is one design ten times.\n */\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { parseDocument } from \"yaml\";\nimport { claimNewCreativeInWorkspace, creativeLimitRefusal } from \"../canvas/creative-limit.ts\";\nimport { leadVersion, writeSeriesMemberCanvas } from \"../canvas/series-member.ts\";\nimport type { EvidenceLevel, Idea } from \"./ideas-model.ts\";\nimport { IDEAS_DIR } from \"./ideas-workspace.ts\";\nimport { definitionFieldsOf, setDefinitionFields, setSpecMessage } from \"./make-model.ts\";\n\ntype Failure = { code: string; message: string; fix?: string };\n\n/** The lead's own reasons, which are not this ad's: its idea, evidence and the like are replaced or dropped. */\nconst LEAD_ONLY = [\"idea\", \"message\", \"evidence\", \"angle\", \"persona\", \"awareness\", \"hypothesis\", \"series\", \"title\"];\n\n/** `raw` with `keys` dropped from its frontmatter, every other field and the body kept. */\nexport function withoutFields(raw: string, keys: readonly string[]): string {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/);\n  if (!match) return raw;\n  const doc = parseDocument(match[1] ?? \"\");\n  if (doc.errors.length > 0) return raw;\n  for (const key of keys) doc.delete(key);\n  return `---\\n${doc.toString()}---${raw.slice(match[0].length)}`;\n}\n\n/** Make `slug`, an ad of the series led by `lead`, from `idea`. The made ad, or why not. */\nexport async function makeSeriesAd(\n  root: string,\n  idea: Idea,\n  slug: string,\n  lead: string,\n  evidence: EvidenceLevel | \"explore\",\n  deps: { sync: (dir: string) => Promise<unknown>; chatId: string | null },\n): Promise<{ slug: string; lead: string; leadRunId: string; canvasPath: string } | Failure> {\n  if (slug === lead) {\n    return {\n      code: \"series_of_itself\",\n      message: `\"${slug}\" is the lead itself.`,\n      fix: \"Give the new ad its own --slug.\",\n    };\n  }\n  const version = await leadVersion(root, lead);\n  if (\"refused\" in version) return version.refused;\n  const dir = path.join(root, \"src\", \"creatives\", slug);\n  const definitionPath = path.join(dir, \"_definition.md\");\n  const claim = await claimNewCreativeInWorkspace(path.join(root, \"canvas\"), slug, deps.chatId, definitionPath);\n  if (!claim.allowed) return creativeLimitRefusal(slug).error;\n  await mkdir(dir, { recursive: true });\n  await writeFile(path.join(dir, \"prompt.json\"), setSpecMessage(JSON.stringify(version.spec), idea.message), \"utf8\");\n  const leadDefinition = await readFile(path.join(root, \"src\", \"creatives\", lead, \"_definition.md\"), \"utf8\").catch(\n    () => \"---\\nkind: static\\n---\\n\",\n  );\n  const definition = setDefinitionFields(withoutFields(leadDefinition, LEAD_ONLY), {\n    title: idea.message.slice(0, 120),\n    series: lead,\n    status: \"draft\",\n    ...definitionFieldsOf(idea, evidence),\n  });\n  await writeFile(definitionPath, definition, \"utf8\");\n  const made = await writeSeriesMemberCanvas(root, slug, { leadWords: true });\n  if (made === null || \"refused\" in made) {\n    return (\n      made?.refused ?? { code: \"series_not_made\", message: `\"${slug}\" could not be made in the series of \"${lead}\".` }\n    );\n  }\n  if (idea.status === \"idea\") {\n    const ideaPath = path.join(root, IDEAS_DIR, `${idea.id}.md`);\n    const raw = await readFile(ideaPath, \"utf8\").catch(() => null);\n    if (raw !== null) await writeFile(ideaPath, setDefinitionFields(raw, { status: \"built\" }), \"utf8\");\n  }\n  // The dashboard learns the ad and its series now, not at Publish.\n  await deps.sync(dir);\n  return { slug, lead, leadRunId: version.lead.runId, canvasPath: made.canvasPath };\n}\n\n/** What `make --series` prints: the ad, its lead, and the one step left (its words), then the series run. Pure. */\nexport function seriesMadeEnvelope(\n  made: { slug: string; lead: string; leadRunId: string; canvasPath: string },\n  idea: Pick<Idea, \"id\" | \"message\">,\n) {\n  return {\n    ok: true as const,\n    data: {\n      creative: made.slug,\n      idea: idea.id,\n      message: idea.message,\n      series: made.lead,\n      canvas_path: made.canvasPath,\n    },\n    hints: [\n      `Write this ad's words in src/creatives/${made.slug}/prompt.json \\`copy\\`: one line for each of the lead's, in the same roles and about as long, saying this idea's message. Change nothing else: the picture, layout and colours are the lead's (${made.lead}), and every word you write replaces the lead's line in its place.`,\n      `When every ad of the series has its words: baker canvas run --series ${made.lead} (renders them all at once, each reviewed and corrected on its own).`,\n    ],\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-LERTEZST.js

@@ -0,0 +1,28 @@
+import {
+  ApiError
+} from "./chunk-XBOK23HI.js";
+import {
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+
+// src/commands/winning-ads/shared.ts
+function splitList(value) {
+  if (!value) {
+    return [];
+  }
+  return value.split(",").map((v) => v.trim()).filter(Boolean);
+}
+function reportError(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+
+export {
+  splitList,
+  reportError
+};
+//# sourceMappingURL=chunk-LERTEZST.js.map

package/dist/chunk-LL2CD5WU.js

@@ -0,0 +1,310 @@
+import {
+  mappingRowProblem,
+  mentionOf
+} from "./chunk-EDLZGTGN.js";
+import {
+  CONDITION_LOGICS,
+  HUBSPOT_DEAL_CONTACTS,
+  HUBSPOT_OBJECTS,
+  HUBSPOT_PROPERTY_KINDS,
+  REJECTION_MESSAGES,
+  TRIGGER_CONDITIONS_MAX,
+  onlyCondition,
+  triggerProblem,
+  validateEventName
+} from "./chunk-XWH7CCBL.js";
+
+// ../api/src/event-sources/hubspot.ts
+var HUBSPOT_CONTACT_ID_VARIABLE = "id";
+var HUBSPOT_CONTACT_PREFIX = "contact.";
+function contactPath(property) {
+  return `${HUBSPOT_CONTACT_PREFIX}${property}`;
+}
+var HUBSPOT_DEFAULT_PROPERTIES = {
+  email: "email",
+  phone: "phone",
+  external_id: HUBSPOT_CONTACT_ID_VARIABLE,
+  first_name: "firstname",
+  last_name: "lastname",
+  city: "city",
+  postal_code: "zip",
+  country: "country",
+  gclid: "hs_google_click_id",
+  fbclid: "hs_facebook_click_id"
+};
+var throughContact = Object.fromEntries(
+  Object.entries(HUBSPOT_DEFAULT_PROPERTIES).map(([field, property]) => [field, contactPath(property)])
+);
+var HUBSPOT_DEAL_DEFAULT_PROPERTIES = {
+  ...throughContact,
+  value: "amount",
+  currency: "deal_currency_code"
+};
+var HUBSPOT_LEAD_DEFAULT_PROPERTIES = throughContact;
+var DEFAULTS = {
+  contact: HUBSPOT_DEFAULT_PROPERTIES,
+  deal: HUBSPOT_DEAL_DEFAULT_PROPERTIES,
+  lead: HUBSPOT_LEAD_DEFAULT_PROPERTIES
+};
+function hubspotDefaultMapping(sourceName, object = "contact") {
+  const mapping = { event_name: sourceName };
+  for (const [field, property] of Object.entries(DEFAULTS[object])) {
+    mapping[field] = mentionOf(property);
+  }
+  return mapping;
+}
+
+// ../api/src/event-sources/wire.ts
+import { z } from "zod";
+var SOURCE_KINDS = ["webhook", "hubspot"];
+var SOURCE_STATUSES = ["learning", "counting", "paused"];
+var SOURCE_NAME_MAX = 80;
+var sourceNameSchema = z.string().trim().min(1).max(SOURCE_NAME_MAX).refine((name) => validateEventName(name) === null, REJECTION_MESSAGES.invalid_name);
+var sourceIdSchema = z.string().min(1);
+var sourceMappingSchema = z.record(z.string(), z.string().min(1)).superRefine((mapping, ctx) => {
+  for (const row of Object.keys(mapping)) {
+    const problem = mappingRowProblem(row);
+    if (problem !== null) ctx.addIssue({ code: "custom", message: problem, path: [row] });
+  }
+});
+var currencyCodeSchema = z.string().trim().toUpperCase().regex(/^[A-Z]{3}$/, "A currency is a three-letter code, like EUR or USD.");
+var hubspotObjectSchema = z.enum(HUBSPOT_OBJECTS);
+var hubspotDealContactsSchema = z.enum(HUBSPOT_DEAL_CONTACTS);
+var hubspotConditionInputSchema = z.strictObject({
+  property: z.string().trim().min(1),
+  /** One of the property's kind's operators (`baker hubspot contacts properties` lists them); `is` when unsaid. */
+  operator: z.string().trim().min(1).default("is"),
+  /** As HubSpot spells them: an option's internal value, a number, a `YYYY-MM-DD`, `true`/`false`. None for an empty check, two for a between, several for a list. */
+  values: z.array(z.string().trim().min(1)).max(50).default([])
+});
+var conditionLogicSchema = z.enum(CONDITION_LOGICS);
+var conditionGroupInputSchema = z.strictObject({
+  logic: conditionLogicSchema,
+  conditions: z.array(hubspotConditionInputSchema).min(1).max(TRIGGER_CONDITIONS_MAX)
+});
+var combinedInputSchema = z.strictObject({
+  /** How the rows combine: `And` (every one) or `Or` (any one) — a Form's filter's "Match AND / OR". */
+  logic: conditionLogicSchema.default("And"),
+  /** Conditions, and groups of conditions with their own logic, one level deep. */
+  conditions: z.array(z.union([hubspotConditionInputSchema, conditionGroupInputSchema])).min(1).max(TRIGGER_CONDITIONS_MAX)
+}).superRefine((trigger, context) => {
+  const problem = triggerProblem(trigger);
+  if (problem !== null) context.addIssue({ code: "custom", message: problem });
+});
+var hubspotTriggerInputSchema = z.union([combinedInputSchema, hubspotConditionInputSchema]).transform((input) => "conditions" in input ? input : onlyCondition(input));
+var hubspotConditionSchema = hubspotConditionInputSchema.extend({
+  propertyLabel: z.string(),
+  kind: z.enum(HUBSPOT_PROPERTY_KINDS),
+  /** A select that holds several values at once (`a;b`); decides what HubSpot may filter on. */
+  multiple: z.boolean().optional(),
+  valueLabels: z.array(z.string())
+});
+var hubspotTriggerFields = {
+  logic: conditionLogicSchema,
+  conditions: z.array(
+    z.union([
+      hubspotConditionSchema,
+      z.strictObject({ logic: conditionLogicSchema, conditions: z.array(hubspotConditionSchema) })
+    ])
+  )
+};
+var hubspotWatchSchema = z.strictObject({
+  ...hubspotTriggerFields,
+  object: hubspotObjectSchema,
+  contacts: hubspotDealContactsSchema.optional()
+});
+var sampleRecordSchema = z.strictObject({ id: z.string(), properties: z.record(z.string(), z.string()) });
+var hubspotPreviewRequestSchema = z.strictObject({
+  object: hubspotObjectSchema.default("contact"),
+  trigger: hubspotTriggerInputSchema,
+  /** Property names to read off the sample; `id` is always there. On a deal or a lead, `contact.<name>` reads its first contact. */
+  properties: z.array(z.string().trim().min(1)).max(60).optional(),
+  /** The record to draw the preview from — an id, or text to search (an email or a name for a contact, a deal's or a lead's name). The one most recently at the trigger when unsaid. */
+  contact: z.string().trim().min(1).max(200).optional()
+});
+var hubspotPreviewSchema = z.strictObject({
+  /** Records satisfying the trigger today — the ones that will NOT be counted. */
+  total: z.number(),
+  /** False when the trigger has more combinations than HubSpot's search takes, so `total` is only near. */
+  exact: z.boolean().optional(),
+  /**
+   * The sample record the trigger is on, with the properties asked for and
+   * the contacts behind it, first first; none when nothing fits.
+   *
+   * One field rather than one per object: a contact source's record *is* the
+   * person and its `contacts` is empty, while a deal's and a lead's carry the
+   * people the event is about. Three parallel nullable fields, exactly one of
+   * them ever set, would say the same thing and let a caller read the wrong one.
+   */
+  record: sampleRecordSchema.extend({ contacts: z.array(sampleRecordSchema) }).nullable()
+});
+var sourcesRequestSchema = z.strictObject({
+  /** The company's own server door: made once, `counting` from the start, the same address for ever after. */
+  server: z.strictObject({}).optional(),
+  create: z.strictObject({ name: sourceNameSchema }).optional(),
+  /** A HubSpot event: read every five minutes, counting from now. The labels are looked up server-side. */
+  createHubspot: z.strictObject({
+    name: sourceNameSchema.optional(),
+    /** A contact, a deal or a lead. A deal's and a lead's event is about its contact, read through `contact.<property>` rows. */
+    object: hubspotObjectSchema.default("contact"),
+    trigger: hubspotTriggerInputSchema,
+    /** On a deal: the deal's first contact (the default), or every contact on it, each its own event. */
+    contacts: hubspotDealContactsSchema.optional(),
+    /** Rows to read off the record, over the defaults; the same table `map` writes. */
+    mapping: sourceMappingSchema.optional(),
+    /** A number property on the record to read as the amount; needs `currency` beside it. Sugar over the mapping's `value` and `currency` rows. */
+    amountProperty: z.string().trim().min(1).optional(),
+    currency: currencyCodeSchema.optional()
+  }).optional(),
+  /** Change what a HubSpot event watches. It counts from now on under the new trigger; the rows stay. The object cannot change: the rows read it. */
+  setTrigger: z.strictObject({
+    sourceId: sourceIdSchema,
+    trigger: hubspotTriggerInputSchema,
+    contacts: hubspotDealContactsSchema.optional()
+  }).optional(),
+  /** Ask HubSpot what a trigger would count today, and read one real record, without making anything. */
+  preview: hubspotPreviewRequestSchema.optional(),
+  /** Change where a HubSpot-read source takes its amount from; no `amountProperty` clears it. Sugar over `map`. */
+  setAmount: z.strictObject({
+    sourceId: sourceIdSchema,
+    amountProperty: z.string().trim().min(1).optional(),
+    currency: currencyCodeSchema.optional()
+  }).optional(),
+  /**
+   * Count a HubSpot event's history: every moment its trigger came to hold
+   * since `since`, read out of HubSpot's own property history.
+   *
+   * Not the thing a source deliberately refuses to do. A source never
+   * backfills the **present state** — somebody who already satisfies a
+   * condition is not an event today — and this reports only moments HubSpot
+   * has a timestamp for, so nothing is invented. Dry unless `write`.
+   */
+  backfill: z.strictObject({
+    sourceId: sourceIdSchema,
+    /** ISO instant, or Unix milliseconds. Bounded by the 400 days the store keeps. */
+    since: z.union([z.string().trim().min(1), z.number()]),
+    /**
+     * Where a capped run carries on from: only records last changed at or
+     * before this instant are read.
+     *
+     * The **read** is what it bounds, never the history. Records are chosen
+     * most-recently-changed first, so a run that reaches its cap has covered
+     * the newest of them and the rest are the ones nearest `since` — which
+     * no shorter window can reach, because shortening one only drops
+     * candidates from the old end and hands back the same newest records
+     * again. `reachedBack` is the value to pass here, and the moments each
+     * record is then judged on are still the whole of `since` to now.
+     */
+    before: z.union([z.string().trim().min(1), z.number()]).optional(),
+    /** Without it, nothing is counted and the answer says what would be. */
+    write: z.boolean().optional()
+  }).optional(),
+  map: z.strictObject({ sourceId: sourceIdSchema, mapping: sourceMappingSchema }).optional(),
+  pause: z.strictObject({ sourceId: sourceIdSchema }).optional(),
+  resume: z.strictObject({ sourceId: sourceIdSchema }).optional(),
+  remove: z.strictObject({ sourceId: sourceIdSchema }).optional()
+});
+var sourceRefusalSchema = z.strictObject({
+  at: z.number(),
+  count: z.number(),
+  code: z.string(),
+  reason: z.string()
+});
+var detectedFieldSchema = z.strictObject({
+  path: z.string(),
+  confidence: z.enum(["key", "value"])
+});
+var HUBSPOT_LISTENING_STATES = ["listening", "not_configured", "failed"];
+var sourceViewSchema = z.strictObject({
+  id: z.string(),
+  kind: z.enum(SOURCE_KINDS),
+  name: z.string(),
+  status: z.enum(SOURCE_STATUSES),
+  /** The address a tool posts to. A HubSpot source has none: Baker calls HubSpot. */
+  url: z.string().optional(),
+  /** What a HubSpot source watches, and on which object. */
+  hubspot: hubspotWatchSchema.optional(),
+  /** A HubSpot source counts changes from here on; one HubSpot reports from before it is dropped. Moves when the trigger changes. */
+  countingSince: z.number().optional(),
+  /**
+   * Whether HubSpot is keeping this source's changes for Baker, as last
+   * checked: `listening` when the app's journal subscription on the account
+   * names the property; `not_configured` when the app has not been told yet
+   * (or cannot be, with no credentials); `failed` when HubSpot refused the
+   * subscription. `detail` says what to do.
+   */
+  listening: z.strictObject({ state: z.enum(HUBSPOT_LISTENING_STATES), detail: z.string().optional() }).optional(),
+  /** Why the last delivery could not be counted, in product words; absent when the last one was. */
+  lastError: z.string().optional(),
+  lastArrivalAt: z.number().optional(),
+  /**
+   * What its last delivery **refused, event by event** — which `lastError` is
+   * not and `lastArrivalAt` cannot be. A source refusing everything it
+   * receives has no arrival and no read failure, so without this it reads as
+   * one nobody has sent anything to. `refusalWords` turns it into the
+   * sentence a person is shown. Cleared by the next delivery that counts.
+   */
+  lastRefusal: sourceRefusalSchema.optional(),
+  /** The first send, masked, while learning. Kept once confirmed. */
+  sample: z.strictObject({ receivedAt: z.number(), body: z.string() }).optional(),
+  /** Field → template; empty means the guess (an address) or the defaults (a HubSpot read). */
+  mapping: z.record(z.string(), z.string()),
+  /** The guess over the sample, for the sheet to prefill and the CLI to suggest. */
+  detected: z.record(z.string(), detectedFieldSchema).optional(),
+  /** Every path the sample's first item holds, with its masked value — what the picker offers. */
+  paths: z.array(z.strictObject({ path: z.string(), value: z.string() })).optional(),
+  /** `baker` when the sample already parses as the `POST /v1/events` contract and needs no mapping. */
+  format: z.enum(["baker", "foreign"]).optional()
+});
+var stagedSourceOpSchema = z.strictObject({
+  kind: z.enum(["create", "setTrigger", "map", "status", "remove"]),
+  ref: z.string(),
+  name: z.string(),
+  summary: z.string(),
+  /** On a create: what the source will watch and read. */
+  hubspot: hubspotWatchSchema.optional(),
+  mapping: z.record(z.string(), z.string()).optional(),
+  status: z.enum(["paused", "counting"]).optional()
+});
+var backfillResultSchema = z.strictObject({
+  sourceId: z.string(),
+  name: z.string(),
+  since: z.number(),
+  /** Records whose history was read. */
+  examined: z.number(),
+  /** Moments the trigger came to hold, across them. */
+  entries: z.number(),
+  /** Of those, already counted — the journal got there first, or a previous run did. */
+  alreadyCounted: z.number(),
+  /** What a `write` run would hand over, or did. */
+  pending: z.number(),
+  /** Whether the read stopped at its cap; {@link BackfillResult.reachedBack} is where to carry on from. */
+  capped: z.boolean(),
+  /**
+   * How far back the read got: the instant the oldest record it examined was
+   * last changed. Only on a capped run, and it is the next run's `before`.
+   */
+  reachedBack: z.number().optional(),
+  counted: z.number().optional(),
+  refused: z.number().optional(),
+  refusedReason: z.string().optional()
+});
+var sourcesResponseSchema = z.strictObject({
+  ok: z.literal(true),
+  data: z.strictObject({
+    sources: z.array(sourceViewSchema),
+    /** Only when the request carried `preview`. */
+    preview: hubspotPreviewSchema.optional(),
+    /** Only when the request carried `backfill`. */
+    backfill: backfillResultSchema.optional(),
+    /** What this chat has staged, when one is attached: applied at Publish, dropped with a discard. */
+    staged: z.array(stagedSourceOpSchema).optional()
+  }),
+  hints: z.array(z.string()).optional()
+});
+
+export {
+  hubspotDefaultMapping,
+  hubspotTriggerInputSchema
+};
+//# sourceMappingURL=chunk-LL2CD5WU.js.map

package/dist/chunk-LO6GEJ4Z.js

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

package/dist/chunk-LS5MTRFI.js

@@ -0,0 +1,106 @@
+import {
+  apiGet
+} from "./chunk-XBOK23HI.js";
+
+// src/commands/testimonials/emptyCorpusHints.ts
+function resolveEmptyReason({
+  resultCount,
+  activeFilters,
+  sourceCount
+}) {
+  if (resultCount > 0) {
+    return null;
+  }
+  if (activeFilters.length > 0) {
+    return "filtered_out";
+  }
+  return sourceCount === 0 ? "no_corpus_connected" : "corpus_empty";
+}
+var NO_CORPUS_EXIT = "Testimonials are ingested from the client's public review pages \u2014 an agent cannot write one \u2014 so no rewording will find quotes. If the user named the client's own review page (Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store, Google Play), add it with `baker testimonials sources add <link>` \u2014 its reviews arrive over the next minutes, not in this turn. Stop searching and source proof another way: a result or case study the client already published, a named-customer logo (`baker images logo`), or a founder claim attributed as a claim. Otherwise ship without a testimonial block and file the gap: `baker actions create --name \"Collect customer quotes for <page>\" --priority medium --tags <slug>`. Never invent, paraphrase-into-existence, or pad with unrelated praise.";
+function emptyReasonDetail(reason, sourceCount, activeFilters) {
+  if (reason === "filtered_out") {
+    return `No rows matched, and ${activeFilters.join(", ")} narrowed this read. The corpus was not checked \u2014 drop every filter to see whether the library itself is empty.`;
+  }
+  if (reason === "no_corpus_connected") {
+    return "This company has no review source connected \u2014 checked against its source list, not inferred from the empty result.";
+  }
+  return `${sourceCount} review source${sourceCount === 1 ? " is" : "s are"} connected but hold no testimonials yet \u2014 the source is there, the rows are not. Ingestion may still be running.`;
+}
+function morePagesHint(resultCount, cursor) {
+  const found = resultCount === 0 ? "This page held no matches" : `This page held ${resultCount}`;
+  return `${found}, and the library continues past it \u2014 so this is one page, not the client's whole set. Do not report it as the corpus and do not conclude anything is missing from it. Read the next page with \`baker testimonials list --cursor ${cursor}\` (same filters), or go straight at the rows you want with \`baker testimonials search <query>\`.`;
+}
+function endOfWalkHint(command) {
+  const noun = command === "search" ? "results" : "rows";
+  return `That was the end of the library \u2014 no more ${noun} past the page before this one. Nothing here says the corpus is empty (the earlier pages held it), so answer from what those pages returned rather than re-reading.`;
+}
+async function measureEmptyCorpus({
+  command,
+  resultCount,
+  activeFilters,
+  nextCursor = null,
+  continued = false
+}) {
+  if (nextCursor) {
+    return { hints: [morePagesHint(resultCount, nextCursor)] };
+  }
+  if (resultCount > 0) {
+    return { hints: [] };
+  }
+  if (continued) {
+    return { hints: [endOfWalkHint(command)] };
+  }
+  if (activeFilters.length > 0) {
+    const reason2 = "filtered_out";
+    return {
+      hints: emptyCorpusHints({ command, reason: reason2, sourceCount: 0, activeFilters }),
+      empty: { reason: reason2, detail: emptyReasonDetail(reason2, 0, activeFilters) }
+    };
+  }
+  let sourceCount;
+  try {
+    const sources = await apiGet("/api/testimonials/sources");
+    sourceCount = Array.isArray(sources) ? sources.length : 0;
+  } catch {
+    return {
+      hints: [
+        "No rows, and the check for connected review sources failed \u2014 so this is NOT evidence that the client has no reviews. Do not record an absence you could not verify. Re-run once; if it fails again, say the library could not be read rather than that it is empty."
+      ]
+    };
+  }
+  const reason = resolveEmptyReason({ resultCount, activeFilters, sourceCount });
+  if (reason === null) {
+    return { hints: [] };
+  }
+  return {
+    hints: emptyCorpusHints({ command, reason, sourceCount, activeFilters }),
+    empty: { reason, detail: emptyReasonDetail(reason, sourceCount, activeFilters) }
+  };
+}
+function emptyCorpusHints({
+  command,
+  reason,
+  sourceCount,
+  activeFilters
+}) {
+  if (reason === null) {
+    return [];
+  }
+  if (reason === "filtered_out") {
+    return [
+      `No rows \u2014 ${activeFilters.join(", ")} narrowed this. Drop every filter and re-run once before touching the query; a filter combination and an empty library look identical from here.`
+    ];
+  }
+  const lead = command === "search" ? "No hits" : "No rows";
+  if (reason === "no_corpus_connected") {
+    return [`${lead}, and this company's source list is empty: there is no review corpus to search. ${NO_CORPUS_EXIT}`];
+  }
+  return [
+    `${lead}. ${sourceCount} review source${sourceCount === 1 ? " is" : "s are"} connected but no testimonials have landed yet \u2014 so this is a timing or ingestion gap, not a missing connection, and re-querying will not change it. Ingestion may still be running: say so rather than reporting the client has no reviews. ${NO_CORPUS_EXIT}`
+  ];
+}
+
+export {
+  measureEmptyCorpus
+};
+//# sourceMappingURL=chunk-LS5MTRFI.js.map