@robbeverhelst/do 1.365.0 → 1.366.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.366.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)
@@ -19540,6 +19544,39 @@ 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 POST_CARD_DATA_MAX = 16000;
+var postCardSchema = object({
+  type: postCardTypeSchema,
+  data: record(string2(), unknown()).default({}).refine((d) => JSON.stringify(d).length <= POST_CARD_DATA_MAX, {
+    message: `a card's data is at most ${POST_CARD_DATA_MAX} characters as JSON`
+  })
+});
 var briefSchema = object({
   label: string2().trim().min(1).max(40),
   title: string2().trim().min(1).max(200),
@@ -19652,6 +19689,7 @@ var agentPostInputSchema = object({
   run: postRunSchema.optional(),
   recovered: boolean2().optional(),
   brief: briefSchema.optional(),
+  card: postCardSchema.optional(),
   receipt: postReceiptInputSchema.optional()
 });
 var agentPostEditSchema = object({
@@ -19660,9 +19698,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 +21403,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 +21468,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 +21542,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 +21561,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 +21684,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 +22699,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 +22789,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 +22811,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 +22824,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 +24199,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 +24270,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 +24289,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 +24318,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 +24338,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 +27307,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 +27333,43 @@ 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),
+  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 +27384,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 +27431,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 +27465,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 +27486,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 +27541,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 +27553,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 +43828,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 +43849,11 @@ 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
   });
   return { data: await client.post(pathOf(agentPostOperations.post), body), render: renderRecord };
 }
@@ -44445,6 +44561,11 @@ 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: "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 +47801,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 +47826,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 +47907,11 @@ 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: "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 +47970,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 +48090,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 +48111,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 +48144,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 +51916,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 +51929,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.366.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",