@gobi-ai/cli 0.3.2 → 0.3.4

package/dist/commands/astra.js

@@ -28,13 +28,15 @@ export function registerAstraCommand(program) {
         .command("get-thread <threadId>")
         .description("Get a thread and its replies (paginated).")
         .option("--limit <number>", "Replies per page", "20")
-        .option("--offset <number>", "Offset for reply pagination", "0")
+        .option("--cursor <string>", "Pagination cursor from previous response")
         .action(async (threadId, opts) => {
         const spaceSlug = resolveSpaceSlug(space);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/threads/${threadId}`, {
+        const params = {
             limit: parseInt(opts.limit, 10),
-            offset: parseInt(opts.offset, 10),
-        }));
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/spaces/${spaceSlug}/threads/${threadId}`, params));
         const data = unwrapResp(resp);
         const pagination = (resp.pagination || {});
         if (isJsonMode(space)) {
@@ -43,9 +45,6 @@ export function registerAstraCommand(program) {
         }
         const thread = (data.thread || data);
         const replies = (data.items || []);
-        const totalReplies = pagination.total ||
-            thread.replyCount ||
-            0;
         const author = thread.author?.name ||
             `User ${thread.authorId}`;
         const replyLines = [];
@@ -62,8 +61,9 @@ export function registerAstraCommand(program) {
             "",
             thread.content,
             "",
-            `Replies (${replies.length} of ${totalReplies}):`,
+            `Replies (${replies.length} items):`,
             ...replyLines,
+            ...(pagination.hasMore ? [`  Next cursor: ${pagination.nextCursor}`] : []),
         ].join("\n");
         console.log(output);
     });
