codeblog-mcp 2.1.4 → 2.2.0

package/dist/index.d.ts

@@ -1,2 +1,7 @@
 #!/usr/bin/env node
-export {};
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Create a fully configured McpServer with all scanners and tools registered.
+ * Does NOT connect to any transport — the caller decides how to connect.
+ */
+export declare function createServer(version?: string): McpServer;

package/dist/index.js

@@ -8,24 +8,53 @@ import { registerSessionTools } from "./tools/sessions.js";
 import { registerPostingTools } from "./tools/posting.js";
 import { registerForumTools } from "./tools/forum.js";
 import { registerAgentTools } from "./tools/agents.js";
-const require = createRequire(import.meta.url);
-const { version: PKG_VERSION } = require("../package.json");
-// ─── Initialize scanners ────────────────────────────────────────────
-registerAllScanners();
-// ─── MCP Server ─────────────────────────────────────────────────────
-const server = new McpServer({
-    name: "codeblog",
-    version: PKG_VERSION,
-});
-// ─── Register all tools ─────────────────────────────────────────────
-registerSetupTools(server, PKG_VERSION);
-registerSessionTools(server);
-registerPostingTools(server);
-registerForumTools(server);
-registerAgentTools(server);
-// ─── Start ──────────────────────────────────────────────────────────
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+function getVersion() {
+    try {
+        const req = createRequire(import.meta.url);
+        return req("../package.json").version;
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+/**
+ * Create a fully configured McpServer with all scanners and tools registered.
+ * Does NOT connect to any transport — the caller decides how to connect.
+ */
+export function createServer(version) {
+    const pkgVersion = version ?? getVersion();
+    registerAllScanners();
+    const server = new McpServer({
+        name: "codeblog",
+        version: pkgVersion,
+    });
+    registerSetupTools(server, pkgVersion);
+    registerSessionTools(server);
+    registerPostingTools(server);
+    registerForumTools(server);
+    registerAgentTools(server);
+    return server;
+}
+// ─── CLI entry point (standalone mode) ──────────────────────────────
+// Only run when executed directly (not when imported as a library)
+import { fileURLToPath } from "url";
+import { resolve } from "path";
+const isDirectRun = (() => {
+    if (typeof process === "undefined" || !process.argv[1])
+        return false;
+    try {
+        const modulePath = fileURLToPath(import.meta.url);
+        const scriptPath = resolve(process.argv[1]);
+        return scriptPath === modulePath;
+    }
+    catch {
+        return false;
+    }
+})();
+if (isDirectRun) {
+    (async () => {
+        const server = createServer();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    })().catch(console.error);
 }
-main().catch(console.error);

package/dist/lib/config.d.ts

@@ -4,6 +4,7 @@ export interface CodeblogConfig {
     apiKey?: string;
     url?: string;
     defaultLanguage?: string;
+    activeAgent?: string;
 }
 export declare function loadConfig(): CodeblogConfig;
 export declare function saveConfig(config: CodeblogConfig): void;

package/dist/lib/registry.js

@@ -3,7 +3,11 @@
 // (missing deps, changed file formats, permission errors, etc.)
 // MUST NEVER take down the whole MCP server.
 const scanners = [];
+const registeredSources = new Set();
 export function registerScanner(scanner) {
+    if (registeredSources.has(scanner.sourceType))
+        return;
+    registeredSources.add(scanner.sourceType);
     scanners.push(scanner);
 }
 export function getScanners() {

package/dist/scanners/cursor.js

@@ -1,8 +1,26 @@
 import * as path from "path";
 import * as fs from "fs";
-import BetterSqlite3 from "better-sqlite3";
 import { getHome, getPlatform } from "../lib/platform.js";
 import { listFiles, listDirs, safeReadFile, safeReadJson, safeStats, extractProjectDescription, decodeDirNameToPath } from "../lib/fs-utils.js";
+// Lazy-loaded SQLite module (better-sqlite3 or bun:sqlite)
+let BetterSqlite3 = null;
+let sqliteLoadAttempted = false;
+function getSqlite() {
+    if (sqliteLoadAttempted)
+        return BetterSqlite3;
+    sqliteLoadAttempted = true;
+    try {
+        BetterSqlite3 = require("better-sqlite3");
+    }
+    catch {
+        try {
+            // Fallback for Bun runtime
+            BetterSqlite3 = null;
+        }
+        catch { /* */ }
+    }
+    return BetterSqlite3;
+}
 // Cursor stores conversations in THREE places (all supported for version compatibility):
 //
 // FORMAT 1 — Agent transcripts (plain text, XML-like tags):
@@ -20,8 +38,11 @@ import { listFiles, listDirs, safeReadFile, safeReadJson, safeStats, extractProj
 //          bubbleId:<composerId>:<bubbleId> — individual message content (type 1=user, 2=ai)
 // Run a callback with a shared DB connection, safely closing on completion
 function withDb(dbPath, fn, fallback) {
+    const Sqlite = getSqlite();
+    if (!Sqlite)
+        return fallback;
     try {
-        const db = new BetterSqlite3(dbPath, { readonly: true, fileMustExist: true });
+        const db = new Sqlite(dbPath, { readonly: true, fileMustExist: true });
         try {
             return fn(db);
         }

package/dist/scanners/windsurf.js

@@ -1,8 +1,22 @@
 import * as path from "path";
 import * as fs from "fs";
-import BetterSqlite3 from "better-sqlite3";
 import { getHome, getPlatform } from "../lib/platform.js";
 import { listDirs, safeReadJson, safeStats, extractProjectDescription } from "../lib/fs-utils.js";
+// Lazy-loaded SQLite module (better-sqlite3 or bun:sqlite)
+let BetterSqlite3 = null;
+let sqliteLoadAttempted = false;
+function getSqlite() {
+    if (sqliteLoadAttempted)
+        return BetterSqlite3;
+    sqliteLoadAttempted = true;
+    try {
+        BetterSqlite3 = require("better-sqlite3");
+    }
+    catch {
+        BetterSqlite3 = null;
+    }
+    return BetterSqlite3;
+}
 export const windsurfScanner = {
     name: "Windsurf",
     sourceType: "windsurf",
@@ -138,8 +152,11 @@ export const windsurfScanner = {
     },
 };
 function readVscdbChatSessions(dbPath) {
+    const Sqlite = getSqlite();
+    if (!Sqlite)
+        return null;
     try {
-        const db = new BetterSqlite3(dbPath, { readonly: true, fileMustExist: true });
+        const db = new Sqlite(dbPath, { readonly: true, fileMustExist: true });
         let row;
         try {
             row = db.prepare("SELECT value FROM ItemTable WHERE key = 'chat.ChatSessionStore.index'").get();

package/dist/tools/agents.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { text } from "../lib/config.js";
+import { text, saveConfig } from "../lib/config.js";
 import { withAuth } from "../lib/auth-guard.js";
 export function registerAgentTools(server) {
     server.registerTool("manage_agents", {
@@ -16,8 +16,9 @@ export function registerAgentTools(server) {
             description: z.string().optional().describe("Agent description (optional, for create)"),
             source_type: z.string().optional().describe("IDE source: claude-code, cursor, codex, windsurf, git, other (required for create)"),
             agent_id: z.string().optional().describe("Agent ID or name (required for delete and switch)"),
+            api_key: z.string().optional().describe("API key of the agent to switch to (alternative to agent_id for switch)"),
         },
-    }, withAuth(async ({ action, name, description, source_type, agent_id }, { apiKey, serverUrl }) => {
+    }, withAuth(async ({ action, name, description, source_type, agent_id, api_key }, { apiKey, serverUrl }) => {
         if (action === "list") {
             try {
                 const res = await fetch(`${serverUrl}/api/v1/agents/list`, {
@@ -92,30 +93,68 @@ export function registerAgentTools(server) {
             }
         }
         if (action === "switch") {
-            if (!agent_id) {
-                return { content: [text("agent_id is required for switch.")], isError: true };
+            // Auto-detect: if agent_id looks like an API key, treat it as api_key
+            const effectiveApiKey = api_key || (agent_id && (agent_id.startsWith("cbk_") || agent_id.startsWith("cmk_")) ? agent_id : undefined);
+            const effectiveAgentId = effectiveApiKey ? undefined : agent_id;
+            if (!effectiveAgentId && !effectiveApiKey) {
+                return { content: [text("agent_id or api_key is required for switch.")], isError: true };
+            }
+            // If api_key is provided (or detected from agent_id), verify it and switch directly
+            if (effectiveApiKey) {
+                try {
+                    const res = await fetch(`${serverUrl}/api/v1/agents/me`, {
+                        headers: { Authorization: `Bearer ${effectiveApiKey}` },
+                    });
+                    if (!res.ok) {
+                        return { content: [text(`Invalid API key. Server returned: ${res.status}`)], isError: true };
+                    }
+                    const data = await res.json();
+                    if (!data.agent) {
+                        return { content: [text("This API key is not associated with any agent.")], isError: true };
+                    }
+                    // Save the new API key and agent name to config
+                    saveConfig({ apiKey: effectiveApiKey, activeAgent: data.agent.name });
+                    return {
+                        content: [text(`✅ Switched to agent **${data.agent.name}** (${data.agent.sourceType})!\n\n` +
+                                `API key has been saved to your config. All subsequent operations will use this agent.`)],
+                    };
+                }
+                catch (err) {
+                    return { content: [text(`Network error: ${err}`)], isError: true };
+                }
             }
-            // First verify the agent exists and belongs to us
+            // Otherwise, look up by agent_id or name via the switch endpoint
             try {
-                const res = await fetch(`${serverUrl}/api/v1/agents/list`, {
-                    headers: { Authorization: `Bearer ${apiKey}` },
+                const res = await fetch(`${serverUrl}/api/v1/agents/switch`, {
+                    method: "POST",
+                    headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+                    body: JSON.stringify({ agent_id }),
                 });
-                if (!res.ok)
-                    return { content: [text(`Error: ${res.status}`)], isError: true };
-                const data = await res.json();
-                // Support both ID and name lookup
-                const target = data.agents.find((a) => a.id === agent_id || a.name === agent_id);
-                if (!target) {
-                    return { content: [text(`Agent ${agent_id} not found in your agents.`)], isError: true };
+                if (res.status === 404) {
+                    // Agent not found — fetch list to show available agents
+                    const listRes = await fetch(`${serverUrl}/api/v1/agents/list`, {
+                        headers: { Authorization: `Bearer ${apiKey}` },
+                    });
+                    let available = "";
+                    if (listRes.ok) {
+                        const listData = await listRes.json();
+                        available = listData.agents.map((a) => `  - ${a.name} (ID: ${a.id})`).join("\n");
+                    }
+                    return { content: [text(`Agent "${agent_id}" not found in your agents.\n\n` +
+                                (available ? `Your agents:\n${available}\n\n` : "") +
+                                `Use manage_agents(action='list') to see all your agents.`)], isError: true };
+                }
+                if (!res.ok) {
+                    const err = await res.json().catch(() => ({ error: "Unknown" }));
+                    return { content: [text(`Error: ${err.error}`)], isError: true };
                 }
-                // We need to get the API key for this agent — create a new one via the create endpoint
-                // Actually, we need a dedicated endpoint for this. For now, inform the user.
+                const data = await res.json();
+                const target = data.agent;
+                // Save the target agent's API key and name to config
+                saveConfig({ apiKey: target.api_key, activeAgent: target.name });
                 return {
-                    content: [text(`⚠️ To switch agents, you need to update your API key.\n\n` +
-                            `Agent: **${target.name}** (${target.source_type})\n` +
-                            `If you created this agent via manage_agents(action='create'), ` +
-                            `use the API key that was returned at creation time.\n\n` +
-                            `Set it with: codeblog_setup or update ~/.codeblog/config.json`)],
+                    content: [text(`✅ Switched to agent **${target.name}** (${target.source_type})!\n\n` +
+                            `API key has been saved to your config. All subsequent operations will use this agent.`)],
                 };
             }
             catch (err) {

package/dist/tools/setup.js

@@ -30,7 +30,7 @@ export function registerSetupTools(server, PKG_VERSION) {
                     return { content: [text(`API key verification failed (${res.status}).`)], isError: true };
                 }
                 const data = await res.json();
-                const config = { apiKey: api_key };
+                const config = { apiKey: api_key, activeAgent: data.agent.name };
                 if (url)
                     config.url = url;
                 if (default_language)
@@ -65,7 +65,7 @@ export function registerSetupTools(server, PKG_VERSION) {
             if (!res.ok) {
                 return { content: [text(`Setup failed: ${data.error || "Unknown error"}`)], isError: true };
             }
-            const config = { apiKey: data.agent.api_key };
+            const config = { apiKey: data.agent.api_key, activeAgent: data.agent.name };
             if (url)
                 config.url = url;
             if (default_language)

package/package.json

@@ -1,18 +1,22 @@
 {
   "name": "codeblog-mcp",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "description": "CodeBlog MCP server — 26 tools for AI agents to fully participate in a coding forum. Scan 9 IDEs, auto-post insights, manage agents, edit/delete posts, bookmark, notifications, follow users, weekly digest, trending topics, and more",
   "type": "module",
   "bin": {
     "codeblog-mcp": "./dist/index.js"
   },
   "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
   "files": [
     "dist"
   ],
   "scripts": {
     "build": "tsc && node -e \"require('fs').chmodSync('dist/index.js',0o755)\"",
     "dev": "tsx src/index.ts",
+    "release": "tsx scripts/release.ts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [