secondbrainos-mcp-server 1.5.3 → 1.6.0

package/bin/cli.js

@@ -362,42 +362,6 @@ async function main() {
     const cliPath = path.join(packageRoot, 'bin', 'cli.js');
     const claudeCodeConfigured = await configureClaudeCode(cliPath, nodePath);
 
-    // Add SessionStart hook to global Claude Code settings
-    if (claudeCodeConfigured) {
-      try {
-        const claudeSettingsPath = path.join(homedir(), '.claude', 'settings.json');
-        let settings = {};
-        try {
-          settings = JSON.parse(await fs.readFile(claudeSettingsPath, 'utf8'));
-        } catch { /* file may not exist yet */ }
-
-        if (!settings.hooks) settings.hooks = {};
-        if (!settings.hooks.SessionStart) settings.hooks.SessionStart = [];
-
-        // Check if our hook already exists
-        const skillFilePath = path.join(homedir(), '.claude', 'skills', 'secondbrainos', 'server-use', 'SKILL.md');
-        const hookCommand = `cat "${skillFilePath}" 2>/dev/null || true`;
-        const hasHook = settings.hooks.SessionStart.some(
-          entry => entry.hooks && entry.hooks.some(h => h.command && h.command.includes('secondbrainos/server-use/SKILL.md'))
-        );
-
-        if (!hasHook) {
-          settings.hooks.SessionStart.push({
-            hooks: [
-              {
-                type: "command",
-                command: hookCommand
-              }
-            ]
-          });
-          await fs.writeFile(claudeSettingsPath, JSON.stringify(settings, null, 2));
-          console.log('SessionStart hook configured for SBOS context loading.');
-        }
-      } catch (error) {
-        console.log(`Note: Could not configure SessionStart hook: ${error.message}`);
-      }
-    }
-
     console.log('\nInstallation successful!');
     console.log('\nClaude Desktop:');
     console.log('1. Completely quit Claude Desktop if it is running');

package/build/index.js

@@ -74,7 +74,7 @@ class SecondBrainOSServer {
                 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/"
+            instructions: "SBOS provides tools for managing knowledge along with definitions for sub-agents and associated skills. Run /secondbrainos:start_secondbrainos to load full SBOS context."
         });
         this.setupHandlers();
         this.setupErrorHandling();
@@ -247,6 +247,13 @@ class SecondBrainOSServer {
                     console.error('Failed to fetch agents for prompts/list:', error);
                 }
             }
+            // Add start_secondbrainos prompt — returns the server-use context document
+            prompts.push({
+                name: "start_secondbrainos",
+                title: "[Start] Second Brain OS",
+                description: "Load SBOS context: terminology, architecture, and available agents & skills index",
+                arguments: []
+            });
             // Add Knowledge Bases prompt (collects searchMyKnowledge_collection_ids from agents)
             if (this.getAIAgentsSchemaPath) {
                 try {
@@ -279,6 +286,22 @@ class SecondBrainOSServer {
         this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
             const promptName = request.params.name;
             const userInput = request.params.arguments?.user_input;
+            // Check if this is the start_secondbrainos prompt
+            if (promptName === "start_secondbrainos") {
+                const content = await this.buildServerUseContent();
+                return {
+                    description: "Second Brain OS — Server Context",
+                    messages: [
+                        {
+                            role: "user",
+                            content: {
+                                type: "text",
+                                text: content
+                            }
+                        }
+                    ]
+                };
+            }
             // Check if this is the Knowledge Bases prompt
             if (promptName === "knowledge_bases") {
                 const agents = await this.fetchAndEnrichAgents();
@@ -574,25 +597,28 @@ class SecondBrainOSServer {
         return enriched;
     }
     /**
-     * Write Claude Code skill files to ~/.claude/skills/secondbrainos/
-     * Called on every server startup so skills stay in sync with SBOS.
+     * Write the server-use skill file to ~/.claude/skills/secondbrainos/
+     * Called on every server startup so the context index stays 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 — context document for Claude Code sessions
-        // Gather agent and workflow names for the index
+    async writeServerUseSkillFile() {
+        const serverUseContent = await this.buildServerUseContent();
+        const dir = path.join(homedir(), '.claude', 'skills', 'secondbrainos', 'server-use');
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, 'SKILL.md'), serverUseContent, 'utf-8');
+        console.error('Server-use skill file written to ~/.claude/skills/secondbrainos/server-use/');
+    }
+    /**
+     * Build the server-use context document content.
+     * Used by both writeServerUseSkillFile and the start_secondbrainos prompt.
+     */
+    async buildServerUseContent() {
         let agentIndex = '';
         let skillIndex = '';
         try {
             const agents = await this.fetchAndEnrichAgents();
             agentIndex = agents
                 .filter((a) => a.name && a.id)
-                .map((a) => `- ${a.name} → \`/secondbrainos:agent_${toSnakeCase(a.name)}\``)
+                .map((a) => `- ${a.name} (id: ${a.id}) → \`/secondbrainos:agent_${toSnakeCase(a.name)}\`${a.description ? `\n  ${a.description}` : ''}`)
                 .join('\n');
         }
         catch { /* skip if unavailable */ }
@@ -600,12 +626,12 @@ class SecondBrainOSServer {
             const workflows = await this.fetchAndEnrichWorkflows();
             skillIndex = workflows
                 .filter((wf) => wf.name)
-                .map((wf) => `- ${wf.name} → \`/secondbrainos:skill_${toSnakeCase(wf.name)}\``)
+                .map((wf) => `- ${wf.name} (id: ${wf.workflow_id}) → \`/secondbrainos:skill_${toSnakeCase(wf.name)}\`${wf.description ? `\n  ${wf.description}` : ''}`)
                 .join('\n');
         }
         catch { /* skip if unavailable */ }
-        const serverUseContent = `---
-name: secondbrainos_server_use
+        return `---
+name: server-use
 description: Second Brain OS server context — terminology, architecture, and available agents/skills index
 user-invocable: false
 ---
@@ -624,14 +650,13 @@ An agent definition combines:
 2. **Services (Tools)** — the MCP tools the agent can use
 3. **Workflows (Skills)** — the prompt chains the agent follows
 
-This means you can spin up sub-agents from an agent's skill definitions (see \`~/.claude/skills/secondbrainos/tabs/\`).
+## Loading Agent & Skill Details
+- To get full agent definitions (behaviour, knowledge, actions, workflows): use the \`getAIAgentsSchema\` tool
+- To get full skill/workflow details and run prompt chains: use the \`runPromptChain\` tool
 
 ## Accessing Agents & Skills
-- Skill files live at \`~/.claude/skills/secondbrainos/\` (tabs/, workflows/, knowledgebases/)
-- All skill files are set to \`user-invocable: false\` to avoid duplicating slash commands already available via MCP prompts
 - **Users** invoke agents or skills via slash commands (e.g. \`/secondbrainos:agent_...\` or \`/secondbrainos:skill_...\`)
 - **Users** cannot invoke MCP tools directly via slash commands — they must ask you to load and call the relevant tool
-- When using an agent with sub-agents, load the necessary skills at the start of the conversation by reading the agent's skill files
 
 ## Available Agents
 ${agentIndex || '_None configured_'}
@@ -639,85 +664,14 @@ ${agentIndex || '_None configured_'}
 ## Available Skills
 ${skillIndex || '_None configured_'}
 `;
-        writeSkill(path.join(skillsBase, 'server-use'), serverUseContent);
-        // 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 (uses cached enriched data)
-        if (this.runPromptChainPath) {
-            try {
-                const workflows = await this.fetchAndEnrichWorkflows();
-                for (const wf of workflows) {
-                    const folderName = toSnakeCase(wf.name);
-                    const workflowDocument = {
-                        skill_id: wf.workflow_id,
-                        name: wf.name,
-                        description: wf.description || '',
-                        prompts: wf.prompts
-                    };
-                    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.
-        // This is fast now (~2-3s) since enrichment uses single API calls.
-        await this.writeSkillFiles().catch(err => console.error('Failed to write skill files:', err));
+        // Write server-use skill file before connecting so Claude Code sees it at session start.
+        await this.writeServerUseSkillFile().catch(err => console.error('Failed to write server-use skill file:', 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.5.3",
+  "version": "1.6.0",
   "description": "Second Brain OS MCP Server for Claude Desktop",
   "type": "module",
   "main": "build/index.js",