secondbrainos-mcp-server 1.3.0 → 1.4.1

package/build/index.js

@@ -7,6 +7,7 @@ import dotenv from "dotenv";
 import yaml from 'js-yaml';
 import fs from 'fs';
 import path from 'path';
+import { homedir } from 'os';
 dotenv.config();
 function toSnakeCase(str) {
     return str
@@ -71,7 +72,8 @@ class SecondBrainOSServer {
                 resources: {},
                 tools: {},
                 prompts: {}
-            }
+            },
+            instructions: "SBOS provides tools for managing knowledge along with definitions for sub-agents and associated skills. For full server context, see the skills at ~/.claude/skills/secondbrainos/"
         });
         this.setupHandlers();
         this.setupErrorHandling();
@@ -562,11 +564,116 @@ class SecondBrainOSServer {
         this.cachedAgents = agents;
         return agents;
     }
+    /**
+     * Write Claude Code skill files to ~/.claude/skills/secondbrainos/
+     * Called on every server startup so skills stay in sync with SBOS.
+     */
+    async writeSkillFiles() {
+        const skillsBase = path.join(homedir(), '.claude', 'skills', 'secondbrainos');
+        // Helper to write a SKILL.md file
+        const writeSkill = (dir, content) => {
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(path.join(dir, 'SKILL.md'), content, 'utf-8');
+        };
+        // 1. server-use — placeholder
+        writeSkill(path.join(skillsBase, 'server-use'), `---\nname: secondbrainos_server_use\ndescription: Second Brain OS server context\nuser-invocable: false\n---\n\nHello world.\n`);
+        // 2. tabs (agents)
+        if (this.getAIAgentsSchemaPath) {
+            try {
+                const agents = await this.fetchAndEnrichAgents();
+                for (const agent of agents) {
+                    if (!agent.name || !agent.id)
+                        continue;
+                    const folderName = toSnakeCase(agent.name);
+                    const agentDocument = {
+                        agent_id: agent.id,
+                        name: agent.name,
+                        description: agent.description || '',
+                        behaviour_and_instructions: agent.behaviour_and_instructions || '',
+                        searchMyKnowledge_collection_id: agent.searchMyKnowledge_collection_id || '',
+                        actions: agent.actions || [],
+                        workflows: (agent.workflows || []).map((wf) => ({
+                            id: wf.id,
+                            name: wf.name,
+                            prompts: (wf.prompts || []).map((p) => ({
+                                id: p.id,
+                                name: p.name,
+                                order: p.order,
+                                description: p.description
+                            }))
+                        }))
+                    };
+                    writeSkill(path.join(skillsBase, 'tabs', folderName), `---\nname: secondbrainos_agent_${folderName}\ndescription: "${agent.description || agent.name}"\nuser-invocable: false\n---\n\n${JSON.stringify(agentDocument, null, 2)}\n`);
+                }
+            }
+            catch (error) {
+                console.error('Failed to write agent skill files:', error);
+            }
+        }
+        // 3. workflows
+        if (this.runPromptChainPath) {
+            try {
+                const data = await this.callRunPromptChain('', '');
+                const workflows = data.workflows || [];
+                for (const wf of workflows) {
+                    if (!wf.name || !wf.workflow_id)
+                        continue;
+                    const folderName = toSnakeCase(wf.name);
+                    const workflowDetail = await this.callRunPromptChain('workflow', wf.workflow_id);
+                    const promptIds = workflowDetail.prompt_id || [];
+                    const promptResults = await Promise.all(promptIds.map(async (promptId) => {
+                        try {
+                            const promptData = await this.callRunPromptChain('prompt', promptId);
+                            return {
+                                id: promptId,
+                                name: promptData.name,
+                                order: promptData.order,
+                                description: promptData.description || ''
+                            };
+                        }
+                        catch {
+                            return { id: promptId, name: '', order: 0, description: '' };
+                        }
+                    }));
+                    const sortedPrompts = promptResults.sort((a, b) => (a.order || 0) - (b.order || 0));
+                    const workflowDocument = {
+                        skill_id: wf.workflow_id,
+                        name: wf.name,
+                        description: wf.description || '',
+                        prompts: sortedPrompts
+                    };
+                    writeSkill(path.join(skillsBase, 'workflows', folderName), `---\nname: secondbrainos_skill_${folderName}\ndescription: "${wf.description || wf.name}"\nuser-invocable: false\n---\n\n${JSON.stringify(workflowDocument, null, 2)}\n`);
+                }
+            }
+            catch (error) {
+                console.error('Failed to write workflow skill files:', error);
+            }
+        }
+        // 4. knowledgebases
+        if (this.getAIAgentsSchemaPath) {
+            try {
+                const agents = await this.fetchAndEnrichAgents();
+                const collectionIds = agents
+                    .map((a) => a.searchMyKnowledge_collection_id)
+                    .filter((id) => id && id.length > 0);
+                if (collectionIds.length > 0) {
+                    const kbDocument = { searchMyKnowledge_collection_ids: collectionIds };
+                    writeSkill(path.join(skillsBase, 'knowledgebases'), `---\nname: secondbrainos_knowledge_bases\ndescription: Knowledge base collection IDs available to agents\nuser-invocable: false\n---\n\n${JSON.stringify(kbDocument, null, 2)}\n`);
+                }
+            }
+            catch (error) {
+                console.error('Failed to write knowledge bases skill file:', error);
+            }
+        }
+        console.error('Skill files written to ~/.claude/skills/secondbrainos/');
+    }
     setupErrorHandling() {
         // Error handling is now built into HttpLlm.execute
         // This method is kept for future error handling implementations
     }
     async run() {
+        // Write skill files before connecting so Claude Code sees them at session start
+        await this.writeSkillFiles().catch(err => console.error('Failed to write skill files:', err));
         const transport = new StdioServerTransport();
         await this.server.connect(transport);
         console.error("Second Brain OS MCP server running on stdio");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "secondbrainos-mcp-server",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Second Brain OS MCP Server for Claude Desktop",
   "type": "module",
   "main": "build/index.js",