@erdoai/cli 0.131.0 → 0.133.0

package/README.md

@@ -111,7 +111,7 @@ erdo datasets upload ./leads.csv       # create a dataset from a file
 
 ```bash
 erdo agent ask "what was revenue last week?" --datasets sales
-erdo agent thread --name "landing build"          # -> thread id
+erdo threads create --name "landing build"       # -> thread id
 erdo agent send <thread> "Build a landing page for ACME ..." --agent erdo.artifact-builder
 erdo agent send <thread> "What should I do next?" --context "Current screen: checkout experiment"
 

package/dist/index.js

@@ -1071,6 +1071,34 @@ var ErdoClient = class {
       input
     );
   }
+  listPersonas() {
+    return this.request(
+      "GET",
+      "/v1/personas"
+    );
+  }
+  openDirectConversation(personaID) {
+    return this.request(
+      "POST",
+      "/v1/threads-direct",
+      { persona_id: personaID }
+    );
+  }
+  markThreadSeen(threadID) {
+    return this.request("POST", `/v1/threads/${encodeURIComponent(threadID)}/seen`, {});
+  }
+  listSeenThreads() {
+    return this.request("GET", "/v1/threads-seen");
+  }
+  getThread(threadID) {
+    return this.request("GET", `/v1/threads/${encodeURIComponent(threadID)}`);
+  }
+  addThreadParticipant(threadID, participant) {
+    return this.request("POST", `/v1/threads/${encodeURIComponent(threadID)}/participants`, participant);
+  }
+  removeThreadParticipant(threadID, participantID) {
+    return this.request("DELETE", `/v1/threads/${encodeURIComponent(threadID)}/participants/${encodeURIComponent(participantID)}`);
+  }
   async deleteThread(threadID) {
     try {
       await this.request("DELETE", `/v1/threads/${encodeURIComponent(threadID)}`);
@@ -4147,50 +4175,139 @@ thread: ${response.thread_id}`);
     fail(e);
   }
 });
