@koda-sl/baker-cli 0.372.0 → 0.373.0

package/README.md

@@ -721,7 +721,7 @@ Command groups: `budgets`, `campaigns`, `ad-groups`, `keywords` (add/update/remo
 
 **Amending a staged op** — `draft amend <ref> (--file patch.json | --patch '<json>')` merges a JSON patch into an already-staged op's payload (objects deep-merge, `null` deletes a key, arrays/scalars replace) and re-validates it in full. Always prefer this over removing and re-staging — it preserves the op's ref (so dependents don't break) and its position in the draft. `draft show <ref>` prints the full staged payload (including warnings/annotations) so you can verify a change looks right before publish.
 
-**Reading an earlier chat's changes** — `draft list` and `draft show` take `--chat <chat-id>` to read another chat in the same company instead of the current one. Every staged-draft family accepts it: `ads google|meta|linkedin draft list|show`, `tag-manager draft list|show`, `actions draft`, `tags draft`, and `scheduled-agents list|get`. A published draft is kept in full, so this returns what that chat actually wrote — every headline, bid and target — plus each op's outcome and error. Use it when asked to redo or reapply earlier work rather than reconstructing copy from a summary. Read-only: staging, `amend`, `remove` and `clear` stay bound to `BAKER_CHAT_ID`, so one chat can never edit another's draft. To re-run only the changes a publish failed to land, use the chat's **Retry** control in the dashboard — it re-sends exactly those and leaves the ones that applied untouched.
+**Reading an earlier chat's changes** — `draft list` and `draft show` take `--chat <chat-id>` to read another chat in the same company instead of the current one. Every staged-draft family accepts it: `ads google|meta|linkedin draft list|show`, `tag-manager draft list|show`, `actions draft`, `tags draft`, and `scheduled-agents list|get` (`list` leaves briefs out; `get <id>` or `list --full` returns them). A published draft is kept in full, so this returns what that chat actually wrote — every headline, bid and target — plus each op's outcome and error. Use it when asked to redo or reapply earlier work rather than reconstructing copy from a summary. Read-only: staging, `amend`, `remove` and `clear` stay bound to `BAKER_CHAT_ID`, so one chat can never edit another's draft. To re-run only the changes a publish failed to land, use the chat's **Retry** control in the dashboard — it re-sends exactly those and leaves the ones that applied untouched.
 
 **Already-satisfied writes aren't staged** — an update or pause/resume whose every field already holds the requested value on the live account is dropped instead of staged: the envelope returns `"staged": false, "noop": true` with a `reason` ("this ad is already Paused on Google Ads"), plus a hint. This is a success, not an error — there is nothing to publish. Only a positively-read live snapshot can trigger it; a failed or empty read always stages. Batch responses list the dropped ops under `skipped`, and `count` reflects what actually entered the draft.
 
@@ -3312,7 +3312,7 @@ A Scheduled agent is a **trigger** and a **prompt**. When the trigger fires, a S
 baker scheduled-agents triggers                    # every trigger kind, by group, compact
 baker scheduled-agents triggers --trigger experiment.decided   # one kind (or a family: --trigger experiment) in full, with its payload fields
 baker scheduled-agents triggers --group tasks      # one group in full; --full for the whole catalog
-baker scheduled-agents list
+baker scheduled-agents list                        # id, name, trigger, status; briefs left out (--full for everything)
 baker scheduled-agents get <id-or-temp_agent_id>
 
 baker scheduled-agents create --name "Weekly report" --description "Prepare report" --prompt "Review last week's spend." --cron "0 9 * * MON" --timezone Europe/Madrid

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(),
@@ -64254,27 +64308,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) {