@seamnet/client 0.2.5 → 0.3.0

package/bin/cli.js

@@ -53,17 +53,26 @@ try {
     case 'status':
       await status();
       break;
-    case 'stop':
-      await stop();
+    case 'stop': {
+      const { guardianStop } = await import('../lib/guardian.js');
+      await guardianStop();
       break;
+    }
     case 'mcp-serve': {
-      // Start MCP server (called by Claude Code via .mcp.json)
-      // Use dynamic import to load the CJS mcp-server
       const { createRequire } = await import('node:module');
       const require = createRequire(import.meta.url);
       require('../lib/mcp-server.cjs');
       break;
     }
+    case 'guardian': {
+      const sub = process.argv[3];
+      const { guardianStart, guardianRun, guardianStop } = await import('../lib/guardian.js');
+      if (sub === 'start') await guardianStart();
+      else if (sub === 'run') await guardianRun();
+      else if (sub === 'stop') await guardianStop();
+      else console.error('Usage: seam-client guardian [start|stop|run]');
+      break;
+    }
     default:
       console.error(`Unknown command: ${command}`);
       process.exit(1);

package/lib/guardian.js

@@ -0,0 +1,97 @@
+/**
+ * Seam Guardian — 后台长驻进程（插件宿主）
+ * 通过 tmux 运行，负责：保持在线、加载插件、监听 unix socket
+ */
+
+import { existsSync, readFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { SEAM_DIR, CREDENTIALS_PATH } from './paths.js';
+
+const SOCKET_PATH = join(SEAM_DIR, 'guardian.sock');
+const LOGS_DIR = join(SEAM_DIR, 'logs');
+
+export async function guardianStart() {
+  // Load credentials
+  if (!existsSync(CREDENTIALS_PATH)) {
+    console.error('No credentials found. Run: npx @seamnet/client init first.');
+    process.exit(1);
+  }
+
+  const creds = JSON.parse(readFileSync(CREDENTIALS_PATH, 'utf8'));
+  const sessionName = `seam-guardian-${creds.userId}`;
+
+  // Check if already running
+  try {
+    execSync(`tmux has-session -t ${sessionName}`, { stdio: 'ignore' });
+    console.log(`Guardian already running (tmux session: ${sessionName})`);
+    return;
+  } catch {
+    // Not running, continue
+  }
+
+  // Ensure logs dir
+  if (!existsSync(LOGS_DIR)) mkdirSync(LOGS_DIR, { recursive: true });
+
+  // Start guardian in tmux
+  const guardianCmd = `npx @seamnet/client guardian run`;
+  execSync(
+    `tmux new-session -d -s ${sessionName} '${guardianCmd} 2>&1 | tee -a ${join(LOGS_DIR, 'guardian.log')}'`,
+    { stdio: 'inherit' }
+  );
+
+  console.log(`Guardian started (tmux session: ${sessionName})`);
+  console.log(`  Attach: tmux attach -t ${sessionName}`);
+  console.log(`  Logs:   ${join(LOGS_DIR, 'guardian.log')}`);
+}
+
+export async function guardianRun() {
+  // This runs inside the tmux session
+  if (!existsSync(CREDENTIALS_PATH)) {
+    console.error('No credentials found.');
+    process.exit(1);
+  }
+
+  const creds = JSON.parse(readFileSync(CREDENTIALS_PATH, 'utf8'));
+  console.log(`[guardian] Starting for ${creds.userId}...`);
+
+  // Load IM plugin (creates SDK connection + unix socket server)
+  const { createImPlugin } = await import('./plugins/im.js');
+  const imPlugin = await createImPlugin({
+    credentials: creds,
+    socketPath: SOCKET_PATH,
+    seamDir: SEAM_DIR,
+  });
+
+  console.log(`[guardian] Running. Socket: ${SOCKET_PATH}`);
+
+  // Keep alive
+  process.on('SIGTERM', () => {
+    console.log('[guardian] Shutting down...');
+    imPlugin.destroy();
+    process.exit(0);
+  });
+
+  process.on('SIGINT', () => {
+    console.log('[guardian] Shutting down...');
+    imPlugin.destroy();
+    process.exit(0);
+  });
+}
+
+export async function guardianStop() {
+  if (!existsSync(CREDENTIALS_PATH)) {
+    console.log('No credentials found.');
+    return;
+  }
+
+  const creds = JSON.parse(readFileSync(CREDENTIALS_PATH, 'utf8'));
+  const sessionName = `seam-guardian-${creds.userId}`;
+
+  try {
+    execSync(`tmux kill-session -t ${sessionName}`, { stdio: 'ignore' });
+    console.log(`Guardian stopped (tmux session: ${sessionName})`);
+  } catch {
+    console.log('Guardian is not running.');
+  }
+}

package/lib/init.js

@@ -172,16 +172,10 @@ function writeMcpConfig(result) {
 }
 
 function writeSeamSkill() {
-  // Find .claude/skills/ directory — try project dir first, then home
-  const candidates = [
-    join(process.cwd(), '.claude', 'skills'),
-    join(SEAM_DIR, 'skills'),
-  ];
-
-  const skillDir = candidates.find(d => existsSync(dirname(d))) || candidates[0];
+  const skillDir = join(process.cwd(), '.claude', 'skills', 'seam');
   mkdirSync(skillDir, { recursive: true });
 
-  const skillPath = join(skillDir, 'seam.md');
+  const skillPath = join(skillDir, 'SKILL.md');
   const template = readFileSync(join(TEMPLATES_DIR, 'seam-skill.md'), 'utf8');
   writeFileSync(skillPath, template);
   console.log(`  /seam skill installed.`);

package/lib/mcp-server.cjs

@@ -1,124 +1,38 @@
 #!/usr/bin/env node
 /**
- * Seam MCP Server — 腾讯云IM SDK直连版
- * 从 .seam/credentials.json 读凭证，SDK直连收发消息
- * 基于 guardian IM 插件逆向方案封装
+ * Seam MCP Server — 轻量转发器
+ * 不登录 SDK，通过 unix socket 连接 guardian 发消息
  */
 
-const fs = require('fs');
+const net = require('net');
 const path = require('path');
 const readline = require('readline');
 
-// === Polyfills (must be before requiring SDK) ===
-
-// WebSocket polyfill
-try {
-  const WS = require('ws');
-  global.WebSocket = WS;
-} catch(e) {
-  console.error('[seam-im] ws package not found. Run: npm install ws');
-  process.exit(1);
-}
-
-// XHR polyfill
-if (!global.XMLHttpRequest) {
-  try { global.XMLHttpRequest = require('xhr2'); } catch(e) {}
-}
-if (global.XMLHttpRequest) {
-  const _origSend = global.XMLHttpRequest.prototype.send;
-  if (!global.XMLHttpRequest.prototype._imPatched) {
-    global.XMLHttpRequest.prototype._imPatched = true;
-    global.XMLHttpRequest.prototype.send = function(data) {
-      if (data && typeof data === 'object' && data._buffer) return _origSend.call(this, data._buffer);
-      return _origSend.call(this, data);
-    };
-  }
-}
-
-// SDK source patch: skip _getImageInfoArray and _getDownloadIP (timeout in Node.js)
-const Module = require('module');
-const _origCompile = Module.prototype._compile;
-if (!Module.prototype._imPatched) {
-  Module.prototype._imPatched = true;
-  Module.prototype._compile = function(content, filename) {
-    if (filename.includes('@tencentcloud/chat') && filename.endsWith('index.js')) {
-      const p1 = '_getImageInfoArray",value:function(t,n){var o=this,i="".concat(this._n,"._getImageInfoArray")';
-      const r1 = '_getImageInfoArray",value:function(t,n){return Promise.resolve();var o=this,i="".concat(this._n,"._getImageInfoArray")';
-      if (content.includes(p1)) content = content.replace(p1, r1);
-      const p2 = '_getDownloadIP",value:function(e,n){var o="".concat(this._n,"._getDownloadIP")';
-      const r2 = '_getDownloadIP",value:function(e,n){return Promise.resolve();var o="".concat(this._n,"._getDownloadIP")';
-      if (content.includes(p2)) content = content.replace(p2, r2);
-    }
-    return _origCompile.call(this, content, filename);
-  };
-}
-
-// === Redirect console.log to stderr (stdout is reserved for MCP JSON-RPC) ===
-const _origLog = console.log;
-const _origWarn = console.warn;
-const _origInfo = console.info;
-console.log = (...args) => process.stderr.write(args.join(' ') + '\n');
-console.warn = (...args) => process.stderr.write(args.join(' ') + '\n');
-console.info = (...args) => process.stderr.write(args.join(' ') + '\n');
-
-// === Load credentials ===
 const SEAM_DIR = path.join(process.cwd(), '.seam');
-const CRED_PATH = process.env.SEAM_CREDENTIALS || path.join(SEAM_DIR, 'credentials.json');
+const SOCKET_PATH = path.join(SEAM_DIR, 'guardian.sock');
 
-let creds;
-try {
-  creds = JSON.parse(fs.readFileSync(CRED_PATH, 'utf8'));
-} catch(e) {
-  console.error(`[seam-im] Cannot read credentials: ${CRED_PATH}`);
-  process.exit(1);
+function guardianRequest(payload) {
+  return new Promise((resolve, reject) => {
+    const conn = net.createConnection(SOCKET_PATH, () => {
+      conn.end(JSON.stringify(payload));
+    });
+    let data = '';
+    conn.on('data', (chunk) => { data += chunk; });
+    conn.on('end', () => {
+      try { resolve(JSON.parse(data)); }
+      catch { resolve({ error: data || 'Empty response' }); }
+    });
+    conn.on('error', (e) => {
+      reject(new Error(`Guardian not running. Start it first: npx @seamnet/client guardian start`));
+    });
+    conn.setTimeout(10000, () => {
+      conn.destroy();
+      reject(new Error('Guardian request timeout'));
+    });
+  });
 }
 
-const SDK_APP_ID = Number(creds.sdkAppId);
-const USER_ID = creds.userId;
-const USER_SIG = creds.userSig;
-
-// === Initialize SDK ===
-delete global.window;
-const TencentCloudChat = require('@tencentcloud/chat');
-
-const chat = TencentCloudChat.create({ SDKAppID: SDK_APP_ID });
-
-// Set window after require (De flag is locked to false)
-global.window = {
-  location: { href: 'http://localhost', protocol: 'https:', host: 'localhost', hostname: 'localhost' },
-  addEventListener: () => {}, removeEventListener: () => {},
-  URL: Object.assign(function(...a){ return new (require('url').URL)(...a); }, {
-    createObjectURL: () => 'blob:node/1', revokeObjectURL: () => {}
-  })
-};
-global.document = { addEventListener:()=>{}, removeEventListener:()=>{}, characterSet:'UTF-8' };
-global.navigator = { userAgent: 'node', language: 'en', platform: 'linux' };
-global.HTMLInputElement = global.HTMLInputElement || class {};
-global.Image = class {
-  constructor() { this.width = 100; this.height = 100; this._ol = null; }
-  set onload(fn) { this._ol = fn; } get onload() { return this._ol; }
-  set onerror(fn) {} set src(v) { if(this._ol) setTimeout(()=>this._ol(),10); }
-};
-
-chat.setLogLevel(4); // 4 = no SDK logs, only our own stderr output
-
-let sdkReady = false;
-
-chat.on(TencentCloudChat.EVENT.SDK_READY, () => {
-  sdkReady = true;
-  process.stderr.write(`[seam-im] SDK ready: ${USER_ID}\n`);
-});
-
-chat.on(TencentCloudChat.EVENT.SDK_NOT_READY, () => {
-  sdkReady = false;
-  process.stderr.write('[seam-im] SDK not ready\n');
-});
-
-chat.login({ userID: USER_ID, userSig: USER_SIG }).catch(err => {
-  process.stderr.write(`[seam-im] Login failed: ${err}\n`);
-});
-
-// === MCP Protocol ===
+// MCP protocol: stdio JSON-RPC
 const rl = readline.createInterface({ input: process.stdin });
 
 const tools = [
@@ -166,7 +80,7 @@ rl.on('line', async (line) => {
     sendResponse(id, {
       protocolVersion: '2024-11-05',
       capabilities: { tools: {} },
-      serverInfo: { name: 'seam-im', version: '0.2.0' }
+      serverInfo: { name: 'seam-im', version: '0.3.0' }
     });
   } else if (method === 'notifications/initialized') {
     // no response needed
@@ -174,42 +88,29 @@ rl.on('line', async (line) => {
     sendResponse(id, { tools });
   } else if (method === 'tools/call') {
     const { name, arguments: args } = params;
-
-    if (!sdkReady) {
-      sendResponse(id, {
-        content: [{ type: 'text', text: 'IM SDK 未就绪，请稍后重试' }],
-        isError: true
-      });
-      return;
-    }
-
     try {
+      let result;
       if (name === 'msg_send_im') {
-        const msg = chat.createTextMessage({
-          to: args.to,
-          conversationType: TencentCloudChat.TYPES.CONV_C2C,
-          payload: { text: args.text },
-        });
-        await chat.sendMessage(msg);
-        sendResponse(id, {
-          content: [{ type: 'text', text: `消息已发送给 ${args.to}` }]
-        });
+        result = await guardianRequest({ action: 'send_im', to: args.to, text: args.text });
       } else if (name === 'msg_send_group') {
-        const msg = chat.createTextMessage({
-          to: args.group_id,
-          conversationType: TencentCloudChat.TYPES.CONV_GROUP,
-          payload: { text: args.text },
-        });
-        await chat.sendMessage(msg);
+        result = await guardianRequest({ action: 'send_group', groupId: args.group_id, text: args.text });
+      } else {
+        sendError(id, -32601, `Unknown tool: ${name}`);
+        return;
+      }
+      if (result.error) {
         sendResponse(id, {
-          content: [{ type: 'text', text: `消息已发送到群 ${args.group_id}` }]
+          content: [{ type: 'text', text: `发送失败: ${result.error}` }],
+          isError: true
         });
       } else {
-        sendError(id, -32601, `Unknown tool: ${name}`);
+        sendResponse(id, {
+          content: [{ type: 'text', text: `消息已发送` }]
+        });
       }
     } catch (e) {
       sendResponse(id, {
-        content: [{ type: 'text', text: `发送失败: ${e.message || e}` }],
+        content: [{ type: 'text', text: e.message }],
         isError: true
       });
     }

package/lib/plugins/im.cjs

@@ -0,0 +1,206 @@
+/**
+ * Seam IM Plugin — SDK直连 + unix socket server
+ * Guardian 加载此插件：
+ *   - SDK 登录，保持在线
+ *   - 收到消息注入 tmux 终端
+ *   - 监听 unix socket，接收 MCP server 的发消息请求
+ */
+
+const fs = require('fs');
+const net = require('net');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// === Polyfills ===
+try {
+  const WS = require('ws');
+  global.WebSocket = WS;
+} catch (e) {
+  console.error('[im-plugin] ws package not found');
+  process.exit(1);
+}
+
+if (!global.XMLHttpRequest) {
+  try { global.XMLHttpRequest = require('xhr2'); } catch (e) {}
+}
+if (global.XMLHttpRequest) {
+  const _origSend = global.XMLHttpRequest.prototype.send;
+  if (!global.XMLHttpRequest.prototype._imPatched) {
+    global.XMLHttpRequest.prototype._imPatched = true;
+    global.XMLHttpRequest.prototype.send = function (data) {
+      if (data && typeof data === 'object' && data._buffer) return _origSend.call(this, data._buffer);
+      return _origSend.call(this, data);
+    };
+  }
+}
+
+// SDK source patch
+const Module = require('module');
+const _origCompile = Module.prototype._compile;
+if (!Module.prototype._imPatched) {
+  Module.prototype._imPatched = true;
+  Module.prototype._compile = function (content, filename) {
+    if (filename.includes('@tencentcloud/chat') && filename.endsWith('index.js')) {
+      const p1 = '_getImageInfoArray",value:function(t,n){var o=this,i="".concat(this._n,"._getImageInfoArray")';
+      const r1 = '_getImageInfoArray",value:function(t,n){return Promise.resolve();var o=this,i="".concat(this._n,"._getImageInfoArray")';
+      if (content.includes(p1)) content = content.replace(p1, r1);
+      const p2 = '_getDownloadIP",value:function(e,n){var o="".concat(this._n,"._getDownloadIP")';
+      const r2 = '_getDownloadIP",value:function(e,n){return Promise.resolve();var o="".concat(this._n,"._getDownloadIP")';
+      if (content.includes(p2)) content = content.replace(p2, r2);
+    }
+    return _origCompile.call(this, content, filename);
+  };
+}
+
+function createImPlugin({ credentials, socketPath, seamDir }) {
+  return new Promise((resolve) => {
+    const SDK_APP_ID = Number(credentials.sdkAppId);
+    const USER_ID = credentials.userId;
+    const USER_SIG = credentials.userSig;
+
+    // Initialize SDK
+    delete global.window;
+    const TencentCloudChat = require('@tencentcloud/chat');
+
+    const chat = TencentCloudChat.create({ SDKAppID: SDK_APP_ID });
+
+    // Set window after require
+    global.window = {
+      location: { href: 'http://localhost', protocol: 'https:', host: 'localhost', hostname: 'localhost' },
+      addEventListener: () => {}, removeEventListener: () => {},
+      URL: Object.assign(function (...a) { return new (require('url').URL)(...a); }, {
+        createObjectURL: () => 'blob:node/1', revokeObjectURL: () => {}
+      })
+    };
+    global.document = { addEventListener: () => {}, removeEventListener: () => {}, characterSet: 'UTF-8' };
+    global.navigator = { userAgent: 'node', language: 'en', platform: 'linux' };
+    global.HTMLInputElement = global.HTMLInputElement || class {};
+    global.Image = class {
+      constructor() { this.width = 100; this.height = 100; this._ol = null; }
+      set onload(fn) { this._ol = fn; } get onload() { return this._ol; }
+      set onerror(fn) {} set src(v) { if (this._ol) setTimeout(() => this._ol(), 10); }
+    };
+
+    chat.setLogLevel(4);
+
+    let sdkReady = false;
+
+    chat.on(TencentCloudChat.EVENT.SDK_READY, () => {
+      sdkReady = true;
+      console.log(`[im-plugin] SDK ready: ${USER_ID}`);
+    });
+
+    chat.on(TencentCloudChat.EVENT.SDK_NOT_READY, () => {
+      sdkReady = false;
+      console.log('[im-plugin] SDK not ready');
+    });
+
+    // Receive messages and inject into tmux
+    chat.on(TencentCloudChat.EVENT.MESSAGE_RECEIVED, (event) => {
+      for (const msg of event.data) {
+        if (msg.from === USER_ID) continue;
+        let text = '';
+        if (msg.type === TencentCloudChat.TYPES.MSG_TEXT) {
+          text = msg.payload.text;
+        } else {
+          text = `[${msg.type}]`;
+        }
+        if (!text) continue;
+
+        const isGroup = msg.conversationType === TencentCloudChat.TYPES.CONV_GROUP;
+        const prefix = isGroup ? '💬 群消息' : '💬 IM消息';
+        const line = `${prefix} | [${msg.from}] ${text}`;
+
+        console.log(`[im-plugin] ${line}`);
+        injectToTerminal(line);
+      }
+    });
+
+    function injectToTerminal(text) {
+      try {
+        const escaped = text.replace(/\\/g, '\\\\').replace(/'/g, "'\\''").replace(/\n/g, ' ');
+        execSync(`tmux send-keys '${escaped}' Enter`, { stdio: 'ignore', timeout: 5000 });
+      } catch (e) {
+        console.error(`[im-plugin] inject failed: ${e.message}`);
+      }
+    }
+
+    // Login
+    chat.login({ userID: USER_ID, userSig: USER_SIG }).then(() => {
+      console.log(`[im-plugin] Login ok: ${USER_ID}`);
+    }).catch(err => {
+      console.error(`[im-plugin] Login failed: ${err}`);
+    });
+
+    // Unix socket server for MCP
+    if (fs.existsSync(socketPath)) {
+      fs.unlinkSync(socketPath); // Clean stale socket
+    }
+
+    const server = net.createServer((conn) => {
+      let data = '';
+      conn.on('data', (chunk) => { data += chunk; });
+      conn.on('end', async () => {
+        try {
+          const req = JSON.parse(data);
+          const res = await handleRequest(req);
+          conn.end(JSON.stringify(res));
+        } catch (e) {
+          try { conn.end(JSON.stringify({ error: e.message })); } catch {}
+        }
+      });
+    });
+
+    server.listen(socketPath, () => {
+      console.log(`[im-plugin] Socket: ${socketPath}`);
+    });
+
+    async function handleRequest(req) {
+      if (!sdkReady) return { error: 'SDK not ready' };
+
+      if (req.action === 'send_im') {
+        const msg = chat.createTextMessage({
+          to: req.to,
+          conversationType: TencentCloudChat.TYPES.CONV_C2C,
+          payload: { text: req.text },
+        });
+        await chat.sendMessage(msg);
+        return { ok: true };
+      }
+
+      if (req.action === 'send_group') {
+        const msg = chat.createTextMessage({
+          to: req.groupId,
+          conversationType: TencentCloudChat.TYPES.CONV_GROUP,
+          payload: { text: req.text },
+        });
+        await chat.sendMessage(msg);
+        return { ok: true };
+      }
+
+      if (req.action === 'status') {
+        return { ready: sdkReady, userId: USER_ID };
+      }
+
+      return { error: `Unknown action: ${req.action}` };
+    }
+
+    const plugin = {
+      destroy() {
+        server.close();
+        if (fs.existsSync(socketPath)) fs.unlinkSync(socketPath);
+        chat.logout();
+        console.log('[im-plugin] Destroyed');
+      }
+    };
+
+    // Resolve once SDK is ready (or after timeout)
+    const timer = setTimeout(() => resolve(plugin), 10000);
+    chat.on(TencentCloudChat.EVENT.SDK_READY, () => {
+      clearTimeout(timer);
+      resolve(plugin);
+    });
+  });
+}
+
+module.exports = { createImPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamnet/client",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "One command to join Seam — the network where people and AI stay in sync.",
   "bin": {
     "seam-client": "bin/cli.js"