claudemesh-cli 0.7.0 → 0.7.1

package/dist/index.js

@@ -47478,6 +47478,10 @@ var TOOLS = [
             required: ["name", "description", "inputSchema"]
           },
           description: "Tool definitions to expose"
+        },
+        persistent: {
+          type: "boolean",
+          description: "If true, registration survives peer disconnect. Other peers see it as 'offline' until you reconnect. Default: false"
         }
       },
       required: ["server_name", "description", "tools"]
@@ -47810,6 +47814,7 @@ class BrokerClient {
             sessionId: `${process.pid}-${Date.now()}`,
             pid: process.pid,
             cwd: process.cwd(),
+            hostname: __require("os").hostname(),
             peerType: "ai",
             channel: "claude-code",
             model: process.env.CLAUDE_MODEL || undefined,
@@ -47841,6 +47846,18 @@ class BrokerClient {
           this.reconnectAttempt = 0;
           this.flushOutbound();
           this.startStatsReporting();
+          if (msg.restored) {
+            const groups = msg.restoredGroups ? msg.restoredGroups.map((g) => g.role ? `@${g.name}:${g.role}` : `@${g.name}`).join(", ") : "none";
+            process.stderr.write(`[claudemesh] session restored — last seen ${msg.lastSeenAt ?? "unknown"}, groups: ${groups}
+`);
+            if (msg.restoredStats) {
+              const rs = msg.restoredStats;
+              this._statsCounters.messagesIn = rs.messagesIn ?? 0;
+              this._statsCounters.messagesOut = rs.messagesOut ?? 0;
+              this._statsCounters.toolCalls = rs.toolCalls ?? 0;
+              this._statsCounters.errors = rs.errors ?? 0;
+            }
+          }
           resolve();
           return;
         }
@@ -48427,7 +48444,7 @@ class BrokerClient {
     this.stateChangeHandlers.add(handler);
     return () => this.stateChangeHandlers.delete(handler);
   }
-  async mcpRegister(serverName, description, tools) {
+  async mcpRegister(serverName, description, tools, persistent) {
     if (!this.ws || this.ws.readyState !== this.ws.OPEN)
       return null;
     return new Promise((resolve) => {
@@ -48436,7 +48453,7 @@ class BrokerClient {
         if (this.mcpRegisterResolvers.delete(reqId))
           resolve(null);
       }, 5000) });
-      this.ws.send(JSON.stringify({ type: "mcp_register", serverName, description, tools, _reqId: reqId }));
+      this.ws.send(JSON.stringify({ type: "mcp_register", serverName, description, tools, ...persistent ? { persistent: true } : {}, _reqId: reqId }));
     });
   }
   async mcpUnregister(serverName) {
@@ -49312,6 +49329,25 @@ function stopAll() {
 }
 
 // src/mcp/server.ts
+function relativeTime(isoStr) {
+  const then = new Date(isoStr).getTime();
+  if (isNaN(then))
+    return "unknown";
+  const diffMs = Date.now() - then;
+  if (diffMs < 0)
+    return "just now";
+  const seconds = Math.floor(diffMs / 1000);
+  if (seconds < 60)
+    return `${seconds}s ago`;
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60)
+    return `${minutes}m ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24)
+    return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  return `${days} day${days !== 1 ? "s" : ""} ago`;
+}
 function text(msg, isError = false) {
   return {
     content: [{ type: "text", text: msg }],
@@ -49484,9 +49520,14 @@ Shared key-value store scoped to the mesh. Use get_state/set_state for live coor
 ## Memory
 Persistent knowledge that survives across sessions. Use remember(content, tags?) to store lessons, decisions, and incidents. Use recall(query) to search before asking peers. New peers should recall at session start to load institutional knowledge.
 
-## Files
-share_file for persistent references, send_message(file:) for ephemeral attachments.
-Tags on shared files make them searchable. Use list_files to find what peers shared.
+## File access — decision guide
+Three ways to access files. Pick the right one:
+
+1. **Local peer (same machine, [local] tag):** Read files directly via filesystem using their \`cwd\` path from list_peers. No limit, instant. This is the default for local peers.
+2. **Remote peer (different machine, [remote] tag):** Use \`read_peer_file(peer, path)\` — relays through the mesh. **1 MB limit**, base64 encoded. Use \`list_peer_files\` to browse first.
+3. **Persistent sharing (any peer):** Use \`share_file(path)\` — uploads to mesh storage (MinIO). **No size limit**. All peers can download anytime via \`get_file\`. Use for files that need to persist or be shared with multiple peers.
+
+**Rule of thumb:** local peer → filesystem. Remote peer, small file → read_peer_file. Large file or needs to persist → share_file.
 
 ## Vectors
 Store and search semantic embeddings. Use vector_store to index content, vector_search to find similar content.
@@ -49583,10 +49624,12 @@ No peers connected.`);
                 meta2.push(`model:${p.model}`);
               const metaStr = meta2.length ? ` {${meta2.join(", ")}}` : "";
               const cwdStr = p.cwd ? ` cwd:${p.cwd}` : "";