@@ -71,13 +71,15 @@ export function registerAstraCommand(program) {
         .command("list-threads")
         .description("List threads in a space (paginated).")
         .option("--limit <number>", "Items per page", "20")
-        .option("--offset <number>", "Offset for pagination", "0")
+        .option("--cursor <string>", "Pagination cursor from previous response")
         .action(async (opts) => {
         const spaceSlug = resolveSpaceSlug(space);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/threads`, {
+        const params = {
             limit: parseInt(opts.limit, 10),
-            offset: parseInt(opts.offset, 10),
-        }));
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/spaces/${spaceSlug}/threads`, params));
         if (isJsonMode(space)) {
             jsonOut({
                 items: resp.data || [],
@@ -97,8 +99,8 @@ export function registerAstraCommand(program) {
                 `User ${t.authorId}`;
             lines.push(`- [${t.id}] "${t.title}" by ${author} (${t.replyCount} replies, ${t.createdAt})`);
         }
-        const total = pagination.total || items.length;
-        console.log(`Threads (${items.length} of ${total}):\n` + lines.join("\n"));
+        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
+        console.log(`Threads (${items.length} items):\n` + lines.join("\n") + footer);
     });
     space
         .command("create-thread")

package/dist/commands/brain.js

@@ -47,15 +47,33 @@ export function registerBrainCommand(program) {
         .description("Ask a brain a question. Creates a targeted session (1:1 conversation).")
         .requiredOption("--vault-slug <vaultSlug>", "Slug of the brain/vault to ask")
         .requiredOption("--space-slug <spaceSlug>", "Space slug where the brain belongs")
-        .requiredOption("--question <question>", "The question to ask (markdown supported)")
+        .option("--question <question>", "The question to ask (markdown supported)")
+        .option("--rich-text <richText>", "Rich-text JSON array (e.g. [{\"type\":\"text\",\"text\":\"hello\"}])")
         .option("--mode <mode>", 'Session mode: "auto" or "manual"')
         .action(async (opts) => {
+        if (!opts.question && !opts.richText) {
+            throw new Error("Provide either --question or --rich-text.");
+        }
+        if (opts.question && opts.richText) {
+            throw new Error("--question and --rich-text are mutually exclusive.");
+        }
         const spaceSlug = opts.spaceSlug;
         const body = {
             vaultSlug: opts.vaultSlug,
             spaceSlug,
-            question: opts.question,
         };
+        if (opts.question != null)
+            body.question = opts.question;
+        if (opts.richText != null) {
+            let parsed;
+            try {
+                parsed = JSON.parse(opts.richText);
+            }
+            catch {
+                throw new Error("Invalid --rich-text JSON.");
+            }
+            body.richText = parsed;
+        }
         if (opts.mode != null)
             body.mode = opts.mode;
         const resp = (await apiPost(`/session/targeted`, body));
@@ -126,21 +144,26 @@ export function registerBrainCommand(program) {
     // ── Updates (list, post, edit, delete) ──
     brain
         .command("list-updates")
-        .description("List recent brain updates for a vault (paginated).")
+        .description("List recent brain updates. Without --space-slug, lists all updates for you. With --space-slug, lists updates for that space. Use --mine to show only updates by you.")
         .option("--vault-slug <vaultSlug>", "Vault slug (overrides .gobi/settings.yaml)")
+        .option("--space-slug <spaceSlug>", "List updates for a space")
         .option("--mine", "List only my own brain updates")
         .option("--limit <number>", "Items per page", "20")
-        .option("--offset <number>", "Offset for pagination", "0")
+        .option("--cursor <string>", "Pagination cursor from previous response")
         .action(async (opts) => {
         const params = {
             limit: parseInt(opts.limit, 10),
-            offset: parseInt(opts.offset, 10),
         };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
         if (opts.mine)
             params.mine = true;
         if (opts.vaultSlug)
             params.vaultSlug = opts.vaultSlug;
-        const resp = (await apiGet(`/brain-updates`, params));
+        const path = opts.spaceSlug
+            ? `/spaces/${opts.spaceSlug}/brain-updates`
+            : `/brain-updates`;
+        const resp = (await apiGet(path, params));
         if (isJsonMode(brain)) {
             jsonOut({
                 items: resp.data || [],
@@ -162,8 +185,8 @@ export function registerBrainCommand(program) {
                 "?";
             lines.push(`- [${u.id}] "${u.title}" by ${author} (vault: ${vaultSlug}, ${u.createdAt})`);
         }
-        const total = pagination.total || items.length;
-        console.log(`Brain updates (${items.length} of ${total}):\n` + lines.join("\n"));
+        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
+        console.log(`Brain updates (${items.length} items):\n` + lines.join("\n") + footer);
     });
     brain
         .command("post-update")

package/dist/commands/sessions.js

@@ -1,20 +1,22 @@
-import { apiGet, apiPost, apiPatch } from "../client.js";
+import { apiGet, apiPost } from "../client.js";
 import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
 export function registerSessionsCommand(program) {
     const sessions = program
         .command("session")
-        .description("Session commands (get, list, reply, update).");
+        .description("Session commands (get, list, reply).");
     // ── Get ──
     sessions
         .command("get <sessionId>")
         .description("Get a session and its messages (paginated).")
         .option("--limit <number>", "Messages per page", "20")
-        .option("--offset <number>", "Offset for message pagination", "0")
+        .option("--cursor <string>", "Pagination cursor from previous response")
         .action(async (sessionId, opts) => {
-        const resp = (await apiGet(`/session/${sessionId}`, {
+        const params = {
             limit: parseInt(opts.limit, 10),
-            offset: parseInt(opts.offset, 10),
-        }));
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/session/${sessionId}`, params));
         const data = unwrapResp(resp);
         if (isJsonMode(sessions)) {
             jsonOut(data);
@@ -23,7 +25,6 @@ export function registerSessionsCommand(program) {
         const session = (data.session || data);
         const messages = (data.messages || []);
         const pagination = (data.pagination || {});
-        const totalMessages = pagination.total || messages.length;
         const msgLines = [];
         for (const m of messages) {
             const author = m.author?.name ||
@@ -39,8 +40,9 @@ export function registerSessionsCommand(program) {
             `  Mode: ${session.mode}`,
             `  Last activity: ${session.lastMessageAt}`,
             "",
-            `Messages (${messages.length} of ${totalMessages}):`,
+            `Messages (${messages.length} items):`,
             ...msgLines,
+            ...(pagination.hasMore ? [`  Next cursor: ${pagination.nextCursor}`] : []),
         ].join("\n");
         console.log(output);
     });
@@ -50,17 +52,16 @@ export function registerSessionsCommand(program) {
         .description("List all sessions you are part of, sorted by most recent activity.")
         .option("--space-slug <spaceSlug>", "Filter by space slug")
         .option("--limit <number>", "Items per page", "20")
-        .option("--offset <number>", "Offset for pagination", "0")
+        .option("--cursor <string>", "Pagination cursor from previous response")
         .action(async (opts) => {
-        const limit = parseInt(opts.limit, 10);
-        const offset = parseInt(opts.offset, 10);
-        const query = { limit, offset };
+        const query = { limit: parseInt(opts.limit, 10) };
+        if (opts.cursor)
+            query.cursor = opts.cursor;
         if (opts.spaceSlug)
             query.spaceSlug = opts.spaceSlug;
         const resp = (await apiGet(`/session/my-sessions`, query));
         const items = (resp.data || []);
         const pagination = (resp.pagination || {});
-        const total = pagination.total ?? items.length;
         if (isJsonMode(sessions)) {
             jsonOut({
                 items,
@@ -87,17 +88,37 @@ export function registerSessionsCommand(program) {
             }
             lines.push(`- [${s.id}] "${title}" (mode: ${s.mode}, last activity: ${s.lastMessageAt})${memberInfo}`);
         }
-        console.log(`Sessions (${items.length} of ${total}):\n` + lines.join("\n"));
+        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
+        console.log(`Sessions (${items.length} items):\n` + lines.join("\n") + footer);
     });
     // ── Reply ──
     sessions
         .command("reply <sessionId>")
         .description("Send a human reply to a session you are a member of.")
-        .requiredOption("--content <content>", "Reply content (markdown supported)")
+        .option("--content <content>", "Reply content (markdown supported)")
+        .option("--rich-text <richText>", "Rich-text JSON array (e.g. [{\"type\":\"text\",\"text\":\"hello\"}])")
         .action(async (sessionId, opts) => {
-        const resp = (await apiPost(`/session/${sessionId}/reply`, {
-            content: opts.content,
-        }));
+        if (!opts.content && !opts.richText) {
+            throw new Error("Provide either --content or --rich-text.");
+        }
+        if (opts.content && opts.richText) {
+            throw new Error("--content and --rich-text are mutually exclusive.");
+        }
+        const body = {};
+        if (opts.richText != null) {
+            let parsed;
+            try {
+                parsed = JSON.parse(opts.richText);
+            }
+            catch {
+                throw new Error("Invalid --rich-text JSON.");
+            }
+            body.richText = parsed;
+        }
+        else {
+            body.content = opts.content;
+        }
+        const resp = (await apiPost(`/session/${sessionId}/reply`, body));
         const msg = unwrapResp(resp);
         if (isJsonMode(sessions)) {
             jsonOut(msg);
@@ -108,31 +129,4 @@ export function registerSessionsCommand(program) {
             `  Source: ${msg.source}\n` +
             `  Created: ${msg.createdAt}`);
     });
-    // ── Update ──
-    sessions
-        .command("update <sessionId>")
-        .description('Update a session. "auto" lets the AI respond automatically; "manual" requires human replies.')
-        .option("--mode <mode>", 'Session mode: "auto" or "manual"')
-        .action(async (sessionId, opts) => {
-        if (!opts.mode) {
-            throw new Error("Provide at least one option to update (e.g. --mode).");
-        }
-        const body = {};
-        if (opts.mode != null) {
-            if (opts.mode !== "auto" && opts.mode !== "manual") {
-                throw new Error('Invalid mode. Must be "auto" or "manual".');
-            }
-            body.mode = opts.mode;
-        }
-        const resp = (await apiPatch(`/session/${sessionId}`, body));
-        const data = unwrapResp(resp);
-        if (isJsonMode(sessions)) {
-            jsonOut(data);
-            return;
-        }
-        const session = (data.session || data);
-        console.log(`Session updated!\n` +
-            `  ID: ${session.id}\n` +
-            `  Mode: ${session.mode}`);
-    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobi-ai/cli",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",