@gobi-ai/cli 2.0.21 → 2.0.23

package/dist/commands/saved.js

@@ -1,261 +0,0 @@
-import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { fetchDraftSummary, isJsonMode, jsonOut, readStdin, unwrapResp, } from "./utils.js";
-function defaultTimezone() {
-    return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
-}
-function formatNoteLine(note) {
-    const content = note.content ?? "";
-    const snippet = content
-        ? content.length > 80
-            ? content.slice(0, 80) + "…"
-            : content
-        : "(no content)";
-    const attachments = (note.attachments || []);
-    const attachStr = attachments.length
-        ? `, ${attachments.length} ${attachments.length === 1 ? "attachment" : "attachments"}`
-        : "";
-    const agent = note.agentId != null ? `, agent: ${note.agentId}` : "";
-    return `- [${note.id}] "${snippet.replace(/\n/g, " ")}" (${note.eventDate}${agent}${attachStr}, updated ${note.updatedAt})`;
-}
-function formatSavedPostLine(item) {
-    const author = item.author?.name;
-    const title = item.title || item.content || "(no title)";
-    const snippet = title.length > 80 ? title.slice(0, 80) + "…" : title;
-    const space = item.spaceSlug ? `, space: ${item.spaceSlug}` : "";
-    return `- [${item.postId}] "${snippet.replace(/\n/g, " ")}" by ${author ?? "?"}${space} (saved ${item.savedAt})`;
-}
-export function registerSavedCommand(program) {
-    const saved = program
-        .command("saved")
-        .description("Saved-knowledge commands (notes and bookmarked posts).");
-    // ── Notes ──
-    saved
-        .command("list-notes")
-        .description("List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.")
-        .option("--date <date>", "Filter to a single day (YYYY-MM-DD)")
-        .option("--timezone <tz>", "IANA timezone name (default: system timezone)")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--cursor <string>", "Pagination cursor from previous response")
-        .action(async (opts) => {
-        const params = {
-            timezone: opts.timezone || defaultTimezone(),
-            limit: parseInt(opts.limit, 10),
-        };
-        if (opts.date)
-            params.date = opts.date;
-        if (opts.cursor)
-            params.cursor = opts.cursor;
-        const resp = (await apiGet(`/app/notes`, params));
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (isJsonMode(saved)) {
-            jsonOut({ items, pagination });
-            return;
-        }
-        if (!items.length) {
-            console.log("No notes found.");
-            return;
-        }
-        const lines = items.map(formatNoteLine);
-        const footer = pagination.hasMore
-            ? `\n  Next cursor: ${pagination.nextCursor}`
-            : "";
-        console.log(`Notes (${items.length} items):\n` + lines.join("\n") + footer);
-    });
-    saved
-        .command("get-note <noteId>")
-        .description("Get a single note by id.")
-        .action(async (noteId) => {
-        const resp = (await apiGet(`/app/notes/${noteId}`));
-        const note = unwrapResp(resp);
-        if (isJsonMode(saved)) {
-            jsonOut(note);
-            return;
-        }
-        const attachments = (note.attachments || []);
-        const attachLines = attachments.map((a) => `  - [${a.id}] ${a.mediaUrl} (position ${a.position})`);
-        const agentLine = note.agentId != null ? `Agent: ${note.agentId}\n` : "";
-        const output = [
-            `Note: ${note.id}`,
-            `Date: ${note.eventDate}`,
-            `Created: ${note.createdAt}`,
-            `Updated: ${note.updatedAt}`,
-            agentLine.trimEnd(),
-            "",
-            note.content || "(no content)",
-            ...(attachLines.length ? ["", `Attachments (${attachLines.length}):`, ...attachLines] : []),
-        ]
-            .filter((line) => line !== "")
-            .concat([""])
-            .join("\n")
-            .trimEnd();
-        console.log(output);
-    });
-    saved
-        .command("create-note")
-        .description("Create a note. Provide --content (use '-' for stdin), or --draft-id to source content from a draft.")
-        .option("--content <content>", 'Note content (markdown supported, use "-" for stdin)')
-        .option("--timezone <tz>", "IANA timezone name (default: system timezone)")
-        .option("--agent-id <number>", "Optional agent id to associate with the note")
-        .option("--draft-id <draftId>", "Use this draft as the source of content (mutually exclusive with --content). The draft's title is prepended as an H1 heading. On success, links the note back by recording noteId on draft.metadata so the client can render an 'Open note' button.")
-        .action(async (opts) => {
-        if (opts.draftId) {
-            if (opts.content) {
-                throw new Error("--draft-id sources content from the draft; --content is not allowed alongside it.");
-            }
-        }
-        else if (!opts.content) {
-            throw new Error("--content is required (use '-' to read from stdin), or pass --draft-id.");
-        }
-        let content;
-        if (opts.draftId) {
-            const draft = await fetchDraftSummary(opts.draftId);
-            content = draft.title
-                ? `# ${draft.title}\n\n${draft.content}`
-                : draft.content;
-        }
-        else {
-            content = opts.content === "-" ? readStdin() : opts.content;
-        }
-        const body = {
-            content,
-            timezone: opts.timezone || defaultTimezone(),
-        };
-        if (opts.agentId)
-            body.agentId = parseInt(opts.agentId, 10);
-        const resp = (await apiPost(`/app/notes`, body));
-        const note = unwrapResp(resp);
-        if (opts.draftId && note.id != null) {
-            try {
-                await apiPatch(`/app/drafts/${opts.draftId}/metadata`, {
-                    noteId: typeof note.id === "number" ? note.id : Number(note.id),
-                });
-            }
-            catch (e) {
-                console.error(`Warning: failed to link note to draft ${opts.draftId}: ${e.message}`);
-            }
-        }
-        if (isJsonMode(saved)) {
-            jsonOut(note);
-            return;
-        }
-        console.log(`Note created!\n  ID: ${note.id}\n  Date: ${note.eventDate}\n  Created: ${note.createdAt}` +
-            (opts.draftId ? `\n  Linked to draft: ${opts.draftId}` : ""));
-    });
-    saved
-        .command("edit-note <noteId>")
-        .description("Edit a note. Provide --content and/or --agent-id.")
-        .option("--content <content>", 'New note content (markdown supported, use "-" for stdin)')
-        .option("--agent-id <number>", 'New agent id, or "null" to clear the association')
-        .action(async (noteId, opts) => {
-        if (opts.content == null && opts.agentId == null) {
-            throw new Error("Provide at least --content or --agent-id to update.");
-        }
-        const body = {};
-        if (opts.content != null) {
-            body.content =
-                opts.content === "-" ? readStdin() : opts.content;
-        }
-        if (opts.agentId != null) {
-            body.agentId = opts.agentId === "null" ? null : parseInt(opts.agentId, 10);
-        }
-        const resp = (await apiPatch(`/app/notes/${noteId}`, body));
-        const note = unwrapResp(resp);
-        if (isJsonMode(saved)) {
-            jsonOut(note);
-            return;
-        }
-        console.log(`Note edited!\n  ID: ${note.id}\n  Updated: ${note.updatedAt}`);
-    });
-    saved
-        .command("delete-note <noteId>")
-        .description("Delete a note you authored.")
-        .action(async (noteId) => {
-        await apiDelete(`/app/notes/${noteId}`);
-        if (isJsonMode(saved)) {
-            jsonOut({ id: noteId });
-            return;
-        }
-        console.log(`Note ${noteId} deleted.`);
-    });
-    // ── Saved posts (bookmarks) ──
-    saved
-        .command("list-posts")
-        .description("List posts you have bookmarked (paginated).")
-        .option("--type <type>", "Filter by type: all|article|space-post", "all")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--cursor <string>", "Pagination cursor from previous response")
-        .action(async (opts) => {
-        const params = {
-            type: opts.type,
-            limit: parseInt(opts.limit, 10),
-        };
-        if (opts.cursor)
-            params.cursor = opts.cursor;
-        const resp = (await apiGet(`/reactions/me/saved`, params));
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (isJsonMode(saved)) {
-            jsonOut({ items, pagination });
-            return;
-        }
-        if (!items.length) {
-            console.log("No saved posts found.");
-            return;
-        }
-        const lines = items.map(formatSavedPostLine);
-        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
-        console.log(`Saved posts (${items.length} items):\n` + lines.join("\n") + footer);
-    });
-    saved
-        .command("get-post <postId>")
-        .description("Get a saved post snapshot by post id.")
-        .action(async (postId) => {
-        const resp = (await apiGet(`/posts/${postId}`));
-        const data = unwrapResp(resp);
-        if (isJsonMode(saved)) {
-            jsonOut(data);
-            return;
-        }
-        const post = (data.update || data.post || data);
-        const author = post.author?.name ||
-            `User ${post.authorId}`;
-        const title = post.title || "(no title)";
-        console.log([
-            `Saved post [${post.id}]: ${title}`,
-            `By: ${author} on ${post.createdAt}`,
-            "",
-            post.content || "",
-        ].join("\n"));
-    });
-    saved
-        .command("create-post")
-        .description("Bookmark a post or reply by id. Records a snapshot in your saved-posts collection.")
-        .requiredOption("--source <id>", "Source post or reply id to bookmark (numeric)")
-        .action(async (opts) => {
-        const sourceId = parseInt(opts.source, 10);
-        if (!Number.isFinite(sourceId)) {
-            throw new Error("--source must be a numeric post or reply id.");
-        }
-        const resp = (await apiPost(`/reactions/posts/${sourceId}/save`, {
-            vaultIds: [],
-        }));
-        const data = unwrapResp(resp);
-        if (isJsonMode(saved)) {
-            jsonOut({ id: sourceId, ...data });
-            return;
-        }
-        console.log(`Saved post ${sourceId}.`);
-    });
-    saved
-        .command("delete-post <postId>")
-        .description("Remove a post from your saved-posts collection.")
-        .action(async (postId) => {
-        await apiDelete(`/reactions/posts/${postId}/save`);
-        if (isJsonMode(saved)) {
-            jsonOut({ id: postId });
-            return;
-        }
-        console.log(`Removed post ${postId} from saved.`);
-    });
-}

