@robbeverhelst/do 1.179.0 → 1.180.0

package/dist/do.js

@@ -21640,7 +21640,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.179.0";
+var VERSION = "1.180.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -23186,6 +23186,80 @@ 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", "threads", "add"],
+    summary: "Add a standing thread of your own (Build, Business), pinned under the agent's.",
+    args: [{ name: "title", required: true, description: "Its name (`Build`)." }],
+    flags: [
+      {
+        name: "slug",
+        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." }
+    ],
+    scopes: ["agents:write"],
+    returns: "EchoThread",
+    notes: "A slug you already use is a 409; an archived thread's slug brings that thread back. The agent can post to it with `do echo post --thread <slug>`."
+  },
+  {
+    path: ["echo", "thread", "add"],
+    summary: "Same as `echo threads add`.",
+    args: [{ name: "title", required: true, description: "Its name (`Build`)." }],
+    flags: [
+      {
+        name: "slug",
+        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." }
+    ],
+    scopes: ["agents:write"],
+    returns: "EchoThread"
+  },
+  {
+    path: ["echo", "threads", "rename"],
+    summary: "Rename one of your agent threads.",
+    args: [
+      { name: "thread", required: true, description: "Its id, or a standing thread's slug." },
+      { name: "title", required: true, description: "The new name." }
+    ],
+    flags: [],
+    scopes: ["agents:write"],
+    returns: "EchoThreadSummary"
+  },
+  {
+    path: ["echo", "threads", "link"],
+    summary: "Set the Areas a standing thread covers, so its brief knows where to look.",
+    args: [{ name: "thread", required: true, description: "Its id, or its slug." }],
+    flags: [
+      {
+        name: "areas",
+        type: "string",
+        description: "Area ids, comma-separated (replaces the list; '' unlinks them all)."
+      }
+    ],
+    scopes: ["agents:write"],
+    returns: "EchoThreadSummary",
+    notes: "Links only: a thread never becomes an Area."
+  },
+  {
+    path: ["echo", "threads", "archive"],
+    summary: "Archive one of your agent threads.",
+    args: [{ name: "thread", required: true, description: "Its id, or a standing thread's slug." }],
+    flags: [],
+    scopes: ["agents:write"],
+    returns: "EchoThreadSummary",
+    notes: "It leaves your list and its slug no longer reaches it. The home thread (the agent's) can't be archived."
+  },
+  {
+    path: ["echo", "threads", "restore"],
+    summary: "Bring an archived thread back.",
+    args: [{ name: "id", required: true, description: "Thread ULID." }],
+    flags: [],
+    scopes: ["agents:write"],
+    returns: "EchoThreadSummary"
+  },
   {
     path: ["settings", "get"],
     summary: "Show the caller's settings for the Space.",
@@ -25773,6 +25847,44 @@ var HANDLERS = {
     }),
     render: renderRecord
   }),
+  "echo threads add": echoThreadAdd,
+  "echo thread add": echoThreadAdd,
+  "echo threads rename": async ({ args, requireClient }) => {
+    const client = requireClient();
+    const id = await echoThreadId(client, requireArg(args, 0, "thread"));
+    const title = args.slice(1).join(" ").trim();
+    if (!title)
+      throw usageError("missing required argument: <title>");
+    return { data: await client.patch(`/echo/threads/${id}`, { title }), render: renderRecord };
+  },
+  "echo threads link": async ({ args, flags, requireClient }) => {
+    const client = requireClient();
+    const id = await echoThreadId(client, requireArg(args, 0, "thread"));
+    const areas = flagString(flags, "areas");
+    if (areas === undefined)
+      throw usageError("pass --areas <id,id> (--areas '' unlinks them all)");
+    const areaIds = splitList(areas);
+    return {
+      data: await client.patch(`/echo/threads/${id}`, { areaIds }),
+      render: renderRecord
+    };
+  },
+  "echo threads archive": async ({ args, requireClient }) => {
+    const client = requireClient();
+    const id = await echoThreadId(client, requireArg(args, 0, "thread"));
+    return {
+      data: await client.patch(`/echo/threads/${id}`, { archived: true }),
+      render: renderRecord
+    };
+  },
+  "echo threads restore": async ({ args, requireClient }) => {
+    const client = requireClient();
+    const id = requireArg(args, 0, "thread id");
+    return {
+      data: await client.patch(`/echo/threads/${id}`, { archived: false }),
+      render: renderRecord
+    };
+  },
   "settings get": async ({ requireClient }) => ({
     data: await requireClient().get("/settings"),
     render: renderRecord
@@ -26293,6 +26405,35 @@ function standardLink(flags) {
     return { kind: "metric", key: metric };
   return null;
 }
+async function echoThreadAdd({ args, flags, requireClient }) {
+  const title = args.join(" ").trim();
+  if (!title)
+    throw usageError("missing required argument: <title>");
+  const slug = flagString(flags, "slug");
+  const areas = flagString(flags, "areas");
+  return {
+    data: await requireClient().post("/echo/threads/standing", {
+      title,
+      ...slug ? { slug } : {},
+      ...areas === undefined ? {} : { areaIds: splitList(areas) }
+    }),
+    render: renderEchoThread
+  };
+}
+async function echoThreadId(client, ref) {
+  if (ULID.test(ref))
+    return ref;
+  const threads = await client.get("/echo/threads", {
+    query: { limit: "50" }
+  });
+  const found = threads.find((t) => t.slug === ref);
+  if (!found)
+    throw usageError(`no thread \`${ref}\` (see \`do echo threads list\`)`);
+  return found.id;
+}
+function splitList(value) {
+  return value.split(",").map((v) => v.trim()).filter((v) => v.length > 0);
+}
 function requireArg(args, index, name) {
   const value = args[index];
   if (value === undefined || value.length === 0) {

package/package.json

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