@robbeverhelst/do 1.418.0 → 1.420.0

package/dist/do.js

@@ -14420,7 +14420,7 @@ var configError = (message) => new CliError("config", message, EXIT.CONFIG);
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.418.0";
+var VERSION = "1.420.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -28625,6 +28625,268 @@ var documentOperations = defineOperations({
   }
 });
 
+// ../../packages/schema/src/db/agent-chat-threads.ts
+var agentChatThreads = pgTable("agent_chat_threads", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  userId: text("user_id").notNull().references(() => users.id, { onDelete: "cascade" }),
+  title: text("title"),
+  slug: text("slug"),
+  standing: boolean4("standing").notNull().default(false),
+  push: text("push").notNull().default("all"),
+  areaIds: text("area_ids").array().notNull().default([]),
+  peopleCapture: boolean4("people_capture").notNull().default(true),
+  kind: text("kind"),
+  anchorType: text("anchor_type"),
+  anchorId: text("anchor_id"),
+  parentId: text("parent_id"),
+  notifyLevel: text("notify_level"),
+  icon: text("icon"),
+  description: text("description"),
+  memoryScope: text("memory_scope"),
+  lastMessageAt: timestamp("last_message_at", { withTimezone: true }),
+  archivedAt: timestamp("archived_at", { withTimezone: true }),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [
+  index("agent_chat_threads_member_idx").on(t.tenantId, t.userId, t.updatedAt),
+  uniqueIndex("agent_chat_threads_slug_uniq").on(t.tenantId, t.userId, t.slug).where(sql`${t.slug} is not null`)
+]);
+var agentChatTurns = pgTable("agent_chat_turns", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  threadId: text("thread_id").notNull().references(() => agentChatThreads.id, { onDelete: "cascade" }),
+  userId: text("user_id").notNull().references(() => users.id, { onDelete: "cascade" }),
+  question: text("question").notNull(),
+  context: jsonb("context").$type().notNull(),
+  reply: text("reply").notNull().default(""),
+  status: text("status").notNull().default("streaming"),
+  error: text("error"),
+  since: text("since"),
+  changes: jsonb("changes").$type().notNull().default([]),
+  confirmations: jsonb("confirmations").$type().notNull().default([]),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [index("agent_chat_turns_thread_idx").on(t.threadId, t.createdAt)]);
+var agentChatPosts = pgTable("agent_chat_posts", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  threadId: text("thread_id").notNull().references(() => agentChatThreads.id, { onDelete: "cascade" }),
+  userId: text("user_id").notNull().references(() => users.id, { onDelete: "cascade" }),
+  author: text("author").notNull(),
+  agentId: text("agent_id").references(() => agents.id),
+  externalId: text("external_id"),
+  kind: text("kind").notNull().default("message"),
+  level: text("level"),
+  text: text("text").notNull().default(""),
+  final: boolean4("final").notNull().default(true),
+  replyToId: text("reply_to_id"),
+  relayOfPostId: text("relay_of_post_id").references(() => agentChatPosts.id, {
+    onDelete: "set null"
+  }),
+  runStatus: text("run_status"),
+  brief: jsonb("brief").$type(),
+  card: jsonb("card").$type(),
+  digestKey: text("digest_key"),
+  title: text("title"),
+  runSteps: jsonb("run_steps").$type(),
+  runEndedAt: timestamp("run_ended_at", { withTimezone: true }),
+  prompt: jsonb("prompt").$type(),
+  receipt: jsonb("receipt").$type(),
+  attachments: jsonb("attachments").$type().notNull().default([]),
+  context: jsonb("context").$type(),
+  deliveredAt: timestamp("delivered_at", { withTimezone: true }),
+  seenAt: timestamp("seen_at", { withTimezone: true }),
+  readAt: timestamp("read_at", { withTimezone: true }),
+  fallbackAt: timestamp("fallback_at", { withTimezone: true }),
+  fallbackAckedAt: timestamp("fallback_acked_at", { withTimezone: true }),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
+  deletedAt: timestamp("deleted_at", { withTimezone: true })
+}, (t) => [
+  index("agent_chat_posts_thread_idx").on(t.threadId, t.createdAt),
+  uniqueIndex("agent_chat_posts_external_uniq").on(t.tenantId, t.agentId, t.externalId).where(sql`${t.externalId} is not null`),
+  index("agent_chat_posts_undelivered_idx").on(t.tenantId, t.createdAt).where(sql`${t.author} = 'member' and ${t.deliveredAt} is null`),
+  index("agent_chat_posts_needs_you_unseen_idx").on(t.tenantId, t.userId, t.createdAt).where(sql`${t.author} = 'agent' and ${t.level} = 'needs_you' and ${t.seenAt} is null and ${t.deletedAt} is null`)
+]);
+
+// ../../packages/schema/src/db/echo-schedules.ts
+var ECHO_SCHEDULE_LEVELS = ["now", "today", "digest", "silent"];
+var ECHO_SCHEDULE_RUN_STATUSES = ["ok", "failed", "unanswered"];
+var echoSchedules = pgTable("echo_schedules", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  userId: text("user_id").notNull().references(() => users.id, { onDelete: "cascade" }),
+  key: text("key").notNull(),
+  name: text("name").notNull(),
+  threadId: text("thread_id").notNull().references(() => agentChatThreads.id, { onDelete: "cascade" }),
+  agentId: text("agent_id").references(() => agents.id),
+  desk: text("desk"),
+  times: text("times").array().notNull(),
+  everyMinutes: integer2("every_minutes"),
+  weekdays: integer2("weekdays").array().notNull().default([]),
+  level: text("level").notNull().default("today"),
+  levelNote: text("level_note"),
+  pausedAt: timestamp("paused_at", { withTimezone: true }),
+  runRequestedAt: timestamp("run_requested_at", { withTimezone: true }),
+  lastRunAt: timestamp("last_run_at", { withTimezone: true }),
+  lastStatus: text("last_status"),
+  lastNote: text("last_note"),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [
+  index("echo_schedules_member_idx").on(t.tenantId, t.userId),
+  uniqueIndex("echo_schedules_key_uniq").on(t.tenantId, t.userId, t.key),
+  check2("echo_schedules_level_chk", sql`${t.level} IN ('now', 'today', 'digest', 'silent')`),
+  check2("echo_schedules_last_status_chk", sql`${t.lastStatus} IS NULL OR ${t.lastStatus} IN ('ok', 'failed', 'unanswered')`)
+]);
+
+// ../../packages/schema/src/contracts/echo-schedules.ts
+var echoScheduleLevelSchema = _enum2(ECHO_SCHEDULE_LEVELS);
+var echoScheduleRunStatusSchema = _enum2(ECHO_SCHEDULE_RUN_STATUSES);
+var clock = string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "a time as HH:MM");
+var echoScheduleKeySchema = string2().regex(/^[a-z0-9][a-z0-9-]{0,39}$/, "lower-case letters, digits and dashes, at most 40");
+var times = array(clock).min(1).max(12);
+var weekdays = array(number2().int().min(1).max(7)).max(7).refine((d) => new Set(d).size === d.length, "each weekday once");
+var everyMinutes = number2().int().min(15).max(10080);
+var echoScheduleSchema = object({
+  id: ulidSchema,
+  key: string2(),
+  name: string2(),
+  thread: object({
+    id: string2(),
+    title: string2().nullable(),
+    slug: string2().nullable(),
+    icon: string2().nullable()
+  }),
+  agentId: string2().nullable(),
+  desk: string2().nullable(),
+  times: array(string2()),
+  everyMinutes: number2().int().nullable(),
+  weekdays: array(number2().int()),
+  level: echoScheduleLevelSchema,
+  levelNote: string2().nullable(),
+  paused: boolean2(),
+  runRequested: boolean2(),
+  lastRunAt: exports_coerce.date().nullable(),
+  lastStatus: echoScheduleRunStatusSchema.nullable(),
+  lastNote: string2().nullable(),
+  createdAt: exports_coerce.date(),
+  updatedAt: exports_coerce.date()
+});
+var putEchoScheduleInputSchema = object({
+  name: string2().trim().min(1).max(80),
+  thread: string2().trim().min(1).max(40),
+  desk: string2().trim().min(1).max(40).nullish(),
+  times,
+  everyMinutes: everyMinutes.nullish(),
+  weekdays: weekdays.optional(),
+  level: echoScheduleLevelSchema.optional(),
+  levelNote: string2().trim().min(1).max(120).nullish()
+}).strict();
+var updateEchoScheduleInputSchema = object({
+  level: echoScheduleLevelSchema.optional(),
+  paused: boolean2().optional()
+}).strict().refine((v) => v.level !== undefined || v.paused !== undefined, "level or paused");
+var reportEchoScheduleRunInputSchema = object({
+  status: echoScheduleRunStatusSchema,
+  note: string2().trim().min(1).max(200).nullish(),
+  at: exports_coerce.date().optional()
+}).strict();
+var echoScheduleKeyParamSchema = object({ key: echoScheduleKeySchema });
+
+// ../../packages/schema/src/operations/echo-schedules.ts
+var NO_USER = "The key has no user identity (scheduled posts are per member).";
+var KEY = {
+  key: {
+    description: "The job's handle, the agent's own (`wake`, `pings`): lower-case letters, digits and dashes.",
+    pattern: "^[a-z0-9][a-z0-9-]{0,39}$"
+  }
+};
+var KEY_SCHEMA = { key: echoScheduleKeySchema };
+var VIEW = "`{ id, key, name, thread: { id, title, slug, icon }, agentId, desk, times, everyMinutes, weekdays, level, levelNote, paused, runRequested, lastRunAt, lastStatus, lastNote }`";
+var echoScheduleOperations = defineOperations({
+  list: {
+    method: "get",
+    path: "/echo/schedules",
+    scopes: ["agents:read"],
+    tag: "Agents",
+    summary: "List the scheduled posts",
+    description: `Every job that posts into the member's threads on a clock, by name: ${VIEW}. \`times\` are \`HH:MM\` on the member's wall clock; with \`everyMinutes\` the job repeats from the first until midnight; \`weekdays\` are ISO (1 = Monday), empty for every day. \`level\` says how its posts land (\`now\` pushes, \`today\` a card in its thread, \`digest\` folded into one line, \`silent\` only in its history). A \`paused\` job doesn't run; \`runRequested\` asks for a run now.`,
+    status: 200,
+    response: { description: "The scheduled posts.", list: true },
+    errors: { 403: NO_USER }
+  },
+  put: {
+    method: "put",
+    path: "/echo/schedules/{key}",
+    pathParams: KEY,
+    pathParamSchemas: KEY_SCHEMA,
+    scopes: ["agents:write"],
+    tag: "Agents",
+    summary: "Declare a scheduled post",
+    description: "The agent declares a job, or redeclares it: `name`, the member's standing `thread` it posts to (by slug), the `desk` that runs it, `times` (`HH:MM`, at most 12), `everyMinutes` (15 to 10080) and `weekdays`, and `level` with a `levelNote`. A new key makes the job (level `today` unless given); a known one updates it, keeping the member's level and pause. A thread the member doesn't have is a 404. The calling agent is recorded as the one that runs it.",
+    body: putEchoScheduleInputSchema,
+    status: 200,
+    response: { description: "The scheduled post." },
+    errors: { 400: true, 403: NO_USER, 404: "No such thread." }
+  },
+  update: {
+    method: "patch",
+    path: "/echo/schedules/{key}",
+    pathParams: KEY,
+    pathParamSchemas: KEY_SCHEMA,
+    scopes: ["agents:write"],
+    tag: "Agents",
+    summary: "Change a scheduled post's level or pause it",
+    description: "How its posts land (`level`: `now`, `today`, `digest` or `silent`) and whether it runs (`paused`). An unknown key is a 404.",
+    body: updateEchoScheduleInputSchema,
+    status: 200,
+    response: { description: "The scheduled post." },
+    errors: { 400: true, 403: NO_USER, 404: true }
+  },
+  runNow: {
+    method: "post",
+    path: "/echo/schedules/{key}/run",
+    pathParams: KEY,
+    pathParamSchemas: KEY_SCHEMA,
+    scopes: ["agents:write"],
+    tag: "Agents",
+    summary: "Ask for a scheduled post now",
+    description: "Asks the agent to run the job now: it reads `runRequested` on the job until it reports the run. A paused job is a 409. An unknown key is a 404.",
+    status: 200,
+    response: { description: "The scheduled post." },
+    errors: { 403: NO_USER, 404: true, 409: "The job is paused." }
+  },
+  report: {
+    method: "post",
+    path: "/echo/schedules/{key}/runs",
+    pathParams: KEY,
+    pathParamSchemas: KEY_SCHEMA,
+    scopes: ["agents:write"],
+    tag: "Agents",
+    summary: "Report a scheduled post's run",
+    description: "The agent says how a run went (`status`: `ok`, `failed`, or `unanswered` for a check-in nobody answered), with a short `note` and when (`at`, default now). It clears a run asked for. An unknown key is a 404.",
+    body: reportEchoScheduleRunInputSchema,
+    status: 200,
+    response: { description: "The scheduled post." },
+    errors: { 400: true, 403: NO_USER, 404: true }
+  },
+  remove: {
+    method: "delete",
+    path: "/echo/schedules/{key}",
+    pathParams: KEY,
+    pathParamSchemas: KEY_SCHEMA,
+    scopes: ["agents:write"],
+    tag: "Agents",
+    summary: "Remove a scheduled post",
+    description: "The agent no longer runs the job. An unknown key is a 404.",
+    status: 204,
+    response: { description: "Removed." },
+    errors: { 403: NO_USER, 404: true }
+  }
+});
+
 // ../../packages/schema/src/contracts/echo-threads.ts
 var echoTurnStatusSchema = _enum2(["streaming", "done", "error", "cancelled"]);
 var echoTurnConfirmationSchema = agentConfirmationSchema.extend({
@@ -28825,7 +29087,7 @@ var createEchoThreadInputSchema = object({
 }).strict();
 
 // ../../packages/schema/src/operations/echo-threads.ts
-var NO_USER = "The key has no user identity (threads are per member).";
+var NO_USER2 = "The key has no user identity (threads are per member).";
 var echoThreadOperations = defineOperations({
   list: {
     method: "get",
@@ -28846,7 +29108,7 @@ var echoThreadOperations = defineOperations({
     querySchema: echoThreadsQuerySchema,
     status: 200,
     response: { description: "The member's threads.", list: true },
-    errors: { 400: true, 403: NO_USER }
+    errors: { 400: true, 403: NO_USER2 }
   },
   create: {
     method: "post",
@@ -28859,7 +29121,7 @@ var echoThreadOperations = defineOperations({
     bodyOptional: true,
     status: 201,
     response: { description: "The new current thread." },
-    errors: { 403: NO_USER }
+    errors: { 403: NO_USER2 }
   },
   current: {
     method: "get",
@@ -28870,7 +29132,7 @@ var echoThreadOperations = defineOperations({
     description: "The thread the agent panel opens on (the most recently used), with its turns oldest first: question, reply, `status` (`streaming` | `done` | `error` | `cancelled`), the change-feed cursor `since`, the changes and the confirmations. `{ thread: null }` before the first.",
     status: 200,
     response: { description: "`{ thread }`." },
-    errors: { 403: NO_USER }
+    errors: { 403: NO_USER2 }
   },
   briefs: {
     method: "get",
@@ -28890,7 +29152,7 @@ var echoThreadOperations = defineOperations({
     querySchema: echoBriefsQuerySchema,
     status: 200,
     response: { description: "`{ briefs }`." },
-    errors: { 400: true, 403: NO_USER }
+    errors: { 400: true, 403: NO_USER2 }
   },
   get: {
     method: "get",
@@ -28901,7 +29163,7 @@ var echoThreadOperations = defineOperations({
     description: "One of the member's threads with its turns, oldest first. Another member's thread is a 404.",
     status: 200,
     response: { description: "The thread." },
-    errors: { 403: NO_USER, 404: true }
+    errors: { 403: NO_USER2, 404: true }
   },
   update: {
     method: "patch",
@@ -28913,7 +29175,7 @@ var echoThreadOperations = defineOperations({
     body: updateEchoThreadInputSchema,
     status: 200,
     response: { description: "The thread as the list shows it, with its `push`." },
-    errors: { 400: true, 403: NO_USER, 404: true }
+    errors: { 400: true, 403: NO_USER2, 404: true }
   },
   addStanding: {
     method: "post",
@@ -28925,7 +29187,7 @@ var echoThreadOperations = defineOperations({
     body: createStandingThreadInputSchema,
     status: 201,
     response: { description: "The standing thread." },
-    errors: { 400: true, 403: NO_USER, 409: true }
+    errors: { 400: true, 403: NO_USER2, 409: true }
   }
 });
 
@@ -34101,6 +34363,10 @@ var houseAssetSchema = object({
   readings: array(assetReadingSchema).default([]),
   loans: array(houseLoanSchema).default([])
 });
+var houseProjectSchema = object({
+  id: string2(),
+  linked: array(houseAssetLinkSchema)
+});
 var setAssetVisibilityInputSchema = object({ visibility: _enum2(NODE_VISIBILITY_VALUES) }).strict();
 var linkAssetPartInputSchema = object({ inventoryItemId: ulidSchema }).strict();
 var lendAssetInputSchema = object({
@@ -44636,7 +44902,7 @@ var PART_LABEL = {
   evening: "Evening",
   anytime: "Any time today"
 };
-function clock(at, timezone) {
+function clock2(at, timezone) {
   return new Intl.DateTimeFormat("en-GB", {
     timeZone: timezone,
     hour: "2-digit",
@@ -44667,7 +44933,7 @@ function habitLines(day, mode) {
       if (h.week)
         meta.push(`${h.week.done} of ${h.week.target} this week`);
       if (h.last?.by && civilDay(h.last.at, day.timezone) === day.date) {
-        meta.push(`${h.last.by}, ${clock(h.last.at, day.timezone)}`);
+        meta.push(`${h.last.by}, ${clock2(h.last.at, day.timezone)}`);
       }
       const tail = meta.length > 0 ? paint(mode, "dim", ` \xB7 ${meta.join(" \xB7 ")}`) : "";
       lines.push(`  ${mark} ${h.title}${tail}  ${paint(mode, "dim", h.habitId)}`);
@@ -50408,10 +50674,205 @@ var commands16 = [
   }
 ];
 
+// src/commands/echo-schedules.ts
+var LEVELS = ["now", "today", "digest", "silent"];
+var STATUSES = ["ok", "failed", "unanswered"];
+var DAYS = ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
+var KEY_ARG = {
+  name: "key",
+  required: true,
+  description: "The job's handle (`wake`, `pings`): lower-case letters, digits and dashes."
+};
+function oneOf(value, allowed, what) {
+  if (!allowed.includes(value))
+    throw usageError(`${what} is one of ${allowed.join(", ")}`);
+  return value;
+}
+function weekdaysOf(days) {
+  return days.split(",").map((d) => {
+    const i = DAYS.indexOf(d.trim().toLowerCase().slice(0, 3));
+    if (i < 0)
+      throw usageError(`--days takes mon,tue,\u2026,sun; got "${d}"`);
+    return i + 1;
+  });
+}
+var keyPath = (op, args) => pathOf(op, { key: requireArg(args, 0, "job key") });
+var commands17 = [
+  {
+    spec: {
+      path: ["echo", "schedules", "list"],
+      summary: "List your scheduled posts: the agent's jobs on a clock, by name.",
+      args: [],
+      flags: [],
+      scopes: [...echoScheduleOperations.list.scopes],
+      returns: "EchoSchedule[]",
+      notes: "times are HH:MM on your wall clock; everyMinutes repeats from the first; paused jobs don't run; runRequested asks for a run now."
+    },
+    run: async ({ requireClient }) => ({
+      data: await requireClient().getPage(pathOf(echoScheduleOperations.list)),
+      render: renderList
+    })
+  },
+  {
+    spec: {
+      path: ["echo", "schedules", "set"],
+      summary: "Declare a scheduled post (the agent's): a new key makes it, a known key updates it.",
+      args: [KEY_ARG],
+      flags: [
+        { name: "name", type: "string", description: "What it's called (Wake message)." },
+        {
+          name: "thread",
+          type: "string",
+          description: "The standing thread it posts to, by slug."
+        },
+        { name: "at", type: "string", description: "When, HH:MM, comma-separated (07:00,16:30)." },
+        {
+          name: "every",
+          type: "string",
+          description: "Repeat every N minutes from the first time."
+        },
+        { name: "days", type: "string", description: "Only on these days: mon,tue,\u2026,sun." },
+        { name: "desk", type: "string", description: "The desk that runs it (build)." },
+        {
+          name: "level",
+          type: "string",
+          description: "A new job's level: now, today, digest or silent."
+        },
+        {
+          name: "note",
+          type: "string",
+          description: "A word on the level (Now only on an incident)."
+        }
+      ],
+      scopes: [...echoScheduleOperations.put.scopes],
+      returns: "EchoSchedule",
+      notes: "A redeclare keeps your level and pause. An unknown thread is a 404."
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const name = flagString(flags, "name");
+      const thread = flagString(flags, "thread");
+      const at = flagString(flags, "at");
+      if (!name || !thread || !at)
+        throw usageError("--name, --thread and --at are required");
+      const every = flagString(flags, "every");
+      const days = flagString(flags, "days");
+      const desk = flagString(flags, "desk");
+      const level = flagString(flags, "level");
+      const note = flagString(flags, "note");
+      return {
+        data: await requireClient().put(keyPath(echoScheduleOperations.put, args), {
+          name,
+          thread,
+          times: at.split(",").map((t) => t.trim()),
+          ...every ? { everyMinutes: Number(every) } : {},
+          ...days ? { weekdays: weekdaysOf(days) } : {},
+          ...desk ? { desk } : {},
+          ...level ? { level: oneOf(level, LEVELS, "--level") } : {},
+          ...note ? { levelNote: note } : {}
+        }),
+        render: renderRecord
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["echo", "schedules", "level"],
+      summary: "Set how a scheduled post lands: now, today, digest or silent.",
+      args: [
+        KEY_ARG,
+        { name: "level", required: true, description: "now, today, digest or silent." }
+      ],
+      flags: [],
+      scopes: [...echoScheduleOperations.update.scopes],
+      returns: "EchoSchedule",
+      notes: "now pushes; today is a card in its thread; digest folds into one line; silent stays in its history."
+    },
+    run: async ({ args, requireClient }) => ({
+      data: await requireClient().patch(keyPath(echoScheduleOperations.update, args), {
+        level: oneOf(requireArg(args, 1, "level"), LEVELS, "level")
+      }),
+      render: renderRecord
+    })
+  },
+  ...["pause", "resume"].map((verb) => ({
+    spec: {
+      path: ["echo", "schedules", verb],
+      summary: verb === "pause" ? "Pause a scheduled post: the agent skips it." : "Resume a paused scheduled post.",
+      args: [KEY_ARG],
+      flags: [],
+      scopes: [...echoScheduleOperations.update.scopes],
+      returns: "EchoSchedule",
+      notes: "An unknown key is a 404."
+    },
+    run: async ({ args, requireClient }) => ({
+      data: await requireClient().patch(keyPath(echoScheduleOperations.update, args), {
+        paused: verb === "pause"
+      }),
+      render: renderRecord
+    })
+  })),
+  {
+    spec: {
+      path: ["echo", "schedules", "run"],
+      summary: "Ask the agent to run a scheduled post now.",
+      args: [KEY_ARG],
+      flags: [],
+      scopes: [...echoScheduleOperations.runNow.scopes],
+      returns: "EchoSchedule",
+      notes: "The job reads runRequested until the agent reports a run. A paused job is a 409."
+    },
+    run: async ({ args, requireClient }) => ({
+      data: await requireClient().post(keyPath(echoScheduleOperations.runNow, args), {}),
+      render: renderRecord
+    })
+  },
+  {
+    spec: {
+      path: ["echo", "schedules", "ran"],
+      summary: "Report a scheduled post's run (the agent's): ok, failed or unanswered.",
+      args: [KEY_ARG, { name: "status", required: true, description: "ok, failed or unanswered." }],
+      flags: [
+        { name: "note", type: "string", description: "A word on the run (2 differences)." },
+        { name: "at", type: "string", description: "When it ran (ISO); default now." }
+      ],
+      scopes: [...echoScheduleOperations.report.scopes],
+      returns: "EchoSchedule",
+      notes: "Clears a run asked for."
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const note = flagString(flags, "note");
+      const at = flagString(flags, "at");
+      return {
+        data: await requireClient().post(keyPath(echoScheduleOperations.report, args), {
+          status: oneOf(requireArg(args, 1, "status"), STATUSES, "status"),
+          ...note ? { note } : {},
+          ...at ? { at } : {}
+        }),
+        render: renderRecord
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["echo", "schedules", "rm"],
+      summary: "Remove a scheduled post (the agent no longer runs it).",
+      args: [KEY_ARG],
+      flags: [],
+      scopes: [...echoScheduleOperations.remove.scopes],
+      returns: "nothing",
+      notes: "An unknown key is a 404."
+    },
+    run: async ({ args, requireClient }) => {
+      await requireClient().delete(keyPath(echoScheduleOperations.remove, args));
+      return { data: { removed: requireArg(args, 0, "job key") }, render: renderRecord };
+    }
+  }
+];
+
 // src/commands/files.ts
 import { readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "fs";
 import { basename as basename2 } from "path";
-var commands17 = [
+var commands18 = [
   {
     spec: {
       path: ["files", "list"],
@@ -50581,7 +51042,7 @@ var commands17 = [
 ];
 
 // src/commands/food.ts
-var commands18 = [
+var commands19 = [
   {
     spec: {
       path: ["foods", "search"],
@@ -51136,7 +51597,7 @@ var commands18 = [
 // src/commands/guest-lists.ts
 import { writeFileSync as writeFileSync3 } from "fs";
 import { basename as basename3 } from "path";
-var commands19 = [
+var commands20 = [
   {
     spec: {
       path: ["guest-lists", "overview"],
@@ -51226,7 +51687,7 @@ var commands19 = [
 ];
 
 // src/commands/guests.ts
-var commands20 = [
+var commands21 = [
   {
     spec: {
       path: ["guests", "sent"],
@@ -51311,7 +51772,7 @@ function renderItems(data, mode) {
 var habitArg = { name: "id", required: true, description: "The checklist habit's ULID." };
 var itemArg = { name: "item-id", required: true, description: "The item's ULID." };
 var NOT_CHECKLIST = "A habit that isn't a checklist answers 409.";
-var commands21 = [
+var commands22 = [
   {
     spec: {
       path: ["habit", "items"],
@@ -51665,7 +52126,7 @@ function seasonFromFlags(flags) {
   const season = flagString(flags, "season");
   return season === undefined ? {} : { activeMonths: seasonFromFlag(season) };
 }
-var commands22 = [
+var commands23 = [
   {
     spec: {
       path: ["habits", "create"],
@@ -52914,7 +53375,7 @@ function healthRecordHandlers() {
   }
   return out;
 }
-var commands23 = pairCommands(HEALTH_COMMAND_SPECS, {
+var commands24 = pairCommands(HEALTH_COMMAND_SPECS, {
   ...healthRecordHandlers(),
   "health record": async ({ flags, requireClient }) => {
     const body = parseInput(logHealthInputSchema, readDataFlag(flags));
@@ -53229,7 +53690,7 @@ var commands23 = pairCommands(HEALTH_COMMAND_SPECS, {
 });
 
 // src/commands/house.ts
-var commands24 = [
+var commands25 = [
   {
     spec: {
       path: ["house"],
@@ -53511,7 +53972,7 @@ function renderSorting(data, _mode) {
   ].join(`
 `);
 }
-var commands25 = [
+var commands26 = [
   defineCommand({
     operation: inboxOperations.list,
     path: ["inbox"],
@@ -53603,7 +54064,7 @@ var commands25 = [
 ];
 
 // src/commands/incidents.ts
-var commands26 = [
+var commands27 = [
   {
     spec: {
       path: ["incidents", "open"],
@@ -53832,7 +54293,7 @@ function journalDateArg(args, verb) {
   }
   return date;
 }
-var commands27 = [
+var commands28 = [
   defineCommand({
     operation: journalOperations.day,
     path: ["journal", "day"],
@@ -54395,7 +54856,7 @@ function renderCreatedKey(data, mode) {
   ].join(`
 `);
 }
-var commands28 = [
+var commands29 = [
   {
     spec: {
       path: ["keys", "list"],
@@ -54531,7 +54992,7 @@ var KIND_FLAG2 = {
   type: "string",
   description: "The kind of an unknown word (pages, eggs, health, note, or a word taught before); remembered for the Space."
 };
-var commands29 = [
+var commands30 = [
   {
     spec: {
       path: ["log"],
@@ -54606,7 +55067,7 @@ var commands29 = [
 ];
 
 // src/commands/mail-campaigns.ts
-var commands30 = [
+var commands31 = [
   {
     spec: {
       path: ["mail-campaigns", "list"],
@@ -54921,7 +55382,7 @@ async function serveMcp(io, target) {
 }
 
 // src/commands/mcp.ts
-var commands31 = [
+var commands32 = [
   {
     spec: {
       path: ["mcp"],
@@ -54966,7 +55427,7 @@ var commands31 = [
 ];
 
 // src/commands/members.ts
-var commands32 = [
+var commands33 = [
   {
     spec: {
       path: ["invite", "create"],
@@ -55091,7 +55552,7 @@ var commands32 = [
 ];
 
 // src/commands/metrics.ts
-var commands33 = [
+var commands34 = [
   {
     spec: {
       path: ["metrics", "list"],
@@ -55219,7 +55680,7 @@ async function setModuleVisibility(args, requireClient, on) {
     render: renderRecord
   };
 }
-var commands34 = [
+var commands35 = [
   {
     spec: {
       path: ["modules", "list"],
@@ -55448,7 +55909,7 @@ function shareFlag(flags) {
 function localMonth(now) {
   return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}`;
 }
-var commands35 = [
+var commands36 = [
   defineCommand({
     operation: moneyOperations.listAccounts,
     path: ["money", "accounts"],
@@ -56617,7 +57078,7 @@ var commands35 = [
 ];
 
 // src/commands/notes.ts
-var commands36 = [
+var commands37 = [
   {
     spec: {
       path: ["notes", "backlinks"],
@@ -56739,7 +57200,7 @@ var commands36 = [
 ];
 
 // src/commands/orca.ts
-var commands37 = [
+var commands38 = [
   {
     spec: {
       path: ["orca", "list"],
@@ -57105,7 +57566,7 @@ function linkBody(args) {
     return parseInput(familyTreeLinkInputSchema, { kind, a: ref, b: other });
   throw usageError("the kind is parent, child or partner");
 }
-var commands38 = [
+var commands39 = [
   {
     spec: {
       path: ["people", "propose"],
@@ -57794,7 +58255,7 @@ var commands38 = [
 
 // src/commands/places.ts
 import { readFileSync as readFileSync10 } from "fs";
-var commands39 = [
+var commands40 = [
   {
     spec: {
       path: ["places", "import"],
@@ -57851,7 +58312,7 @@ async function planDecision({ args, requireClient }, verb) {
     render: renderPlan
   };
 }
-var commands40 = [
+var commands41 = [
   {
     spec: {
       path: ["plans", "list"],
@@ -58078,7 +58539,7 @@ var commands40 = [
 ];
 
 // src/commands/presets.ts
-var commands41 = [
+var commands42 = [
   {
     spec: {
       path: ["presets", "list"],
@@ -58175,7 +58636,7 @@ function renderReviewSummary(data, mode) {
   return out.join(`
 `);
 }
-var commands42 = [
+var commands43 = [
   {
     spec: {
       path: ["progress"],
@@ -58384,7 +58845,7 @@ function renderUpdates(data, mode) {
   return updates.map((u) => updateLine(u, mode)).join(`
 `);
 }
-var commands43 = [
+var commands44 = [
   defineCommand({
     operation: projectOperations.update,
     path: ["projects", "set"],
@@ -58981,7 +59442,7 @@ var routineCommands = [
     }
   }
 ];
-var commands44 = [
+var commands45 = [
   ...routineCommands,
   {
     spec: {
@@ -59104,7 +59565,7 @@ var commands44 = [
 ];
 
 // src/commands/rsvp-answers.ts
-var commands45 = [
+var commands46 = [
   {
     spec: {
       path: ["rsvp-answers", "list"],
@@ -59158,7 +59619,7 @@ var commands45 = [
 ];
 
 // src/commands/rsvp-links.ts
-var commands46 = [
+var commands47 = [
   {
     spec: {
       path: ["rsvp-links", "list"],
@@ -59254,7 +59715,7 @@ var commands46 = [
 ];
 
 // src/commands/rsvp-questions.ts
-var commands47 = [
+var commands48 = [
   {
     spec: {
       path: ["rsvp-questions", "presets"],
@@ -59826,7 +60287,7 @@ function sessionFlags(flags) {
     body.occurredOn = on;
   return body;
 }
-var commands48 = [
+var commands49 = [
   {
     spec: {
       path: ["runs", "change"],
@@ -60143,7 +60604,7 @@ var commands48 = [
 ];
 
 // src/commands/search.ts
-var commands49 = [
+var commands50 = [
   {
     spec: {
       path: ["search"],
@@ -60176,7 +60637,7 @@ var commands49 = [
 ];
 
 // src/commands/seating-proposals.ts
-var commands50 = [
+var commands51 = [
   {
     spec: {
       path: ["seating-proposals", "list"],
@@ -60263,7 +60724,7 @@ var commands50 = [
 ];
 
 // src/commands/sensors.ts
-var commands51 = [
+var commands52 = [
   {
     spec: {
       path: ["sensors", "status"],
@@ -60423,7 +60884,7 @@ var commands51 = [
 ];
 
 // src/commands/settings.ts
-var commands52 = [
+var commands53 = [
   {
     spec: {
       path: ["settings", "get"],
@@ -60457,7 +60918,7 @@ var commands52 = [
 ];
 
 // src/commands/sharing.ts
-var commands53 = [
+var commands54 = [
   {
     spec: {
       path: ["share"],
@@ -60590,7 +61051,7 @@ var commands53 = [
 ];
 
 // src/commands/space.ts
-var commands54 = [
+var commands55 = [
   {
     spec: {
       path: ["space", "address"],
@@ -60646,7 +61107,7 @@ var commands54 = [
 ];
 
 // src/commands/tap-tags.ts
-var commands55 = [
+var commands56 = [
   {
     spec: {
       path: ["tap-tags", "tap"],
@@ -60674,7 +61135,7 @@ var BY = {
   type: "string",
   description: "The blocking task's ref (DO-147) or ULID."
 };
-var commands56 = [
+var commands57 = [
   defineCommand({
     operation: taskBlockOperations.addBlocker,
     path: ["tasks", "block"],
@@ -60740,7 +61201,7 @@ function renderSeries(data, mode) {
   }).join(`
 `);
 }
-var commands57 = [
+var commands58 = [
   defineCommand({
     operation: taskSeriesOperations.make,
     path: ["tasks", "make-series"],
@@ -60895,7 +61356,7 @@ function repeatFromFlags(flags) {
     out.anchor = "from_completion";
   return out;
 }
-var commands58 = [
+var commands59 = [
   {
     spec: {
       path: ["capture"],
@@ -61353,7 +61814,7 @@ var commands58 = [
 ];
 
 // src/commands/time-blocks.ts
-var commands59 = [
+var commands60 = [
   {
     spec: {
       path: ["time-blocks", "record"],
@@ -61545,7 +62006,7 @@ function renderLandedCounts(data, mode) {
   return out.join(`
 `);
 }
-var commands60 = [
+var commands61 = [
   {
     spec: {
       path: ["today"],
@@ -61917,7 +62378,7 @@ function renderViews(data, mode) {
 function renderView(data, mode) {
   return renderViews([data], mode);
 }
-var commands61 = [
+var commands62 = [
   defineCommand({
     operation: workViewOperations.list,
     path: ["views", "list"],
@@ -62036,7 +62497,7 @@ var commands61 = [
 ];
 
 // src/commands/worktree-links.ts
-var commands62 = [
+var commands63 = [
   {
     spec: {
       path: ["worktree-links", "list"],
@@ -62204,7 +62665,8 @@ var FEATURE_COMMANDS = [
   ...commands59,
   ...commands60,
   ...commands61,
-  ...commands62
+  ...commands62,
+  ...commands63
 ];
 
 // src/registry.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.418.0",
+  "version": "1.420.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "homepage": "https://github.com/robbeverhelst/do/tree/main/apps/cli",