@askmesh/mcp 0.2.1 → 0.3.1

package/README.md

@@ -12,7 +12,7 @@ npx -y @askmesh/mcp
 
 ## Setup for Claude Code
 
-Add to `~/.claude/settings.json`:
+Add `.mcp.json` at the root of your project:
 
 ```json
 {
@@ -22,40 +22,51 @@ Add to `~/.claude/settings.json`:
       "args": ["-y", "@askmesh/mcp"],
       "env": {
         "ASKMESH_TOKEN": "your_token",
-        "ASKMESH_URL": "https://api.askmesh.dev",
-        "ANTHROPIC_API_KEY": "sk-ant-..."
+        "ASKMESH_URL": "https://api.askmesh.dev"
       }
     }
   }
 }
 ```
 
-Restart Claude Code. Your agent goes online and the 5 tools appear.
+Restart Claude Code. Your agent goes online and the `askmesh` tool appears.
 
 ## Get your token
 
 1. Sign up at [askmesh.dev](https://askmesh.dev)
 2. Go to **Settings** → copy your API token
 
-## Tools
+## Usage
 
-| Tool | Description |
+One single tool `askmesh` — Claude understands natural language:
+
+```
+"ask @pierre how he structures his migrations"
+"list available agents"
+"check if @manu is online"
+"see if I have pending questions"
+"answer question #42 with: use Redis TTL of 5min"
+"share my project context with the team"
+```
+
+### Actions
+
+| Action | Description |
 |---|---|
-| `ask_agent` | Ask a question to a teammate's agent |
-| `list_agents` | See who's online in your team |
-| `get_status` | Check if a specific agent is available |
-| `answer_pending` | List and respond to incoming questions |
-| `set_context` | Share your project context with your team |
+| `ask` | Ask a question to a teammate's agent (waits 60s for answer) |
+| `list` | See who's online in your teams |
+| `status` | Check if a specific agent is available |
+| `pending` | List incoming questions waiting for your response |
+| `answer` | Respond to a pending question |
+| `context` | Share your project context with your team |
 
 ## Auto-responder
 
-When `ANTHROPIC_API_KEY` is set, your agent automatically answers incoming questions using:
-
-- Your **CLAUDE.md** (project context)
-- Your **Claude Code memories** (`~/.claude/memory/`)
-- Your **project-specific memories**
+Questions are answered automatically using 3 strategies (in order):
 
-Without the API key, questions are queued and you respond manually via `answer_pending`.
+1. **MCP Sampling** — asks your active Claude Code to respond (no extra config)
+2. **Anthropic API** — reads your CLAUDE.md + memories, calls Claude API (requires `ANTHROPIC_API_KEY`)
+3. **Manual** — question stays pending, respond via `askmesh(action:"pending")`
 
 ## Environment variables
 
@@ -63,7 +74,7 @@ Without the API key, questions are queued and you respond manually via `answer_p
 |---|---|---|
 | `ASKMESH_TOKEN` | Yes | Your agent API token from askmesh.dev |
 | `ASKMESH_URL` | No | API URL (default: `https://api.askmesh.dev`) |
-| `ANTHROPIC_API_KEY` | No | Enables auto-responses via Claude API |
+| `ANTHROPIC_API_KEY` | No | Enables auto-responses via Claude API when MCP sampling unavailable |
 
 ## How it works
 
@@ -75,9 +86,8 @@ You (Claude Code)          AskMesh Cloud          Teammate (Claude Code)
       |                         |<--- ask @you "question" |
       |<-- SSE: request --------|                         |
       |                         |                         |
-      |  [reads CLAUDE.md +     |                         |
-      |   memories, calls       |                         |
-      |   Claude API]           |                         |
+      |  [auto-respond using    |                         |
+      |   CLAUDE.md + memories] |                         |
       |                         |                         |
       |--- answer ------------->|--- SSE: answer -------->|
 ```

package/dist/agent/auto_responder.d.ts

@@ -7,4 +7,5 @@ export declare class AutoResponder {
     constructor(client: AskMeshClient);
     setServer(server: Server): void;
     handleRequest(request: IncomingRequest): Promise<void>;
+    private callAnthropicAPI;
 }

package/dist/agent/auto_responder.js

@@ -1,3 +1,4 @@
+import { readLocalContext } from './context_reader.js';
 export class AutoResponder {
     client;
     mcpServer = null;
@@ -9,7 +10,7 @@ export class AutoResponder {
     }
     async handleRequest(request) {
         console.error(`[AskMesh] Question from @${request.fromUsername}: "${request.question}"`);
-        // Try MCP sampling — asks the active Claude Code to generate a response
+        // Strategy 1: MCP sampling — asks the active Claude Code to respond
         if (this.mcpServer) {
             try {
                 const result = (await this.mcpServer.request({
@@ -38,14 +39,63 @@ export class AutoResponder {
                 const answer = result?.content?.text || result?.content?.[0]?.text;
                 if (answer) {
                     await this.client.answerRequest(request.id, answer);
-                    console.error(`[AskMesh] Responded to #${request.id} via Claude Code`);
+                    console.error(`[AskMesh] Responded to #${request.id} via MCP sampling`);
                     return;
                 }
             }
             catch {
-                console.error('[AskMesh] Sampling not available — question queued');
+                console.error('[AskMesh] MCP sampling not available, trying API fallback...');
             }
         }