-agentCmd.command("thread").description("Create a thread; prints its id").option("-n, --name <name>", "thread name").option("-d, --datasets <csv>", "dataset UUIDs to attach").option("--hidden", "keep the thread out of the organization's thread list (for diagnostic or scripted threads)").action(async (opts) => {
+agentCmd.command("delete").description("Permanently delete a thread and its messages (needs admin on the thread: you created it, or you are an org admin)").argument("<threadId>", "thread UUID").action(async (threadId) => {
+  try {
+    await new ErdoClient().deleteThread(threadId);
+    console.log(`deleted ${threadId}`);
+  } catch (e) {
+    fail(e);
+  }
+});
+async function resolveConversationPersona(client, selector) {
+  const { personas } = await client.listPersonas();
+  const needle = selector.trim().toLocaleLowerCase();
+  const matches = personas.filter(
+    (persona) => [persona.id, persona.key, persona.human_name, persona.name].some((value) => value?.trim().toLocaleLowerCase() === needle)
+  );
+  if (matches.length === 1) return matches[0];
+  if (matches.length > 1) throw new Error(`Agent "${selector}" is ambiguous; use its persona key or ID`);
+  throw new Error(`No enabled agent matches "${selector}"`);
+}
+var conversationsCmd = program.command("threads").description("List and open conversations with people and named agents");
+conversationsCmd.command("list").description("List conversations with the latest message, speaker, unread status and open questions").option("-s, --scope <scope>", "own (default) | org | shared | all \u2014 org/shared require org membership").option("--order-by <order>", "created_at (default) | activity (last message time) \u2014 scope=org/shared only").option("--include-automation", "include automation/heartbeat-sourced threads \u2014 scope=org/shared only").option("-l, --limit <n>", "max conversations (default 20, max 100)", (v) => parseInt(v, 10)).option("--offset <n>", "pagination offset", (v) => parseInt(v, 10)).action(async (opts) => {
+  try {
+    const { threads, total } = await new ErdoClient().listThreads(opts);
+    for (const thread of threads) {
+      const preview = (thread.last_message_preview || "").replace(/[\t\r\n]+/g, " ").slice(0, 120);
+      const speaker = thread.last_message_author_display_name || thread.last_message_author_entity_type || "";
+      const creator = thread.created_by_user_name || thread.created_by_user_id;
+      console.log(`${thread.id}	${thread.name || ""}	${creator}	${thread.source || "unrecorded"}	${thread.unread ? "unread" : "read"}	${speaker}	${preview}	questions=${thread.open_question_count ?? 0}`);
+    }
+    const shown = (opts.offset ?? 0) + threads.length;
+    console.error(total > shown ? `(showing ${threads.length} of ${total} \u2014 use --limit/--offset for more)` : `(${total} conversation${total === 1 ? "" : "s"})`);
+  } catch (e) {
+    fail(e);
+  }
+});
+conversationsCmd.command("open <agent>").description("Open or create your direct conversation with an enabled agent").action(async (agent) => {
+  try {
+    const client = new ErdoClient();
+    const persona = await resolveConversationPersona(client, agent);
+    const thread = await client.openDirectConversation(persona.id);
+    console.log(thread.id);
+  } catch (e) {
+    fail(e);
+  }
+});
+conversationsCmd.command("create").description("Create a conversation, optionally bound to an enabled agent").option("--agent <agent>", "agent name, persona key or ID").option("-n, --name <name>", "conversation name").option("-d, --datasets <csv>", "dataset UUIDs to attach").option("--hidden", "keep the conversation out of the organization's conversation list").option("--parent <threadId>", "parent conversation this internal conversation supports").option("--internal", "create an internal conversation hidden until someone follows it").action(async (opts) => {
   try {
-    const res = await new ErdoClient().createThread({
+    if (opts.internal && !opts.parent) throw new Error("--internal requires --parent <thread-id>");
+    const client = new ErdoClient();
+    const persona = opts.agent ? await resolveConversationPersona(client, opts.agent) : void 0;
+    const thread = await client.createThread({
       name: opts.name,
-      dataset_ids: opts.datasets ? opts.datasets.split(",").map((s) => s.trim()) : void 0,
-      visibility: opts.hidden ? "hidden" : void 0
+      dataset_ids: opts.datasets ? opts.datasets.split(",").map((s) => s.trim()).filter(Boolean) : void 0,
+      visibility: opts.hidden ? "hidden" : void 0,
+      persona_id: persona?.id,
+      parent_thread_id: opts.parent,
+      listing: opts.internal ? "internal" : void 0
     });
-    console.log(res.id);
+    console.log(thread.id);
   } catch (e) {
     fail(e);
   }
 });
-agentCmd.command("delete").description("Permanently delete a thread and its messages (needs admin on the thread: you created it, or you are an org admin)").argument("<threadId>", "thread UUID").action(async (threadId) => {
+conversationsCmd.command("follow <threadId>").description("Follow an internal conversation so it appears in your conversation list").action(async (threadID) => {
   try {
-    await new ErdoClient().deleteThread(threadId);
-    console.log(`deleted ${threadId}`);
+    const client = new ErdoClient();
+    const user = await client.me();
+    await client.addThreadParticipant(threadID, { user_id: user.user_id });
+    console.log(`following ${threadID}`);
   } catch (e) {
     fail(e);
   }
 });
-agentCmd.command("threads").description("List threads (default: your own; --scope org/shared for organization-wide)").option("-s, --scope <scope>", "own (default) | org | shared \u2014 org/shared require org membership").option(
-  "--order-by <order>",
-  "created_at (default) | activity (last message time) \u2014 scope=org/shared only"
-).option(
-  "--include-automation",
-  "include automation/heartbeat-sourced threads, excluded by default \u2014 scope=org/shared only"
-).option("-l, --limit <n>", "max threads (default 20, max 100)", (v) => parseInt(v, 10)).option("--offset <n>", "pagination offset", (v) => parseInt(v, 10)).action(
-  async (opts) => {
-    try {
-      const { threads, total } = await new ErdoClient().listThreads(opts);
-      for (const t of threads) {
-        console.log(`${t.id}	${t.name}	${t.created_by_user_name || t.created_by_user_id}	${t.source || "unrecorded"}`);
-      }
-      const shown = (opts.offset ?? 0) + threads.length;
-      if (total > shown) {
-        console.error(`(showing ${threads.length} of ${total} \u2014 use --limit/--offset for more)`);
-      } else {
-        console.error(`(${total} thread${total === 1 ? "" : "s"})`);
-      }
-    } catch (e) {
-      fail(e);
-    }
+conversationsCmd.command("unfollow <threadId>").description("Unfollow an internal conversation").action(async (threadID) => {
+  try {
+    const client = new ErdoClient();
+    const user = await client.me();
+    await client.removeThreadParticipant(threadID, user.user_id);
+    console.log(`unfollowed ${threadID}`);
+  } catch (e) {
+    fail(e);
   }
-);
+});
+conversationsCmd.command("seen <threadId>").description("Mark a conversation as seen").action(async (threadID) => {
+  try {
+    await new ErdoClient().markThreadSeen(threadID);
+    console.log(`seen ${threadID}`);
+  } catch (e) {
+    fail(e);
+  }
+});
+conversationsCmd.command("seen-list").description("List conversations you have marked as seen").action(async () => {
+  try {
+    print(await new ErdoClient().listSeenThreads());
+  } catch (e) {
+    fail(e);
+  }
+});
+conversationsCmd.command("agents").description("List enabled agents and their persona IDs").action(async () => {
+  try {
+    const { personas } = await new ErdoClient().listPersonas();
+    for (const persona of personas) console.log(`${persona.id}	${persona.key}	${persona.human_name || persona.name}`);
+  } catch (e) {
+    fail(e);
+  }
+});
+conversationsCmd.command("get <threadId>").description("Show a conversation and its participants").action(async (threadID) => {
+  try {
+    print(await new ErdoClient().getThread(threadID));
+  } catch (e) {
+    fail(e);
+  }
+});
+var conversationParticipantsCmd = conversationsCmd.command("participants").description("Manage named-agent participants in a conversation");
+conversationParticipantsCmd.command("add <threadId> <agent>").description("Add an enabled agent to a conversation").action(async (threadID, agent) => {
+  try {
+    const client = new ErdoClient();
+    const persona = await resolveConversationPersona(client, agent);
+    await client.addThreadParticipant(threadID, { persona_id: persona.id });
+    console.log(`added ${persona.human_name || persona.name} to ${threadID}`);
+  } catch (e) {
+    fail(e);
+  }
+});
+conversationParticipantsCmd.command("remove <threadId> <agent>").description("Remove an enabled agent from a conversation").action(async (threadID, agent) => {
+  try {
+    const client = new ErdoClient();
+    const persona = await resolveConversationPersona(client, agent);
+    await client.removeThreadParticipant(threadID, persona.id);
+    console.log(`removed ${persona.human_name || persona.name} from ${threadID}`);
+  } catch (e) {
+    fail(e);
+  }
+});
 function contentBlockLabel(c) {
   const type = c.ui_content_type || c.content_type;
   const payload = c.content;
@@ -8580,7 +8697,7 @@ var autoCmd = program.command("automations").description("Scheduled automations
 autoCmd.command("list").description("List automations").action(async () => {
   try {
     const { heartbeats } = await new ErdoClient().listHeartbeats();
-    for (const h of heartbeats) console.log(`${h.id}	${h.state}	${h.name}`);
+    for (const h of heartbeats) console.log(`${h.id}	${h.state}	${h.name}	${h.kind === "script" ? "script" : h.thread_id ? `thread:${h.thread_id}` : h.conversation ?? "new"}${h.persona_id ? `	persona:${h.persona_id}` : ""}`);
   } catch (e) {
     fail(e);
   }
@@ -8606,7 +8723,7 @@ autoCmd.command("run <id>").description("Trigger an automation now").action(asyn
 autoCmd.command("update <id>").description("Edit an automation \u2014 rename, reschedule, or replace its script/instructions").option("--name <name>", "New name").option("--description <text>", "New description").option("--instructions <text>", "Replacement instructions (agent automation)").addOption(new Option2("--agent-key <key>", "Executor for an agent automation; omit to keep current").choices(["erdo.heartbeat-executor", "erdo.workflow-executor"])).option("--script-js <js>", "Replacement script body (scripted automation)").option(
   "--script-file <path>",
   "Read the replacement script body from a file (scripted automation)"
-).option("--interval <minutes>", "New interval in minutes (minimum 5)", (v) => parseInt(v, 10)).option("--timezone <tz>", "New scheduling timezone, e.g. America/New_York").action(
+).addOption(new Option2("--conversation <target>", "Target 'new' (fresh thread) or 'direct' conversation").choices(["new", "direct"])).option("--thread-id <id>", "Post each run into an existing conversation UUID").option("--persona-id <id>", "Org-enabled persona UUID to speak as").option("--interval <minutes>", "New interval in minutes (minimum 5)", (v) => parseInt(v, 10)).option("--timezone <tz>", "New scheduling timezone, e.g. America/New_York").action(
   async (id, opts) => {
     try {
       if (opts.scriptJs && opts.scriptFile) {
@@ -8621,7 +8738,10 @@ autoCmd.command("update <id>").description("Edit an automation \u2014 rename, re
         agent_key: opts.agentKey,
         script_js: scriptJs,
         interval_minutes: opts.interval,
-        timezone: opts.timezone
+        timezone: opts.timezone,
+        conversation: opts.conversation,
+        thread_id: opts.threadId,
+        persona_id: opts.personaId
       };
       if (Object.values(body).every((v) => v === void 0)) {
         fail(new Error("nothing to update \u2014 pass at least one field to change"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.131.0",
+  "version": "0.133.0",
   "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {