@koda-sl/baker-cli 0.372.0 → 0.374.0

package/dist/cli.js

@@ -7143,37 +7143,10 @@ function parseConditionsExpression(expression) {
 }
 
 // ../api/src/scheduledAgents.ts
-import { z as z24 } from "zod";
-var scheduledAgentRunsAsSchema = z24.object({
-  /** The person each run acts as; null when nobody owns it, so only the company's tools load. */
-  name: z24.string().nullable(),
-  /** That person's own connected tools. */
-  personalTools: z24.array(z24.string()),
-  /** The company's and organization's tools, and the platforms Baker connects to directly. */
-  companyTools: z24.array(z24.string()),
-  /** Set up, but nobody has signed in to them, so a run gets nothing from them. */
-  notSignedIn: z24.array(z24.string()).optional(),
-  /** The company switched connected tools off: only the platforms load. */
-  toolsOff: z24.literal(true).optional()
-});
-var AUTO_PUBLISH_REFUSAL = 'Publishing every run unreviewed is a standing authorization only the user can grant, on the item itself, so it is recorded against their name. Stage the item without it, and once this chat is published ask the user to switch on "Publish its work on its own" (under "When a run finishes") on the item in Scheduled agents.';
-var scheduledAgentsUnstageRequestSchema = z24.object({
-  chatId: z24.string().min(1),
-  /** The item: a published id or a temp_agent_* id this chat staged. */
-  ref: z24.string().min(1),
-  /** One change of it, by its `index` in `list`'s draft. Left out, every change staged on it. */
-  index: z24.number().int().min(0).optional()
-});
-var scheduledAgentsUnstageResponseSchema = z24.object({
-  ok: z24.literal(true),
-  data: z24.object({ ref: z24.string(), removed: z24.number().int().min(1) })
-});
-
-// ../api/src/scheduledAgentTriggerCatalog.ts
-import { z as z26 } from "zod";
+import { z as z25 } from "zod";
 
 // ../api/src/scheduledAgentTriggers.ts
