@commonlyai/cli 0.1.219 → 0.1.220

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commonlyai/cli",
-  "version": "0.1.219",
+  "version": "0.1.220",
   "license": "Apache-2.0",
   "description": "The Commonly CLI — connect agents, manage pods, iterate fast",
   "type": "module",

package/src/commands/pod.js

@@ -8,6 +8,7 @@
 
 import { createClient } from '../lib/api.js';
 import { getToken, resolveInstanceUrl } from '../lib/config.js';
+import { createTailPoller } from '../lib/pod-tail.js';
 
 export const registerPod = (program) => {
   const pod = program.command('pod').description('Manage pods');
@@ -96,28 +97,16 @@ Commonly instance (see: commonly login --help).
 
       const client = createClient({ instance: resolveInstanceUrl(opts.instance), token });
 
-      let lastId = null;
       console.log(`Watching pod ${podId}... (Ctrl+C to stop)\n`);
 
+      const pollNew = createTailPoller({
+        fetchPage: (limit) => client.get(`/api/messages/${podId}`, { limit }),
+        filter: opts.filter,
+        print: (line) => console.log(line),
+      });
       const poll = async () => {
         try {
-          const data = await client.get(`/api/messages/${podId}`, {
-            limit: 20,
-            after: lastId,
-          });
-          const messages = Array.isArray(data) ? data : data.messages || [];
-
-          messages.forEach((m) => {
-            const isBot = m.isBot || m.sender?.isBot;
-            if (opts.filter === 'agents' && !isBot) return;
-            if (opts.filter === 'humans' && isBot) return;
-
-            const ts = new Date(m.createdAt || m.timestamp).toTimeString().slice(0, 8);
-            const who = m.username || m.sender?.username || '?';
-            const marker = isBot ? '🤖' : '👤';
-            console.log(`[${ts}] ${marker} ${who}: ${m.content}`);
-            lastId = m._id || m.id;
-          });
+          await pollNew();
         } catch (err) {
           console.error(`[poll error] ${err.message}`);
         }

package/src/lib/pod-tail.js

@@ -0,0 +1,68 @@
+/**
+ * Live pod tail for `commonly pod tail`.
+ *
+ * GET /api/messages/:podId takes `before` and `limit` only; it ignores `after`
+ * and returns the newest `limit` rows. Polling it with a cursor therefore
+ * re-serves the same window every tick. The poller keeps the ids it has
+ * already printed and prints only the rest, in the order the page returns
+ * them (oldest first).
+ */
+
+// Ids kept for de-duplication. Old entries fall out first, so a long tail
+// stays bounded in memory.
+export const TAIL_SEEN_MAX = 1000;
+export const TAIL_PAGE_LIMIT = 100;
+
+// Same bot field the v2 chat reads (frontend/src/v2/utils/threadView.ts
+// participantOf): `user.isBot`, falling back to the mapped `userId.isBot`.
+export const isAgentMessage = (m) => {
+  if (typeof m?.user?.isBot === 'boolean') return m.user.isBot;
+  return m?.userId?.isBot === true;
+};
+
+const authorName = (m) => m?.user?.username || m?.userId?.username || m?.username || '?';
+
+const clock = (m) => {
+  const raw = m?.createdAt || m?.timestamp;
+  const date = raw ? new Date(raw) : null;
+  return date && !Number.isNaN(date.getTime()) ? date.toTimeString().slice(0, 8) : '--:--:--';
+};
+
+export const formatTailLine = (m) => {
+  const marker = isAgentMessage(m) ? '🤖' : '👤';
+  return `[${clock(m)}] ${marker} ${authorName(m)}: ${m?.content ?? ''}`;
+};
+
+/**
+ * @param {object} opts
+ * @param {(limit: number) => Promise<object[] | {messages: object[]}>} opts.fetchPage
+ * @param {'all'|'agents'|'humans'} [opts.filter='all']
+ * @param {(line: string) => void} opts.print
+ */
+export const createTailPoller = ({ fetchPage, filter = 'all', print }) => {
+  const seen = new Set();
+  const remember = (id) => {
+    seen.add(id);
+    if (seen.size > TAIL_SEEN_MAX) seen.delete(seen.values().next().value);
+  };
+
+  return async () => {
+    const data = await fetchPage(TAIL_PAGE_LIMIT);
+    const messages = Array.isArray(data) ? data : data?.messages || [];
+    let printed = 0;
+
+    messages.forEach((m) => {
+      const id = String(m?._id || m?.id || '');
+      if (id) {
+        if (seen.has(id)) return;
+        remember(id);
+      }
+      if (filter === 'agents' && !isAgentMessage(m)) return;
+      if (filter === 'humans' && isAgentMessage(m)) return;
+      print(formatTailLine(m));
+      printed += 1;
+    });
+
+    return printed;
+  };
+};