+              const locality = p.hostname && p.hostname === __require("os").hostname() ? "local" : "remote";
+              const localityTag = ` [${locality}]`;
               const profileAvatar = p.profile?.avatar ? `${p.profile.avatar} ` : "";
               const profileTitle = p.profile?.title ? ` (${p.profile.title})` : "";
               const hiddenTag = p.visible === false ? " [hidden]" : "";
-              return `- ${profileAvatar}**${p.displayName}**${profileTitle} [${p.status}]${hiddenTag}${groupsStr}${metaStr} (${p.pubkey.slice(0, 12)}…)${cwdStr}${summary}`;
+              return `- ${profileAvatar}**${p.displayName}**${profileTitle} [${p.status}]${localityTag}${hiddenTag}${groupsStr}${metaStr} (${p.pubkey.slice(0, 12)}…)${cwdStr}${summary}`;
             });
             sections.push(`${header}
 ${peerLines.join(`
@@ -50423,16 +50466,17 @@ ${lines.join(`
 `));
       }
       case "mesh_mcp_register": {
-        const { server_name, description, tools: regTools } = args ?? {};
+        const { server_name, description, tools: regTools, persistent: regPersistent } = args ?? {};
         if (!server_name || !description || !regTools?.length)
           return text("mesh_mcp_register: `server_name`, `description`, and `tools` required", true);
         const client2 = allClients()[0];
         if (!client2)
           return text("mesh_mcp_register: not connected", true);
-        const result = await client2.mcpRegister(server_name, description, regTools);
+        const result = await client2.mcpRegister(server_name, description, regTools, regPersistent);
         if (!result)
           return text("mesh_mcp_register: broker did not acknowledge", true);
-        return text(`Registered MCP server "${result.serverName}" with ${result.toolCount} tool(s). Other peers can now call its tools via mesh_tool_call.`);
+        const persistLabel = regPersistent ? " (persistent — survives disconnect)" : "";
+        return text(`Registered MCP server "${result.serverName}" with ${result.toolCount} tool(s)${persistLabel}. Other peers can now call its tools via mesh_tool_call.`);
       }
       case "mesh_mcp_list": {
         const client2 = allClients()[0];
@@ -50444,7 +50488,8 @@ ${lines.join(`
         const lines = servers.map((s) => {
           const toolList = s.tools.map((t) => `    - **${t.name}**: ${t.description}`).join(`
 `);
-          return `- **${s.name}** (hosted by ${s.hostedBy}): ${s.description}
+          const status = s.online === false ? ` [OFFLINE${s.offlineSince ? ` since ${s.offlineSince}` : ""}]` : "";
+          return `- **${s.name}** (hosted by ${s.hostedBy})${status}: ${s.description}
 ${toolList}`;
         });
         return text(`${servers.length} MCP server(s) in mesh:
@@ -50531,6 +50576,17 @@ ${lines.join(`
             targetPubkey = match.pubkey;
           }
         }