-import { z as z25 } from "zod";
+import { z as z24 } from "zod";
 var TRIGGER_GROUPS = {
   time: { label: "Time", blurb: "On a clock you set." },
   incoming: { label: "Incoming", blurb: "Another tool or your site calls in." },
@@ -7539,152 +7512,233 @@ var TRIGGER_TARGETS = {
   "review.received": [target("sourceId", { open: false })],
   "advertiser.new_ads": [target("advertiserId", { open: false })]
 };
-var triggerTargetOptionSchema = z25.object({
-  value: z25.string(),
-  label: z25.string(),
+var triggerTargetOptionSchema = z24.object({
+  value: z24.string(),
+  label: z24.string(),
   /** A second line: a status, a tag list, where it comes from. */
-  detail: z25.string().optional(),
+  detail: z24.string().optional(),
   /** A mark: a path under the dashboard's `/logos/`, or an absolute image URL. */
-  logo: z25.string().optional()
+  logo: z24.string().optional()
 });
-var scheduledAgentTriggerSchema = z25.discriminatedUnion("kind", [
-  z25.object({
-    kind: z25.literal("time.once"),
+var scheduledAgentTriggerSchema = z24.discriminatedUnion("kind", [
+  z24.object({
+    kind: z24.literal("time.once"),
     /** Epoch ms. Must still be in the future when the item is written. */
-    runAt: z25.number(),
+    runAt: z24.number(),
     /** IANA zone. Defaults to the company's. */
-    tz: z25.string()
+    tz: z24.string()
   }),
-  z25.object({
-    kind: z25.literal("time.cron"),
+  z24.object({
+    kind: z24.literal("time.cron"),
     /** Five-field cron expression. */
-    cronspec: z25.string(),
-    tz: z25.string()
+    cronspec: z24.string(),
+    tz: z24.string()
   }),
-  z25.object({ kind: z25.literal("webhook.received") }),
-  z25.object({
-    kind: z25.literal("app.event"),
+  z24.object({ kind: z24.literal("webhook.received") }),
+  z24.object({
+    kind: z24.literal("app.event"),
     /** The connected tool, by its toolkit slug: `gmail`, `slack`. */
-    toolkit: z25.string(),
+    toolkit: z24.string(),
     /** What happens in it, by the tool's own trigger id: `GMAIL_NEW_GMAIL_MESSAGE`. */
-    appEvent: z25.string(),
+    appEvent: z24.string(),
     /** Which connected account — a tool can be connected more than once. */
-    account: z25.string(),
+    account: z24.string(),
     /** The tool's own settings for the event (a label, a channel, a repository), as JSON text. */
-    configJson: z25.string().optional()
+    configJson: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("event.received"),
+  z24.object({
+    kind: z24.literal("event.received"),
     /** Absent = any event. */
-    eventName: z25.string().optional()
+    eventName: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("connection.created"),
+  z24.object({
+    kind: z24.literal("connection.created"),
     /** Absent = any tool. An OAuth provider type, or a Composio toolkit slug. */
-    provider: z25.string().optional()
+    provider: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("connection.removed"),
-    provider: z25.string().optional()
+  z24.object({
+    kind: z24.literal("connection.removed"),
+    provider: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("form.submitted"),
+  z24.object({
+    kind: z24.literal("form.submitted"),
     /** Absent = any Form. */
-    flowId: z25.string().optional()
+    flowId: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("flow.step.submitted"),
-    flowId: z25.string(),
-    stepId: z25.string()
+  z24.object({
+    kind: z24.literal("flow.step.submitted"),
+    flowId: z24.string(),
+    stepId: z24.string()
   }),
-  z25.object({
-    kind: z25.literal("landing.created"),
+  z24.object({
+    kind: z24.literal("landing.created"),
     /** Absent = any page. A page's slug. */
-    page: z25.string().optional(),
+    page: z24.string().optional(),
     /** Absent = any tag. */
-    tag: z25.string().optional()
+    tag: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("landing.published"),
-    page: z25.string().optional(),
-    tag: z25.string().optional()
+  z24.object({
+    kind: z24.literal("landing.published"),
+    page: z24.string().optional(),
+    tag: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("experiment.started"),
+  z24.object({
+    kind: z24.literal("experiment.started"),
     /** Absent = any test. */
-    experimentId: z25.string().optional()
+    experimentId: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("experiment.decided"),
-    experimentId: z25.string().optional()
+  z24.object({
+    kind: z24.literal("experiment.decided"),
+    experimentId: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("experiment.ended"),
-    experimentId: z25.string().optional()
+  z24.object({
+    kind: z24.literal("experiment.ended"),
+    experimentId: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("experiment.concluded"),
-    experimentId: z25.string().optional()
+  z24.object({
+    kind: z24.literal("experiment.concluded"),
+    experimentId: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("task.created"),
+  z24.object({
+    kind: z24.literal("task.created"),
     /** Absent = any Task. */
-    tag: z25.string().optional()
+    tag: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("task.claimed"),
+  z24.object({
+    kind: z24.literal("task.claimed"),
     /** Absent = any Task. One Task, by id. */
-    taskId: z25.string().optional(),
-    tag: z25.string().optional()
+    taskId: z24.string().optional(),
+    tag: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("task.completed"),
-    taskId: z25.string().optional(),
-    tag: z25.string().optional()
+  z24.object({
+    kind: z24.literal("task.completed"),
+    taskId: z24.string().optional(),
+    tag: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("session.published"),
+  z24.object({
+    kind: z24.literal("session.published"),
     /** Absent = any agent. Only the runs of this Scheduled agent. */
-    agentId: z25.string().optional()
+    agentId: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("session.publish_failed"),
-    agentId: z25.string().optional()
+  z24.object({
+    kind: z24.literal("session.publish_failed"),
+    agentId: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("knowledge.updated"),
+  z24.object({
+    kind: z24.literal("knowledge.updated"),
     /** Absent = any collection. */
-    collection: z25.string().optional()
+    collection: z24.string().optional()
   }),
-  z25.object({ kind: z25.literal("brand.updated") }),
-  z25.object({ kind: z25.literal("creative.created") }),
-  z25.object({
-    kind: z25.literal("connection.needs_reconnect"),
-    provider: z25.string().optional()
+  z24.object({ kind: z24.literal("brand.updated") }),
+  z24.object({ kind: z24.literal("creative.created") }),
+  z24.object({
+    kind: z24.literal("connection.needs_reconnect"),
+    provider: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("session.publish_incomplete"),
+  z24.object({
+    kind: z24.literal("session.publish_incomplete"),
     /** Absent = any platform. One of `PUBLISH_PLATFORMS`. */
-    platform: z25.string().optional(),
-    agentId: z25.string().optional()
+    platform: z24.string().optional(),
+    agentId: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("review.received"),
+  z24.object({
+    kind: z24.literal("review.received"),
     /** Absent = any review source. */
-    sourceId: z25.string().optional()
+    sourceId: z24.string().optional()
   }),
-  z25.object({
-    kind: z25.literal("advertiser.new_ads"),
+  z24.object({
+    kind: z24.literal("advertiser.new_ads"),
     /** Absent = any followed advertiser. */
-    advertiserId: z25.string().optional()
+    advertiserId: z24.string().optional()
   })
 ]);
-var occurrencesSchema = z25.array(z25.number().int().positive()).max(32);
+var occurrencesSchema = z24.array(z24.number().int().positive()).max(32);
 function firstTimes(count2) {
   return Array.from({ length: Math.max(0, Math.floor(count2)) }, (_, index) => index + 1);
 }
 
+// ../api/src/scheduledAgents.ts
+var scheduledAgentRunsAsSchema = z25.object({
+  /** The person each run acts as; null when nobody owns it, so only the company's tools load. */
+  name: z25.string().nullable(),
+  /** That person's own connected tools. */
+  personalTools: z25.array(z25.string()),
+  /** The company's and organization's tools, and the platforms Baker connects to directly. */
+  companyTools: z25.array(z25.string()),
+  /** Set up, but nobody has signed in to them, so a run gets nothing from them. */
+  notSignedIn: z25.array(z25.string()).optional(),
+  /** The company switched connected tools off: only the platforms load. */
+  toolsOff: z25.literal(true).optional()
+});
+var AUTO_PUBLISH_REFUSAL = 'Publishing every run unreviewed is a standing authorization only the user can grant, on the item itself, so it is recorded against their name. Stage the item without it, and once this chat is published ask the user to switch on "Publish its work on its own" (under "When a run finishes") on the item in Scheduled agents.';
+var scheduledAgentsUnstageRequestSchema = z25.object({
+  chatId: z25.string().min(1),
+  /** The item: a published id or a temp_agent_* id this chat staged. */
+  ref: z25.string().min(1),
+  /** One change of it, by its `index` in `list`'s draft. Left out, every change staged on it. */
+  index: z25.number().int().min(0).optional()
+});
+var scheduledAgentsUnstageResponseSchema = z25.object({
+  ok: z25.literal(true),
+  data: z25.object({ ref: z25.string(), removed: z25.number().int().min(1) })
+});
+var scheduledAgentsListRequestSchema = z25.object({
+  /** Also return what this chat staged. */
+  chatId: z25.string().min(1).optional(),
+  /** Every item and staged change as stored, briefs included. Left out, the compact view below. */
+  full: z25.boolean().optional()
+});
+var scheduledAgentListItemSchema = z25.object({
+  id: z25.string(),
+  name: z25.string(),
+  description: z25.string(),
+  enabled: z25.boolean(),
+  trigger: scheduledAgentTriggerSchema,
+  occurrences: occurrencesSchema.optional(),
+  conditions: conditionsSchema.optional(),
+  cooldownMinutes: z25.number().optional(),
+  /** ISO. Only a one-off knows its next moment. */
+  nextRunAt: z25.string().optional(),
+  /** ISO. */
+  lastRunAt: z25.string().optional(),
+  firedCount: z25.number(),
+  totalRuns: z25.number(),
+  templateName: z25.string().optional(),
+  publishesOwnWork: z25.literal(true).optional(),
+  /** Whether the connected tool is reporting to an `app.event` item. */
+  listening: z25.object({ status: z25.string(), reason: z25.string().optional() }).optional()
+});
+var scheduledAgentStagedChangeSchema = z25.object({
+  index: z25.number().int().min(0),
+  kind: z25.enum(["create", "update", "delete"]),
+  /** The published id, or the temp_agent_* id a create returned. */
+  ref: z25.string(),
+  name: z25.string(),
+  description: z25.string().optional(),
+  trigger: scheduledAgentTriggerSchema.optional(),
+  enabled: z25.boolean().optional(),
+  /** For an update: the fields it changes. */
+  changes: z25.array(z25.string()).optional(),
+  result: z25.object({
+    status: z25.enum(["applied", "skipped", "failed"]),
+    reason: z25.string().optional(),
+    scheduledAgentId: z25.string().optional()
+  }).optional()
+});
+var scheduledAgentsListResponseSchema = z25.object({
+  ok: z25.literal(true),
+  data: z25.object({
+    published: z25.array(scheduledAgentListItemSchema),
+    draft: z25.object({
+      status: z25.enum(["active", "publishing", "discarded", "applied"]).nullable(),
+      ops: z25.array(scheduledAgentStagedChangeSchema)
+    }).nullable()
+  }),
+  hints: z25.array(z25.string()).optional()
+});
+
 // ../api/src/scheduledAgentTriggerCatalog.ts
+import { z as z26 } from "zod";
 var catalogTriggerSchema = z26.object({
   kind: z26.string(),
   label: z26.string(),
@@ -9026,17 +9080,17 @@ function text(value) {
   return typeof value === "string" ? value : "";
 }
 function draftOpNormalizer(record, full) {
-  const compact3 = {
+  const compact4 = {
     kind: text(record.kind),
     name: text(record.targetName),
     ref: text(record.tempId) || text(record.targetActionId),
     tags: Array.isArray(record.tags) ? record.tags.join(",") : ""
   };
   if (!full) {
-    return compact3;
+    return compact4;
   }
   return {
-    ...compact3,
+    ...compact4,
     description: text(record.description),
     note: text(record.note),
     reason: text(record.reason),
@@ -9311,10 +9365,10 @@ var listCommand2 = defineCommand8({
         process.stdout.write(renderMarkdown(response.data, hints2, { full: args5.full === true }));
         return;
       }
-      const compact3 = !args5.full && response.ok;
-      const shaped = compact3 ? { ...response, data: compactListData(response.data) } : response;
+      const compact4 = !args5.full && response.ok;
+      const shaped = compact4 ? { ...response, data: compactListData(response.data) } : response;
       const envelope = hints2.length > 0 ? { ...shaped, hints: hints2 } : shaped;
-      if (compact3) {
+      if (compact4) {
         process.stdout.write(`${JSON.stringify(envelope)}
 `);
         return;
@@ -14705,8 +14759,8 @@ function normalizePhoneV1(raw) {
 var PHONE_PUNCTUATION = /[\s()./-]/g;
 var E164 = /^\+[1-9]\d{7,14}$/;
 function normalizePhoneV2(raw) {
-  const compact3 = raw.replace(PHONE_PUNCTUATION, "");
-  const e164 = compact3.startsWith("00") ? `+${compact3.slice(2)}` : compact3;
+  const compact4 = raw.replace(PHONE_PUNCTUATION, "");
+  const e164 = compact4.startsWith("00") ? `+${compact4.slice(2)}` : compact4;
   return E164.test(e164) ? e164 : null;
 }
 
@@ -31833,6 +31887,7 @@ function parseConversionsArgs(raw, argv) {
     removeName: onlyOnce(raw["remove-name"], "--remove-name", argv),
     flowSlug: onlyOnce(raw.flow, "--flow", argv),
     candidates: raw.candidates === true,
+    full: raw.full === true,
     days: readDays(raw.days)
   };
   checkFlagShape(args5);
@@ -31899,6 +31954,72 @@ function conversionsWrite(args5, existing) {
   return { ...set.length > 0 ? { set } : {}, ...remove.length > 0 ? { remove } : {} };
 }
 
+// src/commands/analytics/conversionCandidates.ts
+function compact2(row) {
+  return {
+    eventKey: row.eventKey,
+    events: row.events,
+    sessions: row.sessions,
+    ...row.isCounted ? { countedAs: row.countedAs } : {}
+  };
+}
+function foldByForm(rows) {
+  const byForm = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const form = byForm.get(row.flowSlug) ?? { form: row.flowSlug, keys: 0, countedKeys: 0, events: 0 };
+    form.keys += 1;
+    if (row.isCounted) form.countedKeys += 1;
+    form.events += row.events;
+    byForm.set(row.flowSlug, form);
+  }
+  return [...byForm.values()];
+}
+function candidatesForFlow(catalogue, flowSlug) {
+  return flowSlug === void 0 ? [...catalogue] : catalogue.filter((row) => row.flowSlug === flowSlug);
+}
+var FOLDED_FORMS_HINT = "A Form's candidates are folded into its `flows` row (`keys` fired, `events`; no `counted` means it counts nothing), or a `formCandidates` row when not listed. `--candidates --flow <slug>` lists that Form's keys; `--full` adds every field of every key.";
+function candidatesView(rows, options) {
+  if (options.full) return { candidates: rows };
+  if (options.flowSlug !== void 0) return { candidates: rows.map(compact2) };
+  const forms = foldByForm(rows.filter((row) => row.flowSlug !== ""));
+  return {
+    candidates: rows.filter((row) => row.flowSlug === "").map(compact2),
+    ...forms.length > 0 ? { formCandidates: forms } : {}
+  };
+}
+function fullFlagHints(args5, format) {
+  if (!args5.full || args5.candidates && format !== "md") return [];
+  return ["`--full` only applies to `--candidates --output json`, so it changed nothing here."];
+}
+function compactConversionsEnvelope(envelope, options) {
+  const { candidates, flows, ...data } = envelope.data;
+  if (candidates === void 0) return { ...envelope };
+  const { formCandidates, ...view } = candidatesView(candidates, options);
+  const traffic = new Map(formCandidates?.map((form) => [form.form, form]));
+  const merged = flows?.map(({ slug, counted, noConversion }) => {
+    const form = traffic.get(slug);
+    traffic.delete(slug);
+    return {
+      slug,
+      ...counted.length > 0 ? { counted } : {},
+      ...noConversion !== null ? { noConversion } : {},
+      keys: form?.keys ?? 0,
+      events: form?.events ?? 0
+    };
+  });
+  const hints2 = [...envelope.hints ?? [], ...formCandidates ? [FOLDED_FORMS_HINT] : []];
+  return {
+    ...envelope,
+    data: {
+      ...data,
+      ...merged ? { flows: merged } : {},
+      ...view,
+      ...traffic.size > 0 ? { formCandidates: [...traffic.values()] } : {}
+    },
+    ...hints2.length > 0 ? { hints: hints2 } : {}
+  };
+}
+
 // src/commands/analytics/conversionHints.ts
 var NAMED_CANDIDATES = 3;
 function conversionHints(definitions, candidates, askedForCandidates) {
@@ -32224,7 +32345,7 @@ function trafficByForm(candidates) {
   return byForm;
 }
 var NO_TRAFFIC = { "endings seen": 0, "endings counted": 0, events: 0, lastSeen: "" };
-var FORM_KEYS_HINT = "A Form's candidates are one row per Form: `baker analytics conversions --flow <slug>` lists that Form's event keys, and `--candidates --output json` lists every key.";
+var FORM_KEYS_HINT = "A Form's candidates are one row per Form: `baker analytics conversions --flow <slug>` lists that Form's event keys, and `--candidates --full --output json` lists every key with every field.";
 function renderConversionsMarkdown(envelope) {
   const { definitions, flow, flows, candidates } = envelope.data;
   const data = {
@@ -32261,7 +32382,7 @@ function renderConversionsMarkdown(envelope) {
   return renderMarkdown3({ data, ...hints2.length > 0 ? { hints: hints2 } : {} });
 }
 function withFormatHint(envelope, format) {
-  const hints2 = [...envelope.hints ?? [], ...formatHint(envelope.data, format)];
+  const hints2 = [...envelope.hints ?? [], ...formatHint({ ...envelope.data }, format)];
   return { ...envelope, ...hints2.length > 0 ? { hints: hints2 } : {} };
 }
 
@@ -34419,13 +34540,13 @@ function readFlowConversions2(slug, definitions) {
     endings: joinFlowConversions(flowEventKeys(tree, slug), definitions)
   };
 }
-function conversionsEnvelope(args5, definitions, candidates, serverHints = []) {
+function conversionsEnvelope(args5, definitions, candidates, leadingHints = []) {
   const flow = args5.flowSlug === void 0 ? null : readFlowConversions2(args5.flowSlug, definitions);
   const forms = flow === null ? readWorkspaceFlows() : [];
   const coverage = flowCoverage(forms, definitions);
   const page = pageCandidates(definitions, candidates, args5.candidates);
   const hints2 = [
-    ...serverHints,
+    ...leadingHints,
     ...flow ? flowConversionHints(flow.slug, flow.endings, flow.noConversionReason) : [],
     ...flowCoverageHints(coverage),
     ...stagedHints(definitions),
@@ -34438,7 +34559,7 @@ function conversionsEnvelope(args5, definitions, candidates, serverHints = []) {
       definitions,
       ...flow ? { flow } : {},
       ...coverage.length > 0 ? { flows: coverage } : {},
-      ...args5.candidates ? { candidates: page.candidates } : {}
+      ...args5.candidates ? { candidates: candidatesForFlow(page.candidates, args5.flowSlug) } : {}
     },
     ...hints2.length > 0 ? { hints: hints2 } : {}
   };
@@ -34482,12 +34603,17 @@ var conversionsCommand3 = (() => {
     },
     candidates: {
       type: "boolean",
-      description: "Also list every event these pages actually produced, ranked by volume, with whether it is already counted. This is where an event key comes from \u2014 do not invent one. Off by default because a busy company produces hundreds of rows",
+      description: "Also list every event these pages actually produced, ranked by volume, with whether it is already counted. This is where an event key comes from \u2014 do not invent one. Compact by default in JSON: each page or system event is one line (eventKey, events, sessions, countedAs when counted) and a Form's keys fold onto its `flows` row as `keys` and `events` (or a `formCandidates` row for a Form not in `flows`). Add --flow <slug> for that Form's keys only, and --full --output json for every field of every row",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "With --candidates: every field of every candidate (origin, nodeType, flowSlug, lastSeen, sources, doors) and every Form key unfolded. Large on a busy company \u2014 narrow it with --flow first",
       required: false
     },
     flow: {
       type: "string",
-      description: "A Form slug. Lists that Form's own endings already spelled as event keys, each with the name Baker counts it under or nothing \u2014 read off the Form's file, so it works on a Form built minutes ago that has never been visited, which is exactly when --candidates is empty. Use it whenever you create or edit a Form: it is the only way to see that the Form counts nothing before it is published counting nothing",
+      description: "A Form slug. Lists that Form's own endings already spelled as event keys, each with the name Baker counts it under or nothing \u2014 read off the Form's file, so it works on a Form built minutes ago that has never been visited, which is exactly when --candidates is empty. With --candidates, narrows the candidates to that Form's keys. Use it whenever you create or edit a Form: it is the only way to see that the Form counts nothing before it is published counting nothing",
       required: false
     },
     days: {
@@ -34505,7 +34631,7 @@ var conversionsCommand3 = (() => {
   return defineCommand99({
     meta: {
       name: "conversions",
-      description: "What this company counts as a conversion \u2014 the numerator of every conversion rate on Measure. A page event (a Form ending, a data-baker-* event) and an event one of the client's systems sends (a HubSpot event made with `baker analytics sources --create-hubspot`, an order the server posts) both count; a system's event is credited to the last landing its person viewed. A HubSpot event is `page:<its name>` here \u2014 `--event 'page:Deal won' --name 'Deal won'`. Run with no flags first: an empty `definitions` list means every conversion number in every other report is zero \u2014 not because nobody converted, but because nothing is marked as converting, and Baker never guesses. Add `--candidates` to see everything these pages actually do (every Form step, every data-baker-* event, every outbound destination) with counts and whether it is already counted; that list is where an event key comes from, so never invent one. Then `--event <key> --name 'Booked a call'` to count it. Inside a chat a change is STAGED: the person sees it under Sources in the chat's changes, on the event's own row and it applies when they publish, retroactively \u2014 the whole history is rescored, so a company that has been running for a month gets a month of correct numbers. A read shows a proposal marked `staged`. Call an event by its name when you talk to the person, never by its key. Two events given the SAME --name are one row and one number. `--remove <key>` stops counting one. `--flow <slug>` answers the other direction \u2014 what one Form counts, with every ending it has already spelled as an event key, read from the Form itself so it works before a single visitor has seen it. Run it whenever you create or edit a Form: a Form nobody named an outcome for is published converting nobody, and no report says so."
+      description: "What this company counts as a conversion \u2014 the numerator of every conversion rate on Measure. A page event (a Form ending, a data-baker-* event) and an event one of the client's systems sends (a HubSpot event made with `baker analytics sources --create-hubspot`, an order the server posts) both count; a system's event is credited to the last landing its person viewed. A HubSpot event is `page:<its name>` here \u2014 `--event 'page:Deal won' --name 'Deal won'`. Run with no flags first: an empty `definitions` list means every conversion number in every other report is zero \u2014 not because nobody converted, but because nothing is marked as converting, and Baker never guesses. Add `--candidates` to see everything these pages actually do (every Form step, every data-baker-* event, every outbound destination) with counts and whether it is already counted; that list is where an event key comes from, so never invent one. It is compact: a Form's keys fold onto its `flows` row, `--candidates --flow <slug>` lists one Form's keys, and `--full --output json` returns every field of every row. Then `--event <key> --name 'Booked a call'` to count it. Inside a chat a change is STAGED: the person sees it under Sources in the chat's changes, on the event's own row and it applies when they publish, retroactively \u2014 the whole history is rescored, so a company that has been running for a month gets a month of correct numbers. A read shows a proposal marked `staged`. Call an event by its name when you talk to the person, never by its key. Two events given the SAME --name are one row and one number. `--remove <key>` stops counting one. `--flow <slug>` answers the other direction \u2014 what one Form counts, with every ending it has already spelled as an event key, read from the Form itself so it works before a single visitor has seen it. Run it whenever you create or edit a Form: a Form nobody named an outcome for is published converting nobody, and no report says so."
     },
     args: args5,
     run: async ({ args: raw }) => {
@@ -34525,10 +34651,10 @@ var conversionsCommand3 = (() => {
           args6,
           mergeStoredWithCounts(stored, report.data.conversions ?? []),
           report.data.eventCatalog ?? [],
-          answer.hints ?? []
+          [...answer.hints ?? [], ...fullFlagHints(args6, format)]
         );
         if (format === "md") process.stdout.write(renderConversionsMarkdown(envelope));
-        else writeJsonEnvelope(withFormatHint(envelope, format));
+        else writeJsonEnvelope(withFormatHint(compactConversionsEnvelope(envelope, args6), format));
       } catch (err) {
         if (err instanceof ConversionArgsError) {
           handleError3(new ApiError("VALIDATION_ERROR", err.message));
@@ -54441,13 +54567,13 @@ function compactHit(hit) {
   };
 }
 function providerHitNormalizer(record, full) {
-  const compact3 = compactHit(record);
+  const compact4 = compactHit(record);
   if (!full) {
-    return compact3;
+    return compact4;
   }
   const group = asRecord2(record.group);
   return {
-    ...compact3,
+    ...compact4,
     externalUrl: str(record.externalUrl),
     externalId: str(record.externalId),
     description: str(record.description),
@@ -55209,7 +55335,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS3 = 4e3;
-function compact2(doc) {
+function compact3(doc) {
   return {
     layeredImageId: doc.layeredImageId,
     imageId: doc.imageId,
@@ -55299,7 +55425,7 @@ var layerizeCommand = defineCommand157({
         });
         process.exit(1);
       }
-      writeJson({ ok: true, data: full ? settled : compact2(settled), hints: hintsFor3(settled) });
+      writeJson({ ok: true, data: full ? settled : compact3(settled), hints: hintsFor3(settled) });
     } catch (err) {
       if (err instanceof ApiError) {
         writeJson({ ok: false, error: { code: err.code, message: err.message } });
@@ -55338,7 +55464,7 @@ var layersCommand = defineCommand157({
         process.exit(1);
       }
       const doc = await apiGet("/api/images/layers", { imageId });
-      writeJson({ ok: true, data: args5.full ? doc : compact2(doc), hints: hintsFor3(doc) });
+      writeJson({ ok: true, data: args5.full ? doc : compact3(doc), hints: hintsFor3(doc) });
     } catch (err) {
       if (err instanceof ApiError) {
         writeJson({
@@ -64254,27 +64380,32 @@ var getCommand4 = defineCommand199({
 
 // src/commands/scheduled-agents/list.ts
 import { defineCommand as defineCommand200 } from "citty";
+var FULL_DESCRIPTION = "Return every item and staged change as stored, briefs included (tens of KB). Prefer `get <id>` for one item.";
 registerSchema({
   command: "scheduled-agents.list",
-  description: "List published scheduled agents. Includes draft state when BAKER_CHAT_ID is set, or --chat <id> to read an earlier chat's staged items instead.",
+  description: "List scheduled agents compactly: each published item's id, name, trigger, enabled and run counts, and each change this chat staged (index, kind, ref, name, trigger). Briefs are left out \u2014 `get <id>` returns one item in full, --full returns everything as stored. Includes draft state when BAKER_CHAT_ID is set, or --chat <id> to read an earlier chat's staged items instead.",
   args: {
-    chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
+    chat: { type: "string", description: CHAT_READ_ARG.description, required: false },
+    full: { type: "boolean", description: FULL_DESCRIPTION, required: false }
   }
 });
 var listCommand17 = defineCommand200({
   meta: {
     name: "list",
-    description: "List scheduled agents. Includes staged draft ops when BAKER_CHAT_ID is set, or --chat <id> to read an earlier chat's staged items instead."
+    description: "List scheduled agents: id, name, trigger and status for each, plus this chat's staged changes when BAKER_CHAT_ID is set (or --chat <id> for an earlier chat's). Briefs are left out. Start here: baker scheduled-agents list; then baker scheduled-agents get <id> for one item's brief."
+  },
+  args: {
+    chat: CHAT_READ_ARG,
+    full: { type: "boolean", description: FULL_DESCRIPTION, required: false, default: false }
   },
-  args: { chat: CHAT_READ_ARG },
   run: async ({ args: args5 }) => {
     try {
       const env = getEnv();
-      const body = {};
       const chatId = typeof args5.chat === "string" && args5.chat.length > 0 ? args5.chat : env.BAKER_CHAT_ID;
-      if (chatId) {
-        body.chatId = chatId;
-      }
+      const body = {
+        ...chatId ? { chatId } : {},
+        ...args5.full === true ? { full: true } : {}
+      };
       const response = await apiPost("/api/scheduled-agents/list", body);
       writeJson(response);
     } catch (err) {
@@ -64962,7 +65093,7 @@ function adByHandHint(input) {
 
 // src/commands/studio/batch.ts
 function projectBatch(generation, full) {
-  const compact3 = {
+  const compact4 = {
     generationId: generation.generationId,
     kind: generation.kind,
     status: generation.status,
@@ -64979,9 +65110,9 @@ function projectBatch(generation, full) {
       ...variant.error ? { error: variant.error } : {}
     }))
   };
-  if (!full) return compact3;
+  if (!full) return compact4;
   return {
-    ...compact3,
+    ...compact4,
     ...generation.skillId ? { skillId: generation.skillId } : {},
     ...generation.imageSettings ? { imageSettings: generation.imageSettings } : {},
     ...generation.clipSettings ? { clipSettings: generation.clipSettings } : {},
@@ -68181,12 +68312,12 @@ function compactAdvertiser(record) {
   };
 }
 function advertiserNormalizer(record, full) {
-  const compact3 = compactAdvertiser(record);
+  const compact4 = compactAdvertiser(record);
   if (!full) {
-    return compact3;
+    return compact4;
   }
   return {
-    ...compact3,
+    ...compact4,
     scraped_name: record.scraped_name ?? null,
     image_url: record.image_url ?? null,
     platforms: Array.isArray(record.platforms) ? record.platforms : [],
@@ -68747,12 +68878,12 @@ function followingHints(records) {
   return hints2;
 }
 function followingNormalizer(record, full) {
-  const compact3 = compactFollowed(record);
+  const compact4 = compactFollowed(record);
   if (!full) {
-    return compact3;
+    return compact4;
   }
   return {
-    ...compact3,
+    ...compact4,
     image_url: record.image_url ?? null,
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };