@voko/lite 0.3.1

package/src/mcp/transport/http.js

@@ -0,0 +1,95 @@
+/**
+ * VOKO MCP — 纯 HTTP JSON-RPC 传输（StreamableHTTP 兼容）
+ *
+ * 自写 HTTP transport，不自用 SDK 的 server.connect()。
+ * 直接解析 JSON-RPC 报文，转发给 McpServer 处理。
+ *
+ * 端点：
+ *   POST /mcp — JSON-RPC 工具调用（initialize / tools/list / tools/call / notifications）
+ */
+
+const { Router } = require('express');
+
+const MCP_VERSION = '2025-11-25';
+const SERVER_NAME = 'voko';
+
+/**
+ * @param {import('@modelcontextprotocol/sdk/server/mcp').McpServer} mcpServer
+ * @param {Object} [options]
+ * @param {string} [options.version]
+ * @returns {Router}
+ */
+function createHttpTransport(mcpServer, options = {}) {
+  const router = Router();
+  const version = options.version || '0.2.14';
+
+  // ─── POST /mcp — JSON-RPC 请求 ───
+  router.post('/', async (req, res) => {
+    const msg = req.body;
+    if (!msg || !msg.jsonrpc) {
+      return res.status(400).json({
+        jsonrpc: '2.0',
+        error: { code: -32700, message: 'Parse error: invalid JSON-RPC' },
+        id: null,
+      });
+    }
+
+    // ── initialize ──
+    if (msg.method === 'initialize') {
+      return res.json({
+        jsonrpc: '2.0',
+        id: msg.id,
+        result: {
+          protocolVersion: MCP_VERSION,
+          capabilities: {
+            tools: {},
+          },
+          serverInfo: {
+            name: SERVER_NAME,
+            version,
+          },
+        },
+      });
+    }
+
+    // ── notifications（无 id，不需要回复） ──
+    if (!msg.id) {
+      return res.status(202).end();
+    }
+
+    // ── tools/list ──
+    if (msg.method === 'tools/list') {
+      const handler = mcpServer.server._requestHandlers.get('tools/list');
+      if (handler) {
+        const result = await handler({ method: 'tools/list', params: {} });
+        return res.json({ jsonrpc: '2.0', id: msg.id, result });
+      }
+      return res.json({ jsonrpc: '2.0', error: { code: -32603, message: 'tools/list handler not found' }, id: msg.id });
+    }
+
+    // ── tools/call ──
+    if (msg.method === 'tools/call') {
+      const handler = mcpServer.server._requestHandlers.get('tools/call');
+      if (handler) {
+        try {
+          const result = await handler({ method: 'tools/call', params: msg.params });
+          return res.json({ jsonrpc: '2.0', id: msg.id, result });
+        } catch (e) {
+          return res.json({ jsonrpc: '2.0', error: { code: -32603, message: e.message }, id: msg.id });
+        }
+      }
+      return res.json({ jsonrpc: '2.0', error: { code: -32603, message: 'tools/call handler not found' }, id: msg.id });
+    }
+
+    // ── 未知 method ──
+    return res.json({
+      jsonrpc: '2.0',
+      error: { code: -32601, message: `Method not found: ${msg.method}` },
+      id: msg.id,
+    });
+  });
+
+  return router;
+}
+
+module.exports = { createHttpTransport };

package/src/mcp/transport/stdio.js

@@ -0,0 +1,20 @@
+/**
+ * VOKO MCP — stdio 传输（可选）
+ *
+ * 3 行代码接入 SDK 的 StdioServerTransport。
+ * 适用于 Claude Code 通过 stdio 模式连接的场景。
+ * CLI：node src/mcp/standalone.js --transport stdio
+ */
+
+const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
+
+/**
+ * @param {import('@modelcontextprotocol/sdk/server/mcp').McpServer} mcpServer
+ */
+async function createStdioTransport(mcpServer) {
+  const transport = new StdioServerTransport();
+  await mcpServer.connect(transport);
+  console.error('[VOKO MCP] stdio transport 已启动');
+}
+
+module.exports = { createStdioTransport };

package/src/preload.js

@@ -0,0 +1,27 @@
+/**
+ * Lite 启动预加载 — 确保 better-sqlite3 使用本地编译的版本
+ *
+ * 在 Electron 下运行时（Desktop），用根目录的 Electron 编译版。
+ * 在纯 Node.js 下运行时（Lite CLI/MCP），用 packages/lite 的本地编译版。
+ */
+const path = require('path');
+const Module = require('module');
+
+// Electron 环境下不需要重定向（根目录的 better-sqlite3 就是 Electron 版）
+const isElectron = process.versions && process.versions.electron;
+if (isElectron) {
+  console.error('[Lite] Electron 环境，使用根目录 better-sqlite3');
+} else {
+  const liteBetterSqlite3 = path.join(__dirname, '..', 'native', 'better-sqlite3');
+  const origResolve = Module._resolveFilename;
+  Module._resolveFilename = function (request, parent) {
+    if (request === 'better-sqlite3') {
+      try {
+        return origResolve.call(this, liteBetterSqlite3, parent);
+      } catch (_) {
+        // 本地未安装 better-sqlite3 时回退默认
+      }
+    }
+    return origResolve.apply(this, arguments);
+  };
+}

package/src/server/agent-email-api.js

@@ -0,0 +1,120 @@
+/**
+ * Agent Email API — 服务端交互邮件 API 客户端
+ *
+ * 封装两个端点：
+ *   POST /api/external/v1/email/send         — 发信
+ *   POST /api/external/v1/email/reply/query  — 查回复
+ *
+ * 使用方式：
+ *   const api = new AgentEmailApi({ apiBaseUrl, getUserAccessToken });
+ *   const result = await api.send(agentDid, content, { subject, external_id, context });
+ *   const reply = await api.queryReply({ message_id });
+ */
+
+class AgentEmailApi {
+  /**
+   * @param {Object} opts
+   * @param {string} opts.apiBaseUrl — VOKO_API_URL
+   * @param {Function} opts.getUserAccessToken — () => string | null，返回 User Access Token
+   */
+  constructor({ apiBaseUrl, getUserAccessToken }) {
+    this.apiBaseUrl = (apiBaseUrl || '').replace(/\/+$/, '');
+    this.getUserAccessToken = getUserAccessToken || (() => null);
+  }
+
+  /**
+   * 发交互邮件
+   * @param {string} agentDid — Agent DID
+   * @param {string} content — 邮件正文（template_data.CONTENT）
+   * @param {Object} [opts]
+   * @param {string} [opts.subject] — 邮件标题
+   * @param {string} [opts.external_id] — 外部关联 ID
+   * @param {Object} [opts.context] — { visitor_id?, session_id?, snippet? }
+   * @returns {Promise<{message_id:string, external_id:string}|null>}
+   */
+  async send(agentDid, content, opts = {}) {
+    const token = this.getUserAccessToken();
+    if (!token) { console.warn('[AgentEmailApi] send 跳过: 无 User Access Token'); return null; }
+    if (!this.apiBaseUrl) { console.warn('[AgentEmailApi] send 跳过: VOKO_API_URL 未配置'); return null; }
+    if (!agentDid) { console.warn('[AgentEmailApi] send 跳过: agentDid 为空'); return null; }
+    if (!content) { console.warn('[AgentEmailApi] send 跳过: content 为空'); return null; }
+
+    const body = {
+      agentDid,
+      template_data: {
+        CONTENT: content,
+        TITLE: opts.subject || '请处理',
+      },
+      reply_enabled: true,
+    };
+
+    if (opts.subject) body.subject = opts.subject;
+    if (opts.external_id) body.external_id = opts.external_id;
+    if (opts.context) body.context = opts.context;
+    if (opts.to) body.to = opts.to;
+
+    try {
+      const resp = await fetch(`${this.apiBaseUrl}/api/external/v1/email/send`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          Authorization: `Bearer ${token}`,
+        },
+        body: JSON.stringify(body),
+      });
+      const json = await resp.json();
+      if (!json.success || !json.data?.message_id) {
+        console.warn('[AgentEmailApi] send 失败:', json.message || json.msg || 'unknown');
+        return null;
+      }
+      return {
+        message_id: json.data.message_id,
+        external_id: json.data.external_id || opts.external_id || null,
+      };
+    } catch (e) {
+      console.warn('[AgentEmailApi] send 异常:', e.message);
+      return null;
+    }
+  }
+
+  /**
+   * 查回复
+   * @param {Object} opts
+   * @param {string} opts.message_id — 发信返回的 message_id
+   * @returns {Promise<{has_reply:boolean, raw_text:string, status:string, replied_at:string}|null>}
+   */
+  async queryReply({ message_id } = {}) {
+    const token = this.getUserAccessToken();
+    if (!token || !this.apiBaseUrl || !message_id) {
+      return null;
+    }
+
+    try {
+      const resp = await fetch(`${this.apiBaseUrl}/api/external/v1/email/reply/query`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          Authorization: `Bearer ${token}`,
+        },
+        body: JSON.stringify({ message_id }),
+      });
+      const json = await resp.json();
+      if (!json.success || !json.data) {
+        return null;
+      }
+      const data = json.data;
+      return {
+        has_reply: !!data.has_reply,
+        raw_text: data.raw_text || null,
+        status: data.status || null,
+        replied_at: data.replied_at || null,
+        actor_email: data.actor_email || null,
+      };
+    } catch (e) {
+      console.warn('[AgentEmailApi] queryReply 异常:', e.message);
+      return null;
+    }
+  }
+}
+
+module.exports = { AgentEmailApi };