@robbeverhelst/do 1.365.0 → 1.367.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.365.0";
+var VERSION = "1.367.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -18024,6 +18024,7 @@ var habits = pgTable("habits", {
   sourceMetric: text("source_metric"),
   aliases: text("aliases").array().notNull().default(sql`'{}'::text[]`),
   timeOfDay: text("time_of_day"),
+  dayTimes: jsonb("day_times").$type(),
   pausedFrom: date5("paused_from", { mode: "string" }),
   pausedUntil: date5("paused_until", { mode: "string" }),
   remind: boolean4("remind").notNull().default(false),
@@ -18130,7 +18131,8 @@ var routines = pgTable("routines", {
   restingUntil: date5("resting_until", { mode: "string" }),
   icon: text("icon"),
   keptNotice: text("kept_notice"),
-  dayTimes: jsonb("day_times").$type().notNull().default({})
+  dayTimes: jsonb("day_times").$type().notNull().default({}),
+  durationMinutes: integer2("duration_minutes")
 }, (t) => [
   index("routines_tenant_idx").on(t.tenantId),
   index("routines_tenant_area_idx").on(t.tenantId, t.areaId)
@@ -19158,9 +19160,11 @@ var saveAgentConnectionInputSchema = object({
   message: "a connection without an endpoint names its agent",
   path: ["agentId"]
 });
+var ECHO_PAGE_LABEL_MAX = 120;
 var agentPageContextSchema = object({
   route: string2().trim().min(1).max(500).startsWith("/"),
   nodeId: string2().trim().min(1).max(64).nullable(),
+  page: string2().trim().min(1).max(ECHO_PAGE_LABEL_MAX).optional(),
   focusArea: object({
     id: string2().trim().min(1).max(64),
     title: string2().trim().min(1).max(200)
@@ -19516,6 +19520,177 @@ var linkGoogleInputSchema = object({
   state: string2().min(1)
 });
 
+// ../../packages/schema/src/contracts/post-cards.ts
+var line2 = string2().trim().min(1).max(200);
+var words = string2().trim().max(2000);
+var href = string2().trim().min(1).max(2000);
+var postCardWhoSchema = object({
+  name: line2,
+  av: union([
+    object({
+      kind: literal("initials"),
+      text: string2().trim().min(1).max(3),
+      tone: _enum2(["you", "plum", "sky", "sea", "sun", "cc", "cx", "clay", "mist"])
+    }),
+    object({ kind: _enum2(["echo", "job", "system"]) })
+  ])
+});
+var postCardStepSchema = object({
+  label: line2,
+  state: _enum2(["done", "running", "failed", "waiting", "queued"]),
+  at: string2().trim().max(20).optional(),
+  detail: words.optional()
+});
+var postCardTextSchema = object({ markdown: string2().max(8000) });
+var postCardBriefSchema = object({
+  title: line2,
+  sub: line2.optional(),
+  read: line2.optional(),
+  sections: array(object({
+    title: line2,
+    n: union([string2().max(20), number2()]).optional(),
+    body: string2().max(4000)
+  })).min(1).max(12),
+  open: array(number2().int().nonnegative()).max(12).optional()
+});
+var postCardRunSchema = object({
+  kind: _enum2(["kanban", "job", "session"]).optional(),
+  title: line2,
+  agent: postCardWhoSchema,
+  machine: line2,
+  account: line2.optional(),
+  since: line2.optional(),
+  state: _enum2(["queued", "running", "paused", "waiting", "done", "failed", "stopped"]),
+  stateText: line2.optional(),
+  now: words.optional(),
+  progress: number2().min(0).max(1).optional(),
+  progressText: line2.optional(),
+  steps: array(postCardStepSchema).max(30).optional(),
+  outputs: array(object({ icon: string2().max(24), label: line2, href })).max(12).optional()
+});
+var postCardDeploySchema = object({
+  title: line2,
+  sub: line2.optional(),
+  state: _enum2(["running", "live", "failed", "queued"]),
+  steps: array(postCardStepSchema).max(30),
+  siteHref: href.optional(),
+  logsHref: href.optional()
+});
+var postCardAskSchema = object({
+  kind: _enum2(["approval", "question", "review"]),
+  state: _enum2(["open", "answered", "expired", "snoozed", "delegated"]).default("open"),
+  from: postCardWhoSchema,
+  title: line2,
+  detail: words.optional(),
+  code: string2().max(4000).optional(),
+  why: words.optional(),
+  risk: literal("high").optional(),
+  expires: object({
+    at: exports_iso.datetime({ offset: true }),
+    windowS: number2().int().positive().max(7 * 24 * 3600).optional(),
+    note: words.optional()
+  }).optional(),
+  yes: line2.optional(),
+  no: line2.optional(),
+  options: array(object({ label: line2, sub: line2.optional() })).max(12).optional(),
+  multi: boolean2().optional(),
+  submit: line2.optional(),
+  acts: array(object({ label: line2, primary: boolean2().optional(), href: href.optional() })).max(6).optional(),
+  done: object({
+    answer: line2.optional(),
+    answeredAt: line2.optional(),
+    expiredAt: line2.optional(),
+    expiredWhat: words.optional(),
+    until: line2.optional(),
+    delegatedWhat: words.optional()
+  }).optional()
+});
+var postCardPrSchema = object({
+  title: line2,
+  repo: line2,
+  num: union([string2().trim().min(1).max(20), number2().int().positive()]),
+  branch: line2.optional(),
+  state: _enum2(["checks", "ready", "red", "merged", "draft", "closed"]),
+  add: string2().max(20),
+  del: string2().max(20),
+  files: string2().max(20),
+  by: postCardWhoSchema.optional(),
+  checks: array(object({
+    name: line2,
+    state: string2().trim().min(1).max(20),
+    note: string2().max(40).optional()
+  })).max(40).optional(),
+  mergedAt: line2.optional(),
+  mergedBy: line2.optional(),
+  href: href.optional()
+});
+var postCardDigestSchema = object({
+  title: line2,
+  sub: line2,
+  items: array(object({
+    id: string2().trim().min(1).max(64).optional(),
+    at: string2().trim().max(20),
+    text: line2
+  })).min(1).max(50)
+});
+var postCardChipsSchema = object({
+  items: array(object({
+    id: string2().trim().min(1).max(64).optional(),
+    kind: _enum2(["task", "habit", "event"]).optional(),
+    title: line2,
+    meta: line2.optional(),
+    done: boolean2().optional(),
+    href: href.optional()
+  })).min(1).max(20)
+});
+var tableBody = object({
+  label: line2.optional(),
+  cols: array(string2().trim().max(60)).min(1).max(12),
+  rows: array(array(string2().max(500)).min(1).max(12)).max(100),
+  num: array(number2().int().nonnegative()).max(12).optional()
+}).refine((t) => t.rows.every((r) => r.length <= t.cols.length), {
+  message: "a row has at most as many cells as there are columns"
+}).refine((t) => new Set(t.rows.map((r) => r[0])).size === t.rows.length, {
+  message: "each row's head is its own"
+});
+var bars = array(object({
+  label: line2,
+  value: number2(),
+  tone: _enum2(["warn", "err"]).optional(),
+  text: string2().max(20).optional()
+})).min(1).max(30);
+var postCardTableSchema = object({ title: line2.optional(), sub: line2.optional() }).and(tableBody);
+var postCardChartSchema = object({
+  title: line2,
+  sub: line2.optional(),
+  label: line2,
+  bars
+});
+var postCardReportSchema = object({
+  title: line2,
+  sub: line2.optional(),
+  state: string2().trim().min(1).max(20).optional(),
+  stateText: line2.optional(),
+  lead: string2().max(4000),
+  stats: array(tuple([string2().trim().max(20), line2])).max(8).optional(),
+  chart: object({ label: line2, bars }).optional(),
+  table: tableBody.optional(),
+  href: href.optional()
+});
+var POST_CARD_DATA = {
+  text: postCardTextSchema,
+  brief: postCardBriefSchema,
+  run: postCardRunSchema,
+  deploy: postCardDeploySchema,
+  ask: postCardAskSchema,
+  pr: postCardPrSchema,
+  digest: postCardDigestSchema,
+  chips: postCardChipsSchema,
+  table: postCardTableSchema,
+  chart: postCardChartSchema,
+  report: postCardReportSchema
+};
+
 // ../../packages/schema/src/contracts/agent-gateway.ts
 var AGENT_GATEWAY_VERSION = 1;
 var AGENT_GATEWAY_MAX_FRAME_BYTES = 1024 * 1024;
@@ -19540,6 +19715,66 @@ var briefRowSchema = object({
   verb: briefVerbSchema.optional()
 }).strict();
 var BRIEF_ROWS_MAX = 8;
+var postCardTypeSchema = _enum2([
+  "text",
+  "brief",
+  "report",
+  "table",
+  "chart",
+  "pr",
+  "deploy",
+  "run",
+  "compare",
+  "gallery",
+  "design",
+  "chip",
+  "chips",
+  "invoice",
+  "mail",
+  "link",
+  "file",
+  "voice",
+  "code",
+  "ask",
+  "digest",
+  "handoff",
+  "decision",
+  "answer"
+]);
+var postDigestKeySchema = string2().trim().min(1).max(40);
+var POST_CARD_DATA_MAX = 16000;
+var withinLimit = (d) => JSON.stringify(d ?? {}).length <= POST_CARD_DATA_MAX;
+var LIMIT = `a card's data is at most ${POST_CARD_DATA_MAX} characters as JSON`;
+var pinned = (type) => object({ type: literal(type), data: POST_CARD_DATA[type] });
+var postCardSchema = discriminatedUnion("type", [
+  pinned("text"),
+  pinned("brief"),
+  pinned("run"),
+  pinned("deploy"),
+  pinned("ask"),
+  pinned("pr"),
+  pinned("digest"),
+  pinned("chips"),
+  pinned("table"),
+  pinned("chart"),
+  pinned("report"),
+  object({
+    type: postCardTypeSchema.exclude([
+      "text",
+      "brief",
+      "run",
+      "deploy",
+      "ask",
+      "pr",
+      "digest",
+      "chips",
+      "table",
+      "chart",
+      "report"
+    ]),
+    data: record(string2(), unknown()).default({})
+  })
+]).refine((card) => withinLimit(card.data), { message: LIMIT, path: ["data"] });
 var briefSchema = object({
   label: string2().trim().min(1).max(40),
   title: string2().trim().min(1).max(200),
@@ -19652,6 +19887,8 @@ var agentPostInputSchema = object({
   run: postRunSchema.optional(),
   recovered: boolean2().optional(),
   brief: briefSchema.optional(),
+  card: postCardSchema.optional(),
+  digestKey: postDigestKeySchema.optional(),
   receipt: postReceiptInputSchema.optional()
 });
 var agentPostEditSchema = object({
@@ -19660,9 +19897,10 @@ var agentPostEditSchema = object({
   final: boolean2().optional(),
   level: postLevelSchema.optional(),
   run: postRunSchema.optional(),
-  brief: briefSchema.optional()
+  brief: briefSchema.optional(),
+  card: postCardSchema.optional()
 }).refine((e) => Object.values(e).some((v) => v !== undefined), {
-  message: "send text, title, final, level, run or brief"
+  message: "send text, title, final, level, run, brief or card"
 });
 var agentPostResultSchema = object({ postId: ulidSchema, created: boolean2() });
 var promptOptionSchema = object({
@@ -21364,6 +21602,7 @@ var occurrenceSchema = createSelectSchema(occurrences, {
   completedAt: exports_coerce.date().nullable()
 });
 var byDayCodeSchema = _enum2(["MO", "TU", "WE", "TH", "FR", "SA", "SU"]);
+var weekdayTimesSchema = partialRecord(byDayCodeSchema, string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/));
 var byDayOrdinalSchema = _enum2(["1", "2", "3", "4", "-1"]);
 var byDaySchema = union([
   byDayCodeSchema,
@@ -21428,6 +21667,7 @@ var habitSchema = createSelectSchema(habits, {
   sourceMetric: string2().nullable().default(null),
   aliases: array(string2()).default([]),
   timeOfDay: string2().nullable().default(null),
+  dayTimes: weekdayTimesSchema.nullish(),
   pausedFrom: exports_iso.date().nullable().default(null),
   pausedUntil: exports_iso.date().nullable().default(null),
   remind: boolean2().default(false),
@@ -21501,6 +21741,7 @@ var createHabitInputSchema = createInsertSchema(habits, {
   areaId: ulidSchema.nullish(),
   aliases: habitAliasesSchema.optional(),
   timeOfDay: habitTimeOfDaySchema.nullish(),
+  dayTimes: weekdayTimesSchema.nullish(),
   remind: boolean2().optional(),
   durationMinutes: habitDurationMinutesSchema.nullish(),
   activeMonths: habitActiveMonthsSchema.optional()
@@ -21519,6 +21760,7 @@ var updateHabitInputSchema = createUpdateSchema(habits, {
   areaId: ulidSchema.nullish(),
   aliases: habitAliasesSchema.optional(),
   timeOfDay: habitTimeOfDaySchema.nullish(),
+  dayTimes: weekdayTimesSchema.nullish(),
   remind: boolean2().optional(),
   durationMinutes: habitDurationMinutesSchema.nullish(),
   activeMonths: habitActiveMonthsSchema.optional()
@@ -21641,7 +21883,8 @@ var habitDueDateSchema = object({
   scheduleLabel: string2().min(1),
   daily: boolean2(),
   streakLabel: string2().min(1),
-  done: boolean2().default(false)
+  done: boolean2().default(false),
+  entryId: string2().nullable().default(null)
 });
 var habitEntriesQuerySchema = object({
   before: exports_coerce.date().optional(),
@@ -22655,7 +22898,7 @@ var projectDetailSchema = projectViewSchema.extend({
 var attachTaskInputSchema = object({ taskId: ulidSchema });
 
 // ../../packages/schema/src/contracts/routines.ts
-var routineDayTimesSchema = partialRecord(_enum2(["MO", "TU", "WE", "TH", "FR", "SA", "SU"]), string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/));
+var routineDayTimesSchema = weekdayTimesSchema;
 var routineSchema = createSelectSchema(routines);
 var routineStepSchema = createSelectSchema(routineSteps, {
   createdAt: exports_coerce.date(),
@@ -22745,8 +22988,10 @@ var routineStepInputSchema = object({
     }
   }
 });
+var routineDurationSchema = number2().int().min(1).max(1440);
 var createRoutineInputSchema = createInsertSchema(routines, {
   id: ulidSchema,
+  durationMinutes: routineDurationSchema.nullish(),
   areaId: ulidSchema.nullish()
 }).omit({ tenantId: true, recurrenceRuleId: true }).extend({
   title: string2().min(1),
@@ -22765,7 +23010,8 @@ var createRoutineInputSchema = createInsertSchema(routines, {
   }
 });
 var updateRoutineInputSchema = createUpdateSchema(routines, {
-  areaId: ulidSchema.nullish()
+  areaId: ulidSchema.nullish(),
+  durationMinutes: routineDurationSchema.nullish()
 }).omit({ id: true, tenantId: true, recurrenceRuleId: true }).extend({
   title: string2().min(1).optional(),
   parentId: ulidSchema.nullish(),
@@ -22777,6 +23023,7 @@ var routineViewSchema = routineSchema.extend({
   icon: string2().nullable().default(null),
   keptNotice: string2().nullable().default(null),
   dayTimes: routineDayTimesSchema.default({}),
+  durationMinutes: number2().int().nullish(),
   title: string2(),
   parentId: ulidSchema.nullable(),
   createdAt: exports_coerce.date(),
@@ -24151,6 +24398,7 @@ var timeBlocks = pgTable("time_blocks", {
   taskId: text("task_id").references(() => tasks.id, { onDelete: "set null" }),
   kind: text("kind", { enum: TIME_BLOCK_KINDS }).notNull().default("focus"),
   lifeKind: text("life_kind", { enum: LIFE_BLOCK_KINDS }),
+  label: text("label"),
   plannedStartAt: timestamp("planned_start_at", { withTimezone: true }),
   plannedEndAt: timestamp("planned_end_at", { withTimezone: true }),
   recurrenceRuleId: text("recurrence_rule_id").references(() => recurrenceRules.id),
@@ -24221,6 +24469,7 @@ var blockEvidence = pgTable("block_evidence", {
 // ../../packages/schema/src/contracts/time-blocks.ts
 var TIME_BLOCK_MAX_MINUTES = 24 * 60;
 var timeBlockSchema = createSelectSchema(timeBlocks, {
+  label: string2().nullish(),
   startAt: exports_coerce.date(),
   endAt: exports_coerce.date(),
   plannedStartAt: exports_coerce.date().nullable(),
@@ -24239,12 +24488,14 @@ var lifeBlockKindSchema = _enum2(LIFE_BLOCK_KINDS);
 var lifeBlockShareSchema = _enum2(["details", "busy"]);
 var lifeBlockSharingSchema = partialRecord(lifeBlockKindSchema, lifeBlockShareSchema);
 var SPAN_MESSAGE = `endAt must be after startAt and at most ${TIME_BLOCK_MAX_MINUTES / 60} hours later`;
+var blockLabelSchema = string2().trim().min(1).max(200);
 var createTimeBlockInputSchema = object({
   id: ulidSchema,
   title: string2().trim().min(1).max(500).optional(),
   taskId: ulidSchema.nullish(),
   lifeKind: lifeBlockKindSchema.optional(),
   routineId: ulidSchema.nullish(),
+  label: blockLabelSchema.nullish(),
   recorded: boolean2().optional(),
   startAt: exports_coerce.date(),
   endAt: exports_coerce.date()
@@ -24266,6 +24517,7 @@ var updateTimeBlockInputSchema = object({
   taskId: ulidSchema.nullish(),
   lifeKind: lifeBlockKindSchema.optional(),
   routineId: ulidSchema.nullish(),
+  label: blockLabelSchema.nullish(),
   startAt: exports_coerce.date().optional(),
   endAt: exports_coerce.date().optional()
 }).strict().refine(validSpan, { message: SPAN_MESSAGE, path: ["endAt"] });
@@ -24285,6 +24537,7 @@ var timeBlockViewSchema = timeBlockSchema.omit({
   recordAskedAt: true
 }).extend({
   title: string2(),
+  label: string2().nullish(),
   task: timeBlockTaskSchema.nullable(),
   status: _enum2(TIME_BLOCK_STATUSES).optional(),
   recordState: _enum2(RECORD_STATES).optional(),
@@ -27253,6 +27506,11 @@ var answerEchoPromptInputSchema = object({
   text: string2().trim().min(1).max(2000).optional(),
   device: echoDeviceSchema.optional()
 }).strict();
+var echoPostContextSchema = object({
+  route: string2(),
+  nodeId: string2().nullable(),
+  page: string2().optional()
+});
 var echoPostSchema = object({
   id: string2(),
   threadId: string2(),
@@ -27274,15 +27532,44 @@ var echoPostSchema = object({
   receipt: postReceiptSchema.nullable().default(null),
   createdAt: exports_coerce.date(),
   updatedAt: exports_coerce.date(),
-  brief: briefSchema.nullable().default(null)
+  brief: briefSchema.nullable().default(null),
+  card: postCardSchema.nullable().default(null),
+  digestKey: string2().nullable().default(null),
+  context: echoPostContextSchema.nullable().default(null)
 });
 var threadPushSchema = _enum2(["needs_you", "all", "off"]);
+var threadKindSchema = _enum2([
+  "personal",
+  "work",
+  "system",
+  "client",
+  "object",
+  "shared"
+]);
+var threadTopicKindSchema = threadKindSchema.extract([
+  "personal",
+  "work",
+  "system",
+  "client"
+]);
+var threadAnchorTypeSchema = _enum2(["task", "project", "habit", "note"]);
+var threadAnchorSchema = object({ type: threadAnchorTypeSchema, id: string2() });
+var threadNotifyLevelSchema = _enum2(["now", "today", "digest", "off"]);
+var threadMemoryScopeSchema = _enum2(["personal", "work", "none", "isolated", "inherit"]);
+var threadIconSchema = string2().regex(/^[a-z][a-z0-9-]{0,23}$/, "an icon is a lowercase icon name");
+var ECHO_THREAD_DESCRIPTION_MAX = 200;
+var threadDescriptionSchema = string2().trim().max(ECHO_THREAD_DESCRIPTION_MAX);
 var echoBriefCardSchema = echoPostSchema.extend({
   brief: briefSchema,
   threadTitle: string2().nullable(),
   threadSlug: string2().nullable()
 });
 var echoBriefsQuerySchema = object({ since: exports_coerce.date() });
+var echoNeedSchema = echoPostSchema.extend({
+  threadTitle: string2().nullable(),
+  threadSlug: string2().nullable()
+});
+var echoNeedsSchema = object({ needs: array(echoNeedSchema) });
 var echoBriefsSchema = object({ briefs: array(echoBriefCardSchema) });
 var echoRunSchema = echoPostSchema.extend({
   threadTitle: string2().nullable()
@@ -27297,6 +27584,17 @@ var echoThreadSummarySchema = object({
   home: boolean2().default(false),
   areaIds: array(string2()).default([]),
   peopleCapture: boolean2().default(true),
+  kind: threadKindSchema.default("personal"),
+  anchor: threadAnchorSchema.nullable().default(null),
+  parentId: string2().nullable().default(null),
+  icon: string2().default("lock"),
+  description: string2().nullable().default(null),
+  memoryScope: threadMemoryScopeSchema.default("personal"),
+  notifyLevel: threadNotifyLevelSchema.default("now"),
+  lastMessageAt: exports_coerce.date().nullable().default(null),
+  lastLine: string2().nullable().default(null),
+  needsYou: number2().int().nonnegative().default(0),
+  unseen: number2().int().nonnegative().default(0),
   turnCount: number2().int(),
   postCount: number2().int().default(0),
   createdAt: exports_coerce.date(),
@@ -27333,17 +27631,30 @@ var threadAreaIdsSchema = array(string2().min(1)).max(ECHO_THREAD_AREAS_MAX);
 var createStandingThreadInputSchema = object({
   title: threadTitleSchema,
   slug: threadSlugSchema.optional(),
-  areaIds: threadAreaIdsSchema.default([])
+  areaIds: threadAreaIdsSchema.default([]),
+  kind: threadTopicKindSchema.optional(),
+  icon: threadIconSchema.optional(),
+  description: threadDescriptionSchema.optional(),
+  memoryScope: threadMemoryScopeSchema.exclude(["inherit"]).optional()
 }).strict();
 var updateEchoThreadInputSchema = object({
   push: threadPushSchema.optional(),
   title: threadTitleSchema.optional(),
   areaIds: threadAreaIdsSchema.optional(),
   archived: boolean2().optional(),
-  peopleCapture: boolean2().optional()
+  peopleCapture: boolean2().optional(),
+  kind: threadTopicKindSchema.optional(),
+  icon: threadIconSchema.optional(),
+  description: threadDescriptionSchema.optional(),
+  memoryScope: threadMemoryScopeSchema.optional()
 }).strict().refine((e) => Object.values(e).some((v) => v !== undefined), {
-  message: "send push, title, areaIds, archived or peopleCapture"
+  message: "send push, title, areaIds, archived, peopleCapture, kind, icon, description or memoryScope"
 });
+var createEchoThreadInputSchema = object({
+  title: threadTitleSchema.optional(),
+  anchor: threadAnchorSchema.optional(),
+  parentId: string2().trim().min(1).max(64).optional()
+}).strict();
 
 // ../../packages/schema/src/operations/echo-threads.ts
 var NO_USER = "The key has no user identity (threads are per member).";
@@ -27354,7 +27665,7 @@ var echoThreadOperations = defineOperations({
     scopes: ["agents:read"],
     tag: "Agents",
     summary: "List agent threads",
-    description: "The member's most recent agent threads, newest first: `id`, `title` (the first question), `turnCount`, `createdAt`, `updatedAt`.",
+    description: "The member's most recent agent threads, newest first: `id`, `title` (the first question), `turnCount`, `createdAt`, `updatedAt`. Each also says what it is for (`kind`: `personal`, `work`, `system`, `client`, `object` or `shared`), the do object it hangs on (`anchor`: `{ type, id }`, null for a topic) and the thread it started from (`parentId`), its `icon`, `description` and `memoryScope` (`personal`, `work`, `none`, `isolated`, `inherit`), the most its posts may push in do v2 (`notifyLevel`: `now`, `today`, `digest` or `off`), when its last message was written (`lastMessageAt`) with that message as one plain line (`lastLine`), and how many of the agent's posts there are unseen (`needsYou` for Needs you, `unseen` for any that isn't silent).",
     query: [
       {
         name: "limit",
@@ -27375,7 +27686,9 @@ var echoThreadOperations = defineOperations({
     scopes: ["agents:write"],
     tag: "Agents",
     summary: "Start a new agent thread",
-    description: "New conversation: a fresh thread that becomes the member's current one. When the current thread has nothing in it yet, that one is returned instead.",
+    description: "New conversation: a fresh thread that becomes the member's current one. When the current thread has nothing in it yet, that one is returned instead. With a body, a new thread (do v2): loose with a `title`, or on a thing of the Space (`anchor`: `{ type: task|project|habit|note, id }`, a 404 when there is no such live thing; titled after it unless a `title` is given), started from one of the member's threads (`parentId`, else a 404). A thing has one thread per member: asking again returns it.",
+    body: createEchoThreadInputSchema,
+    bodyOptional: true,
     status: 201,
     response: { description: "The new current thread." },
     errors: { 403: NO_USER }
@@ -27428,7 +27741,7 @@ var echoThreadOperations = defineOperations({
     scopes: ["agents:write"],
     tag: "Agents",
     summary: "Change an agent thread",
-    description: "What the agent's posts in this thread may push to the member's devices (do-4): `all` (Needs you, and Told quietly), `needs_you` (only what waits on the member) or `off`. For later and Silent posts never push. Returns the thread as the list shows it. Another member's thread is a 404. Rename a thread (`title`), change the Areas a standing thread links (`areaIds`), or archive it (`archived: true`; `false` brings it back). An archived thread leaves the list and its slug no longer reaches it. The home thread (named after the Space's agent) can't be archived.",
+    description: "What the agent's posts in this thread may push to the member's devices (do-4): `all` (Needs you, and Told quietly), `needs_you` (only what waits on the member) or `off`. For later and Silent posts never push. Returns the thread as the list shows it. Another member's thread is a 404. Rename a thread (`title`), change the Areas a standing thread links (`areaIds`), or archive it (`archived: true`; `false` brings it back). An archived thread leaves the list and its slug no longer reaches it. The home thread (named after the Space's agent) can't be archived. Say what a topic is for (`kind`: `personal`, `work`, `system` or `client`); a thread on a thing keeps `object`, a 400. Set its `icon`, its one-line `description` (`\"\"` clears it) and which memory the agent answers with (`memoryScope`: `personal`, `work`, `none`, `isolated` or `inherit`).",
     body: updateEchoThreadInputSchema,
     status: 200,
     response: { description: "The thread as the list shows it, with its `push`." },
@@ -27440,7 +27753,7 @@ var echoThreadOperations = defineOperations({
     scopes: ["agents:write"],
     tag: "Agents",
     summary: "Add a standing thread",
-    description: "A standing thread of the member's own (Build, Business), pinned under the agent's home thread. `slug` is what the agent and scripts address it by (`do echo post --thread build`); it defaults to one made from the title. A slug another live thread has is a 409; an archived thread's brings that thread back.",
+    description: "A standing thread of the member's own (Build, Business), pinned under the agent's home thread. `slug` is what the agent and scripts address it by (`do echo post --thread build`); it defaults to one made from the title. `kind` says what it is for (`personal`, `work`, `system` or `client`; `work` when not given), with an `icon` (a v2 icon name), a one-line `description` and its `memoryScope` (`personal`, `work`, `none` or `isolated`). A slug another live thread has is a 409; an archived thread's brings that thread back.",
     body: createStandingThreadInputSchema,
     status: 201,
     response: { description: "The standing thread." },
@@ -43715,13 +44028,15 @@ async function agentPost({
   }
   const text = await postText(io, args);
   const brief = flagString(flags, "brief") === undefined ? undefined : readDataFlag(flags, "brief");
+  const card = flagString(flags, "card") === undefined ? undefined : readDataFlag(flags, "card");
   const edit = flagString(flags, "edit");
   if (edit !== undefined) {
     const body = parseInput(agentPostEditSchema, {
       text,
       ...flagBool(flags, "draft") ? { final: false } : {},
       level: flagString(flags, "level"),
-      brief
+      brief,
+      card
     });
     return {
       data: await client.patch(pathOf(agentPostOperations.edit, { postId: edit }), body),
@@ -43734,10 +44049,12 @@ async function agentPost({
     externalId: flagString(flags, "external-id") ?? `cli:${ulid3()}`,
     thread: ULID.test(thread) ? { id: thread.toUpperCase() } : { slug: thread, ...member ? { memberId: member } : {} },
     text,
-    kind: flagString(flags, "kind") ?? (brief ? "brief" : undefined),
+    kind: flagString(flags, "kind") ?? (brief ? "brief" : card ? "card" : undefined),
     level: flagString(flags, "level"),
     final: !flagBool(flags, "draft"),
-    brief
+    brief,
+    card,
+    digestKey: flagString(flags, "digest-key")
   });
   return { data: await client.post(pathOf(agentPostOperations.post), body), render: renderRecord };
 }
@@ -44445,6 +44762,16 @@ var commands = [
           type: "string",
           description: `A brief's sections as JSON: {"label":"HQ brief","title":"\u2026","rows":[{"text":"\u2026","meta":"\u2026","icon":"tasks","verb":{"label":"Start","href":"/tasks"}}]} (a verb has href or say). Makes the post a brief; shows as a card on Now until the day ends.`
         },
+        {
+          name: "card",
+          type: "string",
+          description: `A typed card as JSON: {"type":"pr","data":{\u2026}} (do v2's Echo draws it by type, else the text). Makes the post a card; the same --external-id changes it in place.`
+        },
+        {
+          name: "digest-key",
+          type: "string",
+          description: "A quiet post's noun (`heartbeat`): with --level for_later, do v2 folds such posts into one digest line."
+        },
         { name: "edit", type: "string", description: "Edit this post (its id) instead: its text." },
         { name: "delete", type: "string", description: "Take this post (its id) back." }
       ],
@@ -47680,11 +48007,16 @@ async function echoThreadAdd({ args, flags, requireClient }) {
     throw usageError("missing required argument: <title>");
   const slug = flagString(flags, "slug");
   const areas = flagString(flags, "areas");
+  const kind = flagString(flags, "kind");
+  if (kind !== undefined)
+    topicKind(kind);
   return {
     data: await requireClient().post(pathOf(echoThreadOperations.addStanding), {
       title,
       ...slug ? { slug } : {},
-      ...areas === undefined ? {} : { areaIds: splitList(areas) }
+      ...areas === undefined ? {} : { areaIds: splitList(areas) },
+      ...kind ? { kind } : {},
+      ...aboutOf(flags)
     }),
     render: renderEchoThread
   };
@@ -47700,6 +48032,44 @@ async function echoThreadId(client, ref) {
     throw usageError(`no thread \`${ref}\` (see \`do echo threads list\`)`);
   return found.id;
 }
+var TOPIC_KINDS = ["personal", "work", "system", "client"];
+function topicKind(value) {
+  if (!TOPIC_KINDS.includes(value)) {
+    throw usageError(`kind is one of ${TOPIC_KINDS.join(", ")}`);
+  }
+  return value;
+}
+function anchorOf(value) {
+  const [type, id] = value.split(":");
+  if (!type || !id || !["task", "project", "habit", "note"].includes(type)) {
+    throw usageError("--on is type:id, the type one of task, project, habit, note");
+  }
+  return { type, id };
+}
+var KIND_FLAG = {
+  name: "kind",
+  type: "string",
+  description: "What it is for: personal, work (default), system or client."
+};
+var ABOUT_FLAGS = [
+  { name: "icon", type: "string", description: "Its icon in the list (`wrench`)." },
+  { name: "about", type: "string", description: "One line on what it is for." },
+  {
+    name: "memory",
+    type: "string",
+    description: "Which memory the agent answers with: personal, work, none or isolated."
+  }
+];
+function aboutOf(flags) {
+  const icon = flagString(flags, "icon");
+  const description = flagString(flags, "about");
+  const memoryScope = flagString(flags, "memory");
+  return {
+    ...icon ? { icon } : {},
+    ...description === undefined ? {} : { description },
+    ...memoryScope ? { memoryScope } : {}
+  };
+}
 function splitList(value) {
   return value.split(",").map((v) => v.trim()).filter((v) => v.length > 0);
 }
@@ -47743,6 +48113,16 @@ var commands16 = [
           type: "string",
           description: `A brief's sections as JSON: {"label":"HQ brief","title":"\u2026","rows":[{"text":"\u2026","meta":"\u2026","icon":"tasks","verb":{"label":"Start","href":"/tasks"}}]} (a verb has href or say). Makes the post a brief; shows as a card on Now until the day ends.`
         },
+        {
+          name: "card",
+          type: "string",
+          description: `A typed card as JSON: {"type":"pr","data":{\u2026}} (do v2's Echo draws it by type, else the text). Makes the post a card; the same --external-id changes it in place.`
+        },
+        {
+          name: "digest-key",
+          type: "string",
+          description: "A quiet post's noun (`heartbeat`): with --level for_later, do v2 folds such posts into one digest line."
+        },
         { name: "edit", type: "string", description: "Edit this post (its id) instead: its text." },
         { name: "delete", type: "string", description: "Take this post (its id) back." }
       ],
@@ -47801,15 +48181,37 @@ var commands16 = [
       path: ["echo", "threads", "new"],
       summary: "Start a new agent conversation (it becomes the current thread).",
       args: [],
-      flags: [],
+      flags: [
+        { name: "title", type: "string", description: "Its name: a loose thread (do v2)." },
+        {
+          name: "on",
+          type: "string",
+          description: "A thing it hangs on, as type:id (task:01J\u2026, project, habit or note)."
+        },
+        {
+          name: "from",
+          type: "string",
+          description: "The thread it starts from (id or slug): a thread on a thing takes its memory."
+        }
+      ],
       scopes: [...echoThreadOperations.create.scopes],
       returns: "EchoThread",
-      notes: "When the current thread is still empty, that one is returned instead."
+      notes: "Without flags: when the current thread is still empty, that one is returned instead. A thing has one thread per member: --on again returns it."
     },
-    run: async ({ requireClient }) => ({
-      data: await requireClient().post(pathOf(echoThreadOperations.create), {}),
-      render: renderEchoThread
-    })
+    run: async ({ flags, requireClient }) => {
+      const client = requireClient();
+      const title = flagString(flags, "title");
+      const on = flagString(flags, "on");
+      const from = flagString(flags, "from");
+      return {
+        data: await client.post(pathOf(echoThreadOperations.create), {
+          ...title ? { title } : {},
+          ...on === undefined ? {} : { anchor: anchorOf(on) },
+          ...from ? { parentId: await echoThreadId(client, from) } : {}
+        }),
+        render: renderEchoThread
+      };
+    }
   },
   {
     spec: {
@@ -47899,7 +48301,9 @@ var commands16 = [
           type: "string",
           description: "What the agent and scripts address it by (default: from the title)."
         },
-        { name: "areas", type: "string", description: "Area ids it covers, comma-separated." }
+        { name: "areas", type: "string", description: "Area ids it covers, comma-separated." },
+        KIND_FLAG,
+        ...ABOUT_FLAGS
       ],
       scopes: [...echoThreadOperations.addStanding.scopes],
       returns: "EchoThread",
@@ -47918,7 +48322,9 @@ var commands16 = [
           type: "string",
           description: "What the agent and scripts address it by (default: from the title)."
         },
-        { name: "areas", type: "string", description: "Area ids it covers, comma-separated." }
+        { name: "areas", type: "string", description: "Area ids it covers, comma-separated." },
+        KIND_FLAG,
+        ...ABOUT_FLAGS
       ],
       scopes: [...echoThreadOperations.addStanding.scopes],
       returns: "EchoThread"
@@ -47949,6 +48355,29 @@ var commands16 = [
       };
     }
   },
+  {
+    spec: {
+      path: ["echo", "threads", "kind"],
+      summary: "Say what one of your agent topics is for: personal, work, system or client.",
+      args: [
+        { name: "thread", required: true, description: "Its id, or a standing thread's slug." },
+        { name: "kind", required: true, description: "personal, work, system or client." }
+      ],
+      flags: [],
+      scopes: [...echoThreadOperations.update.scopes],
+      returns: "EchoThreadSummary",
+      notes: "A thread on a thing (a task, a project) keeps its kind, `object`: a 400."
+    },
+    run: async ({ args, requireClient }) => {
+      const client = requireClient();
+      const id = await echoThreadId(client, requireArg(args, 0, "thread"));
+      const kind = topicKind(requireArg(args, 1, "kind"));
+      return {
+        data: await client.patch(pathOf(echoThreadOperations.update, { id }), { kind }),
+        render: renderRecord
+      };
+    }
+  },
   {
     spec: {
       path: ["echo", "threads", "link"],
@@ -51698,7 +52127,7 @@ function renderLogged(data, mode) {
   return rows.map((e) => `${e.at}  ${e.what}  ${paint(mode, "dim", e.where)}`).join(`
 `);
 }
-var KIND_FLAG = {
+var KIND_FLAG2 = {
   name: "kind",
   type: "string",
   description: "The kind of an unknown word (pages, eggs, health, note, or a word taught before); remembered for the Space."
@@ -51711,7 +52140,7 @@ var commands28 = [
       args: [{ name: "line", required: true, description: 'The line, e.g. "pages 34".' }],
       flags: [
         { name: "dry-run", type: "boolean", description: "Preview only; write nothing." },
-        KIND_FLAG,
+        KIND_FLAG2,
         {
           name: "destination",
           type: "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.365.0",
+  "version": "1.367.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",