@robbeverhelst/do 1.181.0 → 1.182.0

package/dist/do.js

@@ -20279,6 +20279,25 @@ var runStatusSchema = _enum2(["running", "needs_you", "done", "failed", "stopped
 var externalIdSchema = string2().min(1).max(200).regex(/^[\x21-\x7e]+$/, "printable ASCII without spaces");
 var AGENT_POST_TEXT_MAX = 64000;
 var postTextSchema = string2().max(AGENT_POST_TEXT_MAX);
+var briefVerbSchema = object({
+  label: string2().trim().min(1).max(24),
+  href: string2().max(2000).regex(/^(\/(?!\/)|https:\/\/)/, "a path in do (`/tasks`) or an https link").optional(),
+  say: string2().trim().min(1).max(500).optional()
+}).strict().refine((v) => v.href === undefined !== (v.say === undefined), {
+  message: "a verb has either href or say"
+});
+var briefRowSchema = object({
+  text: string2().trim().min(1).max(200),
+  meta: string2().trim().max(200).optional(),
+  icon: string2().max(24).optional(),
+  verb: briefVerbSchema.optional()
+}).strict();
+var BRIEF_ROWS_MAX = 8;
+var briefSchema = object({
+  label: string2().trim().min(1).max(40),
+  title: string2().trim().min(1).max(200),
+  rows: array(briefRowSchema).max(BRIEF_ROWS_MAX).default([])
+}).strict();
 var gatewayMemberSchema = object({
   id: string2().min(1),
   name: string2(),
@@ -20326,15 +20345,17 @@ var agentPostInputSchema = object({
   attachments: array(ulidSchema).max(20).default([]),
   final: boolean3().default(true),
   run: postRunSchema.optional(),
-  recovered: boolean3().optional()
+  recovered: boolean3().optional(),
+  brief: briefSchema.optional()
 });
 var agentPostEditSchema = object({
   text: postTextSchema.optional(),
   final: boolean3().optional(),
   level: postLevelSchema.optional(),
-  run: postRunSchema.optional()
+  run: postRunSchema.optional(),
+  brief: briefSchema.optional()
 }).refine((e) => Object.values(e).some((v) => v !== undefined), {
-  message: "send text, final, level or run"
+  message: "send text, final, level, run or brief"
 });
 var agentPostResultSchema = object({ postId: ulidSchema, created: boolean3() });
 var promptOptionSchema = object({
@@ -21651,7 +21672,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.181.0";
+var VERSION = "1.182.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -23089,6 +23110,11 @@ var COMMAND_SPECS = [
         type: "boolean",
         description: "Not final yet (a reply still being edited)."
       },
+      {
+        name: "brief",
+        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: "edit", type: "string", description: "Edit this post (its id) instead: its text." },
       { name: "delete", type: "string", description: "Take this post (its id) back." }
     ],
@@ -23138,6 +23164,11 @@ var COMMAND_SPECS = [
         type: "boolean",
         description: "Not final yet (a reply still being edited)."
       },
+      {
+        name: "brief",
+        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: "edit", type: "string", description: "Edit this post (its id) instead: its text." },
       { name: "delete", type: "string", description: "Take this post (its id) back." }
     ],
@@ -23197,6 +23228,21 @@ var COMMAND_SPECS = [
     returns: "EchoThreadSummary",
     notes: "For later and Silent posts never push. The home thread and conversations start at all, a standing thread you add at needs_you."
   },
+  {
+    path: ["echo", "briefs"],
+    summary: "Show today's briefs from the agent, as Now shows them.",
+    args: [],
+    flags: [
+      {
+        name: "since",
+        type: "string",
+        description: "ISO 8601: where your day starts (default: local midnight)."
+      }
+    ],
+    scopes: ["agents:read"],
+    returns: "{ briefs: EchoBriefCard[] }",
+    notes: "Brief posts with sections, oldest first, at most 12; silent ones and archived threads are left out."
+  },
   {
     path: ["echo", "threads", "add"],
     summary: "Add a standing thread of your own (Build, Business), pinned under the agent's.",
@@ -25858,6 +25904,13 @@ var HANDLERS = {
     }),
     render: renderRecord
   }),
+  "echo briefs": async ({ flags, requireClient }) => {
+    const since = flagString(flags, "since") ?? startOfToday().toISOString();
+    return {
+      data: await requireClient().get("/echo/threads/briefs", { query: { since } }),
+      render: renderRecord
+    };
+  },
   "echo threads add": echoThreadAdd,
   "echo thread add": echoThreadAdd,
   "echo threads rename": async ({ args, requireClient }) => {
@@ -26416,6 +26469,10 @@ function standardLink(flags) {
     return { kind: "metric", key: metric };
   return null;
 }
+function startOfToday() {
+  const now = new Date;
+  return new Date(now.getFullYear(), now.getMonth(), now.getDate());
+}
 async function echoThreadAdd({ args, flags, requireClient }) {
   const title = args.join(" ").trim();
   if (!title)
@@ -26540,12 +26597,14 @@ async function agentPost({ io, args, flags, requireClient }) {
     return { data: { ok: true, deleted: remove }, render: renderRecord };
   }
   const text = await postText(io, args);
+  const brief = flagString(flags, "brief") === undefined ? undefined : readDataFlag(flags, "brief");
   const edit = flagString(flags, "edit");
   if (edit !== undefined) {
     const body = parseInput(agentPostEditSchema, {
       text,
       ...flagBool(flags, "draft") ? { final: false } : {},
-      level: flagString(flags, "level")
+      level: flagString(flags, "level"),
+      brief
     });
     return {
       data: await client.patch(`/agent/posts/${encodeURIComponent(edit)}`, body),
@@ -26558,9 +26617,10 @@ async function agentPost({ io, args, flags, requireClient }) {
     externalId: flagString(flags, "external-id") ?? `cli:${ulid3()}`,
     thread: ULID.test(thread) ? { id: thread.toUpperCase() } : { slug: thread, ...member ? { memberId: member } : {} },
     text,
-    kind: flagString(flags, "kind"),
+    kind: flagString(flags, "kind") ?? (brief ? "brief" : undefined),
     level: flagString(flags, "level"),
-    final: !flagBool(flags, "draft")
+    final: !flagBool(flags, "draft"),
+    brief
   });
   return { data: await client.post("/agent/posts", body), render: renderRecord };
 }
@@ -26616,18 +26676,18 @@ function mergePreview(before, changes) {
   }
   return changes;
 }
-function readDataFlag(flags) {
-  const raw = flagString(flags, "data");
+function readDataFlag(flags, name = "data") {
+  const raw = flagString(flags, name);
   if (raw === undefined)
     return {};
   let parsed;
   try {
     parsed = JSON.parse(raw);
   } catch (err) {
-    throw usageError(`--data is not valid JSON: ${err.message}`);
+    throw usageError(`--${name} is not valid JSON: ${err.message}`);
   }
   if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw usageError("--data must be a JSON object");
+    throw usageError(`--${name} must be a JSON object`);
   }
   return parsed;
 }

package/package.json

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