+        const resolvedPeer = peers.find((p) => p.pubkey === targetPubkey);
+        const isLocal = resolvedPeer?.hostname && resolvedPeer.hostname === __require("os").hostname();
+        let localHint = "";
+        if (isLocal && resolvedPeer?.cwd) {
+          const directPath = __require("path").resolve(resolvedPeer.cwd, filePath);
+          localHint = `
+
+> **Hint:** This peer is LOCAL (same machine). Next time, read directly: \`${directPath}\` — faster, no size limit.
+
+`;
+        }
         const result = await client2.requestFile(targetPubkey, filePath);
         if (result.error)
           return text(`read_peer_file: ${result.error}`, true);
@@ -50538,7 +50594,7 @@ ${lines.join(`
           return text("read_peer_file: empty response from peer", true);
         try {
           const decoded = Buffer.from(result.content, "base64").toString("utf-8");
-          return text(decoded);
+          return text(localHint + decoded);
         } catch {
           return text("read_peer_file: failed to decode file content (binary file?)", true);
         }
@@ -50638,8 +50694,21 @@ ${lines.join(`
           content2 = `[heartbeat] tick ${tick} | sim time: ${simTime} | speed: x${speed}`;
         } else if (eventName === "peer_joined") {
           content2 = `[system] Peer "${data.name ?? "unknown"}" joined the mesh`;
+        } else if (eventName === "peer_returned") {
+          const peerName = String(data.name ?? "unknown");
+          const lastSeenAt = data.lastSeenAt ? relativeTime(String(data.lastSeenAt)) : "unknown";
+          const groups = Array.isArray(data.groups) ? data.groups.map((g) => g.role ? `@${g.name}:${g.role}` : `@${g.name}`).join(", ") : "";
+          const summary = data.summary ? ` Summary: "${data.summary}"` : "";
+          content2 = `[system] Welcome back, "${peerName}"! Last seen ${lastSeenAt}.${groups ? ` Restored: ${groups}` : ""}${summary}`;
         } else if (eventName === "peer_left") {
           content2 = `[system] Peer "${data.name ?? "unknown"}" left the mesh`;
+        } else if (eventName === "mcp_registered") {
+          const tools = Array.isArray(data.tools) ? data.tools.join(", ") : "";
+          content2 = `[system] New MCP server available: "${data.serverName}" (hosted by ${data.hostedBy}). Tools: ${tools}. Use mesh_tool_call to invoke.`;
+        } else if (eventName === "mcp_unregistered") {
+          content2 = `[system] MCP server "${data.serverName}" removed (was hosted by ${data.hostedBy})`;
+        } else if (eventName === "mcp_restored") {
+          content2 = `[system] MCP server "${data.serverName}" is back online (hosted by ${data.hostedBy})`;
         } else {
           content2 = `[system] ${eventName}: ${JSON.stringify(data)}`;
         }
@@ -51739,7 +51808,7 @@ init_config();
 // package.json
 var package_default = {
   name: "claudemesh-cli",
-  version: "0.7.0",
+  version: "0.7.1",
   description: "Claude Code MCP client for claudemesh — peer mesh messaging between Claude sessions.",
   keywords: [
     "claude-code",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudemesh-cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Claude Code MCP client for claudemesh — peer mesh messaging between Claude sessions.",
   "keywords": [
     "claude-code",
@@ -48,10 +48,10 @@
     "prettier": "3.6.2",
     "typescript": "5.9.3",
     "vitest": "4.0.14",
+    "@turbostarter/eslint-config": "0.1.0",
     "@turbostarter/tsconfig": "0.1.0",
     "@turbostarter/prettier-config": "0.1.0",
-    "@turbostarter/vitest-config": "0.1.0",
-    "@turbostarter/eslint-config": "0.1.0"
+    "@turbostarter/vitest-config": "0.1.0"
   },
   "scripts": {
     "build": "bun build src/index.ts --target=node --outfile dist/index.js --banner \"#!/usr/bin/env node\" && chmod +x dist/index.js",