@robbeverhelst/do 1.366.0 → 1.368.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.366.0";
+var VERSION = "1.368.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -19520,6 +19520,233 @@ 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 postCardHandoffSchema = object({
+  from: line2,
+  to: line2,
+  what: string2().trim().min(1).max(2000),
+  sub: line2.optional(),
+  state: _enum2(["stuck", "seen", "picked"]),
+  reassignHref: href.optional()
+});
+var postCardDecisionSchema = object({
+  text: string2().trim().min(1).max(2000),
+  when: line2.optional(),
+  by: line2.optional()
+});
+var postCardInvoiceSchema = object({
+  title: line2,
+  to: line2,
+  due: line2,
+  state: _enum2(["draft", "sent", "paid"]),
+  amount: string2().trim().min(1).max(40),
+  lines: words.optional(),
+  sentAt: line2.optional(),
+  paidAt: line2.optional(),
+  editHref: href.optional()
+});
+var postCardMailSchema = object({
+  subject: line2,
+  to: line2,
+  from: line2.optional(),
+  state: _enum2(["draft", "sent"]).default("draft"),
+  text: string2().max(8000),
+  note: line2.optional(),
+  sentAt: line2.optional(),
+  undoUntil: line2.optional()
+});
+var postCardLinkSchema = object({
+  href,
+  site: line2,
+  title: line2,
+  desc: words.optional(),
+  image: href.optional()
+});
+var postCardFileSchema = object({
+  name: line2,
+  meta: line2.optional(),
+  preview: union([
+    object({ kind: literal("pdf"), title: line2 }),
+    object({ kind: literal("text"), text: string2().max(2000) })
+  ]).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,
+  handoff: postCardHandoffSchema,
+  decision: postCardDecisionSchema,
+  invoice: postCardInvoiceSchema,
+  mail: postCardMailSchema,
+  link: postCardLinkSchema,
+  file: postCardFileSchema
+};
+
 // ../../packages/schema/src/contracts/agent-gateway.ts
 var AGENT_GATEWAY_VERSION = 1;
 var AGENT_GATEWAY_MAX_FRAME_BYTES = 1024 * 1024;
@@ -19570,13 +19797,52 @@ var postCardTypeSchema = _enum2([
   "decision",
   "answer"
 ]);
+var postDigestKeySchema = string2().trim().min(1).max(40);
 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 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"),
+  pinned("handoff"),
+  pinned("decision"),
+  pinned("invoice"),
+  pinned("mail"),
+  pinned("link"),
+  pinned("file"),
+  object({
+    type: postCardTypeSchema.exclude([
+      "text",
+      "brief",
+      "run",
+      "deploy",
+      "ask",
+      "pr",
+      "digest",
+      "chips",
+      "table",
+      "chart",
+      "report",
+      "handoff",
+      "decision",
+      "invoice",
+      "mail",
+      "link",
+      "file"
+    ]),
+    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),
@@ -19690,6 +19956,7 @@ var agentPostInputSchema = object({
   recovered: boolean2().optional(),
   brief: briefSchema.optional(),
   card: postCardSchema.optional(),
+  digestKey: postDigestKeySchema.optional(),
   receipt: postReceiptInputSchema.optional()
 });
 var agentPostEditSchema = object({
@@ -27335,6 +27602,7 @@ var echoPostSchema = object({
   updatedAt: exports_coerce.date(),
   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"]);
@@ -43853,7 +44121,8 @@ async function agentPost({
     level: flagString(flags, "level"),
     final: !flagBool(flags, "draft"),
     brief,
-    card
+    card,
+    digestKey: flagString(flags, "digest-key")
   });
   return { data: await client.post(pathOf(agentPostOperations.post), body), render: renderRecord };
 }
@@ -44566,6 +44835,11 @@ var commands = [
           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." }
       ],
@@ -47912,6 +48186,11 @@ var commands16 = [
           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." }
       ],

package/package.json

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