@robbeverhelst/do 1.307.0 → 1.308.0

package/dist/do.js

@@ -28197,6 +28197,21 @@ var guestListOverviewSchema = object({
     invites: number2().int()
   })
 });
+var rsvpDigestQuerySchema = object({ since: exports_coerce.date().optional() }).strict();
+var rsvpDigestSchema = object({
+  guestListId: string2(),
+  since: exports_coerce.date(),
+  households: array(object({
+    householdId: string2().nullable(),
+    household: string2(),
+    answeredAt: exports_coerce.date(),
+    coming: array(string2()),
+    maybe: array(string2()),
+    notComing: array(string2())
+  })),
+  waiting: number2().int().nonnegative(),
+  text: string2()
+});
 var RSVP_TOKEN_RE = /^rsvp_[A-Za-z0-9_-]{43}$/;
 var RSVP_CODE_ALPHABET = "23456789ABCDEFGHJKMNPQRSTWXYZ";
 var RSVP_CODE_LENGTH = 6;
@@ -28502,7 +28517,7 @@ var mailProviderEventSchema = looseObject({
     }).optional()
   })
 });
-var MAIL_CAMPAIGN_KINDS = ["message", "save_the_date", "invitation"];
+var MAIL_CAMPAIGN_KINDS = ["message", "save_the_date", "invitation", "reminder"];
 var mailCampaignKindSchema = _enum2(MAIL_CAMPAIGN_KINDS);
 var MAIL_TEMPLATES = [
   "message",
@@ -28565,7 +28580,8 @@ var mailRecipientHouseholdSchema = object({
   name: string2(),
   language: mailLanguageSchema,
   addresses: number2().int().nonnegative(),
-  status: householdMailStatusSchema.nullable()
+  status: householdMailStatusSchema.nullable(),
+  link: boolean3().nullable().default(null)
 });
 var mailCampaignViewSchema = mailCampaignSchema.extend({
   households: array(mailRecipientHouseholdSchema),
@@ -31735,6 +31751,21 @@ var guestListOperations = defineOperations({
     response: { description: "`{ toThank, thanked }`." },
     errors: { 404: true }
   },
+  rsvpDigest: {
+    method: "get",
+    path: "/guest-lists/{id}/rsvp-digest",
+    pathParams: list,
+    scopes: ["contacts:read"],
+    tag: "Guests",
+    summary: "The RSVPs that came in",
+    description: "For the agent's daily digest (wedding C8): each household whose answer came in or changed through its RSVP link since `since` (default: the last 24 hours), oldest first, with who's `coming`, `maybe` and `notComing` by name, how many households are still `waiting` (nobody answered yet), and the same as plain lines in `text` (\"Sam & Kai answered. Coming: Sam, Kai.\"). The couple get each answer as a do notification, never a mail.",
+    query: [{ name: "since", description: "An ISO instant; default 24 hours ago." }],
+    querySchema: rsvpDigestQuerySchema,
+    operationId: "get_guest_list_rsvp_digest",
+    status: 200,
+    response: { description: "`{ guestListId, since, households, waiting, text }`." },
+    errors: { 400: true, 404: true }
+  },
   export: {
     method: "get",
     path: "/guest-lists/{id}/exports/{kind}",
@@ -32558,6 +32589,31 @@ var nodeOperations = defineOperations({
   }
 });
 
+// ../../packages/schema/src/operations/notes.ts
+var noteOperations = defineOperations({
+  ...crudOperations({
+    segment: "notes",
+    tag: "Notes",
+    noun: "note",
+    read: "notes:read",
+    write: "notes:write",
+    create: createNoteInputSchema,
+    update: updateNoteInputSchema,
+    view: "Note"
+  }),
+  backlinks: {
+    method: "get",
+    path: "/notes/{id}/backlinks",
+    scopes: ["notes:read"],
+    tag: "Notes",
+    summary: "List backlinks",
+    description: "The notes that link to this note.",
+    status: 200,
+    response: { description: "The backlinking notes." },
+    errors: { 404: true }
+  }
+});
+
 // ../../packages/schema/src/operations/occurrences.ts
 var occurrenceOperations = defineOperations({
   list: {
@@ -34828,7 +34884,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.307.0";
+var VERSION = "1.308.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -35361,26 +35417,17 @@ var ENTITIES = [
     createInput: "CreateRoutineInput",
     updateInput: "UpdateRoutineInput"
   }),
-  {
+  entityFromOperations(noteOperations, {
     name: "notes",
-    path: "/notes",
-    readScopes: ["notes:read"],
     returns: "Note",
-    canGet: true,
     listFlags: [
       { name: "q", description: "full-text search over the title and body", query: "q" },
       { name: "area", description: "filter to notes filed under this area id", query: "areaId" },
       { name: "tag", description: "filter to notes carrying this tag", query: "tag" }
     ],
-    write: {
-      scopes: ["notes:write"],
-      createSchema: createNoteInputSchema,
-      createInput: "CreateNoteInput",
-      updateSchema: updateNoteInputSchema,
-      updateInput: "UpdateNoteInput",
-      canDelete: true
-    }
-  },
+    createInput: "CreateNoteInput",
+    updateInput: "UpdateNoteInput"
+  }),
   {
     name: "contacts",
     path: "/contacts",
@@ -36461,7 +36508,7 @@ var COMMAND_SPECS = [
         description: "How long it takes, in minutes (overrides an estimate in the text)."
       }
     ],
-    scopes: ["tasks:write"],
+    scopes: [...taskOperations.create.scopes],
     returns: "Task",
     grammar: {
       "#tag": "Adds a tag. Repeatable: '#home #urgent'.",
@@ -36477,9 +36524,9 @@ var COMMAND_SPECS = [
     summary: "Show today's actionable tasks (scheduled, due, overdue, in-progress), then the habits and routines due today.",
     args: [],
     flags: [],
-    scopes: ["tasks:read"],
+    scopes: [...taskOperations.list.scopes],
     returns: "TodaySummary",
-    notes: "Tasks are composed client-side from GET /api/v1/tasks (the local day from your clock); habits and routines come from GET /api/v1/habits/today (your saved time zone's day) under `habits`, left out when the key lacks habits:read."
+    notes: `Tasks are composed client-side from ${routeOf(taskOperations.list)} (the local day from your clock); habits and routines come from ${routeOf(habitOperations.today)} (your saved time zone's day) under \`habits\`, left out when the key lacks habits:read.`
   },
   {
     path: ["today", "earlier"],
@@ -36502,9 +36549,9 @@ var COMMAND_SPECS = [
       { name: "ids", required: true, description: "One or more task ids." }
     ],
     flags: [],
-    scopes: ["tasks:write"],
+    scopes: [...todayOperations.rollover.scopes],
     returns: "RolloverResult",
-    notes: "POST /api/v1/today/rollover. `later` reads the day from `do today earlier` first. Let go is cancelled, never done, so it stays out of Landed; undo with `do task reopen`."
+    notes: `${routeOf(todayOperations.rollover)}. \`later\` reads the day from \`do today earlier\` first. Let go is cancelled, never done, so it stays out of Landed; undo with \`do task reopen\`.`
   },
   {
     path: ["now"],
@@ -36960,7 +37007,7 @@ var COMMAND_SPECS = [
         description: "When it was finished (ISO); back-dates completedAt. Default: now."
       }
     ],
-    scopes: ["tasks:write"],
+    scopes: [...new Set([...taskOperations.get.scopes, ...taskOperations.update.scopes])],
     returns: "Task",
     notes: "Sets completedAt (the basis of Landed); --at corrects it on an already-done task."
   },
@@ -37381,7 +37428,7 @@ var COMMAND_SPECS = [
     ],
     scopes: [...habitOperations.checkInByTitle.scopes],
     returns: "HabitSummary",
-    notes: `POST /api/v1/habits/check-in. Title or alias, case-insensitive; several matches \u2192 409 with error.details.candidates (id, title, aliases), none \u2192 404 naming close titles; a habit counted from Google Fit, Strava or GitHub \u2192 409. --set writes the difference to the day's total as its own check-in. An Agent's key records the check-in as that Agent's ("<agent>, 07:12"). --note puts a short note on it ("drill done, felt heavy" \u2192 --note "felt heavy"); the reply's lastCheckIn.id is the check-in, for \`do habit note\` later.`
+    notes: `${routeOf(habitOperations.checkInByTitle)}. Title or alias, case-insensitive; several matches \u2192 409 with error.details.candidates (id, title, aliases), none \u2192 404 naming close titles; a habit counted from Google Fit, Strava or GitHub \u2192 409. --set writes the difference to the day's total as its own check-in. An Agent's key records the check-in as that Agent's ("<agent>, 07:12"). --note puts a short note on it ("drill done, felt heavy" \u2192 --note "felt heavy"); the reply's lastCheckIn.id is the check-in, for \`do habit note\` later.`
   },
   {
     path: ["habit", "alias", "add"],
@@ -37393,7 +37440,7 @@ var COMMAND_SPECS = [
     flags: [],
     scopes: [...habitOperations.addAlias.scopes],
     returns: "HabitSummary",
-    notes: "POST /api/v1/habits/:id/aliases. One already there (ignoring case) is a no-op; at most 12."
+    notes: `${routeOf(habitOperations.addAlias)}. One already there (ignoring case) is a no-op; at most 12.`
   },
   {
     path: ["habit", "alias", "rm"],
@@ -37405,7 +37452,7 @@ var COMMAND_SPECS = [
     flags: [],
     scopes: [...habitOperations.removeAlias.scopes],
     returns: "HabitSummary",
-    notes: "DELETE /api/v1/habits/:id/aliases/:alias. 404 when the habit doesn't have it."
+    notes: `${routeOf(habitOperations.removeAlias)}. 404 when the habit doesn't have it.`
   },
   {
     path: ["habits", "today"],
@@ -37568,7 +37615,7 @@ var COMMAND_SPECS = [
     ],
     scopes: ["habits:read", "habits:write"],
     returns: "AwayState",
-    notes: "GET/PUT /api/v1/habits/away. While away, habits leave Now, reminders stop and plants wait; tasks and events carry on. Reading needs habits:read, setting habits:write."
+    notes: `${habitOperations.getAway.method.toUpperCase()}/${routeOf(habitOperations.setAway)}. While away, habits leave Now, reminders stop and plants wait; tasks and events carry on. Reading needs habits:read, setting habits:write.`
   },
   {
     path: ["tap-tags", "tap"],
@@ -37855,7 +37902,7 @@ var COMMAND_SPECS = [
     summary: "List the notes/entities whose body [[wikilinks]] reference a note.",
     args: [{ name: "id", required: true, description: "Note (node) ULID." }],
     flags: [],
-    scopes: ["notes:read"],
+    scopes: [...noteOperations.backlinks.scopes],
     returns: "Backlink",
     notes: "The reverse of the links a note's body declares; cross-entity."
   },
@@ -38011,7 +38058,7 @@ var COMMAND_SPECS = [
     ],
     scopes: [...worktreeLinkOperations.set.scopes],
     returns: "WorktreeLink",
-    notes: "PUT /api/v1/worktree-links/{node}. --host and --worktree are required."
+    notes: `${routeOf(worktreeLinkOperations.set)}. --host and --worktree are required.`
   },
   {
     path: ["worktree-links", "clear"],
@@ -38725,16 +38772,16 @@ var COMMAND_SPECS = [
     summary: "List feature-modules and whether each is enabled for the caller.",
     args: [],
     flags: [],
-    scopes: ["settings:read"],
+    scopes: [...settingsOperations.get.scopes],
     returns: "ModuleStatus",
-    notes: "Reads enabledModules from GET /api/v1/settings; an empty set means every module is on."
+    notes: `Reads enabledModules from ${routeOf(settingsOperations.get)}; an empty set means every module is on.`
   },
   {
     path: ["modules", "enable"],
     summary: "Enable a feature-module (surfaces it in nav / quick-add / \u2318K).",
     args: [{ name: "key", required: true, description: "Module key (see `do modules list`)." }],
     flags: [],
-    scopes: ["settings:read", "settings:write"],
+    scopes: [...new Set([...settingsOperations.get.scopes, ...settingsOperations.update.scopes])],
     returns: "UserSettings",
     notes: "Reads then patches settings; only the module visibility list changes."
   },
@@ -38743,7 +38790,7 @@ var COMMAND_SPECS = [
     summary: "Disable a feature-module (hides its surfaces \u2014 nothing is deleted).",
     args: [{ name: "key", required: true, description: "Module key (see `do modules list`)." }],
     flags: [],
-    scopes: ["settings:read", "settings:write"],
+    scopes: [...new Set([...settingsOperations.get.scopes, ...settingsOperations.update.scopes])],
     returns: "UserSettings",
     notes: "Reads then patches settings; only the module visibility list changes."
   },
@@ -38784,7 +38831,7 @@ var COMMAND_SPECS = [
     flags: [],
     scopes: [...collectionOperations.types.scopes],
     returns: "CollectionTypeSummary",
-    notes: "The Type registry is code-defined (ADR 0017); served from GET /api/v1/collection/types."
+    notes: `The Type registry is code-defined (ADR 0017); served from ${routeOf(collectionOperations.types)}.`
   },
   {
     path: ["collection", "list"],
@@ -39104,16 +39151,16 @@ var COMMAND_SPECS = [
     summary: "Focus on one Area for the rest of the day: Now, Tasks and Calendar show only it.",
     args: [{ name: "id", required: false, description: "Area ULID (omit with --off)." }],
     flags: [{ name: "off", type: "boolean", description: "Show everything again." }],
-    scopes: ["settings:write"],
+    scopes: [...settingsOperations.update.scopes],
     returns: "UserSettings",
-    notes: "PATCH /api/v1/settings { focusAreaId }. Clears itself at the end of the member's day (focusUntil); hidden tasks don't move or go overdue."
+    notes: `${routeOf(settingsOperations.update)} { focusAreaId }. Clears itself at the end of the member's day (focusUntil); hidden tasks don't move or go overdue.`
   },
   {
     path: ["areas", "pin"],
     summary: "Pin an Area under Life in the desktop sidebar (up to five).",
     args: [{ name: "id", required: true, description: "Area ULID." }],
     flags: [],
-    scopes: ["settings:read", "settings:write"],
+    scopes: [...new Set([...settingsOperations.get.scopes, ...settingsOperations.update.scopes])],
     returns: "UserSettings",
     notes: "Reads then patches settings.pinnedAreaIds; a pinned Area stays where it is."
   },
@@ -39122,7 +39169,7 @@ var COMMAND_SPECS = [
     summary: "Take an Area out of the desktop sidebar.",
     args: [{ name: "id", required: true, description: "Area ULID." }],
     flags: [],
-    scopes: ["settings:read", "settings:write"],
+    scopes: [...new Set([...settingsOperations.get.scopes, ...settingsOperations.update.scopes])],
     returns: "UserSettings",
     notes: "Reads then patches settings.pinnedAreaIds."
   },
@@ -40779,6 +40826,17 @@ var COMMAND_SPECS = [
     returns: "ThankYouView",
     notes: 'Log a gift as a gift_received moment with sourceNodeId = the project: `do contact-moments create --data \'{"contactId":"<id>","kind":"gift_received","summary":"a moka pot","sourceNodeId":"<project>"}\'`. Mark the card sent: `do contact-moments update <id> --data \'{"thankedAt":"2027-07-10"}\'`.'
   },
+  {
+    path: ["guest-lists", "rsvp-digest"],
+    summary: "The RSVPs that came in since a moment (default the last 24 hours), for a daily digest.",
+    args: [{ name: "id", required: true, description: "The guest list's id." }],
+    flags: [
+      { name: "since", type: "string", description: "An ISO instant; default 24 hours ago." }
+    ],
+    scopes: [...guestListOperations.rsvpDigest.scopes],
+    returns: "RsvpDigest",
+    notes: "Each household that answered or changed its answer, with who's coming, maybe and not coming by name, how many households still wait, and the same as plain lines in `text`. The couple get each answer as a do notification, never a mail."
+  },
   {
     path: ["guest-lists", "export"],
     summary: "Export for the caterer, the venue, the church or the RSVP answers (CSV) to stdout, or save the floor plan or the paper invitations (PDF) to a file.",
@@ -41108,7 +41166,7 @@ var COMMAND_SPECS = [
     ],
     scopes: [],
     returns: "LoginResult",
-    notes: "Writes ~/.config/do/config.json (0600) after a successful GET /api/v1/whoami."
+    notes: `Writes ~/.config/do/config.json (0600) after a successful ${routeOf(whoamiOperations.whoami)}.`
   },
   {
     path: ["config", "set"],
@@ -43322,7 +43380,7 @@ var HANDLERS = {
       ...duration ? { durationMinutes: duration } : {}
     });
     const client = requireClient();
-    const task = await client.post("/tasks", input);
+    const task = await client.post(pathOf(taskOperations.create), input);
     if (parsed.recurrence) {
       const rule = parseInput(createRecurrenceRuleInputSchema, {
         templateId: id,
@@ -43337,13 +43395,13 @@ var HANDLERS = {
     const tasks = [];
     let cursor;
     do {
-      const page = await client.getPage("/tasks", {
+      const page = await client.getPage(pathOf(taskOperations.list), {
         query: { filter: "all", cursor }
       });
       tasks.push(...page.data);
       cursor = page.nextCursor ?? undefined;
     } while (cursor);
-    const habits = await client.get("/habits/today").catch((error) => {
+    const habits = await client.get(pathOf(habitOperations.today)).catch((error) => {
       if (error instanceof CliError && (error.code === "auth" || error.exitCode === EXIT.NOT_FOUND))
         return;
       throw error;
@@ -43381,7 +43439,7 @@ var HANDLERS = {
       to = today.toISOString();
       body = { action: "reschedule", to, taskIds };
     } else if (answer === "later") {
-      const earlier = await client.get("/today/from-earlier", {
+      const earlier = await client.get(pathOf(todayOperations.fromEarlier), {
         query: { from: today.toISOString() }
       });
       to = earlier.laterThisWeek;
@@ -43389,7 +43447,7 @@ var HANDLERS = {
     } else {
       body = { action: answer === "someday" ? "someday" : "drop", taskIds };
     }
-    const result = await client.post("/today/rollover", body);
+    const result = await client.post(pathOf(todayOperations.rollover), body);
     return {
       data: { answer, ...to ? { to } : {}, ...result },
       render: renderFromEarlierAnswer
@@ -44300,7 +44358,7 @@ var HANDLERS = {
   "notes backlinks": async ({ args, requireClient }) => {
     const id = requireArg(args, 0, "note id");
     return {
-      data: await requireClient().get(`/notes/${id}/backlinks`),
+      data: await requireClient().get(pathOf(noteOperations.backlinks, { id })),
       render: renderList
     };
   },
@@ -44308,14 +44366,17 @@ var HANDLERS = {
     const id = requireArg(args, 0, "task id");
     const at = flagString(flags, "at");
     const client = requireClient();
-    const current = await client.get(`/tasks/${id}`);
+    const current = await client.get(pathOf(taskOperations.get, { id }));
     if (current.status === "done" && at === undefined)
       return { data: current, render: renderTask };
     const body = parseInput(updateTaskInputSchema, {
       status: "done",
       ...at !== undefined ? { completedAt: at } : {}
     });
-    return { data: await client.patch(`/tasks/${id}`, body), render: renderTask };
+    return {
+      data: await client.patch(pathOf(taskOperations.update, { id }), body),
+      render: renderTask
+    };
   },
   "task cancel": async ({ args, requireClient }) => {
     const id = requireArg(args, 0, "task id");
@@ -44720,10 +44781,16 @@ var HANDLERS = {
     if (off && until)
       throw usageError("`do away off` comes back now; it takes no --until");
     if (!off && !until) {
-      return { data: await requireClient().get("/habits/away"), render: renderAway };
+      return {
+        data: await requireClient().get(pathOf(habitOperations.getAway)),
+        render: renderAway
+      };
     }
     const input = parseInput(awayInputSchema, { until: off ? null : until });
-    return { data: await requireClient().put("/habits/away", input), render: renderAway };
+    return {
+      data: await requireClient().put(pathOf(habitOperations.setAway), input),
+      render: renderAway
+    };
   },
   "routine done": async ({ args, requireClient }) => {
     const id = requireArg(args, 0, "routine id");
@@ -44927,7 +44994,7 @@ var HANDLERS = {
     };
   },
   "modules list": async ({ requireClient }) => {
-    const settings = await requireClient().get("/settings");
+    const settings = await requireClient().get(pathOf(settingsOperations.get));
     const enabled = new Set(effectiveEnabledModules(settings.enabledModules));
     const rows = FEATURE_MODULES.map((module) => ({
       key: module.key,
@@ -45206,7 +45273,10 @@ var HANDLERS = {
     if (id === undefined)
       throw usageError("areas focus needs an area id, or --off to show everything");
     const body = parseInput(updateUserSettingsInputSchema, { focusAreaId: id });
-    return { data: await requireClient().patch("/settings", body), render: renderRecord };
+    return {
+      data: await requireClient().patch(pathOf(settingsOperations.update), body),
+      render: renderRecord
+    };
   },
   "areas pin": async ({ args, requireClient }) => setAreaPinned(args, requireClient, true),
   "areas unpin": async ({ args, requireClient }) => setAreaPinned(args, requireClient, false),
@@ -45900,7 +45970,7 @@ var HANDLERS = {
       const input = await saveUpload(path);
       if (dryRun)
         return { ...input, screenshot: input.screenshot ? "(png)" : null };
-      return requireClient().post(`/runs/${id}/save-header`, input);
+      return requireClient().post(pathOf(runOperations.uploadSaveHeader, { id }), input);
     };
     if (!flagBool(flags, "watch")) {
       return { data: await send(await resolveSave(target)), render: renderRecord };
@@ -46642,6 +46712,17 @@ var HANDLERS = {
       render: renderRecord
     };
   },
+  "guest-lists rsvp-digest": async ({ args, flags, requireClient }) => {
+    const id = requireArg(args, 0, "guest list id");
+    const since = flagString(flags, "since");
+    const query = parseInput(rsvpDigestQuerySchema, since ? { since } : {});
+    return {
+      data: await requireClient().get(pathOf(guestListOperations.rsvpDigest, { id }), {
+        query: query.since ? { since: query.since.toISOString() } : {}
+      }),
+      render: renderRecord
+    };
+  },
   "guest-lists export": async ({ args, flags, requireClient }) => {
     const id = requireArg(args, 0, "guest list id");
     const kind = parseInput(guestExportKindSchema, flagString(flags, "kind") ?? "venue");
@@ -46857,7 +46938,7 @@ var HANDLERS = {
     if (!config.apiKey) {
       throw configError("provide --api-key <key> (or set DO_API_KEY) to log in");
     }
-    const auth = await requireClient().get("/whoami");
+    const auth = await requireClient().get(pathOf(whoamiOperations.whoami));
     const path = writeConfigFile(io, { apiUrl: config.apiUrl, apiKey: config.apiKey });
     return {
       data: {
@@ -46935,20 +47016,26 @@ async function setModuleVisibility(args, requireClient, on) {
     throw usageError(`unknown module \`${key}\` \u2014 valid keys: ${MODULE_KEYS.join(", ")}`);
   }
   const client = requireClient();
-  const settings = await client.get("/settings");
+  const settings = await client.get(pathOf(settingsOperations.get));
   const enabledModules = setModuleEnabled(settings.enabledModules, key, on);
   const body = parseInput(updateUserSettingsInputSchema, { enabledModules });
-  return { data: await client.patch("/settings", body), render: renderRecord };
+  return {
+    data: await client.patch(pathOf(settingsOperations.update), body),
+    render: renderRecord
+  };
 }
 async function setAreaPinned(args, requireClient, pinned) {
   const id = requireArg(args, 0, "area id");
   const client = requireClient();
-  const settings = await client.get("/settings");
+  const settings = await client.get(pathOf(settingsOperations.get));
   const rest = (settings.pinnedAreaIds ?? []).filter((x) => x !== id);
   const body = parseInput(updateUserSettingsInputSchema, {
     pinnedAreaIds: pinned ? [...rest, id] : rest
   });
-  return { data: await client.patch("/settings", body), render: renderRecord };
+  return {
+    data: await client.patch(pathOf(settingsOperations.update), body),
+    render: renderRecord
+  };
 }
 function parseTitleTags(args) {
   const titleWords = [];
@@ -47272,10 +47359,10 @@ async function postText(io, args) {
   return text;
 }
 async function homeSlug(client) {
-  const me = await client.get("/whoami");
+  const me = await client.get(pathOf(whoamiOperations.whoami));
   if (!me.agentId)
     throw usageError("this key isn't an Agent's: pass --thread <slug|id>");
-  const { data } = await client.getPage("/agents");
+  const { data } = await client.getPage(pathOf(agentOperations.list));
   const agent = data.find((a) => a.id === me.agentId);
   if (!agent)
     throw usageError("couldn't read the agent's name: pass --thread <slug|id>");
@@ -47285,7 +47372,7 @@ var ULID = /^[0-9A-HJKMNP-TV-Z]{26}$/i;
 async function resolveAgentId(client, agent) {
   if (ULID.test(agent))
     return agent;
-  const { data } = await client.getPage("/agents");
+  const { data } = await client.getPage(pathOf(agentOperations.list));
   const wanted = agent.trim().toLowerCase();
   const match = data.find((a) => a.name.toLowerCase() === wanted);
   if (!match) {

package/package.json

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