npm - @gobi-ai/cli - Versions diffs - 0.3.0 → 0.3.2 - Mend

@gobi-ai/cli 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md +32 -30
package/dist/commands/astra.js +89 -447
package/dist/commands/brain.js +227 -0
package/dist/commands/init.js +14 -6
package/dist/commands/sessions.js +138 -0
package/dist/commands/utils.js +19 -0
package/dist/main.js +4 -0
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -38,13 +38,13 @@ npm link
 gobi init
 # Select a space
-gobi astra warp
+gobi space warp
-# Search brains in your space
-gobi astra search-brain --query "machine learning"
+# Search brains across your spaces
+gobi brain search --query "machine learning"
 # Ask a brain a question
-gobi astra ask-brain --vault-slug my-vault --question "What is RAG?"
+gobi brain ask --vault-slug my-vault --space-slug my-space --question "What is RAG?"
 ```
 ## Commands
@@ -62,59 +62,61 @@ gobi astra ask-brain --vault-slug my-vault --question "What is RAG?"
 | Command | Description |
 |---------|-------------|
 | `gobi init` | Log in (if needed) and select or create a vault |
-| `gobi astra warp` | Select the active space |
+| `gobi space warp` | Select the active space |
 ### Brains
 | Command | Description |
 |---------|-------------|
-| `gobi astra search-brain --query <q>` | Search brains in a space |
-| `gobi astra ask-brain --vault-slug <slug> --question <q>` | Ask a brain a question (creates a 1:1 session) |
-| `gobi astra publish-brain` | Upload `BRAIN.md` to your vault |
-| `gobi astra unpublish-brain` | Remove `BRAIN.md` from your vault |
+| `gobi brain search --query <q>` | Search brains across all your spaces |
+| `gobi brain ask --vault-slug <slug> --space-slug <slug> --question <q>` | Ask a brain a question (creates a 1:1 session) |
+| `gobi brain publish` | Upload `BRAIN.md` to your vault |
+| `gobi brain unpublish` | Remove `BRAIN.md` from your vault |
-### Posts
+### Brain Updates
 | Command | Description |
 |---------|-------------|
-| `gobi astra list-posts` | List posts in the current space |
-| `gobi astra get-post <id>` | Get a post and its replies |
-| `gobi astra create-post --title <t> --content <c>` | Create a post |
-| `gobi astra edit-post <id> --title <t>` | Edit a post |
-| `gobi astra delete-post <id>` | Delete a post |
+| `gobi brain list-updates` | List brain updates for your vault |
+| `gobi brain list-updates --mine` | List only your own brain updates |
+| `gobi brain post-update --title <t> --content <c>` | Post a brain update |
+| `gobi brain edit-update <id> --title <t>` | Edit a brain update |
+| `gobi brain delete-update <id>` | Delete a brain update |
-### Replies
+### Threads
 | Command | Description |
 |---------|-------------|
-| `gobi astra create-reply <postId> --content <c>` | Reply to a post |
-| `gobi astra edit-reply <replyId> --content <c>` | Edit a reply |
-| `gobi astra delete-reply <replyId>` | Delete a reply |
+| `gobi space list-threads` | List threads in the current space |
+| `gobi space get-thread <id>` | Get a thread and its replies |
+| `gobi space create-thread --title <t> --content <c>` | Create a thread |
+| `gobi space edit-thread <id> --title <t>` | Edit a thread |
+| `gobi space delete-thread <id>` | Delete a thread |
-### Sessions
+### Replies
 | Command | Description |
 |---------|-------------|
-| `gobi astra list-sessions` | List your sessions |
-| `gobi astra get-session <id>` | Get a session and its messages |
-| `gobi astra reply-session <id> --content <c>` | Send a message in a session |
-| `gobi astra update-session <id> --mode <mode>` | Set session mode (auto/manual) |
+| `gobi space create-reply <threadId> --content <c>` | Reply to a thread |
+| `gobi space edit-reply <replyId> --content <c>` | Edit a reply |
+| `gobi space delete-reply <replyId>` | Delete a reply |
-### Brain updates
+### Sessions
 | Command | Description |
 |---------|-------------|
-| `gobi astra list-brain-updates` | List brain updates in the space |
-| `gobi astra create-brain-update --title <t> --content <c>` | Create a brain update |
-| `gobi astra edit-brain-update <id> --title <t>` | Edit a brain update |
-| `gobi astra delete-brain-update <id>` | Delete a brain update |
+| `gobi session list` | List your sessions |
+| `gobi session get <id>` | Get a session and its messages |
+| `gobi session reply <id> --content <c>` | Send a message in a session |
+| `gobi session update <id> --mode <mode>` | Set session mode (auto/manual) |
 ### Global options
 | Option | Description |
 |--------|-------------|
 | `--json` | Output results as JSON |
-| `--space-slug <slug>` | Override the default space (astra commands) |
+| `--space-slug <slug>` | Override the default space (on `space` commands); required on `brain ask`, optional filter on `session list` |
+| `--vault-slug <slug>` | Override the default vault (on `brain list-updates` and `brain post-update`) |
 ## Configuration

package/dist/commands/astra.js CHANGED Viewed

@@ -1,36 +1,15 @@
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
 import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { WEBDRIVE_BASE_URL } from "../constants.js";
-import { getValidToken } from "../auth/manager.js";
-import { getSpaceSlug, getVaultSlug, selectSpace, writeSpaceSetting } from "./init.js";
-function isJsonMode(cmd) {
-    return !!cmd.parent?.opts().json;
-}
-function jsonOut(data) {
-    console.log(JSON.stringify({ success: true, data }));
-}
-function resolveSpaceSlug(cmd) {
-    return cmd.opts().spaceSlug || getSpaceSlug();
-}
-function resolveVaultSlug(opts) {
-    return opts.vaultSlug || getVaultSlug();
-}
-function unwrapResp(resp) {
-    if (typeof resp === "object" && resp !== null && "data" in resp) {
-        return resp.data;
-    }
-    return resp;
-}
+import { selectSpace, writeSpaceSetting } from "./init.js";
+import { isJsonMode, jsonOut, resolveSpaceSlug, unwrapResp } from "./utils.js";
 export function registerAstraCommand(program) {
-    const astra = program
-        .command("astra")
-        .description("Astra commands (posts, sessions, brains, brain updates).")
+    const space = program
+        .command("space")
+        .description("Space commands (threads, replies).")
         .option("--space-slug <slug>", "Space slug (overrides .gobi/settings.yaml)");
     // ── Warp (space selection) ──
-    astra
+    space
         .command("warp")
-        .description("Select the active space for astra commands.")
+        .description("Select the active space.")
         .action(async () => {
         const result = await selectSpace();
         if (result === null) {
@@ -38,146 +17,37 @@ export function registerAstraCommand(program) {
             return;
         }
         writeSpaceSetting(result.slug);
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut({ spaceSlug: result.slug, spaceName: result.name });
             return;
         }
         console.log(`Warped to space "${result.name}" (${result.slug})`);
     });
-    // ── Brains ──
-    astra
-        .command("search-brain")
-        .description("Search brains (second brains/vaults) in a space using text and semantic search.")
-        .requiredOption("--query <query>", "Search query")
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/brains`, {
-            query: opts.query,
-        }));
-        const results = (Array.isArray(resp) ? resp : resp.data || resp);
-        if (isJsonMode(astra)) {
-            jsonOut(results || []);
-            return;
-        }
-        if (!results || results.length === 0) {
-            console.log(`No brains found matching "${opts.query}".`);
-            return;
-        }
-        const lines = [];
-        for (const entry of results) {
-            const vault = (entry.vault || entry);
-            const owner = (entry.owner || {});
-            const ownerName = owner.name ? ` by ${owner.name}` : "";
-            const sim = entry.similarity != null
-                ? ` [similarity: ${entry.similarity.toFixed(3)}]`
-                : "";
-            lines.push(`- ${vault.name || vault.title || "N/A"} (ID: ${vault.vaultId || vault.id || "N/A"})${ownerName}${sim}`);
-        }
-        console.log(`Brains matching "${opts.query}":\n` + lines.join("\n"));
-    });
-    astra
-        .command("ask-brain")
-        .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("--question <question>", "The question to ask (markdown supported)")
-        .option("--mode <mode>", 'Session mode: "auto" or "manual"')
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const body = {
-            vaultSlug: opts.vaultSlug,
-            spaceSlug,
-            question: opts.question,
-        };
-        if (opts.mode != null)
-            body.mode = opts.mode;
-        const resp = (await apiPost(`/session/targeted`, body));
-        const data = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(data);
-            return;
-        }
-        const session = (data.session || {});
-        const members = (data.members || []);
-        console.log(`Session created!\n` +
-            `  Session ID: ${session.id}\n` +
-            `  Mode: ${session.mode}\n` +
-            `  Members: ${members.length}\n` +
-            `  Question sent.`);
-    });
-    astra
-        .command("publish-brain")
-        .description("Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).")
-        .action(async () => {
-        const vaultId = getVaultSlug();
-        const filePath = join(process.cwd(), "BRAIN.md");
-        if (!existsSync(filePath)) {
-            throw new Error(`BRAIN.md not found in ${process.cwd()}`);
-        }
-        const content = readFileSync(filePath, "utf-8");
-        const token = await getValidToken();
-        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/files/BRAIN.md`;
-        const res = await fetch(url, {
-            method: "PUT",
-            headers: {
-                Authorization: `Bearer ${token}`,
-                "Content-Type": "text/markdown",
-            },
-            body: content,
-        });
-        if (!res.ok) {
-            throw new Error(`Upload failed: HTTP ${res.status}: ${(await res.text()) || "(no body)"}`);
-        }
-        if (isJsonMode(astra)) {
-            jsonOut({ vaultId });
-            return;
-        }
-        console.log(`Published BRAIN.md to vault "${vaultId}"`);
-    });
-    astra
-        .command("unpublish-brain")
-        .description("Delete BRAIN.md from the vault on webdrive.")
-        .action(async () => {
-        const vaultId = getVaultSlug();
-        const token = await getValidToken();
-        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/files/BRAIN.md`;
-        const res = await fetch(url, {
-            method: "DELETE",
-            headers: { Authorization: `Bearer ${token}` },
-        });
-        if (!res.ok) {
-            throw new Error(`Delete failed: HTTP ${res.status}: ${(await res.text()) || "(no body)"}`);
-        }
-        if (isJsonMode(astra)) {
-            jsonOut({ vaultId });
-            return;
-        }
-        console.log(`Deleted BRAIN.md from vault "${vaultId}"`);
-    });
-    // ── Posts (get, list, create, edit, delete) ──
-    astra
-        .command("get-post <postId>")
-        .description("Get a post and its replies (paginated).")
+    // ── Threads (get, list, create, edit, delete) ──
+    space
+        .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")
-        .action(async (postId, opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/posts/${postId}`, {
+        .action(async (threadId, opts) => {
+        const spaceSlug = resolveSpaceSlug(space);
+        const resp = (await apiGet(`/spaces/${spaceSlug}/threads/${threadId}`, {
             limit: parseInt(opts.limit, 10),
             offset: parseInt(opts.offset, 10),
         }));
         const data = unwrapResp(resp);
         const pagination = (resp.pagination || {});
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut({ ...data, pagination });
             return;
         }
-        const msg = (data.post || data);
+        const thread = (data.thread || data);
         const replies = (data.items || []);
         const totalReplies = pagination.total ||
-            msg.replyCount ||
+            thread.replyCount ||
             0;
-        const author = msg.author?.name ||
-            `User ${msg.authorId}`;
+        const author = thread.author?.name ||
+            `User ${thread.authorId}`;
         const replyLines = [];
         for (const r of replies) {
             const rAuthor = r.author?.name ||
@@ -187,28 +57,28 @@ export function registerAstraCommand(program) {
             replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
         }
         const output = [
-            `Post: ${msg.title}`,
-            `By: ${author} on ${msg.createdAt}`,
+            `Thread: ${thread.title}`,
+            `By: ${author} on ${thread.createdAt}`,
             "",
-            msg.content,
+            thread.content,
             "",
             `Replies (${replies.length} of ${totalReplies}):`,
             ...replyLines,
         ].join("\n");
         console.log(output);
     });
-    astra
-        .command("list-posts")
-        .description("List posts in a space (paginated).")
+    space
+        .command("list-threads")
+        .description("List threads in a space (paginated).")
         .option("--limit <number>", "Items per page", "20")
         .option("--offset <number>", "Offset for pagination", "0")
         .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/posts`, {
+        const spaceSlug = resolveSpaceSlug(space);
+        const resp = (await apiGet(`/spaces/${spaceSlug}/threads`, {
             limit: parseInt(opts.limit, 10),
             offset: parseInt(opts.offset, 10),
         }));
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut({
                 items: resp.data || [],
                 pagination: resp.pagination || {},
@@ -218,344 +88,116 @@ export function registerAstraCommand(program) {
         const items = (resp.data || []);
         const pagination = (resp.pagination || {});
         if (!items.length) {
-            console.log("No posts found.");
+            console.log("No threads found.");
             return;
         }
         const lines = [];
-        for (const msg of items) {
-            const author = msg.author?.name ||
-                `User ${msg.authorId}`;
-            lines.push(`- [${msg.id}] "${msg.title}" by ${author} (${msg.replyCount} replies, ${msg.createdAt})`);
+        for (const t of items) {
+            const author = t.author?.name ||
+                `User ${t.authorId}`;
+            lines.push(`- [${t.id}] "${t.title}" by ${author} (${t.replyCount} replies, ${t.createdAt})`);
         }
         const total = pagination.total || items.length;
-        console.log(`Posts (${items.length} of ${total}):\n` + lines.join("\n"));
+        console.log(`Threads (${items.length} of ${total}):\n` + lines.join("\n"));
     });
-    astra
-        .command("create-post")
-        .description("Create a post in a space.")
-        .requiredOption("--title <title>", "Title of the post")
-        .requiredOption("--content <content>", "Post content (markdown supported)")
+    space
+        .command("create-thread")
+        .description("Create a thread in a space.")
+        .requiredOption("--title <title>", "Title of the thread")
+        .requiredOption("--content <content>", "Thread content (markdown supported)")
         .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiPost(`/spaces/${spaceSlug}/posts`, {
+        const spaceSlug = resolveSpaceSlug(space);
+        const resp = (await apiPost(`/spaces/${spaceSlug}/threads`, {
             title: opts.title,
             content: opts.content,
         }));
-        const msg = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(msg);
-            return;
-        }
-        console.log(`Post created!\n` +
-            `  ID: ${msg.id}\n` +
-            `  Title: ${msg.title}\n` +
-            `  Created: ${msg.createdAt}`);
-    });
-    astra
-        .command("edit-post <postId>")
-        .description("Edit a post. You must be the author.")
-        .option("--title <title>", "New title for the post")
-        .option("--content <content>", "New content for the post (markdown supported)")
-        .action(async (postId, opts) => {
+        const thread = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(thread);
+            return;
+        }
+        console.log(`Thread created!\n` +
+            `  ID: ${thread.id}\n` +
+            `  Title: ${thread.title}\n` +
+            `  Created: ${thread.createdAt}`);
+    });
+    space
+        .command("edit-thread <threadId>")
+        .description("Edit a thread. You must be the author.")
+        .option("--title <title>", "New title for the thread")
+        .option("--content <content>", "New content for the thread (markdown supported)")
+        .action(async (threadId, opts) => {
         if (!opts.title && !opts.content) {
             throw new Error("Provide at least --title or --content to update.");
         }
-        const spaceSlug = resolveSpaceSlug(astra);
+        const spaceSlug = resolveSpaceSlug(space);
         const body = {};
         if (opts.title != null)
             body.title = opts.title;
         if (opts.content != null)
             body.content = opts.content;
-        const resp = (await apiPatch(`/spaces/${spaceSlug}/posts/${postId}`, body));
-        const msg = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(msg);
+        const resp = (await apiPatch(`/spaces/${spaceSlug}/threads/${threadId}`, body));
+        const thread = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(thread);
             return;
         }
-        console.log(`Post edited!\n` +
-            `  ID: ${msg.id}\n` +
-            `  Title: ${msg.title}\n` +
-            `  Edited: ${msg.editedAt}`);
+        console.log(`Thread edited!\n` +
+            `  ID: ${thread.id}\n` +
+            `  Title: ${thread.title}\n` +
+            `  Edited: ${thread.editedAt}`);
     });
-    astra
-        .command("delete-post <postId>")
-        .description("Delete a post. You must be the author.")
-        .action(async (postId) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        await apiDelete(`/spaces/${spaceSlug}/posts/${postId}`);
-        if (isJsonMode(astra)) {
-            jsonOut({ id: postId });
+    space
+        .command("delete-thread <threadId>")
+        .description("Delete a thread. You must be the author.")
+        .action(async (threadId) => {
+        const spaceSlug = resolveSpaceSlug(space);
+        await apiDelete(`/spaces/${spaceSlug}/threads/${threadId}`);
+        if (isJsonMode(space)) {
+            jsonOut({ id: threadId });
             return;
         }
-        console.log(`Post ${postId} deleted.`);
+        console.log(`Thread ${threadId} deleted.`);
     });
     // ── Replies (create, edit, delete) ──
-    astra
-        .command("create-reply <postId>")
-        .description("Create a reply to a post in a space.")
+    space
+        .command("create-reply <threadId>")
+        .description("Create a reply to a thread in a space.")
         .requiredOption("--content <content>", "Reply content (markdown supported)")
-        .action(async (postId, opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiPost(`/spaces/${spaceSlug}/posts/${postId}/replies`, { content: opts.content }));
+        .action(async (threadId, opts) => {
+        const spaceSlug = resolveSpaceSlug(space);
+        const resp = (await apiPost(`/spaces/${spaceSlug}/threads/${threadId}/replies`, { content: opts.content }));
         const msg = unwrapResp(resp);
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut(msg);
             return;
         }
         console.log(`Reply created!\n  ID: ${msg.id}\n  Created: ${msg.createdAt}`);
     });
-    astra
+    space
         .command("edit-reply <replyId>")
         .description("Edit a reply. You must be the author.")
         .requiredOption("--content <content>", "New content for the reply (markdown supported)")
         .action(async (replyId, opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
+        const spaceSlug = resolveSpaceSlug(space);
         const resp = (await apiPatch(`/spaces/${spaceSlug}/replies/${replyId}`, { content: opts.content }));
         const msg = unwrapResp(resp);
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut(msg);
             return;
         }
         console.log(`Reply edited!\n  ID: ${msg.id}\n  Edited: ${msg.editedAt}`);
     });
-    astra
+    space
         .command("delete-reply <replyId>")
         .description("Delete a reply. You must be the author.")
         .action(async (replyId) => {
-        const spaceSlug = resolveSpaceSlug(astra);
+        const spaceSlug = resolveSpaceSlug(space);
         await apiDelete(`/spaces/${spaceSlug}/replies/${replyId}`);
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut({ replyId });
             return;
         }
         console.log(`Reply ${replyId} deleted.`);
     });
-    // ── Sessions (get, list, reply) ──
-    astra
-        .command("get-session <sessionId>")
-        .description("Get a session and its messages (paginated).")
-        .option("--limit <number>", "Messages per page", "20")
-        .option("--offset <number>", "Offset for message pagination", "0")
-        .action(async (sessionId, opts) => {
-        const resp = (await apiGet(`/session/${sessionId}`, {
-            limit: parseInt(opts.limit, 10),
-            offset: parseInt(opts.offset, 10),
-        }));
-        const data = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(data);
-            return;
-        }
-        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 ||
-                m.source ||
-                `User ${m.authorId}`;
-            const text = m.content;
-            const truncated = text.length > 200 ? text.slice(0, 200) + "\u2026" : text;
-            msgLines.push(`  - ${author}: ${truncated} (${m.createdAt})`);
-        }
-        const output = [
-            `Session: ${session.title}`,
-            `  ID: ${session.id}`,
-            `  Mode: ${session.mode}`,
-            `  Last activity: ${session.lastMessageAt}`,
-            "",
-            `Messages (${messages.length} of ${totalMessages}):`,
-            ...msgLines,
-        ].join("\n");
-        console.log(output);
-    });
-    astra
-        .command("list-sessions")
-        .description("List all sessions you are part of, sorted by most recent activity.")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--offset <number>", "Offset for pagination", "0")
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const limit = parseInt(opts.limit, 10);
-        const offset = parseInt(opts.offset, 10);
-        const resp = (await apiGet(`/session/my-sessions`, {
-            spaceSlug,
-            limit,
-            offset,
-        }));
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        const total = pagination.total ?? items.length;
-        if (isJsonMode(astra)) {
-            jsonOut({
-                items,
-                pagination: resp.pagination || {},
-            });
-            return;
-        }
-        if (!items.length) {
-            console.log("No sessions found.");
-            return;
-        }
-        const lines = [];
-        for (const s of items) {
-            const title = s.title || "(no title)";
-            const members = s.members || [];
-            const memberCount = s.memberCount ?? 0;
-            let memberInfo = "";
-            if (members.length > 0) {
-                const names = members.map((m) => m.vaultName || m.name || "Unknown");
-                const overflow = memberCount - members.length - 1; // -1 for "me"
-                memberInfo = ` | with: ${names.join(", ")}`;
-                if (overflow > 0)
-                    memberInfo += ` +${overflow} more`;
-            }
-            lines.push(`- [${s.id}] "${title}" (mode: ${s.mode}, last activity: ${s.lastMessageAt})${memberInfo}`);
-        }
-        console.log(`Sessions (${items.length} of ${total}):\n` + lines.join("\n"));
-    });
-    astra
-        .command("reply-session <sessionId>")
-        .description("Send a human reply to a session you are a member of.")
-        .requiredOption("--content <content>", "Reply content (markdown supported)")
-        .action(async (sessionId, opts) => {
-        const resp = (await apiPost(`/session/${sessionId}/reply`, {
-            content: opts.content,
-        }));
-        const msg = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(msg);
-            return;
-        }
-        console.log(`Reply sent!\n` +
-            `  Message ID: ${msg.id}\n` +
-            `  Source: ${msg.source}\n` +
-            `  Created: ${msg.createdAt}`);
-    });
-    astra
-        .command("update-session <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(astra)) {
-            jsonOut(data);
-            return;
-        }
-        const session = (data.session || data);
-        console.log(`Session updated!\n` +
-            `  ID: ${session.id}\n` +
-            `  Mode: ${session.mode}`);
-    });
-    // ── Brain Updates (list, create, edit, delete) ──
-    astra
-        .command("list-brain-updates")
-        .description("List recent brain updates in a space (paginated).")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--offset <number>", "Offset for pagination", "0")
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/brain-updates`, {
-            limit: parseInt(opts.limit, 10),
-            offset: parseInt(opts.offset, 10),
-        }));
-        if (isJsonMode(astra)) {
-            jsonOut({
-                items: resp.data || [],
-                pagination: resp.pagination || {},
-            });
-            return;
-        }
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (!items.length) {
-            console.log("No brain updates found.");
-            return;
-        }
-        const lines = [];
-        for (const u of items) {
-            const author = u.author?.name ||
-                `User ${u.authorId}`;
-            const vaultSlug = u.vault?.vaultSlug ||
-                "?";
-            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"));
-    });
-    astra
-        .command("create-brain-update")
-        .description("Create a brain update in a space. Uses the vault from settings.")
-        .option("--vault-slug <vaultSlug>", "Vault slug (overrides .gobi/settings.yaml)")
-        .requiredOption("--title <title>", "Title of the update")
-        .requiredOption("--content <content>", "Update content (markdown supported)")
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const vaultSlug = resolveVaultSlug(opts);
-        const resp = (await apiPost(`/spaces/${spaceSlug}/brain-updates`, {
-            vaultSlug,
-            title: opts.title,
-            content: opts.content,
-        }));
-        const u = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(u);
-            return;
-        }
-        console.log(`Brain update created!\n` +
-            `  ID: ${u.id}\n` +
-            `  Title: ${u.title}\n` +
-            `  Vault: ${u.vaultSlug || vaultSlug}\n` +
-            `  Created: ${u.createdAt}`);
-    });
-    astra
-        .command("edit-brain-update <updateId>")
-        .description("Edit a published brain update. You must be the author.")
-        .option("--title <title>", "New title for the update")
-        .option("--content <content>", "New content for the update (markdown supported)")
-        .action(async (updateId, opts) => {
-        if (!opts.title && !opts.content) {
-            throw new Error("Provide at least --title or --content to update.");
-        }
-        const spaceSlug = resolveSpaceSlug(astra);
-        const body = {};
-        if (opts.title != null)
-            body.title = opts.title;
-        if (opts.content != null)
-            body.content = opts.content;
-        const resp = (await apiPatch(`/spaces/${spaceSlug}/brain-updates/${updateId}`, body));
-        const u = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(u);
-            return;
-        }
-        console.log(`Brain update edited!\n` +
-            `  ID: ${u.id}\n` +
-            `  Title: ${u.title}\n` +
-            `  Updated: ${u.updatedAt}`);
-    });
-    astra
-        .command("delete-brain-update <updateId>")
-        .description("Delete a published brain update. You must be the author.")
-        .action(async (updateId) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        await apiDelete(`/spaces/${spaceSlug}/brain-updates/${updateId}`);
-        if (isJsonMode(astra)) {
-            jsonOut({ id: updateId });
-            return;
-        }
-        console.log(`Brain update ${updateId} deleted.`);
-    });
 }

package/dist/commands/brain.js ADDED Viewed

@@ -0,0 +1,227 @@
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
+import { WEBDRIVE_BASE_URL } from "../constants.js";
+import { getValidToken } from "../auth/manager.js";
+import { getVaultSlug } from "./init.js";
+import { isJsonMode, jsonOut, resolveVaultSlug, unwrapResp } from "./utils.js";
+export function registerBrainCommand(program) {
+    const brain = program
+        .command("brain")
+        .description("Brain commands (search, ask, publish, unpublish, updates).");
+    // ── Search ──
+    brain
+        .command("search")
+        .description("Search public brains by text and semantic similarity.")
+        .requiredOption("--query <query>", "Search query")
+        .action(async (opts) => {
+        const resp = (await apiGet(`/vault/public/search`, {
+            query: opts.query,
+        }));
+        const results = (Array.isArray(resp) ? resp : resp.data || resp);
+        if (isJsonMode(brain)) {
+            jsonOut(results || []);
+            return;
+        }
+        if (!results || results.length === 0) {
+            console.log(`No brains found matching "${opts.query}".`);
+            return;
+        }
+        const lines = [];
+        for (const entry of results) {
+            const vault = (entry.vault || entry);
+            const owner = (entry.owner || {});
+            const ownerName = owner.name ? ` by ${owner.name}` : "";
+            const sim = entry.similarity != null
+                ? ` [similarity: ${entry.similarity.toFixed(3)}]`
+                : "";
+            const spaceSlug = (entry.spaceSlug || vault.spaceSlug || "");
+            const vaultSlug = (vault.slug || vault.vaultSlug || vault.id || "N/A");
+            lines.push(`- ${vault.name || vault.title || "N/A"} (vault: ${vaultSlug}, space: ${spaceSlug || "N/A"})${ownerName}${sim}`);
+        }
+        console.log(`Brains matching "${opts.query}":\n` + lines.join("\n"));
+    });
+    // ── Ask ──
+    brain
+        .command("ask")
+        .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("--mode <mode>", 'Session mode: "auto" or "manual"')
+        .action(async (opts) => {
+        const spaceSlug = opts.spaceSlug;
+        const body = {
+            vaultSlug: opts.vaultSlug,
+            spaceSlug,
+            question: opts.question,
+        };
+        if (opts.mode != null)
+            body.mode = opts.mode;
+        const resp = (await apiPost(`/session/targeted`, body));
+        const data = unwrapResp(resp);
+        if (isJsonMode(brain)) {
+            jsonOut(data);
+            return;
+        }
+        const session = (data.session || {});
+        const members = (data.members || []);
+        console.log(`Session created!\n` +
+            `  Session ID: ${session.id}\n` +
+            `  Mode: ${session.mode}\n` +
+            `  Members: ${members.length}\n` +
+            `  Question sent.`);
+    });
+    // ── Publish ──
+    brain
+        .command("publish")
+        .description("Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).")
+        .action(async () => {
+        const vaultId = getVaultSlug();
+        const filePath = join(process.cwd(), "BRAIN.md");
+        if (!existsSync(filePath)) {
+            throw new Error(`BRAIN.md not found in ${process.cwd()}`);
+        }
+        const content = readFileSync(filePath, "utf-8");
+        const token = await getValidToken();
+        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/files/BRAIN.md`;
+        const res = await fetch(url, {
+            method: "PUT",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "text/markdown",
+            },
+            body: content,
+        });
+        if (!res.ok) {
+            throw new Error(`Upload failed: HTTP ${res.status}: ${(await res.text()) || "(no body)"}`);
+        }
+        if (isJsonMode(brain)) {
+            jsonOut({ vaultId });
+            return;
+        }
+        console.log(`Published BRAIN.md to vault "${vaultId}"`);
+    });
+    // ── Unpublish ──
+    brain
+        .command("unpublish")
+        .description("Delete BRAIN.md from the vault on webdrive.")
+        .action(async () => {
+        const vaultId = getVaultSlug();
+        const token = await getValidToken();
+        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/files/BRAIN.md`;
+        const res = await fetch(url, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok) {
+            throw new Error(`Delete failed: HTTP ${res.status}: ${(await res.text()) || "(no body)"}`);
+        }
+        if (isJsonMode(brain)) {
+            jsonOut({ vaultId });
+            return;
+        }
+        console.log(`Deleted BRAIN.md from vault "${vaultId}"`);
+    });
+    // ── Updates (list, post, edit, delete) ──
+    brain
+        .command("list-updates")
+        .description("List recent brain updates for a vault (paginated).")
+        .option("--vault-slug <vaultSlug>", "Vault slug (overrides .gobi/settings.yaml)")
+        .option("--mine", "List only my own brain updates")
+        .option("--limit <number>", "Items per page", "20")
+        .option("--offset <number>", "Offset for pagination", "0")
+        .action(async (opts) => {
+        const params = {
+            limit: parseInt(opts.limit, 10),
+            offset: parseInt(opts.offset, 10),
+        };
+        if (opts.mine)
+            params.mine = true;
+        if (opts.vaultSlug)
+            params.vaultSlug = opts.vaultSlug;
+        const resp = (await apiGet(`/brain-updates`, params));
+        if (isJsonMode(brain)) {
+            jsonOut({
+                items: resp.data || [],
+                pagination: resp.pagination || {},
+            });
+            return;
+        }
+        const items = (resp.data || []);
+        const pagination = (resp.pagination || {});
+        if (!items.length) {
+            console.log("No brain updates found.");
+            return;
+        }
+        const lines = [];
+        for (const u of items) {
+            const author = u.author?.name ||
+                `User ${u.authorId}`;
+            const vaultSlug = u.vault?.vaultSlug ||
+                "?";
+            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"));
+    });
+    brain
+        .command("post-update")
+        .description("Post a brain update for a vault.")
+        .option("--vault-slug <vaultSlug>", "Vault slug (overrides .gobi/settings.yaml)")
+        .requiredOption("--title <title>", "Title of the update")
+        .requiredOption("--content <content>", "Update content (markdown supported)")
+        .action(async (opts) => {
+        const vaultSlug = resolveVaultSlug(opts);
+        const resp = (await apiPost(`/brain-updates/vault/${vaultSlug}`, {
+            title: opts.title,
+            content: opts.content,
+        }));
+        const u = unwrapResp(resp);
+        if (isJsonMode(brain)) {
+            jsonOut(u);
+            return;
+        }
+        console.log(`Brain update posted!\n` +
+            `  ID: ${u.id}\n` +
+            `  Title: ${u.title}\n` +
+            `  Vault: ${u.vaultSlug || vaultSlug}\n` +
+            `  Created: ${u.createdAt}`);
+    });
+    brain
+        .command("edit-update <updateId>")
+        .description("Edit a published brain update. You must be the author.")
+        .option("--title <title>", "New title for the update")
+        .option("--content <content>", "New content for the update (markdown supported)")
+        .action(async (updateId, opts) => {
+        if (!opts.title && !opts.content) {
+            throw new Error("Provide at least --title or --content to update.");
+        }
+        const body = {};
+        if (opts.title != null)
+            body.title = opts.title;
+        if (opts.content != null)
+            body.content = opts.content;
+        const resp = (await apiPatch(`/brain-updates/${updateId}`, body));
+        const u = unwrapResp(resp);
+        if (isJsonMode(brain)) {
+            jsonOut(u);
+            return;
+        }
+        console.log(`Brain update edited!\n` +
+            `  ID: ${u.id}\n` +
+            `  Title: ${u.title}\n` +
+            `  Updated: ${u.updatedAt}`);
+    });
+    brain
+        .command("delete-update <updateId>")
+        .description("Delete a published brain update. You must be the author.")
+        .action(async (updateId) => {
+        await apiDelete(`/brain-updates/${updateId}`);
+        if (isJsonMode(brain)) {
+            jsonOut({ id: updateId });
+            return;
+        }
+        console.log(`Brain update ${updateId} deleted.`);
+    });
+}

package/dist/commands/init.js CHANGED Viewed

@@ -21,7 +21,7 @@ export function getSpaceSlug() {
     const settings = readSettings();
     const slug = settings?.selectedSpaceSlug;
     if (!slug) {
-        throw new Error("Space not set. Run 'gobi astra warp' first.");
+        throw new Error("Space not set. Run 'gobi space warp' first.");
     }
     return slug;
 }
@@ -35,13 +35,21 @@ export function getVaultSlug() {
 }
 export function printContext() {
     const settings = readSettings();
-    const slug = settings?.selectedSpaceSlug;
-    if (!slug) {
-        console.log("Not initialized. Run 'gobi init' to set up.");
+    const vault = settings?.vaultSlug;
+    const space = settings?.selectedSpaceSlug;
+    if (!vault && !space) {
+        console.log("Run 'gobi init' to set up, then 'gobi space warp' to select a space.");
+        return;
+    }
+    if (!vault) {
+        console.log("Vault not set. Run 'gobi init' to set up.");
+        return;
+    }
+    if (!space) {
+        console.log(`Vault: ${vault} | Space not set. Run 'gobi space warp' to select a space.`);
         return;
     }
-    const vaultId = settings?.vaultSlug || "?";
-    console.log(`Space: ${slug} | Vault: ${vaultId}`);
+    console.log(`Space: ${space} | Vault: ${vault}`);
 }
 function ensureSettingsDir() {
     const dir = join(process.cwd(), SETTINGS_DIR);

package/dist/commands/sessions.js ADDED Viewed

@@ -0,0 +1,138 @@
+import { apiGet, apiPost, apiPatch } 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).");
+    // ── 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")
+        .action(async (sessionId, opts) => {
+        const resp = (await apiGet(`/session/${sessionId}`, {
+            limit: parseInt(opts.limit, 10),
+            offset: parseInt(opts.offset, 10),
+        }));
+        const data = unwrapResp(resp);
+        if (isJsonMode(sessions)) {
+            jsonOut(data);
+            return;
+        }
+        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 ||
+                m.source ||
+                `User ${m.authorId}`;
+            const text = m.content;
+            const truncated = text.length > 200 ? text.slice(0, 200) + "\u2026" : text;
+            msgLines.push(`  - ${author}: ${truncated} (${m.createdAt})`);
+        }
+        const output = [
+            `Session: ${session.title}`,
+            `  ID: ${session.id}`,
+            `  Mode: ${session.mode}`,
+            `  Last activity: ${session.lastMessageAt}`,
+            "",
+            `Messages (${messages.length} of ${totalMessages}):`,
+            ...msgLines,
+        ].join("\n");
+        console.log(output);
+    });
+    // ── List ──
+    sessions
+        .command("list")
+        .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")
+        .action(async (opts) => {
+        const limit = parseInt(opts.limit, 10);
+        const offset = parseInt(opts.offset, 10);
+        const query = { limit, offset };
+        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,
+                pagination: resp.pagination || {},
+            });
+            return;
+        }
+        if (!items.length) {
+            console.log("No sessions found.");
+            return;
+        }
+        const lines = [];
+        for (const s of items) {
+            const title = s.title || "(no title)";
+            const members = s.members || [];
+            const memberCount = s.memberCount ?? 0;
+            let memberInfo = "";
+            if (members.length > 0) {
+                const names = members.map((m) => m.vaultName || m.name || "Unknown");
+                const overflow = memberCount - members.length - 1; // -1 for "me"
+                memberInfo = ` | with: ${names.join(", ")}`;
+                if (overflow > 0)
+                    memberInfo += ` +${overflow} more`;
+            }
+            lines.push(`- [${s.id}] "${title}" (mode: ${s.mode}, last activity: ${s.lastMessageAt})${memberInfo}`);
+        }
+        console.log(`Sessions (${items.length} of ${total}):\n` + lines.join("\n"));
+    });
+    // ── 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)")
+        .action(async (sessionId, opts) => {
+        const resp = (await apiPost(`/session/${sessionId}/reply`, {
+            content: opts.content,
+        }));
+        const msg = unwrapResp(resp);
+        if (isJsonMode(sessions)) {
+            jsonOut(msg);
+            return;
+        }
+        console.log(`Reply sent!\n` +
+            `  Message ID: ${msg.id}\n` +
+            `  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/dist/commands/utils.js ADDED Viewed

@@ -0,0 +1,19 @@
+import { getSpaceSlug, getVaultSlug } from "./init.js";
+export function isJsonMode(cmd) {
+    return !!cmd.parent?.opts().json;
+}
+export function jsonOut(data) {
+    console.log(JSON.stringify({ success: true, data }));
+}
+export function resolveSpaceSlug(cmd) {
+    return cmd.opts().spaceSlug || getSpaceSlug();
+}
+export function resolveVaultSlug(opts) {
+    return opts.vaultSlug || getVaultSlug();
+}
+export function unwrapResp(resp) {
+    if (typeof resp === "object" && resp !== null && "data" in resp) {
+        return resp.data;
+    }
+    return resp;
+}

package/dist/main.js CHANGED Viewed

@@ -5,6 +5,8 @@ import { ApiError, AstraError } from "./errors.js";
 import { registerAuthCommand } from "./commands/auth.js";
 import { registerInitCommand, printContext } from "./commands/init.js";
 import { registerAstraCommand } from "./commands/astra.js";
+import { registerBrainCommand } from "./commands/brain.js";
+import { registerSessionsCommand } from "./commands/sessions.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const SKIP_BANNER_COMMANDS = new Set(["auth", "init"]);
@@ -26,6 +28,8 @@ export async function cli() {
     registerAuthCommand(program);
     registerInitCommand(program);
     registerAstraCommand(program);
+    registerBrainCommand(program);
+    registerSessionsCommand(program);
     // Propagate helpWidth to all subcommands
     const helpWidth = process.stdout.columns || 200;
     for (const cmd of program.commands) {

package/package.json CHANGED Viewed

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