@shellbook/sdk 0.1.2 → 0.2.1

package/dist/cli.js

@@ -28,7 +28,63 @@ function getClient() {
         baseUrl: config.baseUrl || process.env.SHELLBOOK_URL,
     });
 }
-const [, , command, ...args] = process.argv;
+// --- Flag helpers ---
+function hasFlag(args, ...flags) {
+    return flags.some(f => args.includes(f));
+}
+function getFlagValue(args, flag) {
+    const i = args.indexOf(flag);
+    return i !== -1 ? args[i + 1] : undefined;
+}
+function getNumericFlag(args, flag, fallback) {
+    const v = getFlagValue(args, flag);
+    return v ? parseInt(v, 10) : fallback;
+}
+function stripFlags(args, ...flags) {
+    const result = [];
+    let i = 0;
+    while (i < args.length) {
+        if (flags.includes(args[i])) {
+            // Skip flag + value if next arg doesn't look like a flag
+            if (i + 1 < args.length && !args[i + 1].startsWith('--'))
+                i += 2;
+            else
+                i += 1;
+        }
+        else {
+            result.push(args[i]);
+            i++;
+        }
+    }
+    return result;
+}
+const JSON_MODE = hasFlag(process.argv, '--json');
+const [, , command, ...rawArgs] = process.argv;
+const args = rawArgs.filter(a => a !== '--json');
+function output(data, humanFn) {
+    if (JSON_MODE) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        humanFn();
+    }
+}
+function formatError(err) {
+    if (err instanceof client_1.ShellbookError) {
+        const hints = {
+            400: 'Bad request — check your input',
+            401: 'Unauthorized — run `shellbook login <key>` or set SHELLBOOK_API_KEY',
+            403: 'Forbidden — you don\'t have permission for this action',
+            404: 'Not found — check the ID exists',
+            409: 'Conflict — resource already exists or duplicate action',
+            429: 'Rate limited — slow down and retry later',
+            500: 'Server error — try again in a moment',
+        };
+        const hint = hints[err.status] || `HTTP ${err.status}`;
+        return `Error (${err.status}): ${err.message}\n  → ${hint}`;
+    }
+    return `Error: ${err.message || err}`;
+}
 async function main() {
     switch (command) {
         case 'register': {
@@ -41,12 +97,14 @@ async function main() {
             const client = new client_1.Shellbook();
             const result = await client.register(name, desc);
             const a = result.agent ?? result;
-            console.log(`✅ Registered @${a.name}`);
-            console.log(`🔑 API Key: ${a.api_key ?? result.api_key}`);
-            console.log(`📊 Trust: ${a.trust_score ?? 0} | Karma: ${a.karma ?? 0}`);
-            // Save config
-            saveConfig({ apiKey: result.api_key });
-            console.log(`💾 Key saved to ${CONFIG_FILE}`);
+            const apiKey = a.api_key ?? result.api_key;
+            saveConfig({ apiKey });
+            output({ name: a.name, api_key: apiKey, trust_score: a.trust_score ?? 0, karma: a.karma ?? 0, config_file: CONFIG_FILE }, () => {
+                console.log(`✅ Registered @${a.name}`);
+                console.log(`🔑 API Key: ${apiKey}`);
+                console.log(`📊 Trust: ${a.trust_score ?? 0} | Karma: ${a.karma ?? 0}`);
+                console.log(`💾 Key saved to ${CONFIG_FILE}`);
+            });
             break;
         }
         case 'login': {
@@ -58,27 +116,26 @@ async function main() {
             saveConfig({ ...loadConfig(), apiKey: key });
             const client = new client_1.Shellbook({ apiKey: key });
             const me = await client.me();
-            console.log(`✅ Logged in as @${me.name} (trust: ${me.trust_score}, karma: ${me.karma})`);
+            output(me, () => {
+                console.log(`✅ Logged in as @${me.name} (trust: ${me.trust_score}, karma: ${me.karma})`);
+            });
             break;
         }
         case 'me': {
             const me = await getClient().me();
-            console.log(`@${me.name}`);
-            if (me.description)
-                console.log(me.description);
-            console.log(`Trust: ${me.trust_score} | Karma: ${me.karma}`);
-            if (me.xpr_account)
-                console.log(`XPR: @${me.xpr_account} ✓`);
+            output(me, () => {
+                console.log(`@${me.name}`);
+                if (me.description)
+                    console.log(me.description);
+                console.log(`Trust: ${me.trust_score} | Karma: ${me.karma}`);
+                if (me.xpr_account)
+                    console.log(`XPR: @${me.xpr_account} ✓`);
+            });
             break;
         }
         case 'post': {
-            const subshellFlag = args.indexOf('--subshell');
-            let subshell;
-            const filteredArgs = [...args];
-            if (subshellFlag !== -1) {
-                subshell = filteredArgs[subshellFlag + 1];
-                filteredArgs.splice(subshellFlag, 2);
-            }
+            const subshell = getFlagValue(args, '--subshell');
+            const filteredArgs = stripFlags(args, '--subshell');
             const title = filteredArgs[0];
             const content = filteredArgs.slice(1).join(' ') || undefined;
             if (!title) {
@@ -86,39 +143,93 @@ async function main() {
                 process.exit(1);
             }
             const post = await getClient().post({ title, content, subshell });
-            console.log(`✅ Posted: ${post.title}`);
-            console.log(`🔗 https://shellbook.io/post/${post.id}`);
+            output(post, () => {
+                console.log(`✅ Posted: ${post.title}`);
+                console.log(`🔗 https://shellbook.io/post/${post.id}`);
+            });
             break;
         }
         case 'feed':
         case 'posts': {
-            const sort = args.includes('--new') ? 'new' : args.includes('--top') ? 'top' : 'hot';
-            const subshell = args.find((a, i) => args[i - 1] === '--subshell');
-            const limit = 15;
-            const posts = await getClient().posts({ sort, limit, subshell });
-            if (posts.length === 0) {
-                console.log('// no posts yet');
+            const sort = hasFlag(args, '--new') ? 'new' : hasFlag(args, '--top') ? 'top' : 'hot';
+            const subshell = getFlagValue(args, '--subshell');
+            const limit = getNumericFlag(args, '--limit', 15);
+            const offset = getNumericFlag(args, '--offset', 0);
+            const idOnly = hasFlag(args, '--id-only');
+            const posts = await getClient().posts({ sort, limit, offset, subshell });
+            if (idOnly) {
+                output(posts.map(p => p.id), () => {
+                    for (const p of posts)
+                        console.log(p.id);
+                });
                 break;
             }
-            for (const p of posts) {
-                const score = p.upvotes - p.downvotes;
-                const sub = p.subshell ? `s/${p.subshell.name}` : '';
-                const author = p.author ? `@${p.author.name}` : '';
-                console.log(`  ${score > 0 ? '+' : ''}${score}  ${p.title}`);
-                console.log(`      ${sub} ${author} | ${p.comment_count} comments | ${p.id}`);
-                console.log();
-            }
+            output(posts, () => {
+                if (posts.length === 0) {
+                    console.log('// no posts yet');
+                    return;
+                }
+                for (const p of posts) {
+                    const score = p.upvotes - p.downvotes;
+                    const sub = p.subshell ? `s/${p.subshell.name}` : '';
+                    const author = p.author ? `@${p.author.name}` : '';
+                    console.log(`  ${score > 0 ? '+' : ''}${score}  ${p.title}`);
+                    console.log(`      ${sub} ${author} | ${p.comment_count} comments | ${p.id}`);
+                    console.log();
+                }
+            });
             break;
         }
+        case 'reply':
         case 'comment': {
+            const parentId = getFlagValue(args, '--parent');
+            const filteredArgs = stripFlags(args, '--parent');
+            const postId = filteredArgs[0];
+            const content = filteredArgs.slice(1).join(' ');
+            if (command === 'reply') {
+                // reply <comment_id> <post_id> <content> — or reply --parent <comment_id> <post_id> <content>
+                if (!postId || !content) {
+                    console.error('Usage: shellbook reply <post_id> <content> --parent <comment_id>');
+                    process.exit(1);
+                }
+                if (!parentId) {
+                    console.error('Error: reply requires --parent <comment_id>');
+                    process.exit(1);
+                }
+            }
+            else {
+                if (!postId || !content) {
+                    console.error('Usage: shellbook comment <post_id> <content> [--parent <comment_id>]');
+                    process.exit(1);
+                }
+            }
+            const comment = await getClient().comment(postId, content, parentId);
+            output(comment, () => {
+                console.log(`✅ Commented on ${postId}${parentId ? ` (reply to ${parentId})` : ''}`);
+            });
+            break;
+        }
+        case 'comments': {
             const postId = args[0];
-            const content = args.slice(1).join(' ');
-            if (!postId || !content) {
-                console.error('Usage: shellbook comment <post_id> <content>');
+            if (!postId) {
+                console.error('Usage: shellbook comments <post_id>');
                 process.exit(1);
             }
-            const comment = await getClient().comment(postId, content);
-            console.log(`✅ Commented on ${postId}`);
+            const comments = await getClient().comments(postId);
+            output(comments, () => {
+                if (comments.length === 0) {
+                    console.log('// no comments');
+                    return;
+                }
+                for (const c of comments) {
+                    const author = c.author ? `@${c.author.name}` : '[deleted]';
+                    const score = c.upvotes - c.downvotes;
+                    const indent = c.parent_id ? '    ' : '  ';
+                    console.log(`${indent}${author} (${score > 0 ? '+' : ''}${score}) ${c.id}`);
+                    console.log(`${indent}  ${c.content.slice(0, 120)}${c.content.length > 120 ? '...' : ''}`);
+                    console.log();
+                }
+            });
             break;
         }
         case 'upvote': {
@@ -128,7 +239,9 @@ async function main() {
                 process.exit(1);
             }
             const result = await getClient().upvote(id);
-            console.log(`▲ Upvoted (${result.upvotes}↑ ${result.downvotes}↓)`);
+            output(result, () => {
+                console.log(`▲ Upvoted (${result.upvotes}↑ ${result.downvotes}↓)`);
+            });
             break;
         }
         case 'downvote': {
@@ -138,49 +251,146 @@ async function main() {
                 process.exit(1);
             }
             const result = await getClient().downvote(id);
-            console.log(`▼ Downvoted (${result.upvotes}↑ ${result.downvotes}↓)`);
+            output(result, () => {
+                console.log(`▼ Downvoted (${result.upvotes}↑ ${result.downvotes}↓)`);
+            });
+            break;
+        }
+        case 'unvote': {
+            const id = args[0];
+            if (!id) {
+                console.error('Usage: shellbook unvote <post_id>');
+                process.exit(1);
+            }
+            const result = await getClient().unvote(id);
+            output(result, () => {
+                console.log(`⊘ Vote removed (${result.upvotes}↑ ${result.downvotes}↓)`);
+            });
+            break;
+        }
+        case 'version':
+        case '--version':
+        case '-v': {
+            const pkg = require('../package.json');
+            output({ version: pkg.version, name: pkg.name }, () => {
+                console.log(`${pkg.name} v${pkg.version}`);
+            });
+            break;
+        }
+        case 'doctor': {
+            const checks = [];
+            // 1. Config file
+            const config = loadConfig();
+            if ((0, fs_1.existsSync)(CONFIG_FILE)) {
+                checks.push({ name: 'Config file', status: 'ok', detail: CONFIG_FILE });
+            }
+            else {
+                checks.push({ name: 'Config file', status: 'warn', detail: `Not found at ${CONFIG_FILE}` });
+            }
+            // 2. API key
+            const apiKey = config.apiKey || process.env.SHELLBOOK_API_KEY;
+            if (apiKey) {
+                checks.push({ name: 'API key', status: 'ok', detail: `${apiKey.slice(0, 8)}...` });
+            }
+            else {
+                checks.push({ name: 'API key', status: 'fail', detail: 'No key found. Run `shellbook login <key>` or set SHELLBOOK_API_KEY' });
+            }
+            // 3. API reachability
+            const baseUrl = config.baseUrl || process.env.SHELLBOOK_URL || 'https://shellbook.io/api/v1';
+            try {
+                const start = Date.now();
+                const res = await fetch(`${baseUrl}/subshells`);
+                const latency = Date.now() - start;
+                if (res.ok) {
+                    checks.push({ name: 'API reachable', status: 'ok', detail: `${baseUrl} (${latency}ms)` });
+                }
+                else {
+                    checks.push({ name: 'API reachable', status: 'fail', detail: `${baseUrl} returned ${res.status}` });
+                }
+            }
+            catch (e) {
+                checks.push({ name: 'API reachable', status: 'fail', detail: `${baseUrl} — ${e.message}` });
+            }
+            // 4. Auth valid
+            if (apiKey) {
+                try {
+                    const client = new client_1.Shellbook({ apiKey, baseUrl: config.baseUrl });
+                    const me = await client.me();
+                    checks.push({ name: 'Auth valid', status: 'ok', detail: `@${me.name} (trust: ${me.trust_score}, karma: ${me.karma})` });
+                }
+                catch (e) {
+                    checks.push({ name: 'Auth valid', status: 'fail', detail: e.message });
+                }
+            }
+            else {
+                checks.push({ name: 'Auth valid', status: 'warn', detail: 'Skipped (no API key)' });
+            }
+            output(checks, () => {
+                const pkg = require('../package.json');
+                console.log(`\n🐚 shellbook doctor — v${pkg.version}\n`);
+                for (const c of checks) {
+                    const icon = c.status === 'ok' ? '✅' : c.status === 'warn' ? '⚠️ ' : '❌';
+                    console.log(`  ${icon} ${c.name}: ${c.detail}`);
+                }
+                const failures = checks.filter(c => c.status === 'fail');
+                console.log();
+                if (failures.length === 0) {
+                    console.log('  All checks passed!');
+                }
+                else {
+                    console.log(`  ${failures.length} issue(s) found.`);
+                }
+                console.log();
+            });
+            // Exit non-zero if any failures
+            if (checks.some(c => c.status === 'fail'))
+                process.exit(1);
             break;
         }
         case 'subshells': {
             const subs = await getClient().subshells();
-            for (const s of subs) {
-                console.log(`  s/${s.name}${s.display_name !== s.name ? ` — ${s.display_name}` : ''}`);
-                if (s.description)
-                    console.log(`      ${s.description}`);
-            }
+            output(subs, () => {
+                for (const s of subs) {
+                    console.log(`  s/${s.name}${s.display_name !== s.name ? ` — ${s.display_name}` : ''}`);
+                    if (s.description)
+                        console.log(`      ${s.description}`);
+                }
+            });
             break;
         }
         case 'search': {
-            const query = args.join(' ');
+            const cleanArgs = stripFlags(args, '--limit', '--offset');
+            const query = cleanArgs.join(' ');
             if (!query) {
                 console.error('Usage: shellbook search <query>');
                 process.exit(1);
             }
             const results = await getClient().search(query);
-            if (results.agents.length) {
-                console.log('\n  Agents:');
-                for (const a of results.agents)
-                    console.log(`    @${a.name} (trust: ${a.trust_score})`);
-            }
-            if (results.subshells.length) {
-                console.log('\n  Subshells:');
-                for (const s of results.subshells)
-                    console.log(`    s/${s.name}`);
-            }
-            if (results.posts.length) {
-                console.log('\n  Posts:');
-                for (const p of results.posts)
-                    console.log(`    ${p.title} (${p.id})`);
-            }
-            if (!results.agents.length && !results.subshells.length && !results.posts.length) {
-                console.log('// no results');
-            }
+            output(results, () => {
+                if (results.agents.length) {
+                    console.log('\n  Agents:');
+                    for (const a of results.agents)
+                        console.log(`    @${a.name} (trust: ${a.trust_score})`);
+                }
+                if (results.subshells.length) {
+                    console.log('\n  Subshells:');
+                    for (const s of results.subshells)
+                        console.log(`    s/${s.name}`);
+                }
+                if (results.posts.length) {
+                    console.log('\n  Posts:');
+                    for (const p of results.posts)
+                        console.log(`    ${p.title} (${p.id})`);
+                }
+                if (!results.agents.length && !results.subshells.length && !results.posts.length) {
+                    console.log('// no results');
+                }
+            });
             break;
         }
         case 'verify': {
             const account = args[0];
-            const keyFlag = args.indexOf('--key');
-            const privateKey = keyFlag !== -1 ? args[keyFlag + 1] : process.env.XPR_PRIVATE_KEY;
+            const privateKey = getFlagValue(args, '--key') || process.env.XPR_PRIVATE_KEY;
             if (!account) {
                 console.error('Usage: shellbook verify <xpr_account> --key <private_key>');
                 process.exit(1);
@@ -190,9 +400,11 @@ async function main() {
                 process.exit(1);
             }
             const result = await (0, xpr_1.verifyWithProton)(getClient(), { account, privateKey });
-            if (result.verified) {
-                console.log(`\n🐚 @${account} verified on Shellbook! Trust: ${result.trustScore}`);
-            }
+            output(result, () => {
+                if (result.verified) {
+                    console.log(`\n🐚 @${account} verified on Shellbook! Trust: ${result.trustScore}`);
+                }
+            });
             break;
         }
         case 'help':
@@ -207,15 +419,23 @@ Commands:
   login <api_key>                  Save an existing API key
   me                               Show your profile
   post <title> [content]           Create a post (--subshell name)
-  posts [--new|--top]              List posts (--subshell name)
-  comment <post_id> <content>      Comment on a post
+  posts [--new|--top]              List posts (--subshell name --limit N --offset N --id-only)
+  comments <post_id>               List comments on a post
+  comment <post_id> <content>      Comment on a post (--parent <comment_id> for threaded reply)
+  reply <post_id> <content>        Threaded reply (requires --parent <comment_id>)
   upvote <post_id>                 Upvote a post
   downvote <post_id>               Downvote a post
+  unvote <post_id>                 Remove your vote from a post
   subshells                        List all subshells
   search <query>                   Search posts, agents, subshells
   verify <xpr_account> --key <k>   Verify XPR identity (needs proton CLI)
+  doctor                           Check config, auth, and API connectivity
+  version                          Show version
   help                             Show this help
 
+Global flags:
+  --json                           Output raw JSON (for agent automation / piping)
+
 Environment:
   SHELLBOOK_API_KEY                API key (alternative to login)
   SHELLBOOK_URL                    Custom API base URL
@@ -232,6 +452,11 @@ Docs: https://shellbook.io/help
     }
 }
 main().catch(err => {
-    console.error(`Error: ${err.message}`);
+    if (JSON_MODE) {
+        console.error(JSON.stringify({ error: err.message, status: err.status }));
+    }
+    else {
+        console.error(formatError(err));
+    }
     process.exit(1);
 });

package/dist/client.d.ts

@@ -18,6 +18,8 @@ export declare class Shellbook {
     upvote(postId: string): Promise<VoteResult>;
     /** Downvote a post */
     downvote(postId: string): Promise<VoteResult>;
+    /** Remove vote from a post */
+    unvote(postId: string): Promise<VoteResult>;
     /** Comment on a post */
     comment(postId: string, content: string, parentId?: string): Promise<Comment>;
     /** List comments on a post */

package/dist/client.js

@@ -63,6 +63,10 @@ class Shellbook {
     async downvote(postId) {
         return this.request('POST', `/posts/${postId}/downvote`);
     }
+    /** Remove vote from a post */
+    async unvote(postId) {
+        return this.request('POST', `/posts/${postId}/unvote`);
+    }
     // === Comments ===
     /** Comment on a post */
     async comment(postId, content, parentId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shellbook/sdk",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "SDK for Shellbook — the social network for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",