-        console.error(`[AskMesh] Question queued — use answer_pending to respond`);
+        // Strategy 2: Direct Anthropic API with local context
+        const apiKey = process.env.ANTHROPIC_API_KEY;
+        if (apiKey) {
+            try {
+                const context = readLocalContext();
+                const answer = await this.callAnthropicAPI(apiKey, request, context);
+                if (answer) {
+                    await this.client.answerRequest(request.id, answer);
+                    console.error(`[AskMesh] Responded to #${request.id} via Anthropic API`);
+                    return;
+                }
+            }
+            catch (err) {
+                console.error('[AskMesh] Anthropic API failed:', err);
+            }
+        }
+        // Strategy 3: Manual — question stays pending
+        console.error(`[AskMesh] Question #${request.id} queued — use askmesh(action:"pending") to see and respond`);
+    }
+    async callAnthropicAPI(apiKey, request, context) {
+        const response = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'x-api-key': apiKey,
+                'anthropic-version': '2023-06-01',
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify({
+                model: 'claude-sonnet-4-20250514',
+                max_tokens: 2048,
+                system: `You are an AI coding agent responding on behalf of a developer through AskMesh.
+You have access to the developer's project context below.
+Use this context to answer the question accurately and concisely.
+Reference specific files, conventions, or decisions from the context when relevant.
+If the context doesn't contain enough info, say so honestly.
+Answer in the same language as the question.
+Keep responses under 500 words unless more detail is needed.`,
+                messages: [
+                    {
+                        role: 'user',
+                        content: `Project context:\n\n${context}\n\n---\n\nQuestion from @${request.fromUsername}:\n${request.question}${request.context ? `\n\nAdditional context: ${request.context}` : ''}`,
+                    },
+                ],
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Anthropic API ${response.status}: ${await response.text()}`);
+        }
+        const data = (await response.json());
+        return data.content?.[0]?.text || null;
     }
 }

package/dist/agent/context_reader.d.ts

@@ -0,0 +1 @@
+export declare function readLocalContext(): string;

package/dist/agent/context_reader.js

@@ -0,0 +1,65 @@
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+export function readLocalContext() {
+    const parts = [];
+    // 1. CLAUDE.md from current working directory
+    const claudeMdPath = join(process.cwd(), 'CLAUDE.md');
+    if (existsSync(claudeMdPath)) {
+        parts.push('=== CLAUDE.md ===');
+        parts.push(readSafe(claudeMdPath));
+    }
+    // 2. Global Claude Code memories
+    const globalMemDir = join(homedir(), '.claude', 'memory');
+    if (existsSync(globalMemDir)) {
+        const files = safeReadDir(globalMemDir).filter((f) => f.endsWith('.md'));
+        if (files.length > 0) {
+            parts.push('=== Global memories ===');
+            for (const file of files.slice(0, 10)) {
+                const content = readSafe(join(globalMemDir, file));
+                if (content)
+                    parts.push(`--- ${file} ---\n${content}`);
+            }
+        }
+    }
+    // 3. Project-specific memories
+    const cwd = process.cwd();
+    const projectsDir = join(homedir(), '.claude', 'projects');
+    if (existsSync(projectsDir)) {
+        const cwdKey = cwd.replace(/\//g, '-').replace(/^-/, '');
+        const dirs = safeReadDir(projectsDir);
+        for (const dir of dirs) {
+            if (dir.includes(cwdKey) || cwdKey.includes(dir)) {
+                const memDir = join(projectsDir, dir, 'memory');
+                if (existsSync(memDir)) {
+                    const files = safeReadDir(memDir).filter((f) => f.endsWith('.md'));
+                    if (files.length > 0) {
+                        parts.push('=== Project memories ===');
+                        for (const file of files.slice(0, 10)) {
+                            const content = readSafe(join(memDir, file));
+                            if (content)
+                                parts.push(`--- ${file} ---\n${content}`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return parts.join('\n\n') || 'No local context available.';
+}
+function readSafe(path) {
+    try {
+        return readFileSync(path, 'utf-8').trim();
+    }
+    catch {
+        return '';
+    }
+}
+function safeReadDir(path) {
+    try {
+        return readdirSync(path);
+    }
+    catch {
+        return [];
+    }
+}

package/dist/client/askmesh_client.d.ts

@@ -7,6 +7,12 @@ export declare class AskMeshClient {
         requestId: number;
         status: string;
     }>;
+    getRequest(requestId: number): Promise<{
+        id: number;
+        status: string;
+        answer: string | null;
+        question: string;
+    }>;
     getPendingRequests(): Promise<{
         requests: Array<{
             id: number;

package/dist/client/askmesh_client.js

@@ -21,6 +21,14 @@ export class AskMeshClient {
             throw new Error(`askAgent failed: ${res.status} ${await res.text()}`);
         return res.json();
     }
+    async getRequest(requestId) {
+        const res = await fetch(`${this.baseUrl}/api/v1/requests/${requestId}`, {
+            headers: this.headers(),
+        });
+        if (!res.ok)
+            throw new Error(`getRequest failed: ${res.status}`);
+        return res.json();
+    }
     async getPendingRequests() {
         const res = await fetch(`${this.baseUrl}/api/v1/requests/pending`, {
             headers: this.headers(),

package/dist/index.js

@@ -4,11 +4,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { AskMeshClient } from './client/askmesh_client.js';
 import { SseListener } from './sse/sse_listener.js';
 import { AutoResponder } from './agent/auto_responder.js';
-import { registerAskAgent } from './tools/ask_agent.js';
-import { registerListAgents } from './tools/list_agents.js';
-import { registerGetStatus } from './tools/get_status.js';
-import { registerAnswerPending } from './tools/answer_pending.js';
-import { registerSetContext } from './tools/set_context.js';
+import { registerAskMesh } from './tools/askmesh.js';
 const TOKEN = process.env.ASKMESH_TOKEN;
 const URL = process.env.ASKMESH_URL || 'https://api.askmesh.dev';
 if (!TOKEN) {
@@ -19,20 +15,18 @@ const client = new AskMeshClient(URL, TOKEN);
 const autoResponder = new AutoResponder(client);
 const server = new McpServer({
     name: 'askmesh',
-    version: '0.2.0',
+    version: '0.3.0',
 });
-// Register all tools
-registerAskAgent(server, client);
-registerListAgents(server, client);
-registerGetStatus(server, client);
-registerAnswerPending(server, client);
-registerSetContext(server, client);
+// Single unified tool
+registerAskMesh(server, client);
 // Give the auto-responder access to the underlying MCP server for sampling
 autoResponder.setServer(server.server);
-// Start SSE listener — auto-respond to incoming questions
+// Start SSE listener — auto-respond to incoming questions + receive answers
 const sse = new SseListener();
 sse.start(URL, TOKEN, async (request) => {
     await autoResponder.handleRequest(request);
+}, (answer) => {
+    console.error(`[AskMesh] Answer received for request #${answer.id}: "${answer.answer.slice(0, 100)}${answer.answer.length > 100 ? '...' : ''}"`);
 });
 // Cleanup on exit
 process.on('SIGINT', () => {

package/dist/sse/sse_listener.d.ts

@@ -5,8 +5,20 @@ export interface IncomingRequest {
     question: string;
     context: string | null;
 }
+export interface IncomingAnswer {
+    id: number;
+    answer: string;
+}
 export declare class SseListener {
     private es;
-    start(baseUrl: string, token: string, onRequest: (req: IncomingRequest) => void): void;
+    private reconnectTimer;
+    private baseUrl;
+    private token;
+    private onRequest;
+    private onAnswer;
+    private connected;
+    start(baseUrl: string, token: string, onRequest: (req: IncomingRequest) => void, onAnswer?: (ans: IncomingAnswer) => void): void;
+    private connect;
+    private scheduleReconnect;
     stop(): void;
 }

package/dist/sse/sse_listener.js

@@ -1,29 +1,77 @@
 import EventSource from 'eventsource';
 export class SseListener {
     es = null;
-    start(baseUrl, token, onRequest) {
-        this.es = new EventSource(`${baseUrl}/api/v1/sse/subscribe`, {
-            headers: { Authorization: `Bearer ${token}` },
+    reconnectTimer = null;
+    baseUrl = '';
+    token = '';
+    onRequest = null;
+    onAnswer = null;
+    connected = false;
+    start(baseUrl, token, onRequest, onAnswer) {
+        this.baseUrl = baseUrl;
+        this.token = token;
+        this.onRequest = onRequest;
+        this.onAnswer = onAnswer || null;
+        this.connect();
+    }
+    connect() {
+        if (this.es) {
+            this.es.close();
+            this.es = null;
+        }
+        this.es = new EventSource(`${this.baseUrl}/api/v1/sse/subscribe`, {
+            headers: { Authorization: `Bearer ${this.token}` },
         });
+        this.es.addEventListener('open', (() => {
+            this.connected = true;
+            console.error('[AskMesh SSE] Connected');
+        }));
         this.es.addEventListener('request_incoming', ((e) => {
             try {
                 const payload = JSON.parse(e.data);
-                onRequest(payload);
+                this.onRequest?.(payload);
             }
-            catch {
-                // ignore parse errors
+            catch { }
+        }));
+        this.es.addEventListener('answer_ready', ((e) => {
+            try {
+                const payload = JSON.parse(e.data);
+                this.onAnswer?.(payload);
+                console.error(`[AskMesh] Answer received for request #${payload.id}`);
             }
+            catch { }
         }));
         this.es.addEventListener('ping', () => {
-            // keepalive — nothing to do
+            // Keepalive — confirms connection is alive
         });
         this.es.onerror = () => {
-            // EventSource handles automatic reconnection
-            console.error('[AskMesh SSE] Connection error — will reconnect');
+            if (this.connected) {
+                this.connected = false;
+                console.error('[AskMesh SSE] Disconnected — reconnecting in 5s...');
+            }
+            // EventSource auto-reconnects, but if it fails repeatedly
+            // we force a clean reconnect after 5s
+            this.scheduleReconnect();
         };
     }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            if (!this.connected && this.es?.readyState === 2) {
+                console.error('[AskMesh SSE] Force reconnecting...');
+                this.connect();
+            }
+        }, 5000);
+    }
     stop() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
         this.es?.close();
         this.es = null;
+        this.connected = false;
     }
 }

package/dist/tools/ask_agent.js

@@ -1,17 +1,36 @@
 import { z } from 'zod';
 export function registerAskAgent(server, client) {
-    server.tool('ask_agent', 'Pose une question à un agent de ton équipe par son username', {
+    server.tool('ask_agent', 'Pose une question à un agent de ton équipe. Attend la réponse (max 60s).', {
         username: z.string().describe("Username de l'agent cible (ex: manu)"),
         question: z.string().describe('La question à poser'),
         context: z.string().optional().describe('Contexte additionnel (optionnel)'),
     }, async ({ username, question, context }) => {
         const target = username.replace(/^@/, '');
         const result = await client.askAgent(target, question, context);
+        const requestId = result.requestId;
+        // Poll for the answer (max 60s, check every 3s)
+        for (let i = 0; i < 20; i++) {
+            await new Promise((r) => setTimeout(r, 3000));
+            try {
+                const req = await client.getRequest(requestId);
+                if (req.status === 'answered' && req.answer) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `@${target} a répondu :\n\n${req.answer}`,
+                            },
+                        ],
+                    };
+                }
+            }
+            catch { }
+        }
         return {
             content: [
                 {
                     type: 'text',
-                    text: `Question envoyée à @${target} (request #${result.requestId})\nStatut: ${result.status}`,
+                    text: `Question envoyée à @${target} (request #${requestId}). L'agent n'a pas encore répondu (timeout 60s). La réponse arrivera plus tard — vérifie avec answer_pending.`,
                 },
             ],
         };

package/dist/tools/askmesh.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AskMeshClient } from '../client/askmesh_client.js';
+export declare function registerAskMesh(server: McpServer, client: AskMeshClient): void;

package/dist/tools/askmesh.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+export function registerAskMesh(server, client) {
+    server.tool('askmesh', `AskMesh — communique avec les agents de ton équipe.
+
+Actions:
+- "ask" : pose une question à un agent (attend la réponse max 60s)
+- "list" : liste les agents de tes teams et leur statut
+- "status" : vérifie si un agent est disponible
+- "pending" : voir les questions qu'on t'a posées
+- "answer" : répondre à une question en attente
+- "context" : partager ton contexte projet avec ta team`, {
+        action: z.enum(['ask', 'list', 'status', 'pending', 'answer', 'context']).describe('Action à effectuer'),
+        username: z.string().optional().describe("Username de l'agent cible (pour ask/status)"),
+        question: z.string().optional().describe('Question à poser (pour ask)'),
+        requestId: z.number().optional().describe('ID de la requête (pour answer)'),
+        message: z.string().optional().describe('Réponse ou contexte à envoyer (pour answer/context)'),
+    }, async ({ action, username, question, requestId, message }) => {
+        switch (action) {
+            case 'ask': {
+                if (!username || !question) {
+                    return text("Paramètres requis : username et question");
+                }
+                const target = username.replace(/^@/, '');
+                const result = await client.askAgent(target, question);
+                const reqId = result.requestId;
+                // Poll for answer (max 60s)
+                for (let i = 0; i < 20; i++) {
+                    await new Promise((r) => setTimeout(r, 3000));
+                    try {
+                        const req = await client.getRequest(reqId);
+                        if (req.status === 'answered' && req.answer) {
+                            return text(`@${target} a répondu :\n\n${req.answer}`);
+                        }
+                    }
+                    catch { }
+                }
+                return text(`Question envoyée à @${target} (#${reqId}). Pas de réponse dans les 60s — utilise "pending" pour vérifier plus tard.`);
+            }
+            case 'list': {
+                const { agents } = await client.listAgents();
+                if (agents.length === 0)
+                    return text('Aucun agent dans tes teams.');
+                const lines = agents.map((a) => {
+                    const icon = a.status === 'online' ? '🟢' : '⚫';
+                    return `${icon} @${a.username} — ${a.status}`;
+                });
+                return text(lines.join('\n'));
+            }
+            case 'status': {
+                if (!username)
+                    return text("Paramètre requis : username");
+                const target = username.replace(/^@/, '');
+                const result = await client.getAgentStatus(target);
+                const icon = result.status === 'online' ? '🟢' : '⚫';
+                return text(`${icon} @${result.username} — ${result.status}${result.lastSeenAt ? `\nDernière activité: ${result.lastSeenAt}` : ''}`);
+            }
+            case 'pending': {
+                const { requests } = await client.getPendingRequests();
+                if (requests.length === 0)
+                    return text('Aucune question en attente.');
+                const lines = requests.map((r) => `#${r.id} — "${r.question}"`);
+                return text(`Questions en attente:\n${lines.join('\n')}\n\nUtilise action "answer" avec requestId et message pour répondre.`);
+            }
+            case 'answer': {
+                if (!requestId || !message) {
+                    return text("Paramètres requis : requestId et message");
+                }
+                const result = await client.answerRequest(requestId, message);
+                return text(`Réponse envoyée pour la requête #${result.id}.`);
+            }
+            case 'context': {
+                if (!message)
+                    return text("Paramètre requis : message (le contenu du contexte)");
+                await client.setContext(message);
+                return text(`Contexte mis à jour (${message.length} caractères).`);
+            }
+            default:
+                return text('Action inconnue. Actions disponibles : ask, list, status, pending, answer, context');
+        }
+    });
+}
+function text(t) {
+    return { content: [{ type: 'text', text: t }] };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askmesh/mcp",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "AskMesh MCP server — connect your AI coding agent to your team's mesh network",
   "type": "module",
   "bin": {