package/dist/commands/sessions.js

@@ -1,124 +0,0 @@
-import { apiGet, apiPost } from "../client.js";
-import { isJsonMode, jsonOut, readStdin, unwrapResp } from "./utils.js";
-export function registerSessionsCommand(program) {
-    const sessions = program
-        .command("session")
-        .description("Session commands (get, list, create-reply).");
-    // ── Get ──
-    sessions
-        .command("get <sessionId>")
-        .description("Get a session and its messages (paginated).")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--cursor <string>", "Pagination cursor from previous response")
-        .action(async (sessionId, opts) => {
-        const params = {
-            limit: parseInt(opts.limit, 10),
-        };
-        if (opts.cursor)
-            params.cursor = opts.cursor;
-        const resp = (await apiGet(`/chat/${sessionId}/messages`, params));
-        const messages = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (isJsonMode(sessions)) {
-            jsonOut({ messages, pagination });
-            return;
-        }
-        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: ${sessionId}`,
-            "",
-            `Messages (${messages.length} items):`,
-            ...msgLines,
-            ...(pagination.hasMore ? [`  Next cursor: ${pagination.nextCursor}`] : []),
-        ].join("\n");
-        console.log(output);
-    });
-    // ── List ──
-    sessions
-        .command("list")
-        .description("List all sessions you are part of, sorted by most recent activity.")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--cursor <string>", "Pagination cursor from previous response")
-        .action(async (opts) => {
-        const query = { limit: parseInt(opts.limit, 10) };
-        if (opts.cursor)
-            query.cursor = opts.cursor;
-        const resp = (await apiGet(`/chat/my-sessions`, query));
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        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.sessionId}] "${title}" (mode: ${s.mode}, last activity: ${s.lastMessageAt})${memberInfo}`);
-        }
-        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
-        console.log(`Sessions (${items.length} items):\n` + lines.join("\n") + footer);
-    });
-    // ── Reply ──
-    sessions
-        .command("create-reply <sessionId>")
-        .description("Send a human reply to a session you are a member of.")
-        .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
-        .option("--rich-text <richText>", "Rich-text JSON array (e.g. [{\"type\":\"text\",\"text\":\"hello\"}])")
-        .action(async (sessionId, opts) => {
-        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 === "-" ? readStdin() : opts.content;
-        }
-        const resp = (await apiPost(`/chat/${sessionId}/reply`, body));
-        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}`);
-    });
-}

package/skills/gobi-core/references/session.md

@@ -1,55 +0,0 @@
-# gobi session
-
-```
-Usage: gobi session [options] [command]
-
-Session commands (get, list, create-reply).
-
-Options:
-  -h, --help                          display help for command
-
-Commands:
-  get [options] <sessionId>           Get a session and its messages (paginated).
-  list [options]                      List all sessions you are part of, sorted by most recent activity.
-  create-reply [options] <sessionId>  Send a human reply to a session you are a member of.
-  help [command]                      display help for command
-```
-
-## get
-
-```
-Usage: gobi session get [options] <sessionId>
-
-Get a session and its messages (paginated).
-
-Options:
-  --limit <number>   Items per page (default: "20")
-  --cursor <string>  Pagination cursor from previous response
-  -h, --help         display help for command
-```
-
-## list
-
-```
-Usage: gobi session list [options]
-
-List all sessions you are part of, sorted by most recent activity.
-
-Options:
-  --limit <number>   Items per page (default: "20")
-  --cursor <string>  Pagination cursor from previous response
-  -h, --help         display help for command
-```
-
-## create-reply
-
-```
-Usage: gobi session create-reply [options] <sessionId>
-
-Send a human reply to a session you are a member of.
-
-Options:
-  --content <content>     Reply content (markdown supported, use "-" for stdin)
-  --rich-text <richText>  Rich-text JSON array (e.g. [{"type":"text","text":"hello"}])
-  -h, --help              display help for command
-```

package/skills/gobi-saved/SKILL.md

@@ -1,70 +0,0 @@
----
-name: gobi-saved
-description: >-
-  Gobi saved commands for the user's personal saved-knowledge collection:
-  notes (list/get/create/edit/delete) and bookmarked posts (snapshot a
-  post/reply from feed/space; list/get/delete). Use when the user wants to
-  capture their own notes or bookmark/manage posts they've saved.
-allowed-tools: Bash(gobi:*)
-metadata:
-  author: gobi-ai
-  version: "2.0.9"
----
-
-# gobi-saved
-
-Gobi saved-knowledge commands (v2.0.9).
-
-Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
-
-## What is "saved"?
-
-`gobi saved` is the user's personal saved-knowledge collection. It covers two kinds of items:
-
-- **Notes** — user-authored notes (private, dated entries). Verbs: `list-notes`, `get-note`, `create-note`, `edit-note`, `delete-note`.
-- **Posts** — snapshots of posts (or replies) bookmarked from a space or the global feed. Verbs: `list-posts`, `get-post`, `create-post`, `delete-post`.
-
-Both are user-private — only the author can see/edit/delete their own items.
-
-> Naming note: `gobi saved create-post --source <id>` is a **bookmark** operation — it saves an existing post into your collection. It does *not* author a new post (use `gobi global create-post` or `gobi space create-post` for that).
-
-## Timezone
-
-`gobi saved list-notes` and `gobi saved create-note` need a timezone to compute the calendar day. The CLI auto-detects your system timezone via `Intl.DateTimeFormat().resolvedOptions().timeZone`. Override with `--timezone <iana-name>` (e.g. `America/Los_Angeles`).
-
-## Important: JSON Mode
-
-For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
-
-```bash
-gobi --json saved list-notes --date 2026-04-27
-```
-
-## Available Commands
-
-### Notes
-- `gobi saved list-notes` — List your notes. Without `--date`, returns recent notes via cursor pagination. With `--date YYYY-MM-DD`, returns all notes for that day.
-- `gobi saved get-note <noteId>` — Get a single note by id.
-- `gobi saved create-note --content <md>` — Create a note. Use `'-'` for stdin. Or pass `--draft-id <draftId>` to source content from a draft (mutually exclusive with `--content`); the draft's title is prepended as an H1, and the resulting `noteId` is recorded on `draft.metadata` so the client can render an "Open note" button.
-- `gobi saved edit-note <noteId>` — Edit a note. Provide `--content` and/or `--agent-id`.
-- `gobi saved delete-note <noteId>` — Delete a note you authored.
-
-### Posts (bookmarks)
-- `gobi saved list-posts` — List posts you have bookmarked (paginated). Filter with `--type all|article|space-post`.
-- `gobi saved get-post <postId>` — Get a saved post snapshot by post id.
-- `gobi saved create-post --source <id>` — Bookmark a post or reply by id. Records a snapshot in your saved-posts collection.
-- `gobi saved delete-post <postId>` — Remove a post from your saved-posts collection.
-
-## Confirm before mutating
-
-Saved items are the user's private collection but they still persist server-side and deletes are irreversible. Before running any write, confirm with the user — show the command and the note content / target id. This applies even when running autonomously.
-
-- `create-note`, `edit-note` — confirm the content (or content delta on edit).
-- `create-post` (bookmarking a feed post) — confirm the source id you're about to bookmark.
-- `delete-note`, `delete-post` — irreversible. Flag that explicitly and confirm the target id before running.
-
-Read-only commands (`list-notes`, `get-note`, `list-posts`, `get-post`) run without confirmation.
-
-## Reference Documentation
-
-- [gobi saved](references/saved.md)

package/skills/gobi-saved/references/saved.md

@@ -1,136 +0,0 @@
-# gobi saved
-
-```
-Usage: gobi saved [options] [command]
-
-Saved-knowledge commands (notes and bookmarked posts).
-
-Options:
-  -h, --help                    display help for command
-
-Commands:
-  list-notes [options]          List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.
-  get-note <noteId>             Get a single note by id.
-  create-note [options]         Create a note. Provide --content (use '-' for stdin), or --draft-id to source content from a draft.
-  edit-note [options] <noteId>  Edit a note. Provide --content and/or --agent-id.
-  delete-note <noteId>          Delete a note you authored.
-  list-posts [options]          List posts you have bookmarked (paginated).
-  get-post <postId>             Get a saved post snapshot by post id.
-  create-post [options]         Bookmark a post or reply by id. Records a snapshot in your saved-posts collection.
-  delete-post <postId>          Remove a post from your saved-posts collection.
-  help [command]                display help for command
-```
-
-## list-notes
-
-```
-Usage: gobi saved list-notes [options]
-
-List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.
-
-Options:
-  --date <date>      Filter to a single day (YYYY-MM-DD)
-  --timezone <tz>    IANA timezone name (default: system timezone)
-  --limit <number>   Items per page (default: "20")
-  --cursor <string>  Pagination cursor from previous response
-  -h, --help         display help for command
-```
-
-## get-note
-
-```
-Usage: gobi saved get-note [options] <noteId>
-
-Get a single note by id.
-
-Options:
-  -h, --help  display help for command
-```
-
-## create-note
-
-```
-Usage: gobi saved create-note [options]
-
-Create a note. Provide --content (use '-' for stdin), or --draft-id to source content from a draft.
-
-Options:
-  --content <content>   Note content (markdown supported, use "-" for stdin)
-  --timezone <tz>       IANA timezone name (default: system timezone)
-  --agent-id <number>   Optional agent id to associate with the note
-  --draft-id <draftId>  Use this draft as the source of content (mutually exclusive with --content). The draft's title is prepended as an H1 heading. On success, links the note back by recording
-                        noteId on draft.metadata so the client can render an 'Open note' button.
-  -h, --help            display help for command
-```
-
-## edit-note
-
-```
-Usage: gobi saved edit-note [options] <noteId>
-
-Edit a note. Provide --content and/or --agent-id.
-
-Options:
-  --content <content>  New note content (markdown supported, use "-" for stdin)
-  --agent-id <number>  New agent id, or "null" to clear the association
-  -h, --help           display help for command
-```
-
-## delete-note
-
-```
-Usage: gobi saved delete-note [options] <noteId>
-
-Delete a note you authored.
-
-Options:
-  -h, --help  display help for command
-```
-
-## list-posts
-
-```
-Usage: gobi saved list-posts [options]
-
-List posts you have bookmarked (paginated).
-
-Options:
-  --type <type>      Filter by type: all|article|space-post (default: "all")
-  --limit <number>   Items per page (default: "20")
-  --cursor <string>  Pagination cursor from previous response
-  -h, --help         display help for command
-```
-
-## get-post
-
-```
-Usage: gobi saved get-post [options] <postId>
-
-Get a saved post snapshot by post id.
-
-Options:
-  -h, --help  display help for command
-```
-
-## create-post
-
-```
-Usage: gobi saved create-post [options]
-
-Bookmark a post or reply by id. Records a snapshot in your saved-posts collection.
-
-Options:
-  --source <id>  Source post or reply id to bookmark (numeric)
-  -h, --help     display help for command
-```
-
-## delete-post
-
-```
-Usage: gobi saved delete-post [options] <postId>
-
-Remove a post from your saved-posts collection.
-
-Options:
-  -h, --help  display help for command
-```